共用方式為

將操作與自訂代理結合使用 (預覽版)

  • 發行項

您可以通過添加一個或多個操作來擴展專員的功能。 您的專員使用操作通過生成編排 自動回應使用者，或者您可以從主題中顯式調用它們。

核心動作類型

如果您啟用 生成式編排，您的專員可以自動選擇最合適的操作或主題，或者跨知識搜索，以回應使用者。

在經典模式 (禁用生成編排) 下，專員只能使用主題來響應使用者。 但是，您仍然可以將專員設計為從主題中顯式調用操作。

動作是基於以下其中一個核心動作類型：

  • 預建連接器動作
  • 自訂連接器動作
  • Power Automate 雲端流程
  • AI Builder 提示
  • Bot Framework 技能

每個核心操作都有描述其目的的附加資訊，允許專員使用生成式 AI 來生成問題。 需要這些問題來填寫執行動作所需的輸入。 因此，您無需手動建立問題節點來收集所需的所有輸入 (例如流程上的輸入)。 在運行時為您處理 Importing。

默認情況下，使用生成模式時，操作會將其資訊返回給專員，以便專員可以生成用戶查詢的上下文回覆。 或者，您可以指示您的操作始終立即回應，生成消息或創作顯式消息。

提示

使用從動作生成的問題時，請告知使用者某些對話是由 AI 生成的。

例如，在交談開始系統主題中新增額外的訊息。 此主題會決定新對話開始時要向使用者顯示的訊息。

新增動作

  1. 通過在左側導航窗格中選擇 Agents (代理 ) 並從清單中選擇您的專員來打開您的專員。

  2. 選擇 Actions (操作 ) 以查看專員的操作。

  3. 選取新增動作。

  4. 在 Choose an action (選擇操作 ) 精靈中，搜索要使用的操作並選擇它。

    顯示的預設清單包含您環境中可用的 Power Automate 流程和自訂連接器。 此清單包括常用的預生成連接器和 Bot Framework 技能已註冊到專員。

    動作精靈第一頁的螢幕擷取畫面，其中動作類型篩選器處於開啟狀態。

    重要

    從 AI 外掛程式建立的某些動作 (例如動態提示和基於 Dataverse API 的動作) 需要驗證。

    根據操作，您的連線會自動設定，如範例所示。 否則，跟隨嚮導的說明來配置連接。 成功設定連線後，請選取下一步。

    連線頁面上動作精靈第一頁的螢幕擷取畫面。

  5. 查看您的外掛程式動作配置，並 根據需要進行更改 。

    選取下一步。

  6. 選擇 Finish (完成 ) 將操作添加到您的專員。

測試您的動作

如果您啟用了 生成式編排，則會回覆相關使用者查詢自動調用您的操作。

或者，您也可以 從主題 中顯式調用操作。

您的專員根據名稱和描述選擇並運行您的操作。 您可以作者高品質的描述，使用活動圖查看您的專員從 actions 頁面選擇了哪些操作。

您可以在以下螢幕擷取畫面中看到正在測試的天氣動作：

正在測試動作的螢幕擷取畫面。

變更動作設定

有多種方法可以設定您的動作。 在動作精靈的最後一步 (稱為檢閱並完成) 中，您可以透過按一下相應區段旁邊的編輯來變更動作的設定。 從嚮導中的 Review inputs and outputs （查看輸入和輸出）螢幕，或從已包含在專員中的操作的詳細資訊頁面中，您可以管理操作的輸入和輸出參數。

動作詳細資料

您可以在此處設定有關動作的詳細資訊，包括動作的模型顯示名稱和模型描述。 通常，名稱和描述會根據您選取的動作預先填入。

每個 輸入的顯示名稱 和 Description 屬性可説明專員瞭解輸入的用途，為使用者生成適當的問題，並識別使用者回覆中的正確值。 例如，以下是 MSN Weather 連接器位置輸入參數的預設名稱和描述。

  • 名稱：位置
  • 描述：位置搜尋查詢。 有效輸入為縣/市、地區、州/省、國家/地區、地標、郵遞區號、緯度和經度

當專員提示使用者輸入位置時，它會生成一個問題，例如“ 您要查看天氣的位置是什麼？您可以輸入城市、區域、州、國家/地區、地標或郵遞區號。

您可以根據收集的輸入，將 Identify as (標識為 ) 選項更改為 特定的實體類型，這可以説明專員準確地從使用者的回覆中提取值。

輸入

