Agent API

API di chat in streaming di Apollo Brain con esecuzione di strumenti e gestione delle sessioni.

​

Endpoint

​

Chat (Streaming SSE)

POST /api/v1/agent/chat

Invia un messaggio ad Apollo Brain e riceve una risposta in streaming tramite Server-Sent Events (SSE).

Corpo della Richiesta:

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

Eventi SSE:

Evento	Descrizione
content	Token di testo dalla risposta dell’IA
tool_call	L’IA sta invocando uno strumento (include nome e argomenti)
tool_result	Risultato dell’esecuzione dello strumento
confirmation_required	HITL — un’operazione di scrittura richiede approvazione
done	Stream completato
error	Si e verificato un errore

​

Conferma Azione

POST /api/v1/agent/confirm

Approva o rifiuta una richiesta di conferma HITL.

Corpo della Richiesta:

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

​

Elenco Sessioni

GET /api/v1/agent/sessions

Restituisce tutte le sessioni di chat dell’utente autenticato.

​

Genera Titolo

POST /api/v1/agent/generate-title

Genera automaticamente un titolo descrittivo per una sessione di chat in base al contenuto della conversazione.

​

Preferenze di Memoria

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

Legge o aggiorna le preferenze di memoria IA dell’utente (memoria procedurale).