> ## 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 與後臺任務

從授權請求到持久結果。

## 嘗試假人工智慧，然後選擇真正的提供商

對於您的第一個結果，請遵循 Web 教程的 /dashboard 任務：啟動本地流程、對提示進行排隊、執行它並檢視結果。 AI_PROVIDER=fake 返回可重複的演示響應，無需將資料傳送到外部模型或使用付費的 API 金鑰。

對於真實生成，首先配置持久帳戶，選擇 AI 提供商並遵循下面的 AI 配置。將型號及其價格新增到資料庫目錄中，為每個別名選擇允許的型號，並授予工作區所需的訪問許可權。諸如 fast 之類的別名是向用戶顯示的友好選擇；它本身不是外部提供商的型號 ID。

後臺AI task也需要配置的作業服務。如果未顯示模型選擇，請在重試之前檢查目錄和別名策略。如果訪問被拒絕，請檢查活動工作區的權利。將所有提供者 API 金鑰保留在 Web 伺服器的配置中，而不是瀏覽器、移動應用程式或桌面視窗中。

【嘗試免憑證AI演示】(/docs/web/ship-in-5-minutes)

[配置真實AI生成](https://supastack.dev/zh-tw/docs/modules/ai-configuration.md)

[新增允許的型號和價格](https://supastack.dev/zh-tw/docs/web/setup-ai.md)

[配置後臺任務執行](https://supastack.dev/zh-tw/docs/modules/jobs.md)


## 跟隨任務生命週期

生產任務 API 在持久化任務並派發 Trigger.dev 的 ai.generate 工作流之前，先驗證已認證的工作區與許可權。路由器應用能力要求與已配置的模型策略。

```
POST /api/ai/tasks
  → authenticated workspace + entitlement
  → durable task record
  → Trigger.dev ai.generate
  → model routing + generation
  → usage record + result
  → transactional completion delivery
```


## 配置別名與預算

使用者選擇已啟用的別名：cheap、fast 或 smart。服務端控制底層模型 ID、供應商憑證、工作區策略與預算執行。加密的自帶金鑰支援必須保持同樣的服務端邊界。


## 讓工作流語義保持顯式

JobRunner 只承諾 enqueue、status 與 cancel。Trigger.dev 的工作流語義是顯式的，包括持久執行行為。不要從通用契約推斷重試或排程保證。

生產提交路徑使用冪等與已儲存任務恢復來處理模糊派發。生成完成與完成郵件投遞是兩件事。


如果你想繼續完成設定，可以閱讀《[設定後臺任務](https://supastack.dev/zh-tw/docs/web/setup-jobs.md)》。


## 下一篇

[AI 供應商與模型策略](https://supastack.dev/zh-tw/docs/modules/ai-configuration.md)
