リモートエージェントセッション

Name: Visual Studio Code
Author: Microsoft

Agents ウィンドウを使用すると、リモートマシンに接続してエージェントセッションを開始したり、既存のセッションを確認したりできます。SSH、dev tunnel経由で接続するか、任意のデバイスのブラウザーから直接 Agents ウィンドウを使用できます。

これは、リモートマシンのリソースを活用したい場合、モバイルデバイスから作業したい場合、またはメインの開発マシンから離れているときにエージェントの進捗状況を確認したい場合に便利です。

Agents ウィンドウは、SSHまたはdev tunnelを介して Agent Host Protocol (AHP) を使用してリモートマシンに接続します。接続すると、Agents ウィンドウは自動的にリモートマシン上で VS Code CLI をインストールして起動します。リモートマシンの電源がオンになっており、ネットワーク経由でアクセスできる必要があります。

SSH経由で接続する

前提条件: リモートマシンに SSH 経由でアクセスできる必要があります。リモートマシンに追加のエージェントをインストールする必要はありません。

SSH 経由でリモートマシン上でセッションを開始するには

[新規] (New) を選択するか、⌘N (Windows、Linux は Ctrl+N) を押して、新しいエージェントセッションを開始します。
ワークスペースのドロップダウンで [リモート] (Remote) タブを選択し、[SSH] を選択します。すでに SSH 接続を設定している場合は、ドロップダウンのオプションとして表示されます。
リモートマシンの SSH 接続文字列を入力します (例: user@hostname)。
セッションで使用するリモートマシンのフォルダを選択します。
プロンプトを入力し、Enter キーを押してセッションを開始します。

dev tunnel経由で接続する

前提条件: リモートマシン上で dev tunnel がすでに実行されています。セットアップ手順については、Developing with Remote Tunnels を参照してください。

dev tunnel 経由でリモートマシン上のセッションを開始するには

[新規] (New) を選択するか、⌘N (Windows、Linux は Ctrl+N) を押して、新しいエージェントセッションを開始します。
ワークスペースのドロップダウンで [リモート] (Remote) タブを選択し、[Tunnels] を選択して、アカウントの種類を選択します。
リストからアクティブな dev tunnel を選択します。
セッションで使用するリモートマシンのフォルダを選択します。
プロンプトを入力し、Enter キーを押してセッションを開始します。

重要

dev tunnel で認証 (GitHub または Microsoft アカウント) が必須になっていることを確認してください。トンネルが匿名アクセスを許可している場合、URLを発見した誰でもあなたのマシンにアクセスし、エージェントセッションを開始できるようになります。これは、自動承認モードが有効な場合に特に危険です。権限のないユーザーがあなたの資格情報を使用してAI支援によるコマンド実行をトリガーする可能性があるためです。詳細については、Security を参照してください。

ブラウザーで Agents ウィンドウを使用する

Agents ウィンドウは、ウェブクライアント (https://insiders.vscode.dev/agents) としても利用できるため、ブラウザーを備えた任意のデバイスからエージェントセッションを管理できます。これは、メインの開発マシンから離れているとき、モバイルデバイスから作業しているとき、あるいはローカルに Visual Studio Code をインストールせずにリモートホストで実行されているセッションを確認したい場合に便利です。

ブラウザーベースの Agents ウィンドウは、dev tunnel を介して開発マシンに接続します。エージェントセッションはリモートホスト上で実行され、ブラウザーはチャット、変更内容の確認、セッションの管理を行うための軽量なクライアントとして機能します。

dev tunnel をセットアップする

ブラウザーで Agents ウィンドウを使用する前に、接続先のマシンで dev tunnel を起動します

リモートホストで次のコマンドを実行して、dev tunnel を起動します
```
code-insiders tunnel
```
安定版リリースを使用している場合は、代わりに code tunnel を実行してください。

このコマンドを初めて実行するときは、GitHub または Microsoft アカウントでの認証を求められます。セキュリティのため、デフォルトでトンネルには認証が必要です。
トンネルが実行されたら、任意のデバイスのブラウザーで https://insiders.vscode.dev/agents を開きます。
プロンプトが表示されたら、[GitHub で続行] (Continue with GitHub) でサインインします。すでに認証されている場合は、Agents ウィンドウが直接読み込まれます。
ウィンドウの上部にあるホストバーにトンネルホストが表示されます。それを選択して接続します。
リモートマシンのフォルダを選択し、エージェントを選んで、セッションを開始します。

ホストの管理

ブラウザーベースの Agents ウィンドウのホストバーには、利用可能なトンネルホストが表示されます。各ホストには接続ステータスが表示されます

オンライン (Online): ホストに到達可能であり、そのホストでセッションを開始または継続できます。
オフライン (Offline): ホスト上のトンネルが実行されていません。ホスト上でトンネルを起動してオンラインに戻します。

ホストバーから直接、ホストへの接続と切断を行うことができます。アクティブなセッション中にホストがオフラインになると、セッションは切断状態を示します。ホストがオンラインに戻ると、セッションは自動的に再接続されます。