使用解決方案來匯出和匯入代理人

Note

本文描述由 標準線束驅動的代理或代理流程中使用的功能。

你可以用 解決方案匯出和匯入代理,讓你的代理能跨越多個 環境

首先,建立一個自訂解決方案,並將你的代理人加入其中。 接著,用你的代理匯出解決方案,再匯入到另一個環境。 您還可以使用代理升級或更新解決方案,並從受管理的代理移除非受控層。

欲了解更多關於Copilot Studio解決方案探索器的資訊,請參閱查看並管理Copilot Studio中的解決方案。

Note

匯出 Agent 時,您無法匯出主題等級或節點等級的留言

Prerequisites

須知事項

  • 您無法匯出受管理的解決方案。

  • 並未包含所有代理組件和屬性。

    • 包含 Agent 指示 (主要提示)。

      然而,若某些元件如自訂主題和知識來源被儲存為獨立資源或 Dataverse 表格,可能不會被包含,視其建立或連結方式而定。

    • 有些機器人屬性不會轉移,包括:

      匯入的代理可能缺少某些元素,例如代理圖示和通道細節是空的。

  • 從解決方案中移除 Agent 並不會移除其元件。 您必須另外移除這些元件。

    Warning

    不要直接從解決方案中移除未受管理的 Agent 元件 (例如 Agent 主題),除非您同時也將該 Agent 從解決方案中移除。

    你應該只在 Copilot Studio UI 的標準創作流程中對主題做修改。 直接從解決方案中移除或更改 Agent 的元件會導致匯出與匯入失敗。

  • 你無法匯出包含代理且其主題名稱中句點為 (.) 的解。

建立一個自訂解決方案,然後新增你的 Agent

  1. 要在 Copilot Studio 解決方案總管中建立新解決方案,請依照 在 Copilot Studio 中建立和管理解決方案 的步驟操作。

  2. 你建立的解決方案會自動開啟。 如果它未顯示,請在解決方案清單中選取它。

  3. 選擇加入現有,然後選擇代理,接著再次選擇代理

  4. 「新增現有代理人 」清單中,選擇你想匯出的代理人,然後選擇 新增

Note

對於傳統聊天機器人:

如果您使用技能,請選取從此解決方案移除來移除技能的環境變數目前值

顯示 [從此解決方案移除] 按鈕的螢幕截圖。

從解決方案中移除 Agent 並不會移除其元件。 您必須單獨移除元件。

將元件新增至自訂解決方案的 Agent 中

如果你在 Copilot Studio 的代理程式中新增元件,例如主題或流程,匯出前也必須先將它們加入非管理解決方案的代理。

  1. 在 Copilot Studio 中開啟解決方案總管

  2. 選擇包含您代理程式的方案。

  3. 物件窗格中,在 Agents 底下找出您的 Agent。

  4. 選擇三個點(),選擇 進階,然後選擇 新增所需物件

請檢視 Power Apps 文件中的說明與要求,以將現有元件新增至方案。

為你的解決方案加入自訂連接器

如果你的客服人員使用自訂連接器,請依照 「在解決方案中建立自訂連接器 」的步驟,並了解已知的限制。

Important

你必須先匯入自訂連接器,再匯入與代理解決方案的連線參考。

新增 Power Automate 流程

使用流程和環境變數時,請加入流程和環境變數所需的物件。

  1. 在 Copilot Studio 中開啟解決方案總管

  2. 選擇包含您代理程式的方案。

  3. 物件 面板中,找到你的工作流程。

  4. 選擇三個點(),選擇 進階,然後選擇 新增所需物件

新增環境變數

要加入環境變數,請依照以下步驟操作:

  1. 在 Copilot Studio 中開啟解決方案總管

  2. 選擇包含您代理程式的方案。

  3. 如果解決方案沒有環境變數,請選擇 新增現有變數,選擇 更多,然後選擇 環境變數

    1. 選擇所需的環境變數。

    2. 選擇 「下一步 」,然後選擇 「新增」。

  4. 如果解決方案已經包含所有環境變數,請選擇三個點(),選擇 進階,然後選擇 新增所需物件 ,以確保解決方案包含所有依賴性。

為託管解決方案自訂元件

要讓元件在受管理解決方案中可自訂,請參見 「檢視與編輯資料表管理屬性」。

在匯入託管解決方案前,請確保您的環境允許自訂。 確認你的環境沒有阻擋自訂化或非管理解決方案。 請了解更多在 Dataverse 中被封鎖的未管理自訂功能

匯出由您的Agent管理的解決方案

您可以通過將包含代理的解決方案從一個環境匯出到另一個環境,來進行匯出和匯入。

要用 Agent 匯出解決方案,請依照以下步驟操作:

  1. 在 Copilot Studio 中開啟解決方案總管

  2. 在未管理解決方案清單中,選擇包含您的 Agent 的解決方案。

  3. 選取匯出解決方案。 就像 Power Apps 匯出解決方案 的過程一樣,在匯出前 右側窗格會出現。

  4. 其他步驟和在 Power Apps 匯出解決方案時一樣。 要完成導出解決方案,請依照Power Apps文件中的指示與要求操作。

Important

如果您的代理有大量元件(例如超過 250 個主題或超過 100 個實體),請參閱 使用標準架構匯出

將具有代理程式的解決方案匯入

要將您的 Agent 中的解決方案匯入其他環境,請遵循以下步驟:

  1. 在目標環境中,開啟 Copilot Studio 的解決方案探索器。

  2. 選取匯入解決方案。 就像 Power Apps import solutions 體驗一樣,右側窗格會出現 Import a solution

  3. 其餘步驟與匯入 Power Apps 解決方案相同。 要完成導入解決方案,請依照Power Apps文件中的指示與要求操作。

如果匯入不成功,請選擇下載記錄檔案以下載包含導致匯入失敗的詳細資訊的 XML 檔案。 匯入失敗的最常見原因是解決方案不包含某些必要的元件。

  1. 在「方案總管」中,從清單中選擇匯入的新方案。

  2. 物件窗格中,選取 Agents。 然後選擇該代理人的名字,在 Copilot Studio 的新分頁中開啟該代理人。

  3. 再次為 Agent 設定使用者驗證

Important

  • 您必須先發佈您新匯入的 Agent,然後才能共用它。
  • 您的 Agent 圖示最多可能需要 24 小時才會顯示在各處。

在 Teams 中匯出和匯入代理資料

在 Microsoft Teams 中,你可以透過 Power Apps Teams 應用程式,在各個團隊之間匯出和匯入代理。

舉例來說,如果你從 Teams 團隊(Team A)匯出一個運作中的代理,然後匯入到 Team B,你就不需要從頭建立給 Team B。

請依照從 Dataverse for Teams 匯出自訂設定中的指示進行操作。

當選擇要匯出的自訂項目時,請選擇您要匯出的 Agent。 用側邊面板的篩選器只顯示特定團隊的經紀人。

Agent 將儲存到您電腦上的下載項目資料夾中。

要匯入 Teams,請依照將自訂資料匯入 Dataverse for Teams 的說明操作。

你的代理人會出現在 Teams 的 Copilot Studio 應用程式中,位於你匯入的團隊下。