共用方式為

在 Microsoft Visual Studio Code 中複製你的 Microsoft Copilot Studio agent

當你使用擴充功能從 Microsoft Copilot Studio 複製代理時，你會從 Copilot Studio 下載代理定義及相關元件定義到你的本機。 你可以使用 Microsoft Visual Studio Code 編輯這些檔案。 複製操作會建立一個包含所有代理檔案的本地工作空間，並以結構化目錄格式呈現。

先決條件

在開始克隆試劑之前，有一些重要的前提條件和考量。

選擇工作地點

為你的代理檔案選擇適當的本地資料夾。 這個位置是擴充功能儲存代理檔案的地方。 以下是選擇地點的一些重要建議：

  • 確保磁碟空間充足。 典型的代理程式大小會取決於元件的數量。
  • 雖然系統支援空格，但請盡可能使用不含空格的路徑。
  • 考慮使用已經被 Git 追蹤的位置。

了解哪些東西會被複製

當你克隆代理時，代理檔會在你選擇的位置本地克隆，並建立類似 Visual Studio Code Explorer 的結構定義：

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

複製方法

如果你是第一次使用這個擴充功能，或是第一次接觸 Visual Studio Code，最簡單的複製代理程式是在開啟 Extension 視窗時，選擇 Clone Agent。 不過，當你已經複製並本地開啟了代理程式時，這個選項就無法使用。 以下方法可作為替代：

這是複製代理人最直接且推薦的方法。

  1. 在活動欄中選擇 Copilot Studio 圖示，開啟 Copilot Studio 擴充功能。 你也可以按 Ctrl+Shift+P 輸入「Copilot Studio： Focus on Agents View」。側邊欄會開啟 Copilot Studio 視窗。

  2. 在 代理選 區中，從下拉選單（例如「環境 1」）選擇你的目標環境，即可查看環境中代理的清單。

    > Environment 1
  Environment 2
  Environment 3

  3. 從清單中選擇要複製的代理。 Agent 會顯示其最後修改日期。 按右鍵點擊代理名稱，然後選擇複製代理。

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    檔案選擇器對話框會開啟。

  4. 在檔案選擇器對話框中導向你想要的位置，或建立新資料夾並選擇 「選擇資料夾」。 複製過程開始了。

  5. 等待複製過程完成。 會出現進度通知，顯示「複製代理：客戶支援機器人」，接著是成功訊息「代理成功複製」。這個過程通常需要10到30秒。

  6. 確認複製成功完成。 agent 資料夾會在 Visual Studio Code 檔案總管中開啟，原始碼控制面板顯示一個乾淨的工作樹狀結構，檔案視窗則顯示你資料夾的名稱。

方法三：使用指令選擇器複製

如果你偏好以鍵盤為主的工作流程，可以試試這個方法。

  1. 按 Ctrl+Shift+P 開啟指令面板。

  2. 輸入「Copilot Studio： Clone Agent」並按 Enter。 指令執行後，提示音出現。

  3. 依照指示選擇環境、代理、選擇目的地資料夾，等待複製完成。 探員會被複製到你選定的位置。

方法三：使用代理 URL 克隆

當有人與你分享代理網址時，此方法非常有用。

  1. 在 Copilot Studio 網站平台開啟您的代理。

  2. 選擇 設定>中的代理詳情，並複製代理的網址。 網址格式應為： https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}。 網址現在已經在你的剪貼板裡了。

  3. 返回 Visual Studio Code 並開啟 Copilot Studio 擴充功能。

  4. 選擇 克隆代理。 擴充功能會偵測到剪貼簿中的 URL，並顯示標記為「（從剪貼簿）」的代理程式。

  5. 選擇標示為「（從剪貼簿）」的代理程式，選擇目標資料夾，等待複製完成。 探員會被複製到你選定的位置。

常見的複製情境

以下是幾個常見情境，說明複製代理人的有用性，並附上建議工作流程的高層次細節。

情境一：單人開發的克隆

目標： 自己找經紀人

  1. 把代理克隆到本地資料夾。

  2. 從導覽中的 Source Control 初始化 Git 儲存庫。

  3. 在本機進行變更。

  4. 進行您的認可。

  5. 準備好後，將這些變更套用到 Copilot Studio。

情境二：用於團隊協作的克隆

目標： 多位開發者同時使用同一個代理程式

  1. 第一個開發者複製了代理人。

  2. 第一位開發者會初始化 Git 並將內容推送到共享倉庫（GitHub、Azure DevOps）。

  3. 其他開發者則是從共享的 Git 倉庫複製。

  4. 每位開發者執行 Copilot Studio： Reattach Agent 來將本地資料夾連結到 Copilot Studio。

  5. 團隊使用 Git 進行協作與變更追蹤，並使用 Visual Studio Code 擴充功能來處理代理程式。

  6. 每位開發者接著會根據軟體生命週期或自動化流程，將變更套用到 Copilot Studio 進行測試，或推送至其他下游環境。

情境三：複製多個環境

目標： 管理開發、測試及生產版本

建議在多個環境中部署時，使用解決方案。 考慮一個自動化部署流程，組織流程可稽核且可擴展，例如管線。 對於選擇不使用解決方案的使用者，Copilot Studio 擴充功能提供將 Copilot Studio agent 定義從本地機器同步到其他環境的功能。 你仍應考慮將技術資產遷移到下游環境的組織流程，以便在軟體開發生命週期中提供審計、遙測及其他關鍵元件，並在向客戶和最終用戶出貨軟體時提供服務。

  1. 將開發環境中的代理程式複製到本地的開發資料夾。

  2. 在開發資料夾裡做修改。

  3. 套用這些變更，並在相同環境中測試。

  4. 使用 Copilot Studio： Reattach Agent 將代理連接到替代環境。

  5. 在 Copilot Studio 測試窗格中測試 Agent。

最佳做法

執行

  • 將所有特工複製到一致的位置。
  • 複製後立即初始化 Git。
  • 使用有意義的資料夾名稱。
  • 在做更改前先確認複製品是否正常運作。
  • 請將你的複製位置備份（例如 GitHub 或 Azure DevOps）。
  • 在團隊內部的維基或文件中記錄你的複製人位置。

不要

  • 不要複製到臨時目錄。
  • 不要多次複製到不同地點。 這樣做可能會造成混淆。

後續步驟

在你複製你的代理人之後：

  • Last updated on