建立流程
透過讓代理程式能夠根據請求產生天氣預報,了解如何在 Copilot Studio 中使用雲端流程。 在第一個範例中,您將建立一個取得天氣預報的流程。 在下一個範例中,您設定一個主題來將流程作為操作來呼叫,以便當客戶詢問天氣時,代理程式可以根據天氣預報做出回應。
若要與代理程式搭配使用,Power Automate 流程需要以下流程觸發程序和回應操作:
- 流程觸發程序:從 Copilot 執行流程
- 回應動作:回應副手
當您從 Copilot Studio 建立流程時,將為您新增所需的流程觸發程序和回應操作。 您可以透過更新現有流程來使用這些觸發程序和操作,從而對其進行修改以供代理程式使用。
重要
要在 Copilot Studio 中的自訂代理程式中使用雲端流程,流程必須:
- 具有從 Copilot 執行流程觸發程序。
- 位於與代理程式相同環境內的解決方案中。 可以將現有流程新增至解決方案中,以便在向代理程式新增動作時可用。
- 在 100 秒動作限制內,與回應副手動作同步傳回回應。 為避免逾時,請最佳化流程邏輯、查詢和傳回的資料量,使典型執行低於此限制。 需要執行更長時間的動作可以放置在回應 Copilot 動作之後,以繼續執行直至流程執行持續時間限制 (通常為 30 天)。
必要條件
- 使用包含 Copilot Studio 使用流程的授權進行存取 Copilot Studio。
建立與代理程式一起使用的流程
前往您代理程式的主題頁面。
開啟您要從中呼叫流程的主題。
選擇任意節點下方的新增節點圖示
,然後選擇新增操作。
在基本動作標籤上,選擇新 Power Automate 流程。
Power Automate 入口網站將在新分頁中打開,並開啟一個啟動流程範本以供編輯。 入口網站在與代理程式相同的環境中打開,並使用相同的使用者憑證。
現在將動作新增至您的流程中。 在此範例中,您將新增一個從「MSN 天氣」中提取目前天氣預報的動作。
選擇流程的名稱並將其替換為「取得天氣預報」。
選擇從 Copilot 流程觸發程序執行流程並新增以下輸入參數:
- 市/鎮 (文字)
- 郵遞區號 (數字)
選擇從 Copilot 執行流程流程觸發程序下方的新增圖示。
在新增操作中,搜尋「MSN 天氣」,然後選擇取得今天的預報操作。
在取得今天的預報面板的位置方塊中,輸入斜線 (
/
),選擇插入動態內容,然後選擇您的城市輸入參數。以相同的方式新增您的郵遞區號輸入參數。
在回應副手動作中,新增以下輸出參數和變數:
輸出參數 類型 變數 day_summary
文字 每日摘要 location
文字 位置 chance_of_rain
數字 降雨機率 儲存並發佈流程。
返回您的 Copilot Studio 主題並按照從主題呼叫流程中的說明進行操作。
管理流程使用哪些連線
在支援的經過驗證的代理程式中,雲端流程可以設定為在作為生成式協調流程方案的一部分執行或從主題呼叫時使用使用者認證。 在支援的管道中使用流程不需要在代理程式中進行任何特殊設定。 客戶在使用代理程式時能夠管理他們的連線。
在使用客戶自控金鑰 (CMK) 的環境中雲端流程尚無法使用客戶憑證作為產生編排計畫的一部分或從主題運作。 確保 CMK 環境中雲端流程的僅執行設定設為特定連線,而不是由僅執行使用者提供。
修改現有流程以與代理程式一起使用
如果您希望代理程式使用具有不同觸發程序的流程,則可以變更流程以使用從 Copilot 執行流程觸發程序,和回應 Copilot 回應動作,並確保它位於同一環境中的解決方案中作為自訂代理程式。
前往 Power Automate 入口網站並使用右上角的環境選擇器選擇儲存流程的環境。
在左側導覽窗格中選擇我的流程,然後搜尋要修改的流程。
選擇您的流程,然後選擇編輯。
新增 Copilot 觸發程序和回應動作
如果您的流程尚未包含所需的流程觸發程序和回應操作,則必須先新增它們,然後才能將流程與代理程式一起使用。
選取新步驟。
搜尋副手,然後選擇從 Copilot 執行流程。
選取新步驟。
搜尋 Copilot 連接器,然後選擇回應 Copilot。 回應動作可以在流程中的多個分支中使用,但在每次使用時必須具有相同的輸出。
儲存並發佈流程。
確保回應動作設定為即時傳回
您想要在代理程式中使用的流程必須即時或同步傳回值。 在背景執行或非同步執行的流程可能會導致代理程式嘗試執行錯誤。 代理程式沒有繼續執行流程,而是說「發生了意外情況。 我們正在調查原因。 錯誤碼:3000。」
當您從 Copilot Studio建立流程時,預設會關閉非同步回復。 如果您修改了已開啟非同步回應的現有流程,請依照下列步驟檢查設定並確保已關閉:
打開您的流程並找到回應 Copilot 的操作。
選取設定索引標籤。
將非同步回應設定為關閉,然後選擇儲存。
將流程新增至解決方案
為了可供代理程式使用,流程必須儲存在同一 Power Platform 環境中的解決方案中。 如果流程位於解決方案中,則流程的詳細資訊頁面上會顯示「解決方案」磚,其中列出了流程所在的解決方案。 可以將流程新增至預設解決方案以與代理程式一起使用,或使用下列步驟將流程移至不同的解決方案:
移至 Power Automate。
前往解決方案,然後選擇現有解決方案或為您的流程建立解決方案。
如果您想建立一個新的解決方案:
選取新增解決方案。
為您的新解決方案命名,在發佈者欄位中選擇 CDS 預設發佈者,然後輸入版本號。
選取建立。
如果要將流程新增至現有解決方案,請選擇所需的解決方案,然後選擇編輯。
選取新增現有>自動>雲端流程。
出現新增現有流程面板。
選擇您的流程,然後選擇新增。