共用方式為

安裝 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 市集找不到擴充功能

Problem： 搜尋時找不到 Copilot Studio 擴充功能。

Solution:

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

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

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

解除安裝擴充功能

要移除此擴充功能：

  1. 打開擴充功能視窗。

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

  3. 在清單的項目中，選擇管理 （齒輪圖示） >卸載。

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

備註

卸載擴充功能並不會刪除本地複製的代理檔。 你需要手動移除這些檔案。

後續步驟

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

  • Last updated on