事件觸發程序概觀

您可以設定自訂代理程式來執行操作或呼叫主題以回應使用事件觸發程序發生的事情。與需要使用者輸入的主題觸發程序不同，事件觸發程序可讓您的代理程式自主採取行動以回應發生的已定義事件。

事件觸發程序如何運作

事件觸發程序需要一個選定的事件，該事件會產生觸發程序酬載並透過連接器將其傳送到代理程式。 酬載包含有關事件的資訊，包括特定類型資料的變數。 當代理程式收到酬載時，它會執行代理程式作者在代理程式指令中提供的指示以及透過觸發酬載發送的指令。

代理程式僅根據其作者的設計和指示行事。 例如，您可以在新增團隊成員時新增觸發程序，並將回應指定為向新員工發送包含入職資源的歡迎訊息的操作。

事件觸發程序根據代理程式外部的事件啟動。 它們與主題觸發程序不同，主題觸發程序用於根據使用者輸入的觸發字詞啟動主題或操作。

本文介紹了事件觸發程序的工作原理、其限制以及疑難排解原則。 有關新增事件觸發程序的更多資訊，請參閱新增事件觸發程序。

事件觸發程序的其他範例包括：

• 在 SharePoint 中建立專案時
• 在 OneDrive 中建立檔案時
• 當 Planner 中的工作完成時
• 設定的時間量 (重複觸發程序)

事件觸發程序的計費和使用情況

事件觸發活動計入使用和計費的消費單位。 訊息被定義為發送給代理程式的任何請求或訊息，用於觸發代理程式的動作或回應。 這包括從事件觸發程序發送給代理程式的有效載荷。 例如，設定為每 10 分鐘啟動一次的重複觸發程序每 10 分鐘會將觸發程序承載作為訊息傳送給代理程式一次。

如需詳細資訊，請移至 計費費率和管理。

觸發程序工作流程

觸發程序是包含多個部分的工作流程的一部分：

1. 事件觸發程序記錄特定事件的發生。
2. 觸發程序發送包含有關事件和指令的資訊的酬載。
3. 代理程式根據指令根據負載選擇一個或多個操作或主題。

找到適合您的活動的觸發程序

Copilot Studio 擁有一個觸發程序庫，適用於 Microsoft 和合作夥伴服務中可能發生的一系列事件。 觸發程序設定決定啟動觸發程序的事件的參數。 它還決定觸發負載的內容。

大多數觸發程序可讓您指定有關啟動觸發程序的事件的參數。 例如，在新增、修改或刪除行時觸發程序中，您可以選擇哪個表的變更啟動 Dataverse 觸發程序。

定義觸發負載

觸發程序承載是包含有關事件的資訊的 JSON 或純文字訊息，並以訊息的形式傳送給您的代理程式。 新增觸發程序時，您可以保留該觸發程序的預設負載內容，或新增您自己的指令。 稍後，您可以修改酬載內容，包括在 Power Automate 中新增變數和字串運算子。

例如，新增、修改或刪除行時觸發程序中的預設訊息是使用來自 Body 的內容。 當代理程式收到酬載時，它具有該行的內容以及使用該內容的說明。

您可以在酬載內新增發送給代理程式的指令，指導代理程式在被觸發程序啟動時如何採取行動。 如果您有多個觸發程序，則每個觸發程序承載都可以有具體而詳細的說明。 因此，您可以避免在代理程式的一般指示中寫下冗長而複雜的指導，或者讓代理程式對哪些指示適用於哪些觸發程序感到困惑。

例如，在新增、修改或刪除行時觸發負載中，您可以新增傳送聊天中變更的摘要。 當代理程式收到酬載時，它會總結代理程式聊天中使用者的變更。

但是，請避免編寫與代理程式的一般指令相衝突的酬載指令。 指令衝突可能會導致錯誤或意外結果。 確保測試涉及事件觸發程序的所有變更。

建立觸發程序後，您可以新增或變更觸發程序負載中的變數或字串運算子，並使用 Power Automate 修改現有負載指令。

代理程式指令與酬載指令

酬載指令特定於如何對一個事件做出反應。 您還可以使用代理程式指令來指導代理程式如何處理來自觸發程序的資訊以及在收到觸發程序酬載時如何採取行動，以及確定代理程式的一般行為。 例如，對於檢查新 Dataverse 表行中重複帳戶名稱的代理程式，說明可以是：新增行時，檢查它是否為重複帳戶。如果存在重複項，請建立待辦事項工作進行調查，並包含有關變更和重複項的詳細資訊。

然而，代理程式指令可能不適合所有情況。 如果您的代理程式有多個觸發程序或多個複雜目標，您應該使用觸發程序酬載中的指令。

繼續上一個範例，您可以在觸發程序酬載中新增一條指令，以在同一 Dataverse 表中尋找重複的帳戶名稱。當代理程式收到酬載時，系統會指示它尋找重複的帳戶名稱。 然後，代理程式的一般說明會說：如果存在重複項，請建立待辦事項工作進行調查，並包含有關變更和重複項的詳細資訊。

為代理程式建立指令需要練習。 請參閱撰寫指南以取得更多提示，並始終測試您對代理程式所做的所有變更。

調用操作或主題

當代理程式收到觸發負載時，您提供的指令將根據其掌握的資訊確定其回應呼叫的操作或主題。

