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

# Create a Chat Agent

## Create it

<Steps>
  <Step title="Open Agents">
    Go to **Dashboard → Agents** and click **Create Agent**.
  </Step>

  <Step title="Pick Chat Agent">
    Choose **Chat Agent** — "AI agent for WhatsApp & text-based conversations" — rather than Voice Agent.
  </Step>

  <Step title="Choose the channel">
    **WhatsApp** or **Instagram**. For Instagram, also pick the agent type: **DM Agent**, **Comment Agent**, or **DM & Comments Agent**.

    <Warning>
      The channel is fixed once the agent is created. It decides which configuration panels and which function types exist, so a WhatsApp agent cannot be converted into an Instagram one — create a second agent instead.
    </Warning>
  </Step>

  <Step title="Continue into the builder">
    You land in the chat agent builder with an unsaved draft. Nothing exists on the server until you save.
  </Step>
</Steps>

## The builder

Three panes, left to right:

| Pane                    | What it holds                                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
| **System Prompt**       | The agent's instructions — the single biggest lever on how it behaves                                      |
| **Agent Configuration** | Collapsible panels: LLM Model, Conversation & Features, Instagram Settings, Follow-Ups, Functions, Webhook |
| **Test Chat**           | A live conversation with the agent, using whatever is on screen                                            |

Which configuration panels appear depends on the channel:

| Panel                   | WhatsApp  | Instagram             |
| ----------------------- | --------- | --------------------- |
| LLM Model               | Yes       | Yes                   |
| Conversation & Features | Yes       | —                     |
| Instagram Settings      | —         | Yes                   |
| Follow-Ups              | Yes       | —                     |
| Functions               | All types | Custom functions only |
| Webhook                 | Yes       | Yes                   |

## The header

Along the top of the builder:

* **Agent name** — editable inline. Give it a name that says what it does, not "Test 3".
* **Agent ID** — with a copy button. This is what the API and your own integrations reference.
* **Version selector** — switch, create and publish versions. See [Versions and publishing](/chat-agents/versions-and-publishing).
* **Save / Update** — writes the current version.
* **Publish** — makes a saved version the live one.
* **Import / Export** — move an agent between accounts, or keep a JSON backup.
* **Live / In-Progress** — Instagram agents only.

<Warning>
  The builder tracks unsaved changes and blocks anything that would discard them — going back, switching version, publishing. Publishing ships the last **saved** version, which is not necessarily what is on your screen.
</Warning>

## Defaults a new agent starts with

Sensible out of the box, so a new agent is testable before you touch anything:

| Setting                                                                             | Default               |
| ----------------------------------------------------------------------------------- | --------------------- |
| Primary model                                                                       | `callkaro/arjuna-2.5` |
| Secondary model                                                                     | `gpt-5.4-nano`        |
| Temperature                                                                         | 0.5                   |
| Max Function Rounds                                                                 | 3                     |
| Context Length                                                                      | 10 messages           |
| Max Bot Messages per Session                                                        | 50                    |
| Multiple Messages per Reply                                                         | On                    |
| Gap Between Messages                                                                | 0.1s                  |
| Follow-ups                                                                          | Off                   |
| Audio Transcription, Interactive Messages, Reply to Specific Message, Image Context | Off                   |
| Webhook                                                                             | None                  |

The system prompt starts empty — that part is yours.

## Import and export

**Export** downloads the agent as JSON. You choose which versions to include, so you can ship just the published one or the full history.

**Import** creates an agent from such a file. Use it to copy a working agent into another account, or to restore one.

## Then what

<CardGroup cols={2}>
  <Card title="Write the system prompt" icon="brain" href="/chat-agents/system-prompt">
    Start here — it matters more than any setting
  </Card>

  <Card title="Add functions" icon="code" href="/chat-agents/functions/overview">
    Give the agent something to do
  </Card>

  <Card title="Test it" icon="vial" href="/chat-agents/testing">
    Before a customer does
  </Card>

  <Card title="Go live" icon="rocket" href="/chat-agents/channels/whatsapp">
    Attach it to a WhatsApp number or Instagram account
  </Card>
</CardGroup>