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

# Agents

> List and retrieve Agents

## List agents

```typescript theme={null}
const page = await client.agents.list();

for await (const agent of page) {
  console.log(agent.id, agent.name, agent.status);
}

// Or collect to array
const agents = await page.toArray();
```

## Retrieve an agent

```typescript theme={null}
const agent = await client.agents.retrieve(7);

console.log(agent.name);
console.log(agent.capabilities.streaming); // true/false
```

## Agent model

| Field                                   | Type      | Description                       |
| --------------------------------------- | --------- | --------------------------------- |
| `id`                                    | `number`  | Agent ID                          |
| `name`                                  | `string`  | Display name                      |
| `description`                           | `string`  | Short description                 |
| `status`                                | `string`  | `"active"` or `"inactive"`        |
| `avatar_url`                            | `string`  | Avatar image URL                  |
| `capabilities.persistent_conversations` | `boolean` | Supports persistent conversations |
| `capabilities.streaming`                | `boolean` | Supports streaming responses      |
| `capabilities.tool_activity`            | `boolean` | Can execute tools                 |
| `created_at`                            | `string`  | ISO 8601 timestamp                |
| `updated_at`                            | `string`  | ISO 8601 timestamp                |