Agentes

Listar

GET /api/agents

{
  "data": [
    {
      "id": "agt_abc",
      "name": "Carlos",
      "status": "ACTIVE",
      "template": "SUPORTE",
      "model": "claude-sonnet-4-6",
      "_count": { "conversations": 240, "intents": 18, "numbers": 6 }
    }
  ]
}

Criar

POST /api/agents
{
  "name": "Carlos",
  "template": "SUPORTE",
  "jobName": "Atendente Bee Delivery",
  "jobSite": "https://beedelivery.com.br",
  "jobDescription": "Atende dúvidas de entregadores parceiros",
  "trainingContext": "Quando alguém pergunta sobre pagamento, sempre confirme...",
  "model": "claude-sonnet-4-6"
}

Retorna o agente criado com systemPrompt gerado automaticamente baseado no template.

Atualizar

PUT /api/agents/{agentId}

Importante

Sempre envie TODOS os campos no PUT. Campos omitidos são considerados null e podem zerar name, jobName, etc. Faça GET antes, modifique o objeto, e mande de volta inteiro.

Mudar status

PATCH /api/agents/{agentId}/status
{ "status": "PAUSED" }   // ou "ACTIVE"

PAUSED: o agente continua recebendo mensagens (entram no histórico), mas não responde. Útil pra debug.

Editar prompt diretamente

PUT /api/agents/{agentId}/prompt
{
  "systemPrompt": "Você é o Carlos...",
  "rationale": "Adicionado contexto sobre nova região"
}

Cada PUT /prompt cria uma PromptVersion — você pode reverter via UI (Editor → Histórico de versões).

Deletar

DELETE /api/agents/{agentId}

DANGER

Cascade: deleta também todas as conversas, mensagens, intenções e canais associados. Não tem soft-delete.

Behavior flags

Configuráveis via PUT /api/agents/{agentId}:

Campo	Default	Descrição
enabledHumanTransfer	true	Permite intent <transferir>
enabledReminder	true	Reminder automático após inatividade
splitMessages	true	Quebra resposta longa em N mensagens
enabledEmoji	true	Permite emojis nas respostas
signMessages	false	Assina cada mensagem com nome do agente
messageGroupingTime	MEDIUM	FAST/MEDIUM/SLOW — debounce de mensagens consecutivas
maxDailyMessages	null	Limita N mensagens/dia por contato
autoCloseMinutes	60	Fecha conversa inativa após N min