對自訂副手使用動作 (預覽版)

您可以透過新增一個或多個動作來擴充副手的功能。 您的副手使用生成動作自動回應使用者,或者您可以從主題中明確地呼叫它們。

[本文章是發行前版本文件,隨時可能變更。]

核心動作類型

如果打開生成模式,副手可以自動選擇最合適的動作或主題,以在執行階段回應使用者。

在傳統模式下,副手只能使用主題來回應使用者。 但是,您仍然可以將副手設計為從主題中明確呼叫動作。

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

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

重要

您不能將在 Copilot Studio 中建立的對話動作當做自訂副手的動作。

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

動作可以使用動作的結果生成對使用者查詢的上下文回應。 或者,您可以明確撰寫該動作的回應。

提示

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

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

新增動作

  1. 透過在左側導覽窗格中選擇副手,並從清單中選擇您的副手來打開自訂副手。

  2. 選擇動作以查看副手的動作。

  3. 選取 + 新增動作

  4. 選擇動作 (預覽版) 精靈中,搜尋並選擇您要使用的操作。

    顯示的預設清單包含您環境中可用的 Power Automate 流程和自訂連接器。 此清單包括向您副手註冊的常用預建連接器和 Bot Framework 技能。

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

    重要

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

    連線頁面的螢幕擷取畫面。

    根據操作,您的連線會自動設定,如範例所示。 或者,如果精靈中有顯示說明,則需要設定連線。 成功設定連線後,請選取下一步

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

  5. 請檢視並根據需要變更外掛程式動作設定。 選擇完成將動作新增至您的副手。

    選取下一步

呼叫動作

如果您啟用了生成動作,則會自動呼叫您的動作以回應相關使用者查詢。

或者,您可以從主題中明確呼叫動作

測試您的動作

呼叫動作

您的副手會根據名稱和描述選擇並執行您的動作。 您可以撰寫高品質的描述,使用專用追蹤模式查看副手從生成動作頁面選擇了哪些動作。

或者,如果您已將動作新增到主題,則可以透過輸入類似於該主題其中一個觸發字詞的訊息來進行測試。

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

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

或者,如果您向主題新增了動作,則可以透過使用合適的觸發字詞觸發主題來進行測試。

設定動作的輸入和輸出

變更動作設定

有多種方法可以設定您的動作。 在動作精靈的最後一步 (稱為檢閱並完成) 中,您可以透過按一下相應區段旁邊的編輯來變更動作的設定。

動作詳細資料

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

每個輸入的顯示名稱描述屬性可幫助副手了解輸入的目的,為使用者生成適當的問題,並識別使用者回應中正確的值。 例如,以下是 MSN Weather 連接器位置輸入參數的預設名稱和描述。

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

當向使用者詢問位置時,副手會生成類似以下的問題,您想查看哪個位置的天氣?您可以輸入縣/市、地區、州/省、國家/地區、地標或郵遞區號。

您可以根據收集的輸入將識別為選項變更為特定實體類型,這可以幫助副手從使用者的回應中準確提取值。

預設情況下,每個輸入都設定為動態填入最佳選項。 副手會嘗試從可用上下文中填入值,例如從使用者的訊息中提取值。 如果沒有找到合適的值,它會產生一個問題來詢問使用者一個值。 您可以用值覆寫輸入,而不用詢問使用者。 若要覆寫,請將副手將如何填入此輸入?下拉式清單變更為設定為值,然後輸入值。 該值可以是文字值、現有變數或 Power Fx 公式。

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

若要控制副手在詢問數值或驗證使用者答案時的行為,您可以為輸入設定其他設定

輸出

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

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

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

從主題中呼叫動作

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

若要從主題中呼叫動作:

  1. 在 Copilot Studio 中,移至您要編輯之副手的主題頁面。

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

  3. 新增下列觸發字詞

    • 會下雨嗎
    • 今日預報
    • 取得天氣
    • 天氣如何

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

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

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

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

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

  6. 選取儲存

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

預設情況下,當您的動作執行時,您的副手會為使用者生成問題以填寫所需的輸入。 但您可能會想要覆寫一或多個輸入並提供明確的值,而不是詢問使用者。 您可以在輸入區段中的外掛程式動作設定中進行覆寫。 或者,您可以僅在特定主題使用您的動作時覆寫值:

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

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

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

    輸入單位已覆寫的螢幕擷取畫面。

現在,此輸入已覆寫,副手將不會要求使用者提供值。

啟用 AI 動作驗證

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

動作始終在終端使用者內容中的 Microsoft Copilot 執行階段執行,除非啟用驗證,否則無法執行。 支援兩種類型的身份驗證方法:

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

  2. 終端使用者驗證下,選擇 Copilot 作者驗證

  3. 在副手測試窗格或所需管道中發佈和測試體驗。

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

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

可以將流程動作設定為使用終端使用者認證。 如果您在支援的管道中使用流程,則不需要在副手對話方塊中進行特殊設定,終端使用者將能夠在提供的體驗中針對指定流程管理其連線

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

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

  • 整合驗證 (Teams 和 Power Apps):如果要將副手發佈到 Teams 頻道,可以使用此驗證方法。 此方法也適用於嵌入任何使用透過 PPAPI 標準建置的權杖的 Power Platform 應用程式中的副手。

  • 手動驗證 (協力廠商副手):此驗證方法涉及 Microsoft Entra ID 連線設定。

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

  1. 設定 Microsoft Entra ID 應用程式

  2. 為您的 Copilot Studio 副手設定手動身證

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

    驗證設定