Agent API

API de chat com streaming do Apollo Brain, com execução de ferramentas e gerenciamento de sessões.

​

Endpoints

​

Chat (Streaming SSE)

POST /api/v1/agent/chat

Envia uma mensagem para o Apollo Brain e recebe uma resposta em streaming via Server-Sent Events (SSE).

Corpo da Requisição:

{
  "message": "What tasks are due this week?",
  "session_id": "optional-session-uuid",
  "context": {
    "current_page": "/tasks",
    "selected_project_id": "optional-project-uuid"
  }
}

Eventos SSE:

Evento	Descrição
content	Token de texto da resposta da IA
tool_call	A IA está chamando uma ferramenta (inclui nome e argumentos)
tool_result	Resultado da execução da ferramenta
confirmation_required	HITL — uma operação de escrita precisa de aprovação
done	Stream concluído
error	Ocorreu um erro

​

Confirmar Ação

POST /api/v1/agent/confirm

Aprova ou rejeita uma solicitação de confirmação HITL.

Corpo da Requisição:

{
  "session_id": "session-uuid",
  "confirmation_id": "confirmation-uuid",
  "approved": true
}

​

Listar Sessões

GET /api/v1/agent/sessions

Retorna todas as sessões de chat do usuário autenticado.

​

Gerar Título

POST /api/v1/agent/generate-title

Gera automaticamente um título descritivo para uma sessão de chat com base no conteúdo da conversa.

​

Preferências de Memória

GET/POST /api/v1/agent/memory/preferences

Lê ou atualiza as preferências de memória de IA do usuário (memória procedural).