元件集合讓創作者能夠在多個代理間建立並共享可重複使用的元件。
使用集合時,您可以:
- 你可以 在 Copilot Studio 的側邊欄管理、搜尋並建立元件集合,無需開啟代理程式,讓共享的建構模組更容易被尋找和重複使用。
- 使用 一鍵導出和簡化導入。 Copilot Studio 將集合打包到版本化的託管解決方案中,並允許你直接從代理設定匯入,簡化 Maker 的使用體驗。
- 與隊友共享收藏 ,同時控制編輯訪問權限,實現安全協作並保護核心資產。
- 限制集合,使其 只能由其預期的代理程式 ( 主要代理程式) 使用,協助小組模組化大型或敏感的副手,而不會意外重複使用。
- 直接從「元件集合」工作區測試集合在不同代理程式中的行為方式,以加快疊代速度並確保結果一致。
- 收集和共用較新的連接器類型,包括子代理程式、模型內容通訊協定、連接器和流程。
- 移除或調整相依性以解耦資產,並支援跨團隊的獨立發行週期。
代理程式元件包括:
- topics
- 知識
- 工具
- 子代理程式
- 模型內容通訊協定
- connectors
- flows
- entities
若要編輯元件集合或將元件集合新增至代理程式,您必須是建立該集合的人員,或是具有系統自訂員或系統管理員角色的使用者。 一旦元件集合可供代理程式使用,所有代理程式作者都可以看到並使用該集合,但不能變更集合內的元件。 進一步了解設定環境中的使用者安全性。
建立元件集合
您可以直接從客服專員的 「設定」 頁面或「 元件集合 」頁面建立元件集合。 當您將元件從代理程式新增至集合時,元件會移至集合,且代理程式會參照集合內的元件。
您可以與環境中的其他代理程式共用集合,或匯出集合以匯入其他環境。
從代理程式建立元件集合
開啟包含您想要作為元件集合提供的元件的代理程式。
轉到設定,然後選擇元件集合。
如果您即將在環境中建立第一個元件集合,請選擇建立。 否則,選擇新建。
輸入元件集合的名稱和描述。
選取下一步。
選擇要新增到元件集合的元件。 您可以使用類別和搜尋欄位來縮小元件清單。 您可以在檢閱集合時連接子客服專員。
系統會自動選取任何元件相依性,並新增至集合。 只有 在您已設定元件集合的主要代理程式時,才能排除相依性。
主要代理程式是擁有集合中元件的代理程式。 如果您未設定主要代理程式,則元件集合由環境擁有,因此必須具有相依性的存取權。
小提示
如果您將檔案上傳為代理程式的知識來源,則將此類檔案新增至元件集合會將其從原始代理程式中刪除。
作為解決方法,您可以將此類檔案從元件集合移回其原始代理程式。選取下一步。
查看您的收藏內容,然後選擇建立。
在環境層級建立元件集合
在側邊欄,選擇三個點(...),然後選擇 元件集合。
選擇新增,然後選擇元件集合。
輸入元件集合的名稱和描述。
選取完成。
將包含您想要共用的元件的代理程式連接到您的新元件集合。
將選定代理程式的元件加入集合中。
將代理程式連接到元件集合
在側邊欄,選擇三個點(...),然後選擇 元件集合。
選取您要連線至代理程式的集合。
在 [連線的代理程式 ] 區段中,選取 [ 新增代理程式]。 選取您要連線的代理程式,然後選取 [新增]。
您可以將連接代理程式中的任何元件新增至您的元件集合中。 所有連接的代理程式也可以使用該集合中的任何元件。
將代理程式中的元件加入集合中
在側邊欄,選擇三個點(...),然後選擇 元件集合。
選取您要新增元件的集合。
連線包含您要在集合中重複使用的元件的代理程式 (如果尚未)。
在 新增元件 區段中,選取從 代理程式新增。
備註
如果您尚未將任何代理程式連線到元件集合,則無法使用從代理程式新增元件的選項。
選擇所需的代理程式,然後選擇下一步。
選擇要新增到元件集合的元件。 您可以使用類別標籤和 搜尋元件 欄位來縮小元件清單的範圍。
選取下一步。
查看您的收藏內容,然後選擇新增至收藏夾。
設定元件集合的主要代理程式並排除相依性
您可以將單一代理程式設定為元件集合的主要代理程式。 如果製作者只想讓一個特定代理程式使用元件集合,則可以選擇主要代理程式。
如果您的集合有多個連線的代理程式,則無法設定主要代理程式。 您必須先中斷所有其他代理程式的連線。
當您設定主要代理程式時,您也可以在從該代理程式新增元件時排除相依性。 這可讓您建立不包含所有相依性的較小元件集合,當您只想共用特定元件時,這會很有用。
在側邊欄,選擇三個點(...),然後選擇 元件集合。
選取您要設定主要代理程式的集合。
在 「已連線代理人」 區塊中,選擇代理人旁邊的三個點(...),然後選擇 設定主要代理人。
這很重要
如果您的集合有多個連線的代理程式,則無法使用設定主要代理程式的選項。 對於您要設定為主要代理程式以外的每個代理程式,選取 中斷與代理程式的連線。
若要在從主要代理程式新增元件時排除相依性:
選取 從元件集合中的 代理程式新增 。
選取主要代理程式,然後選取 下一步。
選擇要新增到元件集合的元件。 清除 包括元件相依性。
選取下一步。
查看您的收藏內容,然後選擇新增至收藏夾。
共用元件集合
您可以與組織中的其他使用者共用元件集合,並指定他們是否具有 「檢視者」 或 「編輯者 」權限。 如需有關 Copilot Studio 使用者權限角色的詳細資訊,請參閱 控制客服專員的共用方式。
在側邊欄,選擇三個點(...),然後選擇 元件集合。
選取您要共用的集合。
在頂端功能表列上,選取 [共用]。
在共用面板中,輸入您要與之共用元件集合的其他人的名稱或電子郵件地址。 針對每個使用者,指定權限角色 (檢視者或編輯者)。
匯入和匯出集合
您可以匯出集合,以便將其匯入其他環境。 當您匯出集合時,它會變成受管理。 若要匯出集合而不進行管理,請參閱 使用複雜集合的解決方案。
若要匯出集合:
在側邊欄,選擇三個點(...),然後選擇 元件集合。
開啟您要匯出的集合。
在頂端功能表列上,選取 [匯出]。
匯出開始,並顯示通知列。 匯出準備就緒時,通知會變更為包含將集合下載為 .zip 檔案的連結。
若要匯入集合:
在 Copilot Studio 中,請確定已選取您要匯入集合的環境:
開啟您要連線到集合的代理程式,然後選取頂端列上的 設定 。
選取側邊功能表上的 元件集合 ,然後選取 匯入解決方案。
在出現的面板中,選取 [ 瀏覽檔案 ],然後選擇匯出的集合。
顯示了該系列的詳細信息。 您可以在「 進階設定 」區段下排除外掛程式步驟和流程。
小提示
如果您嘗試將集合匯入匯出集合的相同環境,您會看到錯誤訊息。 確認您位於不包含集合的目標環境中。
選取下一步。 匯入面板關閉後,出現訊息顯示該集合已成功匯入。
使用複雜集合的解決方案
您也可以使用解決方案從一個環境匯出代理程式元件,並將其匯入到另一個環境中。 該解決方案充當了元件的載體。 您可以在一個解決方案中匯出和匯入多個代理程式元件。
一般而言,針對複雜的元件集合使用解決方案。 例如,如果您的集合具有 連接器 或 環境變數。
建立解決方案
前往解決方案頁面。
選取新增解決方案。
為新的解決方案輸入下列資訊:
- 顯示名稱:解決方案清單中顯示的名稱。 稍後可加以變更。
- 名稱:解決方案的唯一名稱,由顯示名稱產生。 您只能在儲存解決方案之前進行變更。
- 發佈者:選擇預設發佈者或建立一個新的發佈者。 請考慮建立單一發行者,並在解決方案的所有環境中統一使用它。 深入了解解決方案發行者。
- 版本:輸入解決方案的版本號碼。 匯出解決方案時,版本號碼會包含在檔案名稱中。
選取建立。
將元件集合新增至解決方案
前往解決方案頁面,開啟所需的解決方案 (如果尚未開啟)。
選擇新增現有的,指向代理程式,然後選擇元件集合。
出現一個面板,顯示所有可用的元件集合。
選擇要匯出的元件集合,然後選擇面板底部的新增。
匯出解決方案以在其他環境中共用元件集合
您可以透過將包含元件集合的解決方案從一個環境匯出和匯入到另一個環境來匯出和匯入元件集合。
前往解決方案頁面。
選擇包含你想匯出元件集合的解決方案的三個點(⋮),然後選擇 匯出解決方案。
輸入或選取下列選項:
- 版本號:Copilot Studio 會自動增加您的解決方案版本。 您可以接受預設值,也可以自行輸入。
- 匯出為:選取套件類型 (受管理或未受管理)。 進一步了解受控和非受控的解決方案。
選取匯出。 匯出可能需要幾分鐘才能完成。 查看解決方案頁面最上方的狀態訊息。
匯出完成後,選擇下載按鈕下載 .zip 檔案。
檔案名稱的格式如下:SolutionName_Version_SolutionType.zip,例如,ContosoSolution_1_0_0_1_managed.zip。
匯入解決方案以將元件集合新增至環境
前往解決方案頁面。
選擇您想要匯入元件集合的環境。
選取匯入解決方案。
在匯入面板中,選擇瀏覽,選擇包含元件集合解決方案的 .zip 文件,然後選擇下一步。
選取匯入。 匯入可能需要幾分鐘才能完成。 查看解決方案頁面最上方的狀態訊息。
等候片刻,讓匯入完成。
如果匯入不成功,請選擇下載記錄檔案以下載包含導致匯入失敗的詳細資訊的 XML 檔案。 匯入失敗的最常見原因是解決方案不包含某些必要的元件。
將匯入的元件集合新增至您的代理程式
匯入元件集合後,您可以在代理程式中使用它。
開啟您想要使用元件集合的代理程式。
前往設定頁面,然後選擇元件集合。
在匯入的元件集合旁邊,選擇三個點 (...) ,然後選擇新增至代理程式。
將出現一則訊息提示您確認。
選擇新增到代理程式。
您的代理程式的名稱將顯示在此元件集合的活動下。
檢查匯入集合中的元件,並發佈代理程式以使客戶可以使用這些變更。
將元件新增至自訂解決方案中的元件集合
如果您將新的代理程式元件新增至 Copilot Studio 中的元件集合,則也必須將它們新增至參考此元件集合的任何非受控解決方案。
前往解決方案頁面,然後開啟包含要更新的元件集合的非受控解決方案。
在物件窗格中,選擇代理程式元件集合。
選擇你想更新的集合的三個點(⋮),指向 進階,然後選擇 新增必需物件。
選取確定。
在物件窗格中,您可以選擇代理程式元件來驗證現在是否出現了預期的元件。
開啟方案總管
在 Copilot Studio 中,選擇側邊欄上的三個點(...),然後選擇 解決方案。
解決方案頁面在新瀏覽器標籤中開啟。