Zum Hauptinhalt springen

​
Endpoints

​
Chat (SSE-Streaming)

POST /api/v1/agent/chat
Sendet eine Nachricht an Apollo Brain und empfängt eine Streaming-Antwort über Server-Sent Events (SSE). Request Body: 
{
  "message": "What tasks are due this week?",
  "session_id": "optional-session-uuid",
  "context": {
    "current_page": "/tasks",
    "selected_project_id": "optional-project-uuid"
  }
}
SSE-Events:
EventBeschreibung
contentText-Token aus der KI-Antwort
tool_callDie KI ruft ein Tool auf (enthält Toolname und Argumente)
tool_resultErgebnis der Tool-Ausführung
confirmation_requiredHITL — eine Schreiboperation erfordert Genehmigung
doneStream abgeschlossen
errorEin Fehler ist aufgetreten

​
Aktion Bestätigen

POST /api/v1/agent/confirm
Genehmigt oder lehnt eine HITL-Bestätigungsanfrage ab. Request Body: 
{
  "session_id": "session-uuid",
  "confirmation_id": "confirmation-uuid",
  "approved": true
}

​
Sitzungen Auflisten

GET /api/v1/agent/sessions
Gibt alle Chat-Sitzungen des authentifizierten Benutzers zurück.

​
Titel Generieren

POST /api/v1/agent/generate-title
Generiert automatisch einen beschreibenden Titel für eine Chat-Sitzung basierend auf dem Gesprächsinhalt.

​
Speicher-Einstellungen

GET/POST /api/v1/agent/memory/preferences
Liest oder aktualisiert die KI-Speicher-Einstellungen des Benutzers (prozeduraler Speicher).