バックグラウンドジョブ
バックグラウンドジョブでは、Anyyが大きな作業を受理して安定したジョブハンドルを即座に返し、親の会話を使う間も子セッションで作業を続けます。
バックグラウンド作業を始める
意図を明示します。
Run this as a background job: review the uploaded reports, compare their recommendations, and notify me when the comparison is ready.
Anyyは、長時間／バックグラウンド作業や完了通知を明示的に依頼された場合だけバックグラウンドモードを使います。「ダウンロード」「Webサイト」「調査」などの単語だけからは推測しません。
受理の応答には、バックグラウンドジョブID、サブエージェント実行ID、子セッションIDが含まれます。特定の実行を確認・キャンセルする必要がある場合は応答を保存します。これらの識別子の用途は異なります。
その後の流れ
- Anyyがタスクと現在許可されたツールポリシーで子セッションを作成します。
- 常駐ランタイムが
agentバックグラウンドジョブを記録します。 - 親のターンは子の完了を待たずに返ります。
- 完了または失敗が親セッションの受信箱へ書き戻されます。
- Dashboardまたは対応する元チャンネルに最終通知が表示されます。
バックグラウンド作業は同じProfile内に留まり、フォアグラウンドの会話が先へ進んでも継続します。通常のサブエージェントは、再帰的に別のバックグラウンドジョブを開始できません。
バックグラウンドセッションを見る
Dashboard → Chatでは通常の会話とバックグラウンドセッションを分けています。Background一覧を開いて子の会話とツール操作を確認します。完了通知には、利用可能な場合、ジョブ種別、状態、ジョブIDが表示されます。
親の会話でも尋ねられます。
List my background jobs and tell me which are still running.
キャンセルと確認
親の会話に戻って依頼します。
Show the status and latest history of background job JOB_ID.
Cancel background job JOB_ID and confirm its final status.
Anyyは最初に親の子実行を一覧表示して、バックグラウンドジョブIDを解決します。サブエージェントの履歴／キャンセルツールは、バックグラウンドジョブIDではなくサブエージェント実行IDを受け取り、別の親に属する実行を拒否します。履歴には上限があります。詳しくはDashboardで子セッションを開きます。
AnyyはバックグラウンドのプロセスジョブとCron配信ブリッジ記録も追跡します。プロセスのlog／wait／killはプロセスジョブ用で、Agentの子やCron記録には使えません。操作を選ぶ前にジョブ種別を識別するようAnyyに依頼します。
キャンセルはベストエフォートです。外部サービスが受理済みのリモート操作は取り消せない場合があります。副作用が元に戻ったと仮定せず、最終状態を確認してください。
現在のターンで回答をまとめる必要がある場合は、調査の委任を依頼します。バックグラウンドジョブは後で終えられる永続的な作業向けです。
制限と費用
バックグラウンド作業は子モデルを実行し、許可ツールを呼び出せるため、フォアグラウンドチャットとは独立してトークン、ツール利用枠、時間、外部サービス費用を消費します。必要ならRole、Workspace、モデル、ラベル、タイムアウトを指定できます。既定では、親1つにつき受理済み／実行中の子が最大3件、深さは1段です。子のツールポリシーは親より制限され、メモリ書き込み、追加エージェント／自動化の作成、メッセージング、認証情報アクセスなどは無効です。完了配信はランタイムが担当します。
トラブルシューティング
| 症状 | 確認する項目 |
|---|---|
| フォアグラウンドで作業する | 「バックグラウンドジョブ」と明示し、完了通知を依頼 |
| 最終通知が届かない | Dashboard → Chat → Backgroundで子セッションを確認 |
| Agentの子がユーザー入力を必要とする | 子はエラー分類clarification_pendingで失敗する。セッションの質問を確認し、次の実行依頼に不足情報を渡す。成功完了ではない |
| 子がさらにバックグラウンド作業を始められない | 再帰的バックグラウンドジョブは意図的に無効 |
| 想定より費用が高い | 子のモデル、タイムアウト、ツール呼び出し、同時ジョブ数を確認 |