在設計工具中編輯和管理您的 Agent 流程或工作流程

Agent 流程與工作流程皆會在 Copilot Studio 的視覺化設計工具中建立及編輯。 新版工作流程目前為公開預覽版,採用重新設計的視覺化設計工具; Agent 流程則使用原始的視覺化設計工具。 這兩種視覺化設計工具都提供畫布,可讓您繼續建置或編輯自動化。 新增及移除動作、檢查錯誤,並發佈流程,全程不需離開設計工具。 您也可以調整 Agent 流程或工作流程的顯示方式,以便專注在特定區域。

重要

本文包含 Microsoft Copilot Studio 預覽版文件,內容可能有所變更。

預覽功能不供生產時使用,而且可能功能受限。 這些功能是在正式發行前先行推出,讓您能夠搶先體驗並提供意見反應

如果您要建置生產就緒 Agent,請參閱 Microsoft Copilot Studio 概觀

若要在設計工具中顯示 Agent 流程或工作流程,請開啟 Copilot Studio,選取流程,選取該流程,然後選取建置索引標籤。

Copilot Studio 設計工具的螢幕擷取畫面,顯示已發佈的工作流程,其中包含觸發程序及多個動作。

變更流程的顯示方式

視 Agent 流程或工作流程的大小及複雜程度而定,您可能需要調整流程的顯示方式,以利操作。 畫布左下角的工具列會控制檢視表。

Copilot Studio 設計工具中檢視選項工具列的螢幕擷取畫面,其中有編號從 1 到 6 的標註。

圖例:

  1. 放大:增加工作流程在畫布上的大小。
  2. 縮小:減少工作流程在畫布上的大小。
  3. 符合檢視:調整檢視比例,讓整個工作流程符合畫布顯示。
  4. 整理:重組工作流程及分支,以呈現更清晰的端對端檢視。
  5. 垂直版面配置:切換至工作流程的垂直版面配置檢視。

新增及移除動作

  1. 在您想新增動作之後的卡片上,選取新增步驟新增窗格隨即開啟。

  2. 新增底下,開始輸入您想讓流程執行的動作或想新增的連接器,然後從清單中選取。 視您的選擇而定,您可能需要提供其他資訊才能完成該動作。

若您判斷不需要該動作,請選取該動作右上角的刪除圖示。

檢查流程參數

若要檢視工作流程中觸發程序或動作的參數,請選取其卡片。 設定面板會在右側開啟。 若要輸入參數值,請在下拉式清單中選取選項,或輸入運算式以動態設定值。

檢視 Agent 流程的版本記錄

當您建置或修改 Agent 流程時,系統會在 Microsoft Dataverse 中記錄版本記錄。 若要了解 Agent 流程的演變過程,請檢閱其版本記錄。 流程版本按日期分組,並標示最新版本、已發佈版本和過去發佈的版本。

流程的歷史記錄是基於已儲存的版本,因此最好在流程完成之前儲存草稿。

若要使用版本記錄面板,您必須先儲存 Agent 流程至少一次。

  1. 在畫布頂端的功能表中,選取版本記錄

  2. 若要查看流程的記錄版本,請展開清單中的項目。

  3. 若要在設計工具中顯示該版本,請在清單中選取它。

檢查錯誤

工作流程動作中的錯誤會以紅色標示。 若要檢視某個動作中錯誤的詳細資料,請選取該錯誤。 若要列出整個流程中的所有錯誤,請開啟健康情況中心橫幅。 若要檢視個別錯誤的詳細資料,請選取該錯誤。

重要

若流程包含錯誤,您將無法發佈。 您必須先修正所有錯誤,才能發佈流程。

發佈工作流程

若工作流程沒有錯誤,即可加以發佈。 若要發佈流程,請在畫布頂端的功能表中選取發佈

測試 Agent 流程或工作流程

測試回合可讓您在不離開設計工具的情況下,使用實際的上游資料、您自行模擬的值,或先前執行的輸出,驗證單一步驟或整個流程。

執行測試的方式有兩種:

您想驗證的項目 測試方法 在哪裡可以找到它
單一動作或獨立的 AI 步驟 測試此節點 節點側邊面板中的「測試」索引標籤
完整流程 (端對端) 執行流程測試 頂端命令列中的播放按鈕

這兩種方式的概念相同:提供輸入 (真實或模擬)、執行,然後檢查輸出。

測試工作流程中的單一節點

開啟工作流程中的任何動作或節點,然後選取播放或「測試」按鈕。 其中包含三個區段:

  1. 執行/重設測試:隨選執行步驟,或清除目前的輸入及輸出。

    節點測試面板的螢幕擷取畫面,顯示「輸入」、「設定」及「輸出」區段,並醒目提示「測試」按鈕。

  2. 從先前的執行載入值:此流程最近執行記錄的下拉式清單。 選取其中一項後,系統會將該次執行中上游步驟的輸出提取到下方的輸入欄位。

  3. 輸入:節點參考的每個上游步驟輸出各有一個可編輯欄位。 每列右側的標記會顯示欄位預期的類型 (例如字串、電子郵件、日期時間、數字等)。

  4. 輸出:最近一次測試的即時結果,會依節點類型格式化 (例如 JSON、提示結果、連接器回應等)。

