遠端代理程式工作階段

Name: Visual Studio Code
Author: Microsoft

Agents 視窗讓您可以連線到遠端機器，以啟動代理程式工作階段或檢查現有的工作階段。您可以透過 SSH、開發通道連線，或直接從任何裝置的瀏覽器中使用 Agents 視窗。

當您想要利用遠端機器的資源、從行動裝置工作，或在離開主要開發機器時檢查代理程式的進度時，這非常有用。

Agents 視窗透過 SSH 或開發通道，使用 Agent 主機通訊協定 (AHP) 連線到遠端機器。當您連線時，Agents 視窗會自動在遠端機器上安裝並啟動 VS Code CLI。遠端機器必須已開機且透過網路可存取。

透過 SSH 連線

先決條件：遠端機器必須透過 SSH 可存取。遠端機器上不需要額外安裝代理程式。

若要透過 SSH 在遠端機器上啟動工作階段

選取新增或按下 ⌘N (Windows, Linux Ctrl+N) 以啟動新的代理程式工作階段。
在工作區下拉式選單中，選取遠端索引標籤，然後選取 SSH。如果您已經設定過 SSH 連線，它們將會顯示為下拉式選單中的選項。
輸入遠端機器的 SSH 連線字串 (例如 user@hostname)。
選取遠端機器上要用於工作階段的資料夾。
輸入提示詞並按下 Enter 以啟動工作階段。

透過開發通道連線

先決條件：遠端機器上必須已經正在執行開發通道。請參閱使用遠端通道進行開發以取得安裝指示。

若要透過開發通道在遠端機器上啟動工作階段

選取新增或按下 ⌘N (Windows, Linux Ctrl+N) 以啟動新的代理程式工作階段。
在工作區下拉式選單中，選取遠端索引標籤，然後選取通道並選擇您的帳戶類型。
從清單中選擇作用中的開發通道。
選取遠端機器上要用於工作階段的資料夾。
輸入提示詞並按下 Enter 以啟動工作階段。

重要

請確保您的開發通道需要驗證 (GitHub 或 Microsoft 帳戶)。如果通道允許匿名存取，任何發現 URL 的人都可以連線到您的機器並啟動代理程式工作階段。當自動核准模式啟用時，這尤其危險，因為未經授權的使用者可以使用您的認證觸發 AI 協助的命令執行。如需詳細資訊，請參閱安全性。

在瀏覽器中使用 Agents 視窗

Agents 視窗也以網頁用戶端的形式提供於 https://insiders.vscode.dev/agents，因此您可以從任何具有瀏覽器的裝置管理代理程式工作階段。當您離開主要的開發機器、從行動裝置工作，或想要在未在本機安裝 Visual Studio Code 的情況下檢查遠端主機上執行的工作階段時，這非常有用。

基於瀏覽器的 Agents 視窗透過開發通道連線到您的開發機器。代理程式工作階段會在遠端主機上執行，而瀏覽器則做為用於聊天、檢閱變更以及管理工作階段的輕量型用戶端。

設定開發通道

在瀏覽器中使用 Agents 視窗之前，請在您要連線的機器上啟動開發通道

在您的遠端主機上，執行下列命令以啟動開發通道
```
code-insiders tunnel
```
如果您使用的是穩定版本，請改為執行 code tunnel。

第一次執行此命令時，系統會提示您使用 GitHub 或 Microsoft 帳戶進行驗證。基於安全性考量，通道預設需要驗證。
通道執行後，請在任何裝置的瀏覽器中開啟 https://insiders.vscode.dev/agents。
出現提示時，使用繼續使用 GitHub 登入。如果您已經通過驗證，Agents 視窗將會直接載入。
您的通道主機會顯示在視窗頂端的主機列中。選取它以進行連線。
選擇遠端機器的資料夾，選取代理程式，然後啟動工作階段。

主機管理

基於瀏覽器的 Agents 視窗中的主機列會顯示您可用的通道主機。每個主機都會顯示其連線狀態

線上 (Online)：主機可連線，您可以在其上啟動或繼續工作階段。
離線 (Offline)：主機上的通道未執行。在主機上啟動通道以使其恢復線上。

您可以直接透過主機列連線至主機或中斷與主機的連線。如果在您有作用中工作階段時主機離線，該工作階段將會顯示已中斷連線的狀態。當主機恢復線上時，工作階段會自動重新連線。