共用方式為


新增事件觸發程序 (預覽版)

事件觸發程序可讓您的代理程式在其他系統中發生事件時自動做出反應。 然後,您可以定義代理程式要採取的回應的特定動作流程,或向代理程式提供如何確定要採取的最佳動作的說明。

重要

啟用事件觸發程序可能會影響帳單的計算方式。 進一步了解生成式模式計費

有關事件觸發程序如何運作以及與代理程式的其他元件相關的深入指導,請前往事件觸發程序概觀

注意

此功能僅適用於啟用了生成式協調流程的代理程式。

若要將事件觸發程序新增至您的代理程式:

  1. 在代理程式的概觀頁面上,轉到觸發程序區段。

  2. 選擇新增觸發程序 概觀頁面中觸發程序面板的螢幕擷取畫面。

  3. 選擇所需的觸發程序。

  4. 如有必要,請提供您的驗證詳細資訊。

  5. 選取下一步

    注意

    您只能使用代理程式建立者的帳戶 (代理程式作者驗證) 來驗證觸發程序連接器。 您只能根據您作為代理程式作者有權存取的系統中的事件為代理程式設定觸發程序。 有關詳細資訊,請參閱事件觸發程序限制

  6. 根據需要設定觸發程序並定義啟動觸發程序和觸發程序承載的事件參數。 觸發程序提供預設承載內容,但您可以新增自己的內容和說明。 有關更多資訊,請前往定義觸發程序承載

為了使代理程式對事件觸發程序做出反應,代理程式需要在其回應中呼叫動作或主題,以及呼叫哪些動作或主題的說明。 有關更多資訊,請參閱呼叫動作或主題

測試觸發程序

在發佈之前始終測試觸發程序及其反應。 您可以使用測試代理程式聊天來測試代理程式對已定義觸發程序的反應。

透過新的觸發程序發佈代理程式之前,代理程式不會自動對觸發程序做出反應。 相反,您必須透過選擇發送給代理程式的觸發承載來手動啟動代理程式。

  1. 執行一次觸發事件以產生承載。 例如,如果使用 Microsoft Planner 觸發程序當為我指派 Microsoft Planner 的新工作時,請在 Microsoft Planner 中向您自己指派測試工作以啟動觸發程序。
  2. 在代理程式的概觀頁面中選擇觸發程序旁邊的測試觸發程序圖示。 此清單包括該事件的所有最近執行個體。
  3. 選擇要測試的執行個體,然後選擇開始測試 顯示要選擇的測試承載的螢幕擷取畫面。

您可以使用活動地圖來查看代理程式在測試期間對觸發程序承載的反應。 若要開啟活動地圖,請選擇測試窗格頂部的地圖圖示

修改觸發程序

建立觸發程序後,您可以透過 Power Automate 變更事件參數和承載。 若要從 Copilot Studio 開啟觸發程序:

  1. 概觀頁面中,找到觸發程序。
  2. 選擇「更多」圖示 (...),然後選擇在 Power Automate 中開啟 如何開啟 Power Automate 以編輯觸發程序的螢幕擷取畫面。
  3. 選擇觸發程序,然後轉到參數代碼索引標籤進行變更。 有關可以新增哪些變數和字串運算子的資訊,請前往關於索引標籤。
  4. 進行並儲存您的變更。 有關在 Power Automate 中進行變更的更多資訊,請前往 Power Automate 中的觸發程序入門

發佈帶有觸發程序的代理程式

發佈帶有事件觸發程序的代理程式後,每次啟動代理程式的觸發程序時,它都會自動做出反應。 您可以在活動頁面中查看代理程式的觸發和反應的逐步記錄。

事件觸發程序只能使用代理程式作者的憑證進行驗證 (即您用於授權連線的憑證)。 這可以允許代理程式使用者在未經授權的情況下存取他們不應該存取的資料和系統。 有關更多資訊,請前往疑難排解和限制