模擬輸入

依預設,輸入欄位為空白。 您可以:

  • 直接在欄位中輸入任意值。 該欄位接受右側標記顯示的類型。
  • 若步驟不需要該欄位,可將其保留空白。

節點測試面板的螢幕擷取畫面,顯示空白的輸入欄位,右側標示類型標記。

提示

這裡會顯示什麼? 「測試」索引標籤會自動列出此節點運算式所參照的上游步驟輸出。 若您在節點中新增權杖,對應的欄位會在您下次開啟「測試」時顯示。

從先前的執行載入值

[載入上次執行的值] 下拉式清單的螢幕擷取畫面,顯示包含日期、時間和狀態標籤的過去執行回合。

若流程先前已執行過,您可以重播實際資料,而不需手動輸入:

  1. 載入上次執行的值下拉式清單中,選擇一個執行回合。 每個項目都會標示執行的日期/時間及狀態 (例如:4 月 24 日 09:12—成功)。

  2. 設計工具會擷取該執行的步驟輸出,並透過節點的輸入結構描述放映這些輸出。 相符的值會寫入輸入欄位。

  3. 之後您可以編輯任何欄位,藉此微調情境。

下拉式清單顯示任何狀態下的最近 10次執行。 若某次執行未包含某個上游步驟的輸出 (因為該步驟已略過或未執行到該路徑),系統只會填入可用的欄位。 其餘欄位會維持原狀。

如果流程先前並未執行,則顯示沒有先前的執行,並隱藏下拉式清單。

執行測試

選取 [執行測試]。 通話正在進行時,按鈕會顯示忙碌狀態;輸出區段顯示進度環,接著顯示結果或錯誤。

  • 重設測試會同時清除輸入及最近一次的輸出。
  • 測試根據連接器的 API,在隔離環境中執行節點。 測試不會觸發流程的其餘部分。

測試整個流程

在頂端命令列中,選取播放按鈕 (測試)。 測試會針對即時執行階段,端對端執行您的流程。

執行開始之前,設計工具會:

  1. 如果您有未儲存的變更 (或是第一次),則會儲存並發佈流程。
  2. 在首次執行時安裝任何新的連線。
  3. 觸發執行。 路徑取決於您的觸發程序類型。
觸發程序類型 選取「測試」時會發生的情況
手動/HTTP 要求 系統會開啟對話方塊,供您輸入觸發程序輸入,然後立即執行流程。
週期性/滑動視窗/輪詢 要麼在排程開始後,第一次執行自動啟動,要麼在已安裝的情況下,流程執行一次。
連接器事件 (例如「收到電子郵件時」) 流程進行發佈並等待。 您可以看到等待觸發…。 在來源系統中執行該動作,以觸發執行。
HTTP Webhook 流程已發佈;像平常一樣從外部系統觸發。

模擬輸入 (手動觸發程序)

針對手動觸發程序,輸入手動觸發程序輸入對話方塊會針對您在觸發程序上定義的每個輸入顯示一個欄位:

  • 文字/數字/電子郵件/日期:對應的輸入控制項。
  • 布林值:切換開關。
  • 單一選擇 (列舉):下拉式清單。
  • 多選:多選下拉式清單。
  • 檔案:檔案選擇器 (在執行過程中上傳內容)。
  • 物件/陣列:可貼上 JSON 的多行文字區域。

選取執行以使用這些輸入啟動流程,或選取取消以不執行的方式關閉。 必要欄位會標示星號。 若值缺漏或無效,畫面會顯示行內驗證訊息,且執行會遭到封鎖,直到問題修正為止。

每次選取「測試」時都會顯示此對話方塊。 值不會在各次執行之間保留,方便您快速嘗試不同情境。

監看執行

一旦執行開始後:

  • 執行進行中時,命令列會顯示取消按鈕。
  • 「活動」面板 (右側) 會在頂端列出目前的執行,並附上狀態標記:執行中等待中成功失敗已取消。 選取任何執行回合以在畫布上開啟,並檢查每個步驟的輸入和輸出。

選取過去的執行

活動面板同時也是流程的執行歷程記錄:

  • 使用頂端的下拉式清單,依全部/成功/失敗/執行中篩選。
  • 選取重新整理即可重新取得清單。
  • 選取底部的載入更多以繼續往回翻頁。
  • 選取執行記錄會將其載入畫布,此時每個節點都會顯示該次執行所收到的輸入及產生的輸出。 此資料與節點層級 [測試] 索引標籤在您從下拉式清單選擇執行時所使用的資料相同。

何時該使用各種測試類型

  • 正在反覆調整單一 AI 步驟或連接器動作?測試此節點。速度較快、不會發佈,且只需模擬重要的上游值。
  • 正在驗證端對端行為或觸發程序邏輯?執行流程測試。會針對實際執行階段,執行整個圖形。
  • 重現生產問題?:從活動面板開啟失敗執行,然後開啟失敗節點,並使用 [測試] 索引標籤中的載入上次執行的值,以重新執行完全相同的上游資料並引入動作中。