> ## 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 標誌會轉發對應要求，停止按鈕會中止進行中的請求。


## 一次性代理執行

隱藏的助手介面向 /api/v1/agent-runs 提交 {alias, prompt, workspaceId, maxSteps: 4} —— 在當前工作區中執行一次有預算上限的任務。客戶端嚴格校驗響應，並拒絕歸屬於其他工作區的執行。速率限制、未登入、缺少權益與 forbidden 應答各自對映為不同狀態；執行歷史在會話記憶體中保留最近十條，成本以微單位精度格式化。


## 驗證與排障

測試被取消的流、執行中途被吊銷的會話、有權益與被鎖定的工作區，以及飛航模式下快取執行緒列表的表現。被伺服器拒絕的執行必須呈現為不可用狀態，絕不應靜默地顯示空回覆。


## 下一篇

[通知與推送](https://supastack.dev/zh-tw/docs/mobile/notifications.md)