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

# Listar agentes de IA

> Retorna todos os agentes de IA da organização.

## Endpoint

```
GET /v1/ai-agents
```

**Escopo necessário:** `read:ai_agents` — disponível nos planos **Growth e Scale**.

## Exemplo de requisição

```bash theme={null}
curl "https://api.socialsell.ai/v1/ai-agents" \
  -H "Authorization: Bearer sk_live_..."
```

## Exemplo de resposta

```json theme={null}
{
  "data": [
    {
      "id": "664p1q2r3s4t5u6v7w8x9y0z",
      "name": "Qualificador de Leads",
      "description": "Qualifica leads inbound e agenda reuniões",
      "type": "sales",
      "status": "active",
      "priority": 1,
      "scope": { "channels": ["whatsapp"], "objectives": ["sales"] },
      "triggers": [{ "event": "message.received.from_contact" }],
      "behavior": { "activationMode": "always" },
      "ai_config": { "model": "gpt-oss-120b" },
      "stats": { "runs": 142, "handoffs": 23 },
      "created_at": "2026-05-01T00:00:00.000Z",
      "updated_at": "2026-06-10T12:00:00.000Z"
    }
  ],
  "meta": { "total": 3, "has_more": false }
}
```

## Objeto agente

| Campo           | Tipo         | Descrição                                         |
| --------------- | ------------ | ------------------------------------------------- |
| `id`            | string       | ID do agente                                      |
| `name`          | string       | Nome                                              |
| `description`   | string\|null | Descrição                                         |
| `type`          | string       | `sales` ou `support`                              |
| `status`        | string       | `draft`, `active`, `paused`                       |
| `priority`      | integer      | Prioridade de execução (menor = mais prioritário) |
| `scope`         | object       | Canais e objetivos cobertos                       |
| `triggers`      | array        | Eventos que ativam o agente                       |
| `behavior`      | object       | Modo de ativação e comportamento                  |
| `humanization`  | object       | Configuração de humanização (delays, split)       |
| `guardrails`    | object       | Limites e proteções                               |
| `tools_allowed` | object       | Ferramentas habilitadas                           |
| `limits`        | object       | Limites de execução                               |
| `ai_config`     | object       | Modelo e parâmetros de IA                         |
| `stats`         | object       | Estatísticas agregadas (`runs`, `handoffs`)       |