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

# Create agent

> Create an agent YAML file and backing pipeline.

Only in Mage Pro.

Try our fully managed solution to access this advanced feature.

[Get started for free](https://cloud.mage.ai/sign-up?source=agents-api)

```http theme={"system"}
POST /api/agents
```

```json theme={"system"}
{
  "agent": {
    "name": "Customer support agent",
    "description": "Routes support questions.",
    "instructions": "Classify the request.",
    "actions": []
  }
}
```

Creating an agent creates one backing pipeline named after the agent and one YAML block file under `agents/`. If `uuid` is omitted, Mage derives it from the cleaned agent name. If that UUID already exists, the request is rejected.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.