Note
本文中的功能由由 GitHub Copilot 架構驅動的代理程式或工作流程所使用。
按使用量計費適用於代理程式的使用、建置、測試與評估。 這些行動可能會消耗 Copilot 點數。 在「管理由 GitHub Copilot 驅動的代理人員成本」中了解更多。
在 Copilot Studio 重新設計的視覺化設計工具中建立和編輯工作流程。 設計器提供一個畫布，讓你可以建立或編輯自動化、新增或移除動作、檢查錯誤，並在不離開設計器的情況下發布工作流程。
在設計器中顯示工作流程
要在設計器中顯示工作流程，打開 Copilot Studio，選擇工作流程，再選擇工作流程，然後選擇建置標籤。
改變工作流程的顯示方式
根據你工作流程的大小和複雜度，你可能想調整顯示方式，讓操作更方便。 使用畫布左下角的工具列來控制視圖。
圖例:
- 放大：放大畫布上的工作流程大小。
- 縮放：縮小畫布上的工作流程大小。
- Fit View：調整視圖大小以容納畫布上的整個工作流程。
- 清理：重整工作流程及分支，以便更清楚地呈現端到端的視圖。
- 垂直版面：切換到工作流程的垂直版面檢視。
新增和刪除動作
在你想加入動作的卡片下方，選擇 新增步驟。 新增視窗打開了。
在 新增功能中，開始輸入你想讓工作流程執行的動作或你想新增的連接器，然後從列表中選擇它。 根據你的選擇，你可能需要提供更多資訊才能完成行動。
如果你判斷不需要動作，請選擇該動作右上角的 刪除 圖示。
檢查工作流程參數
要查看工作流程中觸發或動作的參數，請選擇該卡片。 設定面板在右側開啟。 若要輸入參數的值，請在下拉式清單中選擇選項或輸入運算式來動態設定該值。
檢查錯誤
工作流程動作中的錯誤以紅色標示。 要查看某個動作中某個錯誤的詳細資訊，請選擇該錯誤。 若要列出整個工作流程中的所有錯誤，請打開 健康中心 的橫幅。 若要查看單一錯誤的詳細資訊，請選擇該錯誤。
Important
如果工作流程包含錯誤，你就無法發佈。 你必須修正 所有 錯誤，才能發表。
發佈你的工作流程
如果你的工作流程沒有錯誤，你可以發佈它。 在畫布頂端的選單中，選擇 發佈。
測試工作流程
測試執行讓你在不離開設計師的情況下，驗證一個步驟或整個工作流程。 使用真實的上游數據、你自己模擬的數值，或是之前執行的輸出。
有兩種測試方式：
| 你想驗證的是什麼 | 如何測試 | 哪裡可以找到它 |
|---|---|---|
| 單獨的動作或 AI 步驟 | 測試這個節點 | 節點側面板內的 測試 分頁 |
| 完整的工作流程，端對端 | 執行流程測試 | 上方指令列的播放按鈕（測試） |
兩個表面共享相同理念：提供輸入（真實或模擬），執行，然後檢查輸出。
測試工作流程中的單一節點
打開工作流程中的任意動作或節點，選擇播放按鈕（測試）。 其中包含三個區段：
執行/重置測試：按需執行步驟，或清除目前的輸入與輸出。
前一次執行的載入值：此工作流程最近一次執行的下拉選單。 選擇其中一個將會把該上游步驟的輸出結果填入下方的輸入欄位。
輸入：每個上游步驟輸出節點參考的一個可編輯欄位。 每列右側的徽章顯示欄位的預期類型（字串、電子郵件、日期時間、數字等）。
輸出：最近一次測試的即時結果，依節點類型格式化。
模擬輸入
預設輸入欄位是空白的。 您可以：
- 直接在欄位輸入任意值。 該欄位接受右側徽章所示的類型。
- 如果你的步驟不依賴它，就留一個欄位空著。
Tip
測試分頁會自動列出該節點表達式所參考的上游步驟輸出。 如果你在節點新增一個標記，下次開啟 Test 時會出現對應欄位。
前一次運行的負載值
如果你的工作流程之前曾執行過，你可以重放真實資料，而不是輸入資料：
在 上次運行的負載值 下拉選單中，選擇一條路線。
設計者會擷取該執行的步驟輸出，並透過節點的輸入結構投射出來。 匹配的值會寫入輸入欄位。
如果你想調整劇本，可以編輯任何欄位。
下拉選單顯示任何狀態下最近的10次運行。 如果某個執行步驟沒有包含某個上游步驟的輸出，因為該步驟被跳過或路徑未被選取，則只會填滿可用欄位。 其餘的則保持原狀。
如果工作流程之前沒執行過，則 不會顯示任何可用的先前執行 ，下拉選單也會被隱藏。
執行測試
選擇 執行測試。 按鈕顯示通話中忙碌狀態; 輸出 區段顯示旋轉器，接著顯示結果或錯誤。
- 重置測試 會清除輸入和最後一個輸出。
- 測試在獨立的環境中執行節點，並測試連接器的 API。 測試不會觸發整個工作流程。
測試整個工作流程
在上方指令列，選擇播放按鈕（測試）。 測試會針對實際執行環境對您的工作流程進行端對端測試。
在跑步開始前，設計師：
- 如果你有未儲存的變更，或是第一次，會儲存並發佈工作流程。
- 第一次執行時會安裝任何新連線。
- 觸發跑步。 路徑取決於你的觸發類型。
| 觸發類型 | 當您選擇測試時會發生什麼？ |
|---|---|
| 手動/HTTP 請求 | 會跳出一個對話框讓你輸入觸發器輸入，然後工作流程會立即執行。 |
| 重複/滑動視窗/輪詢 | 要麼排程會啟動，首次執行會自動開始；要麼如果已經安裝完成，工作流程會執行一次。 |
| 連接器事件（例如，當電子郵件抵達時） | 工作流程已發佈，並處於等待狀態。 你會看到 等待觸發中...。請在來源系統中執行該動作，以觸發此次執行。 |
| HTTP 網路鉤子 (webhook) | 工作流程已發布；如同平常一樣，從外部系統觸發它。 |
模擬輸入（手動觸發）
對於手動觸發器，Enter 手動觸發器輸入 對話框會根據你在觸發器上定義的每個輸入，呈現一個欄位：
- 簡訊/號碼/電子郵件/日期：適當的輸入控制。
- 布林值：切換開關。
- 單一選擇（列舉）：下拉選單。
- 多重選擇：多重選擇下拉選單。
- 檔案：檔案選擇器。 內容會隨行程上傳。
- 物件/陣列：多行文字區，可以貼上 JSON。
選取 執行 以這些輸入啟動工作流程，或選取 取消 以關閉而不執行。 必填欄位以星號標示。 若值缺失或無效，則會出現內嵌驗證訊息，執行會被封鎖直到修正。
每次選擇 測試時，對話框都會出現。 數值不會在兩次遊玩間儲存，所以你可以快速嘗試不同的情境。
觀看運行
一旦滑行進入飛行狀態：
- 當跑步啟動時，指令列會顯示 取消 按鈕。
- 右側的活動面板會在頂端列出目前的執行作業，並附有狀態徽章：執行中、等待中、已成功、失敗或已取消。 選擇任一執行，在畫布上打開，檢查每個步驟的輸入和輸出。
選擇過去執行
活動面板同時也是你工作流程的執行紀錄：
- 用頂部的下拉選單篩選「 全部/成功/失敗/執行中 」。
- 選擇 重新整理 以更新清單。
- 在底部選擇 「載入更多」 來載入更多內容。
- 選擇執行後，該執行會載入畫布，每個節點會顯示該執行中收到的輸入與輸出。 這些資料和節點層級測試分頁在下拉選單選擇跑道時使用的相同資料。
何時使用各類檢測
- 是針對單一 AI 步驟或連接器動作進行迭代？ 使用 測試這個節點。 它比較快，不會發佈，而且只模擬重要的上游值。
- 驗證端對端行為或觸發邏輯？ 使用 Run flow test。 它會將整個圖與實際執行時間做對比。
- 重現生產問題？ 從活動面板開啟失敗的執行，然後開啟失敗的節點，並在其「測試」分頁中使用從先前的執行載入值，將完全相同的上游資料重新帶入該動作。
代幣選擇器的取樣值
當你寫出一個引用上游步驟輸出的表達式時，標記選擇器會在每個標記旁邊顯示一個樣本值，讓你能看到該步驟的真實資料長什麼樣子。 取樣值會自動從你工作流程最近完成的測試跑中提取，所以你不必手動選擇跑道或新增標記。
其行為如下：
- 各上游步驟的輸出結果，其樣本值會直接顯示在該列中。
- 僅顯示最近一次已完成執行的成功輸出結果。 跳過、未達成或失敗的步驟沒有樣本值。
- 如果工作流程尚未執行，或最新執行中沒有包含該參考步驟，該標記旁邊就不會出現任何取樣值。
樣本值為唯讀預覽資料。 編輯表達式不會改變底層的執行，關閉選擇器也不會丟棄任何東西。
刪除從 Copilot 聊天產生的工作流程
你可以在首頁的 Copilot 聊天或代理人的建置聊天中描述工作流程。 當你這麼做時，聊天室會顯示該工作流程的內嵌卡片。 即使工作流程已經發布，你仍然可以從其卡片中刪除它。
在聊天的工作流程工件卡中，選擇 ...... 選單。
選擇 刪除工作流程。
在 「刪除此文物 」對話框中，檢視文物名稱並確認。
選擇 刪除。
工作流程會被永久移除。 其相關的運行紀錄也會被刪除。
刪除工作流程項目只有在工作流程儲存並發布後才會啟用。 當工作流程還在儲存或發佈時，或是在首次發佈前，選單會顯示該項目被停用，並有簡短的提示說明原因。 刪除是永久的——沒有還原方法。