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をダウンロードして、エージェント専用のリモートセッションを用意しましょう。