AI 診断と Autopilot

エージェントが停滞している原因を突き止め、シートをバックアップに切り替え、タスクの途中でクラッシュしたり接続が切れたりしたエージェントを Autopilot に再開させます。

エージェントが動かなくなるパターンは2つあります。ひとつは、生きているのに停滞するケースです。クォータの壁、サインインプロンプト、アップセールのモーダルが画面に出ていて、あなたのメッセージが届きません。もうひとつは、完全に停止するケースです。接続が切れるか、CLI がタスクの途中で終了します。AI Diagnosis(AI 診断)は前者を、Autopilot は後者を処理します。どちらも同じ場所にあります。

トップバーから Orchestration Dashboard を開くか、コマンドパレットで Open Orchestration Dashboard を実行し、Advanced → AI Diagnosis を選びます。Tutorials → How-to → Autopilot から直接ジャンプすることもできます。

Diagnose & restore stuck agents が On、With AI が選択された AI Diagnosis 設定。チェッカーエージェントの順序リスト(claude-opus-5 の Claude と gpt-5.6-sol の Codex)にはそれぞれ専用のモデルピッカーが付いている

Diagnose & restore stuck agents(停滞エージェントの診断と復旧)

エージェントのターミナルへの配信が約2分間失敗し続けると、インストール済みの AI CLI がそのターミナルの画面テキストを読み取り、何が起きているかを報告します。配信は15秒ごとに再試行され、8回目の失敗で診断がトリガーされます。そのターミナルがバックアップエージェント付きのチャートシートにいる場合、シートは自動で切り替わります。それ以外のターミナルでは、診断結果が通知として届くので対処できます。正常なターミナルがチェックされることはありません。

Diagnose & restore stuck agents はデフォルトでオンになっており、すべてのチーム、チャート、リンクされたターミナルにアプリ全体で適用されます。How to restore で次のいずれかを選びます。

  • With AI (recommended):チェッカー AI がまず停滞したターミナルの画面を読み取り、クォータまたはサインインの壁が確認された場合のみ復旧が実行されます。単に処理中のエージェントを邪魔することはありません。
  • Manual timer — no AI:タイムアウトだけで復旧します。こちらは速く、完全にローカルで動作しますが、長いタスクに取り組んでいるエージェントと、本当に詰まったエージェントを区別できません。

チェッカーエージェント(順番どおり)

チェッカーは1つずつ順に試行されます。チェッカーがインストールされていない、自身の上限に達した、タイムアウトした場合は、次のチェッカーに引き継がれます。停滞したターミナル自身のプロバイダーは常にスキップされるため、エージェントが自分自身を判定することはありません。Claude、Codex、Gemini、OpenCode、Qwen、Kimi、Grok、Hermes がすべてチェッカーになれ、同時に最大4つまで設定できます。+ Add checker で追加し、矢印で並べ替え、Remove で削除してリストを整えます。何も選ばなかった場合は、その順序で最初にインストールされている CLI が使われます。

各チェッカーには専用のモデルがあります(v1.75.0 以降)。エージェントの横にあるドロップダウンからモデルを選ぶか、Default model のままにして CLI のデフォルトを使います。

チェッカーはヘッドレスで、制限付き権限、中立のディレクトリで実行されます。画面を分類して1行の JSON で回答し、あなたのプロジェクトには一切触れません。画面テキストがチェッカーに送信されるのは、一度だけ求められる画面読み取りへの同意を行った後だけです。

Autopilot (failed tasks)

Autopilot は、タスクの途中で停止したり接続が切れたりしたエージェントを再起動します。エージェントのセッションを再開するか、タスクをシートのバックアップに切り替えます。質問に答えることはなく、ピッカーに入力することもありません。デフォルトではオフです。 Autopilot (failed tasks) カードを On に切り替えます。オンにすると、AI Diagnosis が使う画面読み取りへの同意も同時に付与されます。

Agent Orchestration → AI Diagnosis にある Autopilot (failed tasks) カード。On で Watching の状態。Resume the session、Switch to backup、Wait for you のタイルの下に、再開されたエージェントの Recent decisions リストがある

オンにすると、カードには Watching. Acts only when a running task goes quiet, its process exits, or a message to it stalls. Idle tabs are never checked. と表示されます。How it works を押すと、アニメーションによる解説が見られます。

作動する条件

Autopilot が監視するのは、あなたが送ったプロンプトに取り組んでいるターミナルだけです。トリガーは3つあります。

トリガー条件
The process exitsプロンプトが未完のまま CLI がエラーで終了する。/exit や Ctrl-D で意図的に終了した場合はクリーン終了として扱われ、そのまま放置されます。
The task goes quiet実行中のタスクが出力を停止し、チェッカーが画面を読み取って本当に停滞していることを確認する。
A message stalls配信が失敗し続け、AI Diagnosis が接続切断を報告する。

動作内容

  • Resume the session. Autopilot はその CLI 固有の再開コマンドで同じターミナル内のエージェントを再起動するため、同じセッションとトランスクリプトが戻ります。Claude Code、Codex、Gemini、Cursor、OpenCode、Grok、Kimi、Qwen、Amp、Cline、Hermes、Antigravity、Qoder で動作します。
  • Ask it to continue. After a resume, ask the agent to continue がオン(デフォルト)の場合、再開されたエージェントには1つの指示が渡されます。中断したところから続けること、完了済みのステップをやり直さないこと、中断されたステップを繰り返す前にその結果を確認すること。
  • Switch to backup. 致命的なエラーや再開可能なセッションがないなどでタブが再開できない場合、バックアップエージェント付きのチャートシートがブリーフとともにタスクを引き継ぎます。元のタブは開いたまま残ります。
  • Wait for you. 質問、ピッカー、入力途中のドラフト、サインインの壁が画面にある場合や、その他判断がつかない場合は、何も入力されません。質問、ピッカー、ドラフトはそのまま放置されます。サインインの壁や不明な画面の場合は通知が届きます。

リトライ上限

Autopilot は最初の再起動まで5秒待ちます。同じプロンプトが再び失敗した場合、2回目の再起動まで20秒、3回目まで60秒待ちます。その後は停止し、Stopped retrying "…" after 3 resumes; waiting on you. と書かれた Activity カードで呼び出します。あなたからの新しいプロンプトでカウントはリセットされます。どのターミナルも1時間に6回を超えて再起動されることはありません。

Recent decisions

Recent decisions にはこのマシンでの直近5件のアクションが表示されます。各行には時刻、プロンプト、プロジェクト、理由がバッジ付きで示されます。ResumedSwitched to backupCouldn't resumeContinuedStopped retryingWaiting on you。Activity カードには Autopilot チップが付きます。完全な台帳は追記専用で、~/.1devtool/orchestration/autopilot-ledger.jsonl に書き込まれます。

Pause または Off

  • Pause は、解除するまで Autopilot による再開と切り替えを停止します。Diagnose & restore stuck agents によるバックアップ切り替えは引き続き動作します。
  • Off は Autopilot を停止し、一時停止状態も解除します。

設定を変えずに特定の起動だけ Autopilot をオフにするには、ONEDEVTOOL_AUTOPILOT=off を付けて 1DevTool を起動します。カードには Off for this launch. と表示されます。

関連