# Agentes de IA

> Agentes, funções, servidores MCP, arquivos e histórico da IA.

Endereço: https://docs.nextags.com.br/referencia/agentes-de-ia/
Tipo: Referência

Os agentes de IA do **AI Hub**: as instruções e os modelos com que a IA responde os contatos, usando o provedor conectado na conta (OpenAI, Gemini, Claude, xAI ou DeepSeek). Pela API, você lista e consulta os agentes, troca a mensagem do sistema, o limite de tokens e os modelos, lista as funções, os servidores MCP e os arquivos, e põe mensagens no histórico da IA de um contato. Veja o guia [Agentes de IA pela API](https://docs.nextags.com.br/guias/agentes-de-ia-pela-api/) e [Criar um agente de IA](https://help.nextags.com.br/tutoriais/ia/criar-agente/).

## Endpoints

- [Listar agentes de IA](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-agentes-de-ia.md): `GET /agents/`
- [Consultar agente de IA](https://docs.nextags.com.br/referencia/agentes-de-ia/consultar-agente-de-ia.md): `GET /agents/{agent_id}`
- [Atualizar agente de IA](https://docs.nextags.com.br/referencia/agentes-de-ia/atualizar-agente-de-ia.md): `POST /agents/{agent_id}`
- [Listar funções dos agentes](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-funcoes-dos-agentes.md): `GET /agents/functions`
- [Listar servidores MCP](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-servidores-mcp.md): `GET /agents/mcp`
- [Listar arquivos dos agentes](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-arquivos-dos-agentes.md): `GET /agents/files`
- [Salvar mensagens no histórico da IA](https://docs.nextags.com.br/referencia/agentes-de-ia/salvar-mensagens-no-historico-da-ia.md): `POST /contacts/{contact_id}/ai/save_messages`

## O objeto: Agente de IA

| Campo | Tipo | Descrição |
|---|---|---|
| `id` | integer | O ID do agente. |
| `name` | string | O nome do agente, como aparece na lista do AI Hub. |
| `created_by` | integer | O ID do administrador que criou. |
| `created_at` | string (data e hora) | Quando o agente foi criado, em UTC. |

```json
{
  "id": 5001,
  "name": "Bia - Loja Exemplo",
  "created_by": 10001,
  "created_at": "2026-09-15 13:20:00"
}
```