Note
本文說明由標準執行架構驅動的 Agent 或 Agent 流程中所使用的功能。
對於採用生成式協調流程的 Agent，預設主題觸發程序為 Agent 選擇。 當 Agent 判定主題名稱與觸發節點指定的描述，與使用者傳入訊息相符時，此觸發程序即啟動。
對於採用傳統協調流程的 Agent，預設主題觸發程序為使用者說出特定字詞。 當使用者傳入訊息與指定觸發字詞高度吻合時，此觸發程序即啟動。 了解更多關於 設計有效觸發詞的文章。 另有其他觸發程序類型可決定主題執行時機。
先決條件
熟悉 創作與編輯主題。
觸發類型
觸發程序可讓您的 Agent 攔截和處理不同類型的不同事件或傳入活動。 以下觸發類型決定主題何時觸發。
Tip
當使用者向 Agent 傳送訊息時，承載是活動類型的訊息。 根據聊天或其他事件中發生的情況，Agent 可以接收其他類型的活動。
例如 Microsoft Teams 會發送隱藏式呼叫活動，此類活動代表使用者操作行為 (如與訊息擴充功能互動)。
| 類型 | Description |
|---|---|
| 代理選擇 | 適用於使用生成式協調流程的代理。 當代理程式判斷到 觸發節點 上指定的主題名稱與描述與使用者傳入的訊息相符時，事件會被觸發。 |
| 使用者說出一句話 | 適用於使用傳統協調流程的 Agent。 當一個或多個觸發詞與使用者收到的訊息相符時，會觸發。 |
| 收到訊息 | 收到消息活動 (最常見的活動類型) 時引發。 當使用者輸入或對代理人說某事時收到。 |
| 發生自訂用戶端事件 | 收到事件活動時引發。 預設情況下，所有事件活動都會得到回應。 使用觸發程序屬性中的事件名稱屬性來篩選特定事件。 |
| 活動發生 | 收到任何類型的活動時引發。 您可以選擇設定觸發程序屬性中的活動類型屬性來篩選特定的活動類型。 |
| 對話內容變更 | 當收到對話更新事件時觸發。 例如，當使用者加入交談時，Teams 會傳送此類活動。 |
| 已叫用 | 收到叫用活動時引發。 最常從 Teams 頻道接收，例如，當使用者與 Teams 中的訊息或搜尋延伸模塊互動時。 |
| 它已重新導向到 | 當主題由另一個主題明確呼叫時引發。 使用觸發程序屬性中的無活動持續時間屬性設定所需的無活動時間。 |
| 該使用者有一段時間處於非使用中狀態 | 當使用者在設定的一段時間內未與代理互動時，會觸發。 在 非活動觸發器 中了解更多。 |
| 計畫已完成 | 適用於使用生成式協調流程的代理。 當 Agent 完成執行所有預定步驟以回應使用者查詢或自主觸發時引發。 |
| AI 產生的回應即將被傳送 | 適用於使用生成式協調流程的代理。 當 Agent 在呼叫一個或多個主題、工具或知識來源後，為使用者產生回應時引發。 使用 Response.FormattedText 系統變數來查看產生的回應。 若要防止發送協調處理回應（即如果您修改訊息並使用ContinueResponse節點自行發送訊息），請將變數設為 false。 |
變更主題的觸發條件
前往 Agent 的主題頁面，開啟所需主題。
將滑鼠懸停在觸發程序節點的方塊上，然後選擇變更觸發程序圖示。
為您的主題選擇適當的觸發程序類型。
- 針對 Agent 選擇觸發程序，請描述 Agent 應何時使用此主題。
- 針對使用者說出特定字詞觸發程序，請輸入所需的觸發字詞。
在觸發框上選擇編輯。 出現指定觸發程序類型的屬性面板。
為您的觸發器設定相關屬性：
觸發條件
指定觸發必須滿足的條件。 例如，您可能希望觸發程序只有在員工使用的管道為 Microsoft Teams 時才引發。
如果你需要更複雜的條件，可以切換到 Power Fx 公式編輯器：先選擇 建構者 ，再選擇 公式。
觸發優先順序
單一傳入活動（例如訊息）可以觸發多個觸發器。 觸發類型決定觸發順序。
執行順序：
- 活動發生
- 收到訊息時 / 發生自訂客戶端事件時 / 對話內容變更時 / 已叫用
- 代理選擇 / 使用者說出一句話
若存在多個相同類型的合格觸發程序，系統將依建立時間順序 (由舊至新) 執行觸發程序。
您可以設定優先順序屬性來明確確定執行順序。