您的代理程式不會當場建立新的操作或主題。 作為代理程式作者，您需要定義它可以選擇的操作或主題。 若要了解您的代理程式如何確定要呼叫哪個操作或主題，請前往生成式協調流程如何運作？

如果您的代理程式沒有按預期做出反應，您可以使用活動圖來查看它是否缺少任何關鍵輸入資訊。

您可以對說明進行的一些改進包括：

• 在觸發程序酬載或代理程式指令中新增更詳細的指令。 您的代理程式可能需要更多指導，例如在特定輸入欄位中使用哪些資訊來執行操作。
• 在觸發負載中包含指令。
• 指示您的代理程式調用特定操作或主題。
• 檢查觸發程序酬載和代理程式指令之間的衝突指令。
• 新增操作的描述，以便代理程式有更多資訊來確定何時調用它。
• 在操作輸入欄位中新增描述，以協助您的代理程式正確填寫參數。 如果某個操作的輸入每次都相同，您可以自行設定該值。
• 連續調用少於 15 個操作或主題。 將許多動作或主題作為單一序列執行的複雜代理程式可能難以可靠地執行它們。

如果您的代理程式仍然難以呼叫預期操作，請考慮新增一個可實現您目標的 Power Automate 流程作為代理程式的動作。

具有事件觸發程序的發佈代理程式

在您發佈具有新事件觸發程序的代理程式之前，代理程式不會自動對該觸發程序做出反應。 確保在發佈之前徹底測試代理程式，因為在發佈具有新觸發程序的代理程式後，每次啟動觸發程序時，代理程式都會自動做出反應。 您可以在 活動 頁面中查看代理的觸發和反應的逐步記錄。

有關在測試期間啟動觸發程序的資訊，請前往測試觸發程序。

事件觸發程序只能使用代理程式製作者的憑證 (即您用於授權連線的憑證) 對您的觸發程序進行驗證。 這可能允許代理程式的使用者使用代理程式使用相同授權存取資料和系統。 有關更多資訊，請前往疑難排解和限制。

發佈後驗證操作

如果您的代理程式缺少執行操作的驗證或設定為請求使用者驗證，它會向使用者發送一條訊息，要求提供憑證。 如果代理程式的流程因無法接收訊息或操作失敗而中斷，則無法繼續工作階段。 如果您希望代理程式自主執行，則每個動作都必須設定不需要使用者輸入的有效製作者驗證。 您也可以指示您的代理程式不要向使用者請求憑證。

由於觸發程序使用製作者驗證，因此請注意潛在使用者可以透過具有觸發程序的已發佈代理程式存取哪些資料。 有關詳細資訊，請參閱使用觸發程序的資料保護部分。

疑難排解和限制

配額限制

如果觸發程序啟動過於頻繁，那麼您的代理程式最終可能會使用比預期更多的資源。 然後，您的代理程式可能會超出服務負載配額限制，並且您的服務可能會受到限制。

管理員可以透過 Power Platform 監控資源使用情況。 它們還可以阻止事件觸發程序在環境中使用。

為避免超出配額限制：

• 在新增非常頻繁的觸發程序或無限期重複的觸發程序時要小心。 例如，每當經過設定的時間量時，重複觸發程序就會啟動。 啟動之間的時間越短，觸發程序使用的資源就越多。
• 追蹤環境中有多少個觸發程序處於活動狀態。

具有觸發程序的代理程式的資料保護

目前，事件觸發程序只能使用代理程式作者的憑證進行驗證。 同樣，為了使代理程式能夠自主執行，所有需要驗證的觸發程序和動作都必須使用製作者的憑證。

如果您發佈具有經過驗證的事件觸發程序的代理程式，使用者可能能夠存取資訊或提示代理程式使用作者的憑證執行動作。 如果建立者使用經過驗證的事件觸發程序設定代理程式，則會在發佈代理程式之前提醒他們注意這一限制。

觸發程序承載可能包含代理程式可以透過動作在其他位置輸出的敏感資訊。 例如，如果您建立了一個代理程式，請使用傳入電子郵件的資訊來填入 Dataverse 表中的新資料列。

管理員可以禁止 Copilot Studio 使用者與其代理程式使用事件觸發程序。 有關詳細資訊，請參閱禁止事件觸發程序。

資料保護最佳做法

為了幫助防止使用者存取敏感資料：

• 評估具有事件觸發程序的代理程式是否以及如何使用需要驗證的資料和系統。
• 透過測試了解觸發程序的有效載荷中可能包含哪些訊息，以及使用這些有效載荷輸入輸出哪些資訊動作。
• 使用觸發程序參數縮小啟動觸發程序的範圍，並向代理程式提供如何處理承載資料的指令。

必須打開解決方案感知雲端流程共用

製作者只能在啟用了解決方案感知雲端流程共用的環境中，向代理程式新增事件觸發程序。

如果您無法新增觸發程序，且組織的資料 原則允許觸發程序，則您的環境可能會關閉此選項。 聯絡您環境的管理員，以開啟解決方案感知雲端共用。

對連接器問題進行疑難排解

代理程式可能無法成功執行每個連接器。 如果代理程式多次無法呼叫連接器，請考慮建立 Power Automate 流程操作，使用有問題的連接器來完成操作。