> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent settings

> Set and edit your agent's global rules, model, personality, and fixed greeting line.

Configure your agent's greeting, personality, model, and rules in **Build > Agent**.

<img src="https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=9ce32709180a5bc12b5362412c734f1e" alt="Build > Agent overview" data-og-width="3016" width="3016" data-og-height="1376" height="1376" data-path="images/agent-settings/agent-overview.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?w=280&fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=8dfa6d80aac6ecc8dcfab6e19c4824ae 280w, https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?w=560&fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=62b67a4de899f9e9b64fb8b151e47a04 560w, https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?w=840&fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=84f888379a9ce16141da38f5438a7611 840w, https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?w=1100&fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=917fcc089ab024bf7d06f55a2e02ab1d 1100w, https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?w=1650&fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=7dc182b39fe7e753d11d4ad0fe1a2836 1650w, https://mintcdn.com/polyai/EaIQY0vBmmGQ1SOH/images/agent-settings/agent-overview.png?w=2500&fit=max&auto=format&n=EaIQY0vBmmGQ1SOH&q=85&s=a3825ada77445b4f421b6d5ad47218e2 2500w" />

## When to configure each setting

| Setting                  | When to use                                             | Impact                                                                                                             |
| ------------------------ | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **[Agent](./agent)**     | For the initial setup or when rebranding                | Personality (tone) and role. The greeting is configured per-channel under **Channels > Voice/Chat configuration**. |
| **[Model](./model-use)** | New agent setup, or optimizing for cost/latency/quality | LLM selection. [Raven](/agent-settings/raven) recommended, but other models are also available.                    |
| **[Behavior](./rules)**  | Consistent terminology, compliance, edge-case handling  | Add your global constraints – tone, language style, compliance guardrails, pronunciation overrides.                |

## Configuration sections

<CardGroup cols={3}>
  <Card title="Agent" icon="user" href="./agent">
    Personality and role.
  </Card>

  <Card title="Model" icon="brain" href="./model-use">
    Raven (recommended), OpenAI, Amazon Bedrock, or your own endpoint.
  </Card>

  <Card title="Behavior" icon="list-check" href="./rules">
    Language style, compliance, edge cases, and pronunciation overrides.
  </Card>
</CardGroup>

<div className="developer-only">
  ## Automate with the Agents API

  If you spin up new agents from a reference template — for example, one agent per client or market — you can create and duplicate them from code.

  <AccordionGroup>
    <Accordion title="Script agent creation via the Agents API" icon="code">
      The [Agents API](/api-reference/agents/introduction) has endpoints for [creating](/api-reference/agents/endpoint/agents/create-agent) and [duplicating](/api-reference/agents/endpoint/agents/duplicate-agent) agents.

      ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
      # Create a new agent from scratch
      curl -X POST https://api.us.poly.ai/v1/agents \
        -H "x-api-key: $POLYAI_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{ "name": "Support Agent", "description": "Tier 1 support, US" }'

      # Duplicate an existing agent as a starting point
      curl -X POST https://api.us.poly.ai/v1/agents/AGENT_ID/duplicate \
        -H "x-api-key: $POLYAI_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{ "name": "Support Agent - UK" }'
      ```
    </Accordion>
  </AccordionGroup>
</div>

## Related pages

<CardGroup cols={2}>
  <Card title="Agents endpoints" icon="square-terminal" href="/api-reference/agents/endpoint/agents/create-agent">
    Create, duplicate, and configure agents from code.
  </Card>

  <Card title="Deployment pipeline" icon="server" href="/environments-and-versions/introduction">
    Publish and promote versions through Sandbox, Pre-release, and Live.
  </Card>
</CardGroup>
