> For the complete documentation index, see [llms.txt](https://docs.automatos.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.automatos.app/user-guides/agents.md).

# Agents

The Agent Management page is where you build and manage your AI workforce. Each agent is a specialised AI worker with its own model, persona, tools, and skills.

## Page layout

The Agent Management page has four main tabs:

{% tabs %}
{% tab title="Agent Roster" %}
Your agent directory. Browse all agents as cards, filter by status (Active / Idle), search by name or capability. Each card shows:

* Agent name, category, and model
* Success rate percentage
* Tasks completed and capabilities count
* Status indicator (online/offline)

[Full guide →](/user-guides/agents/roster.md)
{% endtab %}

{% tab title="Configuration" %}
Global agent settings — default models, shared prompts, and system-wide configuration that applies across agents.

[Full guide →](/user-guides/agents/configuration.md)
{% endtab %}

{% tab title="Coordination" %}
Manage how agents work together — team assignments, delegation rules, and inter-agent communication settings.

[Full guide →](/user-guides/agents/coordination.md)
{% endtab %}

{% tab title="Playbooks" %}
Multi-step workflows that chain agents together. Create, edit, and manage playbooks that coordinate multiple agents to complete complex tasks.

[Full guide →](/user-guides/agents/playbooks.md)
{% endtab %}
{% endtabs %}

## Stats bar

At the top of the page, four metric cards give you an at-a-glance view:

| Metric              | What it shows                            |
| ------------------- | ---------------------------------------- |
| **Total Agents**    | Number of agents in your workspace       |
| **Active Agents**   | Agents currently online and processing   |
| **Categories**      | How many distinct agent types you have   |
| **Avg Performance** | Aggregate success rate across all agents |

## Quick start: Create your first agent

1. Click **+ Create Agent** in the top right
2. Choose a template (Code Reviewer, QA Engineer, etc.) or start blank
3. Set a name, select a model, and assign a persona
4. Add tools and skills
5. Click **Create**

Your agent appears on the roster immediately and is ready to receive messages.

### Batch agent creation

Need multiple agents? Use the batch creation feature to create several agents at once. Click **+ Create Agent** and toggle to **Batch Mode** to define multiple agents in a single session.

### Starter agents

New workspaces come with 10 pre-configured starter agents covering common roles: Code Reviewer, QA Engineer, Sentinel (security), Scribe (documentation), Scout (research), Comms (communication), and more. These are ready to use immediately — customise them or create your own.

{% hint style="success" %}
Start with a template. You can always customise the agent later from the [Agent Details](/user-guides/agents/details.md) panel.
{% endhint %}

## Subpages

| Page                                                  | Description                                                          |
| ----------------------------------------------------- | -------------------------------------------------------------------- |
| [Agent Roster](/user-guides/agents/roster.md)         | Browsing, filtering, and managing your agents                        |
| [Creating an Agent](/user-guides/agents/creating.md)  | Step-by-step agent creation guide                                    |
| [Agent Details](/user-guides/agents/details.md)       | The per-agent detail panel (Overview, Performance, Plugins, Reports) |
| [Configuration](/user-guides/agents/configuration.md) | Global agent configuration                                           |
| [Coordination](/user-guides/agents/coordination.md)   | Multi-agent teamwork settings                                        |
| [Playbooks](/user-guides/agents/playbooks.md)         | Creating and managing multi-step workflows                           |


---

# 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:

```
GET https://docs.automatos.app/user-guides/agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.