rdp-cli

AI Agent のリモートデスクトップを見守り、一時停止して操作を引き継ぐ

対象バージョン・環境: 0.1.2 · Windows / macOS · RDP / VNC

既存のセッションを開く

Mac ではメニューバーのアイコン、Windows では通知領域から、名前やアドレスで実行中のセッションを選びます。以下はネイティブウィンドウとブラウザーを開くそれぞれのコマンドです。ブラウザーは LAN または VPN 内でアクセス許可を設定して利用します。公開サイト rdp-cli.com がリモートビューアーになるわけではありません。

Windows PowerShell では実行ファイルのフォルダーに移動し、以下のコマンドの rdp-cli を .\rdp-cli.exe に置き換えてください。

rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web

操作権を取らずに見守る

ビューアーは閲覧専用で始まります。クリック位置、ドラッグ経路、スクロール、入力の進行状況で Agent の操作を確認できます。入力ヒントに文字そのものは表示しませんが、リモートアプリの画面には見える場合があります。ヒントは画面の自動マスキングではありません。ネイティブの FX/F8、ブラウザーの Actions でビューアーごとに無効化できます。複数のビューアーで同時に閲覧できます。

一時停止して修正する

PAUSE は通常の入力を止めます。TAKE でマウスとキーボードの操作を引き継ぎます。操作権を持てるビューアーは一つで、その間 Agent の入力は拒否されます。例えばエディターの一行を修正して確認できます。ログイン画面、「ようこそ」、処理中の画面でも入力を試すことはでき、反応するかどうかはアプリ次第です。RDP のマイクは操作権を持つ間に明示的に有効化し、システムの許可を与えます。VNC はマイクに対応していません。

操作を返す

RELEASE で操作権を返すとマイクも停止します。利用可能な Agent の識別情報があれば制御を返し、なければ一時停止のままです。Agent は新しいスクリーンショットと観測値を取得し、修正内容を確認してから続けます。人が済ませた操作を重複実行しないようにしてください。

ウィンドウを閉じたときの動作

閲覧専用ビューアーを閉じても接続は維持されます。操作権を持つビューアーが閉じられたり切断されたりすると、セッションは一時停止します。再接続後も、新しい観測と一時停止状態への対処が必要です。権限と RDP/VNC の違いは機能紹介で確認できます。

関連記事

rdp-cli の拡張コマンド

まず rdp-cli --version を実行してください。以下のコマンドには agent_execution.contract_version が 1 のビルドが必要です。旧版では、前述の単一操作の手順を引き続き使用できます。

大文字のプレースホルダーは実際の返り値に置き換えます。Windows PowerShell では実行ファイルのフォルダーで .\rdp-cli.exe を使い、macOS・Linux ではインストール済みコマンドか実際の実行ファイルのパスを使います。

複数のエージェントと人で引き継ぐ

登録済みエージェント間で操作権を明示的に移します。人は GUI や Web から引き継ぎ、指定したエージェントに返せます。返された側は画面を確認して再開します。

登録するとエージェント ID と認証情報への参照が返ります。セッション所有者がアクセスを許可し、エージェントは返された claim 参照を使って明示的にリースを更新します。人が引き継ぐと古い観察情報は無効になるため、返却後に画面を再確認してください。

rdp-cli agents register --name Writer
rdp-cli agents grant --session SESSION --id AGENT_ID --permission read --permission control
rdp-cli control claim --session SESSION --agent-id AGENT_ID --agent-ref AGENT_REF
rdp-cli control renew --session SESSION --agent-id AGENT_ID --agent-ref AGENT_REF --claim-ref CLAIM_REF

自分のリモートデスクトップで始める

rdp-cli をダウンロード · 利用する環境のクイックスタートへ