使用變數作為輸入與輸出參數,在 Agent 流程與 Copilot Studio Agents 之間傳遞資訊。
重要
Agent 在單一操作中最多只能從流程接收 1 MB 的資料。 但是,Agent 可以發送的變數數量或資料量沒有限制。
在此範例中,您建立一個具有輸入參數的流程並將其作為輸出參數傳回給 Agent。
先決條件
- 了解如何從 Copilot Studio 撰寫畫布建立流程
支援的參數類型
Copilot Studio Agent 支援以下類型的 Agent 流程輸入與輸出參數:
- 數字
- 字串
- 布林值
以下是不支援的資料類型:
- 物件
- Date
- TimeStamp
- 清單 [字串]
- 清單 [數字]
- 清單 [布林值]
- 清單 [物件]
- 清單 [日期]
- 清單 [時間戳記]
建立主題和流程
前往您 Agent 的主題頁面。
建立名為 Echo 訊息的新主題。
新增觸發字詞 echo。
新增一個問題節點並輸入訊息「告訴我一些事情,我會回覆您。」
在識別選擇使用者的完整回覆。
對於將使用者回應另存為,將變數重新命名為 userResponse。
在問題節點下,選取新增節點圖示
,然後選擇新增工具。在基本動作索引標籤上,選擇新 Agent 流程。 Agent 流程設計工具索引標籤打開,其中包含 Agent 呼叫的 Agent 流程的起始範本。 此流程包括兩個動作:當 Agent 呼叫流程時和回應 Agent。
選擇發佈以儲存流程,然後再做任何更改。 流程建立成功後會出現通知。
選擇返回 Agent 以返回您的主題。 流程會新增一個新的動作節點到您的主題中。
選擇儲存以完成將流程作為工具加入您的 Agent。
視為流程細節
在帶有流程的動作節點上,選擇 檢視流程詳情連結以返回 Agent 流程。
在流程的概觀索引標籤上,編輯流程的詳細資料,將名稱替換為 Echo 參數。 選取儲存。
返回設計工具索引標籤。
向流程新增輸入參數
選取當 Agent 呼叫流程時,然後選取新增輸入。
選取文字,然後輸入名稱 字串_Input。
向流程新增輸出參數
選取回覆 Agent回覆動作,然後選取新增輸出。
選取文字,然後輸入名稱 字串_Output。
對於值,在方塊中輸入斜線 (
/),選擇插入動態內容,然後選擇 字串_Input 變數。選取儲存草稿和發佈。 Copilot Studio 會在 Agent 流程發布時通知您。
選擇返回 Agent Agent,以返回 Agent 主題編輯器。 新的動作流程已新增至主題。
從主題呼叫流程
選取新動作節點。
將流程輸入參數設定為來自問題節點的輸出變數:字串_Input (字串) 從 userResponse 變數取得其值。
新增訊息節點。
選取插入變數,然後選取 字串_Output。
選取儲存。
測試您的 Agent。