> ## 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

# AI チャットとアシスタント

共有 API 上のストリーミングチャットスレッドとワンショットのエージェント実行。

## チャットスレッドは Web コントラクトを使う

チャットタブはブラウザーアプリと同じ REST サーフェスを呼び出します。一覧と作成は /api/chat/threads、読み取り・名前変更・削除は /api/chat/threads/:id です。タイトルは共通の 120 文字制限に正規化され、スレッド一覧はオフライン読み取りキャッシュの対象です。


## ストリーミング応答

応答は expo/fetch 経由の POST /api/chat/stream でストリーミングされます。サーバーからのフレームは chunk、done、error のいずれかのイベントになり、不正なフレームはスキップされます。モデルエイリアスは fast、smart、cheap で、デフォルトは fast です。structuredOutput フラグは対応する要件を転送し、停止コントロールは処理中のリクエストを中断します。


## ワンショットのエージェント実行

非表示の assistant 画面は {alias, prompt, workspaceId, maxSteps: 4} を /api/v1/agent-runs に送信します — アクティブなワークスペースでの予算付きの単一実行です。クライアントは応答を厳密に検証し、別のワークスペースに帰属する実行を拒否します。レート制限、サインイン、エンタイトルメント不足、forbidden の各応答はそれぞれ別の状態に対応付けられ、実行履歴は直近 10 件をセッションメモリに保持し、コストはマイクロユニット単位の正確さで整形されます。


## 検証とトラブルシューティング

キャンセルされたストリーム、実行中に失効したセッション、エンタイトルメントのあるワークスペースとロックされたワークスペース、キャッシュされたスレッド一覧での機内モードの動作をテストしてください。サーバーに拒否された実行は利用不可の作業として表示される必要があり、静かな空の応答になってはいけません。


## 次へ

[通知とプッシュ](https://supastack.dev/ja/docs/mobile/notifications.md)