rdp-cli

AIエージェントのエラー復旧:セッションを直し、タスク全体をやり直さない

AIエージェントのエラー復旧は、最初からやり直すのではなく現在のリモート画面から始めます。タスク全体を再実行すると、完了済みの処理を繰り返したり、データを二重送信したり、エラーの証拠を失ったりします。

rdp-cliを使えば、RDP、VNC、X11、Androidの既存セッションを一時停止し、画面を確認して問題を修正したうえで、新しい画面からエージェントを再開できます。

エージェントがエラーになったら?

まずエージェントの入力を一時停止します。同じセッションを読み取り専用で開き、画面を確認し、人が操作を引き継ぎ、必要最小限の修正を行ってから制御を戻します。次の操作の前には、新しいスクリーンショットと観測結果が必要です。

すぐに再起動してはいけない理由

再起動すると、フォームの二重送信、重複レコード、通知や決済の再実行、エラーダイアログの消失、調査用スクリーンショットの喪失が起きる可能性があります。「保存」を押した後に固まって見えても、処理中かもしれません。まず現在のセッションを確認してください。

再起動と復旧の違い

項目 エージェントを再起動 同じセッションを復旧
アプリの状態 再構築または再実行 現在の状態を保持
完了済みの操作 再実行される可能性 そのまま確認可能
エラーの証拠 失われる可能性 画面に残る
二重送信のリスク 高い 低い

接続や認証情報が壊れた場合、またはアプリが復旧不能な場合だけ再起動します。

AIエージェントのエラー復旧

画面の不一致を検出 → 入力を停止 → 同じセッションを確認 → 人が操作を引き継ぐ → 1つだけ修正 → 制御を戻す → エージェントを再開 → 新しい画面を取得 → 続行または停止。

1. 入力を一時停止

rdp-cli pause --session SESSION を使って追加の入力を止めます。タイムアウトだけでは入力が送信されなかったとは言えません。不確かな操作を盲目的に再試行しないでください。

現在の構文は rdp-cli コマンドドキュメントで確認できます。

2. セッションを確認

rdp-cli watch --session SESSION --viewer web で同じセッションを開きます。アクティブなウィンドウ、ダイアログ、キーボードフォーカス、進捗表示、前回の操作結果を読み取り専用で確認します。

3. 操作を引き継いで修正

画面を確認してから rdp-cli control take --session SESSION --viewer-id VIEWER を実行します。ダイアログを閉じる、正しいフィールドを選ぶ、ウィンドウを戻す、想定内の確認を承認するなど、最小限の修正だけを行います。

4. 制御を戻して再観測

rdp-cli control release --session SESSION --viewer-id VIEWER の後に rdp-cli resume --session SESSION を実行し、新しい画面を取得します。人の操作で状態が変わるため、古い観測結果は使えません。

詳しくは同じリモートセッションを見守り、操作を引き継ぐをご覧ください。

人が確認または操作を引き継ぐタイミング

削除、決済、外部メッセージ、セキュリティ確認、未知のエラーが発生した場合は人が確認します。承認は危険な操作の前、エラー復旧は予期しない状態の後に行います。詳しい AIエージェント承認ワークフローは人間参加型のガイドをご覧ください。

安全な操作のチェックリスト

  • 認証済みの隔離されたリモートセッションを使う
  • 必要最小限の権限だけを付与する
  • 引き継ぐ前に入力を停止する
  • 操作前に画面を確認する
  • 不確かな操作が完了したか確認する
  • スクリーンショットを保存する
  • 一度に1つだけ修正する
  • 引き継ぎ後に新しい画面を取得する
  • 重要な結果を確認する
  • 状態を確認できなければ停止する

rdp-cliはリモートセッションと制御を提供しますが、すべてのエラーの復旧を保証するものではありません。

rdp-cliが代替しないもの

rdp-cliはAIモデル、タスク計画、業務承認、重複検出、クラウドコンピューター作成、アプリケーションテストを提供しません。リモートデバイスは事前に存在し、認証されている必要があります。

セットアップは rdp-cli クイックスタートをご覧ください。

FAQ

動かなくなったAIエージェントを復旧するには?

セッションを一時停止し、読み取り専用で画面を確認し、人が操作を引き継いで最小限の修正を行い、再開します。

エラー後に再起動すべきですか?

通常は不要です。まず既存セッションを確認し、復旧不能な場合だけ再起動します。

rdp-cliは失敗した操作を自動で再試行しますか?

いいえ。再試行の判断はエージェントまたはオーケストレーターが行います。

人の修正後もエージェントは続行できますか?

はい。制御を戻した後、新しい画面と観測結果を取得してから続行します。

復旧中もローカルPCを使えますか?

はい。rdp-cliはリモートセッションを操作するため、ローカルのマウスやキーボードは使用できます。

まとめ

AIエージェントが失敗しても、最初からやり直す必要はありません。セッションを残し、入力を止め、画面を確認し、1つだけ修正して新しい観測結果で再開してください。

rdp-cliをダウンロードして、エージェント専用のリモートセッションを用意しましょう。

Related Reading