> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/en/agent-optimization/agent-settings.md).

# How to configure your agent settings

The Settings tab is where you manage your agent's identity, location, and operational status. Changes here affect how your agent appears in the platform and how it interprets geographic and cultural context in conversations.

In the sidebar, go to Agent > General. The Settings tab opens by default.

## Status panel

| Field           | What it shows                              |
| --------------- | ------------------------------------------ |
| Agent name      | The agent's internal name in the platform  |
| Active Version  | Version currently in production (e.g. v89) |
| Status          | AGENT ONLINE (active) or OFFLINE (paused)  |
| Agent Objective | Short description of the agent's purpose   |
| WhatsApp Number | Number connected to this agent             |
| Quality         | WhatsApp number health (Green/Yellow/Red)  |
| Throughput      | Messaging capacity tier (e.g. STANDARD)    |

The Chat button in the status panel opens a live test conversation directly through WhatsApp. Use it to check your agent's behavior in production without going through the Playground.

## Definition

**Name:** Displayed in the status panel and in your organization's agent list. This name does not affect how the agent introduces itself to leads, which is configured in the Goals & Tone tab.

**Description:** Free text field describing the purpose of this agent. Appears in the status panel as the Agent Objective.

After editing Name or Description, click Apply Changes to save.

## Location

| Field     | What it configures                          |
| --------- | ------------------------------------------- |
| Language  | Primary language for conversations          |
| Country   | Country of operation                        |
| Time zone | Time reference for dates and appointments   |
| Currency  | Currency format for values in conversations |

{% hint style="warning" %}
Changing the language affects how the agent interprets new conversations. Previous conversations are not affected. Change this setting carefully if your agent is already active.
{% endhint %}

## Administrative actions

**Pause Agent:** Temporarily stops the agent from responding without deleting it. The WhatsApp number stays connected. To reactivate, toggle Pause Agent off.

{% hint style="warning" %}
If you pause the agent during business hours, leads in active conversations will not receive a response. Pause outside peak hours or make sure human support is available.
{% endhint %}

**Delete Agent:** Permanently removes the agent and all its configurations. This action cannot be undone. If you only need to stop the agent temporarily, use Pause Agent instead.

**Convert to Manual Billing:** This option appears at the bottom of the Settings screen as a highlighted card. It is intended exclusively for enterprise customers being migrated to monthly invoice billing by the Patagon AI team.

{% hint style="warning" %}
Do not use this option on your own. Contact us at <sales@patagon.ai> if you'd like to learn more about enterprise plans.
{% endhint %}

## How to change your agent's language

Your agent's language determines how it interprets and responds to conversations. Change it from the Location section in Agent > General > Settings.

1. Click the Language dropdown and select the new language.
2. Click Apply Changes.

{% hint style="warning" %}
Changing the language takes effect immediately on new conversations. Leads already in an active conversation will continue in the previous language until their conversation ends. Only change the language outside peak hours to avoid inconsistent responses.
{% endhint %}

## How to change your agent's avatar

Your agent's avatar appears in the platform but does not appear to leads on WhatsApp. The WhatsApp profile photo is managed separately in Meta Business Manager.

1. In Agent > General > Settings, click the avatar image at the top of the status panel.
2. Upload a new image. Supported formats: PNG, JPEG, JPG. Max size: 5MB.
3. Click Apply Changes.

To change the photo leads see on WhatsApp, see How to edit your display name and profile photo.

## How to pause and reactivate your agent

Use Pause Agent when you need to stop your agent temporarily for prompt updates, maintenance, or taking manual control of all conversations.

**To pause:** Scroll to the bottom of Agent > General > Settings and toggle Pause Agent on. The status panel will show OFFLINE.

**To reactivate:** Toggle Pause Agent off. The status panel will show AGENT ONLINE.

The WhatsApp number stays connected while the agent is paused. Leads can still send messages but will not receive a response until you reactivate.

{% hint style="warning" %}
If you pause the agent during business hours, leads in active conversations will not receive a response. Notify your team before pausing so someone can handle incoming messages manually.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/en/agent-optimization/agent-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.