在 Copilot Studio 中使用外掛程式動作 (預覽版)
重要
在對生成式 AI 進行大量投資並增強 Microsoft Copilot 的整合後,Power Virtual Agents 的功能和特性現已成為 Microsoft Copilot Studio 的一部分。
當我們更新文件和培訓內容時,某些文章和螢幕擷取畫面可能會參考 Power Virtual Agents。
您可以透過新增一個或多個外掛程式動作來擴充副手的功能。 您的副手會使用外掛程式動作自動回應使用者 (使用生成式動作),或者您可以從主題中明確呼叫它們。
[本文章是發行前版本文件,隨時可能變更。]
核心外掛程式動作類型
外掛程式動作是根據以下其中一種核心動作類型而定:
- 預建連接器動作
- 自訂連接器動作
- Power Automate 雲端流程
- Bot Framework 技能
重要
您無法將在 Copilot Studio 中建立的交談外掛程式當作外掛程式動作使用。
每個核心動作都有描述其目的的附加資訊,可讓副手使用 GPT 產生問題。 需要這些問題來填寫執行動作所需的輸入。 因此,您無需手動建立問題節點來收集所需的所有輸入 (例如流程上的輸入)。 輸入會在執行階段處理。
外掛程式動作可以使用動作結果產生與使用者查詢上下文相關的回應。 或者,您可以明確地為外掛程式動作建立回應。
新增外掛程式動作
打開您的副手,然後在導覽窗格中選擇主題和外掛程式。
選取 + 建立。
選取外掛程式動作 (預覽版)。
在新增動作 (預覽版)精靈中,搜尋並選擇要使用的外掛程式動作。
顯示的預設清單包含您環境中可用的 Power Automate 流程和自訂連接器。 此清單包括向您副手註冊的常用預建連接器和 Bot Framework 技能。 如需詳細資訊,請參閱為 Microsoft Copilot 建立 AI 外掛程式 (預覽版)。
重要
由 AI 外掛程式建立的某些外掛程式動作 (例如動態提示和基於 Dataverse API 的動作) 需要 驗證才能正常運作。
設定動作的連線。
您的連線會根據不同的外掛程式自動設定,如範例所示。 或者,如果精靈中有顯示說明,則需要設定連線。 成功設定連線後,請選取下一步。
請檢視並根據需要變更外掛程式動作設定。 選擇完成以將外掛程式動作新增至您的副手。
呼叫外掛程式動作
如果您啟用了生成式動作,則會自動呼叫您的外掛程式動作來回應相關的使用者查詢。
或者,您可以從主題中明確呼叫外掛程式動作。
測試您的外掛程式動作
使用測試聊天向副手詢問相關問題。 您可以切換 (顯示或隱藏) 導覽功能表底部的聊天窗格檢視。
您的副手會根據名稱和描述選擇並執行您的外掛程式動作。 您可以從生成式動作頁面中瞭解如何撰寫高品質的描述,以及使用專用追蹤模式查看副手選擇了哪些外掛程式動作。
或者,如果您已為主題新增了外掛程式動作,則可以輸入類似於該主題觸發短語之一的訊息來進行測試。
您可以在此螢幕擷取畫面中看到正在進行測試的天氣外掛程式動作:
GPT 導向的對話比傳統編寫的問題更流暢。 使用者可以在一輪中回答多個問題或修正他們先前輸入的值。
在此範例中,您可以看到副手使用者第一次選擇確認佛羅裡達州奧蘭多的天氣,但隨後在確認階段,他們表示想要將位置變更為西雅圖。 可隨時變更輸入值,而不僅僅是在確認階段。
變更外掛程式動作設定
您可以透過多種方式設定外掛程式動作。 在外掛程式動作精靈的最後一步 (稱為檢閱並完成) 中,您可以透過點擊對應區段旁邊的編輯來變更外掛程式動作設定。
動作詳細資料
您可以在此處設定有關動作的詳細資訊,包括外掛程式動作的模型顯示名稱和模型描述。 通常,名稱和描述會根據您選取的動作預先填入。
在此頁面上,您可以選取執行此動作之前詢問使用者核取方塊,這對於為使用者進行變更的動作非常有用,例如在資料表中插入或更新記錄。
輸入
您可以在輸入區段管理動作中每個輸入的顯示名稱和描述。 名稱和描述可幫助副手向使用者提出問題。 例如,位置輸入產生的問題可能是:您想要檢查天氣的位置是什麼?您可以輸入城市、州、國家/地區、地標或郵遞區號
您可以根據收集的輸入將識別為選項變更為特定實體類型,這可以幫助副手從使用者的回應中準確提取值。
預設情況下,每個輸入都設定為動態填入最佳選項。 副手會嘗試從可用上下文中填入值,例如從使用者的訊息中提取值。 如果沒有找到合適的值,它會產生一個問題來詢問使用者一個值。 您可以用值覆寫輸入,而不用詢問使用者。 若要覆寫,請將副手將如何填入此輸入?下拉式清單變更為設定為值,然後輸入值。 該值可以是文字值、現有變數或 Power Fx 公式。
輸出
根據預設,您的外掛程式動作設定為根據使用者的查詢和動作結果自動為使用者產生關聯式回應。 例如,如果使用者詢問「倫敦目前氣溫是多少?」,則系統會使用 GPT 產生與上下文相關的回覆,例如「倫敦目前溫度為攝氏 9 度」。
或者,您可以選擇為要傳回的外掛程式動作編寫特定回應。 和確認編輯器一樣,您可以使用變數選擇器插入動作中輸出變數的參考,如本範例所示。
從主題中呼叫外掛程式動作
您可以從主題內明確呼叫外掛程式動作,就像呼叫 Power Automate 流程等其他動作類型一樣。 根據您的使用案例,您可以將流程當作使用更多節點的更大主題的一部分使用。 或者,就像在天氣範例中那樣,您可能只需要將單一外掛程式動作節點新增至主題即可。
若要從主題中呼叫外掛程式動作:
在 Microsoft Copilot Studio 中,移至您要編輯之副手的主題頁面。
建立新的主題,並將它命名為取得天氣。
新增下列觸發字詞:
- 會下雨嗎
- 今日預報
- 取得天氣
- 天氣如何
選取新增節點 (+),然後選取呼叫動作。 切換至外掛程式動作 (預覽版) 索引標籤,然後選取先前建立的外掛程式動作,取得天氣預報。
您的外掛程式動作 (預覽版) 節點現在已新增至主題。
選取儲存。
從主題呼叫外掛程式動作時覆寫輸入
根據預設,當外掛程式動作執行時,您的副手會產生問題供使用者填入所需的輸入。 但您可能會想要覆寫一或多個輸入並提供明確的值,而不是詢問使用者。 您可以在輸入區段中的外掛程式動作設定中進行覆寫。 或者,僅當從特定的主題使用外掛程式動作時,您才可以覆寫值:
請選取節點上的設定值,並選取想要覆寫的輸入。
透過鍵入值、選擇變數或使用公式來輸入輸入值。
現在,此輸入已覆寫,副手將不會要求使用者提供值。
啟用 AI 外掛程式驗證
某些由 AI 外掛程式建立的外掛程式動作需要身份驗證才能正常運作,例如動態提示或呼叫 Dataverse API 的其他動作。
外掛程式總是在終端使用者內容中的 Microsoft Copilot 執行階段中執行,除非啟用驗證,否則無法執行。 支援兩種類型的身份驗證方法:
整合式驗證 (Teams 和 Power Apps):如果您的副手位於 Teams 管道,則可以採用此驗證設定。 該設定還可以與任何使用 PPAPI 標準構建之權杖的 Power Platform 應用程式中的嵌入式副手配合使用。
手動身份驗證 (第三方副手):此身份驗證方法涉及 Entra ID 連線的設定。
若要建立手動身份驗證連線:
設定未設定的 Entra ID 應用程式。
允許您的應用程式使用委派代表使用者取得權杖。 請務必添加任何必要的範圍。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應