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 /ja/docs/modules/ai.md (or send Accept: text/markdown).

AI とバックグラウンドジョブ

認可されたリクエストから耐久性のある結果へ。

このガイドについて質問

偽の AI を試してから、本物のプロバイダーを選択してください

最初の結果については、Web チュートリアルの /dashboard タスクに従います。ローカルフローを開始し、プロンプトをキューに入れて実行し、結果を表示します。 AI_PROVIDER=fake は、外部モデルにデータを送信したり、有料の API キーを使用したりせずに、反復可能なデモンストレーション応答を返します。

実際の生成では、まず永続化アカウントを構成し、AI プロバイダーを選択して、以下の AI 構成に従います。モデルとその価格をデータベースカタログに追加し、各エイリアスに対して許可されるモデルを選択し、ワークスペースに必要なアクセスを付与します。 fast などのエイリアスは、ユーザーに表示されるわかりやすい選択肢です。それ自体は外部プロバイダーのモデル ID ではありません。

バックグラウンドの AI task にも、構成されたジョブサービスが必要です。モデルの選択肢が表示されない場合は、再試行する前にカタログとエイリアスのポリシーを調べてください。アクセスが拒否された場合は、アクティブなワークスペースの資格を調べてください。すべてのプロバイダー API キーを、ブラウザー、モバイルアプリ、またはデスクトップウィンドウではなく、Web サーバーの構成に保持します。

タスクライフサイクルを追う

本番タスク 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 のワークフロー意味論は明示的で、耐久性のある実行動作を含みます。汎用コントラクトからリトライやスケジューリング保証を推測しないでください。

本番送信経路は、あいまいなディスパッチを処理するために冪等性と保存済みタスク復旧を使います。生成完了は完了メール配信とは別です。