預設情況下，每個輸入都設定為動態填入最佳選項。 專員嘗試從可用上下文 (例如，從使用者的消息) 中提取值。 如果沒有找到合適的值，它會產生一個問題來詢問使用者一個值。 您可以用值覆寫輸入，而不用詢問使用者。 要設置覆蓋，對於 How will the 專員 fill this input？(如何將 # 填充此輸入？) ，選擇 Set as a value (設置為值)，然後輸入所需的值。 該值可以是文字值、現有變數或 Power Fx 公式。

動作設定的輸入區段螢幕擷取畫面。

要在請求值或驗證使用者答案時控制專員的行為，您可以為輸入配置 其他設置 。

輸出

預設情況下，您的動作設定為根據使用者的查詢和動作結果，為使用者自動生成關聯式回應。 例如，如果使用者詢問「倫敦目前氣溫是多少？」，則系統會使用 GPT 產生與上下文相關的回覆，例如「倫敦目前溫度為攝氏 9 度」。

或者，您可以選擇撰寫特定回應以傳回動作。 和確認編輯器一樣，您可以使用變數選擇器插入動作中輸出變數的參考，如本範例所示。

打開變數選擇器時，輸出回應編輯器的螢幕擷取畫面。

從主題中調用操作

您可以從主題中明確呼叫動作，類似於呼叫其他動作類型 (如 Power Automate 流程)。 根據您的使用案例，您可以將流程當作使用更多節點的更大主題的一部分使用。 或者，就像在天氣範例中一樣，您可能需要將單個動作節點新增至主題。

若要從主題中呼叫動作：

  1. 在中 Copilot Studio，轉到 要編輯的專員的 Topics (主題 ) 頁面。

  2. 建立新的主題，並將它命名為取得天氣。

  3. 新增下列觸發字詞：

    • 會下雨嗎
    • 今日預測
    • 獲取天氣
    • 天氣怎麼樣

    新主題中的觸發字詞螢幕擷取畫面。

  4. 選取新增節點 (+)，然後選取呼叫動作。 切換到外掛程式動作 (預覽版) 索引標籤，然後選擇之前建立的動作取得天氣預報。

    打開新節點功能表並選擇天氣動作的螢幕擷取畫面。

  5. 您的外掛程式動作 (預覽版) 節點現在已新增至主題。

    主題中新動作節點的螢幕擷取畫面。

  6. 選取儲存。

從主題呼叫動作時覆寫輸入

默認情況下，當您的操作運行時，您的專員會生成問題供使用者填充所需的輸入。 但您可能會想要覆寫一或多個輸入並提供明確的值，而不是詢問使用者。 您可以在輸入區段中的外掛程式動作設定中進行覆寫。 或者，您可以僅在特定主題使用您的動作時覆寫值：

  1. 請選取節點上的設定值，並選取想要覆寫的輸入。

    可覆寫的輸入清單螢幕擷取畫面。

  2. 透過鍵入值、選擇變數或使用公式來輸入輸入值。

    使用覆蓋輸入的單位的屏幕截圖。

現在，此輸入已被覆蓋，專員不會要求使用者輸入值。

啟用 AI 動作驗證

某些動作 (基於 AI 動作建立時) 需要驗證才能正常工作，例如動態提示或其他呼叫 Dataverse API 的動作。

操作始終在最終使用者上下文中專員的運行時中運行，除非啟用身份驗證，否則無法運行。 支援兩種類型的身份驗證方法：

  1. 前往連接器動作屬性。

  2. 在 End user authentication (最終使用者身份驗證) 下 ，選擇 專員作者 authentication .

  3. 在專員 test 窗格或所需的渠道中發佈和測試體驗。

    設置連接器設置的螢幕擷取畫面。

將流程動作與終端使用者認證搭配使用

可以將流程動作設定為使用終端使用者認證。 在支持的管道中使用流程不需要在專員對話框中進行特殊配置，並且用戶能夠在 提供的體驗中管理其與給定流程的連接 。

基於程式庫中外掛程式的動作驗證

基於 AI 外掛程式建立時，動作需要驗證才能正常運作。 這種情況最常見於基於提示或其他呼叫 Dataverse API 的動作。 基於外掛程式的操作始終在使用者上下文中運行，除非啟用身份驗證，否則無法運行。 支援兩種類型的身份驗證方法：

  • 集成身份驗證（Teams 和 Power Apps）：如果要將專員發佈到 Teams 頻道，可以使用此身份驗證方法。 此方法也適用於嵌入在使用 Power Platform PPAPI 標準構建的令牌的任何應用程式中的代理。

  • 手動身份驗證 (第三方代理)：此身份驗證方法涉及 ID 連接的設置 Microsoft Entra 。

若要建立手動身份驗證連線：

  1. 設定 Microsoft Entra ID 應用程式。

  2. 為您的 專員設置手動身份驗證 。

  3. 允許您的應用程式使用委派代表使用者取得權杖。 請務必添加任何必要的範圍。

    身份驗證設置的屏幕截圖。