安裝 Microsoft Visual Studio Code 的 Microsoft Copilot Studio 擴充功能

先決條件

在安裝 Microsoft Copilot Studio 擴充功能（針對 Microsoft Visual Studio Code）之前，請確保您符合以下要求：

系統需求

• 作業系統：
  • Windows（x64 架構）
    • Windows 10 版本 1809 或更新版本
    • Windows 11（任何版本）
  • macOS
• Visual Studio Code： 版本 1.80 或更新（建議使用最新穩定版）
• 網路連線： 安裝與認證的必要條件

帳戶要求

• Microsoft 帳號： 啟用 Microsoft 帳號，擁有 Copilot Studio 授權或存取權
• Copilot Studio 授權： 已為你的帳號分配適當的授權
• 環境存取：擁有存取至少一個 Copilot Studio 環境的權限
• Agent 權限：對您計劃編輯的任何 Agent 具有讀取和寫入存取權

安裝步驟

你可以用兩種方式在 Visual Studio Code 中安裝 Copilot Studio 擴充功能：

• 從 Visual Studio Code 中安裝
• 從 Visual Studio Code 市集網站安裝

方法一：從 Visual Studio Code 安裝

1. 在活動欄中選擇 擴充功能 圖示或按下 Ctrl+Shift+X。 Extensions 視窗在 Visual Studio Code 開啟。

2. 在搜尋欄輸入「Copilot Studio」。在結果列表中尋找官方的 Copilot Studio 擴充功能。 確認出版商是「Microsoft」。

3. 找到正確的擴充功能後，選擇它以開啟擴充功能詳情頁面。

4. 選擇 安裝 開始安裝。

5. 等待安裝完成。 你可能會看到重載 Visual Studio Code 的提示，這時在提示時選擇 Reload。

6. 確認安裝狀況。 在活動欄中尋找 Copilot Studio 的圖示。 該圖示以 Copilot Studio 品牌出現。

方法二：從 Visual Studio Code 市集網站安裝

1. 請前往 https://marketplace.visualstudio.com/，搜尋「Copilot Studio」。你也可以使用直接連結：https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio。

2. 在市集頁面選擇 安裝 。 瀏覽器提示可能會先要求你下載 Visual Studio Code，然後才會要求你開啟 Visual Studio Code。

3. 允許瀏覽器開啟 Visual Studio Code，並透過活動列中的擴充功能圖示確認安裝。

初始設定

首次發射

1. 在活動欄中選擇 Copilot Studio 圖示。 擴充功能會以應用程式窗格的形式開啟。 跳出通知，表示 Copilot Studio 擴充功能需要你登入。

2. 在跳出視窗中選擇 「登入 」，然後選擇 「允許」。 你的預設瀏覽器會打開一個 Microsoft 認證頁面。

3. 輸入你的認證憑證，必要時完成多重驗證。

4. 請檢視所申請的權限：

   • 閱讀並撰寫 Copilot Studio 代理程式
   • 存取環境資訊
   • 將檔案同步到雲端

   選擇 接受 或 允許。 瀏覽器會提示你可以關閉視窗並返回 Visual Studio Code。

5. 返回 Visual Studio Code。 擴充面板會載入你能存取的環境，以及這些環境中的代理程式。

確認設定成功

認證後，你會在 Visual Studio Code 的 Copilot Studio 擴充功能中看到一個結構，位於 Agents 窗格下。 你會看到一份環境群組清單，包含巢狀環境和代理，結構類似以下：

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

解決安裝故障

以下的故障排除步驟將解決安裝或設定 Copilot Studio Visual Studio Code 擴充功能時可能出現的一些問題。

擴充功能未顯示

Problem： Copilot Studio 圖示不會出現在活動欄中。

Solution:

1. 重新載入 Visual Studio Code。
2. 選擇 擴充功能 ，並在 已安裝 清單中尋找該擴充功能。 確保擴充功能沒有被停用。
3. 將 Visual Studio Code 更新到最新版本。
4. 重新安裝擴充功能。

認證失敗

問題： 認證會失敗或反覆循環。

Solution:

1. 清除 microsoft.com 的瀏覽器快取和 Cookie。

2. 試著用不同的瀏覽器登入。 暫時將此瀏覽器設為預設。

3. 關閉可能阻擋驗證的瀏覽器擴充功能。

4. 檢查企業防火牆和代理設定。

5. 確保你使用的是支援的帳號類型。

Visual Studio Code 市集找不到擴充功能

問題：你搜尋時找不到 Copilot Studio 擴充功能。

Solution:

1. 請確保你是在擴充 功能 欄目搜尋，而不是網頁搜尋。

2. 檢查拼寫：「Copilot Studio」。

3. 聯絡你的管理員，看看你的組織是否限制 Visual Studio Code 市集的存取權限。

解除安裝擴充功能

若要移除此擴充功能：

1. 打開擴充功能視窗。

2. 在已安裝的擴充功能中找到 Copilot Studio。

3. 在清單中的項目中，選擇 管理 圖示，然後選擇 卸載。

4. 提示時重新載入 Visual Studio Code。

下一步

安裝擴充功能並使用 Copilot Studio 驗證後，你就可以：

• 複製您的第一個 Agent
• 了解編輯代理元件