Agent API

API de chat con streaming de Apollo Brain, con ejecución de herramientas y gestión de sesiones.

​

Endpoints

​

Chat (Streaming SSE)

POST /api/v1/agent/chat

Envía un mensaje a Apollo Brain y recibe una respuesta en streaming mediante Server-Sent Events (SSE).

Cuerpo de la Solicitud:

{
  "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	Descripción
content	Token de texto de la respuesta de la IA
tool_call	La IA está invocando una herramienta (incluye nombre y argumentos)
tool_result	Resultado de la ejecución de la herramienta
confirmation_required	HITL — una operación de escritura necesita aprobación
done	Stream completado
error	Ocurrio un error

​

Confirmar Acción

POST /api/v1/agent/confirm

Aprueba o rechaza una solicitud de confirmación HITL.

Cuerpo de la Solicitud:

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

​

Listar Sesiones

GET /api/v1/agent/sessions

Devuelve todas las sesiones de chat del usuario autenticado.

​

Generar Título

POST /api/v1/agent/generate-title

Genera automáticamente un título descriptivo para una sesión de chat basado en el contenido de la conversación.

​

Preferencias de Memoria

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

Lee o actualiza las preferencias de memoria de IA del usuario (memoria procedural).