共用方式為

建立流程

  • 發行項

透過讓代理程式能夠根據請求產生天氣預報，了解如何在 Copilot Studio 中使用雲端流程。 在此第一個範例中，您將建立可提取天氣預報的流程。 在下一個範例中，您將以主題中的動作形式呼叫流程，以便代理程式可以在客戶詢問天氣時回覆天氣預報。

要與代理程式配合使用，Power Automate 流程需要特定的流程觸發和回應動作。

  • 流程觸發程序：從 Copilot 執行流程

    從 Copilot 執行流程的流程觸發程序螢幕擷取畫面。

  • 回應動作：回應副手

    回應副手回應動作的螢幕擷取畫面。

當您從 Copilot Studio 中建立流程時，將新增觸發程序和動作。 您可以透過將現有流程變更為使用這些動作，來修改現有流程以與代理程式一起使用。

重要

要在 Copilot Studio 中的自訂代理程式中使用雲端流程，流程必須：

  • 具有從 Copilot 執行流程觸發程序。
  • 位於與代理程式相同環境內的解決方案中。 可以將現有流程新增至解決方案中，以便在向代理程式新增動作時可用。
  • 在 100 秒動作限制內，與回應副手動作同步傳回回應。 為避免逾時，請最佳化流程邏輯、查詢和傳回的資料量，使典型執行低於此限制。 需要執行更長時間的動作可以放置在回應 Copilot 動作之後，以繼續執行直至流程執行持續時間限制 (通常為 30 天)。

先決條件

建立與代理程式一起使用的流程

  1. 前往您代理程式的主題頁面。

  2. 開啟您要從中呼叫流程的主題。

  3. 選擇現有節點下方的新增節點 (+) 以新增節點。

  4. 在節點選取視窗中，選取呼叫動作，選取基本動作，然後選取建立流程。

    叫用動作選單中的建立流程選項的螢幕擷取畫面。

    Power Automate 入口網站會在新索引標籤中開啟，且起始流程範本會打開以供編輯。 入口網站在與代理程式相同的環境中打開，並使用相同的使用者憑證。

    從 Copilot Studio 呼叫的 Power Automate 流程範本螢幕擷取畫面。

    提示

    重新命名節點以使其更易於識別。 選擇節點的名稱欄位以直接更新名稱，或選擇節點的更多圖示 (...)，並從功能表中選擇重新命名。 您也可以在程式碼編輯器中重新命名節點。

    無法重新命名觸發程序節點和前往步驟節點。

    節點名稱的長度最多可達 500 個字元。

現在將動作新增至您的流程中。 在此範例中，您將新增一個從「MSN 天氣」中提取目前天氣預報的動作。

  1. 選取流程的名稱，並將其重新命名為天氣預測。

    選取的流程名稱截圖。

  2. 將以下輸入參數新增到從 Copilot 執行流程觸發程序：

    • 市/鎮 (文字)
    • 郵遞區號 (數字)

    Power Automate 流程輸入參數的螢幕擷取畫面。

  3. 選取新增動作，在從 Copilot 執行流程流程觸發程序下方建立新動作。

    新增流程動作按鈕的螢幕擷取畫面。

  4. 搜尋 MSN 天氣，然後選取取得今天的預測動作。

    MSN 氣象連接器下方今天動作的取得預測螢幕擷取畫面。

  5. 在取得今日的預測動作的位置方塊中，選取新增動態內容，然後選取市/鎮和郵遞區號。

    新增至今日行動的取得預測變數螢幕擷取畫面

  6. 在回應副手動作中，新增以下輸出參數和變數：

    輸出參數 類型​ 變數
    day_summary 字串 每日摘要
    location 字串 位置
    chance_of_rain 數字 降雨機率

    新增至流程回復動作的動態輸出變數螢幕擷取畫面。

  7. 選取儲存。

管理流程使用哪些連線

在支援的經過驗證的代理程式中，雲端流程可以設定為在作為生成式協調流程方案的一部分執行或從主題呼叫時使用使用者認證。 如果您在受支援的頻道中使用流程，則不需要在代理程式對話方塊中進行特殊設定，並且使用者將能夠在使用代理程式時管理其連線。

使用客戶自控金鑰 (CMK) 的環境中的雲端流程，尚無法使用客戶認證作為生成式協調流程方案或主題的一部分來運作。 確保 CMK 環境中雲端流程的僅執行設定設為特定連線，而不是由僅執行使用者提供。

修改現有流程以與代理程式一起使用

如果您希望代理程式使用具有不同觸發程序的流程，則可以變更流程以使用從 Copilot 執行流程觸發程序，和回應 Copilot 回應動作，並確保它位於同一環境中的解決方案中作為自訂代理程式。

  1. 前往 Power Automate 入口網站，並使用右上角的環境選取器選擇儲存流程的環境。

  2. 瀏覽到左側的我的流程，然後搜尋流程。

  3. 選取流程。

    預設解決方案中的取得天氣預測流程的螢幕擷取畫面。

新增 Copilot 觸發程序和回應動作

如果您的流程尚未包含 Copilot 觸發程序和回應動作，則必須先新增它們，然後才能將流程與代理程式一起使用。

  1. 選取新步驟。

  2. 搜尋副手，然後選擇從 Copilot 執行流程。

  3. 選取新步驟。

  4. 搜尋 Copilot 連接器，然後選擇回應 Copilot。 回應動作可以在流程中的多個分支中使用，但在每次使用時必須具有相同的輸出。

  5. 儲存並發佈流程。

確保回應動作設定為即時傳回

您想要在代理程式中使用的流程必須即時或同步傳回值。 當您的代理程式嘗試執行在背景執行或非同步執行的流程時，可能會導致錯誤。 代理程式不會執行流程，而是會說：「發生了意外情況。 我們正在調查原因。 錯誤碼：3000。」

當您從 Copilot Studio建立流程時，預設會關閉非同步回復。 如果您修改了已啟用非同步回應的現有流程，請按照以下步驟檢查設定並確保其已關閉：

  1. 打開您的流程，然後找到回應 Copilot 動作。

  2. 選取設定索引標籤。

  3. 將非同步回覆設為關閉，然後選取完成。

    非同步回應切換的螢幕擷取畫面。

將流程新增至解決方案

為了可供代理程式使用，流程必須儲存在同一 Power Platform 環境中的解決方案中。 如果流程位於解決方案中，則流程的詳細資訊頁面上將顯示「解決方案」磚，其中會列出流程所在的解決方案。 可以將流程新增至預設解決方案以與代理程式一起使用，或使用下列步驟將流程移至不同的解決方案：

  1. 前往 Power Automate 入口網站。

  2. 移至解決方案，並選取現有的解決方案，或為您的流程建立解決方案。

    若要建立解決方案，請選取新增解決方案。

    新增解決方案按鈕的螢幕擷取畫面。

    請提供新的解決方案名稱，在發行者欄位中選取 CDS 預設發行者，輸入版本號碼，然後選取建立。

    解決方案屬性螢幕擷取畫面。

  3. 在解決方案索引標籤上，移至想要使用的解決方案。 選取新增現有的以新增流程。

    新增現有按鈕的螢幕擷取畫面。

  4. 在新增現有的流程頁面上，選取從解決方案索引標籤，選取您的流程，然後選取新增。

    清單中清單現有流程的螢幕擷取畫面。

    若要將流程從我的流程索引標籤移至解決方案，請選取外部方案，然後選取新增，將您的流程新增至解決方案中。

    清單中現有流程之外的螢幕擷取畫面。

相關內容