共用方式為


使用輸入和輸出變數來傳遞資訊

使用變數作為輸入與輸出參數,在 Agent 流程與 Copilot Studio Agents 之間傳遞資訊。

重要

Agent 在單一操作中最多只能從流程接收 1 MB 的資料。 但是,Agent 可以發送的變數數量或資料量沒有限制。

在此範例中,您建立一個具有輸入參數的流程並將其作為輸出參數傳回給 Agent。

先決條件

支援的參數類型

Copilot Studio Agent 支援以下類型的 Agent 流程輸入與輸出參數:

  • 數字
  • 字串
  • 布林值

以下是不支援的資料類型:

  • 物件
  • Date
  • TimeStamp
  • 清單 [字串]
  • 清單 [數字]
  • 清單 [布林值]
  • 清單 [物件]
  • 清單 [日期]
  • 清單 [時間戳記]

建立主題和流程

  1. 前往您 Agent 的主題頁面。

  2. 建立名為 Echo 訊息的新主題。

  3. 新增觸發字詞 echo

  4. 新增一個問題節點並輸入訊息「告訴我一些事情,我會回覆您。」

  5. 識別選擇使用者的完整回覆

  6. 對於將使用者回應另存為,將變數重新命名為 userResponse

    收集使用者回答的問題節點的螢幕擷取畫面。

  7. 問題節點下,選取新增節點圖示,然後選擇新增工具

  8. 基本動作索引標籤上,選擇新 Agent 流程。 Agent 流程設計工具索引標籤打開,其中包含 Agent 呼叫的 Agent 流程的起始範本。 此流程包括兩個動作:當 Agent 呼叫流程時回應 Agent

  9. 選擇發佈以儲存流程,然後再做任何更改。 流程建立成功後會出現通知。

  10. 選擇返回 Agent 以返回您的主題。 流程會新增一個新的動作節點到您的主題中。

  11. 選擇儲存以完成將流程作為工具加入您的 Agent。

視為流程細節

  1. 在帶有流程的動作節點上,選擇 檢視流程詳情連結以返回 Agent 流程。

  2. 在流程的概觀索引標籤上,編輯流程的詳細資料,將名稱替換為 Echo 參數。 選取儲存

  3. 返回設計工具索引標籤。

向流程新增輸入參數

  1. 選取當 Agent 呼叫流程時,然後選取新增輸入

  2. 選取文字,然後輸入名稱 字串_Input

    流程觸發程序輸入參數的螢幕擷取畫面。

向流程新增輸出參數

  1. 選取回覆 Agent回覆動作,然後選取新增輸出

  2. 選取文字,然後輸入名稱 字串_Output

    回應操作輸出參數的螢幕擷取畫面。

  3. 對於值,在方塊中輸入斜線 (/),選擇插入動態內容,然後選擇 字串_Input 變數。

  4. 選取儲存草稿發佈。 Copilot Studio 會在 Agent 流程發布時通知您。

  5. 選擇返回 Agent Agent,以返回 Agent 主題編輯器。 新的動作流程已新增至主題。

從主題呼叫流程

  1. 選取新動作節點。

  2. 將流程輸入參數設定為來自問題節點的輸出變數:字串_Input (字串)userResponse 變數取得其值。

    呼叫「Echo 參數」流程的動作節點的螢幕擷取畫面。

  3. 新增訊息節點。

  4. 選取插入變數,然後選取 字串_Output

    回顯使用者輸入的訊息節點的螢幕擷取畫面。

  5. 選取儲存

  6. 測試您的 Agent。

     Agent 交談的螢幕擷取畫面。