Agentes
Um agente roda um loop de *tool use*: o modelo chama as ferramentas do LiteZap (as mesmas do MCP, executadas dentro do motor, com as mesmas validações) até concluir a tarefa. Cada agente tem instruções, grupos de permissão (ler só lê a conversa do gatilho; ler_outros_chats, responder_no_chat, enviar_outros_chats, etiquetas, grupos, midia), um modo (aprovacao, o padrão: cada escrita vira um rascunho que alguém aprova; autonomo; sugerir: só notas) e limites por execução (8 passos, 3 destinatários distintos, 5 envios, 10 escritas, 3 mudanças em grupos). O motor aplica as regras, não só o prompt: um envio para outro chat sem enviar_outros_chats é recusado. Todo envio passa pela fila (ritmo, janela, rampa).
O gatilho "mensagem nova" usa o hook de agente com target: "agents" (um por vez por chat, pausa quando um humano responde, proteção contra loop). Há também "Executar agora" e o simulador, que nunca executa escritas. O provedor (Anthropic ou OpenAI-compatível com function calling) e os limites de gasto são os do Atendente IA, configurados pelo admin. Guia em Agentes.
Conceito: leia antes de integrar.
Operações
| Operação | Rota | Token |
|---|---|---|
| Listar agentes | GET /v1/instances/{id}/agents | token da instância ou admin |
| Criar agente | POST /v1/instances/{id}/agents | token da instância ou admin |
| Ler agente | GET /v1/instances/{id}/agents/{agent_id} | token da instância ou admin |
| Alterar agente | PUT /v1/instances/{id}/agents/{agent_id} | token da instância ou admin |
| Excluir agente | DELETE /v1/instances/{id}/agents/{agent_id} | token da instância ou admin |
| Executar agente agora | POST /v1/instances/{id}/agents/{agent_id}/run | token da instância ou admin |
| Execuções do agente | GET /v1/instances/{id}/agents/{agent_id}/runs | token da instância ou admin |
| Ler execução | GET /v1/instances/{id}/agents/runs/{run_id} | token da instância ou admin |
| Quem pode rodar agentes | GET /v1/instances/{id}/agents/runtimes | token da instância ou admin |
| Listar rascunhos | GET /v1/instances/{id}/agents/drafts | token da instância ou admin |
| Aprovar rascunho | POST /v1/instances/{id}/agents/drafts/{draft_id}/approve | token da instância ou admin |
| Rejeitar rascunho | POST /v1/instances/{id}/agents/drafts/{draft_id}/reject | token da instância ou admin |
| Simular agente | POST /v1/instances/{id}/agents/simulate | token da instância ou admin |
Eventos relacionados
Gerado de openapi.yaml. Convenções gerais na visão geral e todos os códigos em Erros.