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

# Agents

> The single entity you configure — persona, language, and voice.

An **agent** is the one user-facing entity in Flowyte. Everything else — knowledge, skills,
guardrails, playbooks — attaches to an agent. You configure who the agent is; the platform
handles turning that into a real-time voice and chat experience.

## What an agent holds

* **Persona** — its name, role, goals, and the things it must never do.
* **Language & voice** — the primary language (it can mirror a caller's language) and the voice it speaks with.
* **Behavior** — greeting, tone, and how it handles handoffs.

## Draft vs published

Editing an agent changes its **draft**. The in-browser tester runs the draft, but phone and
chat channels serve the last **published** version. Publishing freezes a version; you can roll
back to a previous one at any time.

## In the API

| Action            | Endpoint                                  |
| ----------------- | ----------------------------------------- |
| Create an agent   | `POST /agents`                            |
| Read / update     | `GET /agents/{id}` · `PATCH /agents/{id}` |
| Publish a version | `POST /agents/{id}/publish`               |
| Roll back         | `POST /agents/{id}/rollback`              |
| Test (streaming)  | `POST /agents/{id}/simulate`              |

See the [Agents endpoints](/api-reference/introduction) in the reference for the full shape.