For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/modules/ai.md (or send Accept: text/markdown).

AI 与后台任务

从授权请求到持久结果。

询问本指南

尝试假人工智能，然后选择真正的提供商

对于您的第一个结果，请遵循 Web 教程的 /dashboard 任务：启动本地流程、对提示进行排队、运行它并查看结果。 AI_PROVIDER=fake 返回可重复的演示响应，无需将数据发送到外部模型或使用付费的 API 密钥。

对于真实生成，首先配置持久帐户，选择 AI 提供商并遵循下面的 AI 配置。将型号及其价格添加到数据库目录中，为每个别名选择允许的型号，并授予工作区所需的访问权限。诸如 fast 之类的别名是向用户显示的友好选择；它本身不是外部提供商的型号 ID。

后台AI task也需要配置的作业服务。如果未显示模型选择，请在重试之前检查目录和别名策略。如果访问被拒绝，请检查活动工作区的权利。将所有提供者 API 密钥保留在 Web 服务器的配置中，而不是浏览器、移动应用程序或桌面窗口中。

【尝试免凭证AI演示】(/docs/web/ship-in-5-minutes)

跟随任务生命周期

生产任务 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 的工作流语义是显式的，包括持久执行行为。不要从通用契约推断重试或调度保证。

生产提交路径使用幂等与已保存任务恢复来处理模糊派发。生成完成与完成邮件投递是两件事。

如果你想继续完成设置，可以阅读《设置后台任务》。