> ## 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 とバックグラウンドジョブ

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

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

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

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

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

[資格情報不要の AI デモを試す](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[リアルAI生成の設定](https://supastack.dev/ja/docs/modules/ai-configuration.md)

[許可されるモデルと価格を追加](https://supastack.dev/ja/docs/web/setup-ai.md)

[バックグラウンドタスク実行の設定](https://supastack.dev/ja/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/ja/docs/web/setup-jobs.md)をご覧ください。


## 次へ

[AI プロバイダーとモデルポリシー](https://supastack.dev/ja/docs/modules/ai-configuration.md)