> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# KI-Chat und der Assistent

Gestreamte Chat-Threads und einmalige Agent-Runs über die gemeinsame API.

## Chat-Threads nutzen den Web-Vertrag

Der Chat-Tab ruft dieselbe REST-Oberfläche auf wie die Browser-App: Auflisten und Erstellen über /api/chat/threads, Lesen, Umbenennen oder Löschen über /api/chat/threads/:id. Titel werden auf das gemeinsame Limit von 120 Zeichen normalisiert, und die Thread-Liste wird vom Offline-Lesecache abgedeckt.


## Gestreamte Antworten

Antworten streamen über POST /api/chat/stream per expo/fetch; serverseitige Frames werden zu chunk-, done- oder error-Ereignissen, fehlerhafte Frames werden übersprungen. Die Modell-Aliase lauten fast, smart und cheap — fast ist der Standard —, ein structuredOutput-Flag reicht die passende Anforderung weiter, und die Stopp-Schaltfläche bricht die laufende Anfrage ab.


## Einmalige Agent-Runs

Der versteckte Assistant-Bildschirm postet {alias, prompt, workspaceId, maxSteps: 4} an /api/v1/agent-runs — ein einzelner budgetierter Run im aktiven Arbeitsbereich. Der Client validiert die Antwort strikt und lehnt einen Run ab, der einem anderen Arbeitsbereich zugeordnet ist. Rate-Limits, Anmeldung, fehlende Berechtigung und forbidden-Antworten werden je auf einen eigenen Zustand abgebildet, und die Run-Historie hält die letzten 10 im Sitzungsspeicher mit Microunit-genauer Kostenformatierung.


## Überprüfung und Fehlerbehebung

Testen Sie einen abgebrochenen Stream, eine mitten im Run widerrufene Sitzung, einen berechtigten und einen gesperrten Arbeitsbereich sowie das Verhalten der gecachten Thread-Liste im Flugmodus. Ein vom Server verweigerter Run muss als nicht verfügbare Arbeit erscheinen — nie als stille leere Antwort.


## Weiter

[Mitteilungen und Push](https://supastack.dev/de/docs/mobile/notifications.md)