設置主題觸發器

註

本文描述由 標準線束驅動的代理或代理流程中使用的功能。

對於採用生成式協調流程的 Agent,預設主題觸發程序為 Agent 選擇。 當 Agent 判定主題名稱與觸發節點指定的描述,與使用者傳入訊息相符時,此觸發程序即啟動。

對於採用傳統協調流程的 Agent,預設主題觸發程序為使用者說出特定字詞。 當使用者傳入訊息與指定觸發字詞高度吻合時,此觸發程序即啟動。 了解更多關於 設計有效觸發詞的文章。

另有其他觸發程序類型可決定主題執行時機。

Prerequisites

熟悉 創作與編輯主題。

觸發類型

主題觸發器使您的代理程式能夠攔截並處理不同類型的事件或傳入活動。 以下觸發類型決定主題何時觸發。

Tip

當使用者向 Agent 傳送訊息時,承載是活動類型的訊息。 根據聊天或其他事件中發生的情況,Agent 可以接收其他類型的活動。

例如 Microsoft Teams 會發送隱藏式呼叫活動,此類活動代表使用者操作行為 (如與訊息擴充功能互動)。

類型 描述
代理選擇 適用於使用生成式協調流程的代理。 當代理程式判斷到 觸發節點 上指定的主題名稱與描述與使用者傳入的訊息相符時,事件會被觸發。
使用者說出一句話 適用於使用傳統協調流程的 Agent。 當一個或多個觸發詞與使用者收到的訊息相符時,會觸發。
收到訊息 收到消息活動 (最常見的活動類型) 時觸發。 當使用者輸入或對代理人說某事時收到。
發生自訂用戶端事件 收到任何事件活動時觸發。 預設情況下,所有事件活動都會得到回應。 使用觸發程序屬性中的事件名稱屬性來篩選特定事件。
活動發生 當收到任何類型的活動時觸發。 您可以選擇設定觸發程序屬性中的活動類型屬性來篩選特定的活動類型。
對話內容變更 當收到對話更新事件時觸發。 例如,當使用者加入交談時,Teams 會傳送此類活動。
已叫用 收到呼叫活動時觸發。 最常從 Teams 頻道接收,例如,當使用者與 Teams 中的訊息或搜尋延伸模塊互動時。
它已重新導向到 當另一個主題明確呼叫此主題時會觸發。 使用觸發程序屬性中的無活動持續時間屬性設定所需的無活動時間。
該使用者有一段時間處於非使用中狀態 當使用者在設定的一段時間內未與代理程式互動時,會觸發事件。
計畫已完成 適用於使用生成式協調流程的代理。 當 Agent 完成執行所有預定步驟以回應使用者查詢或自主觸發時觸發。
AI 產生的回應即將被傳送 適用於使用生成式協調流程的代理。 當 Agent 在呼叫一個或多個主題、工具或知識來源後,為使用者產生回應時,會觸發。 使用 Response.FormattedText 系統變數來查看產生的回應。 若要防止發送協調處理回應(即如果您修改訊息並使用ContinueResponse節點自行發送訊息),請將變數設為 false。

變更主題的觸發條件

  1. 前往 Agent 的主題頁面,開啟所需主題。

  2. 將滑鼠移至 觸發 節點的方框上,選取 變更觸發器 圖示。

    螢幕截圖顯示觸發節點上「變更觸發器」圖示的位置。

  3. 為您的主題選擇適當的觸發程序類型。

  4. 針對 Agent 選擇觸發程序,請描述 Agent 應何時使用此主題。

  5. 選取觸發節點的三個點(...),然後選擇屬性。 出現指定觸發程序類型的屬性面板。

  6. 為您的主題觸發器設定適用的屬性:

短語

在使用經典編排的代理程式中,請指定片語以觸發設定為「 使用者說某片語 」觸發器的主題。

  1. 在已識別意圖屬性中,選擇片語區域。 此時將顯示字詞輔助面板。

  2. 在新增字詞下,輸入主題的觸發字詞。

    您的 Agent 需要 5 到 10 個觸發字詞來訓練 AI 理解客戶的反應。 若要新增更多觸發字詞,您可以:

    • 選取文字欄位旁的 「新增 」圖示 ,然後輸入您想要的片語。
    • 貼上一組觸發字詞 (每個觸發字詞佔一行),然後選擇輸入。
    • 輸入一組觸發字詞,在每個觸發字詞後按 Shift+Enter,以將其放在單獨一行上,然後選取 Enter。
    • 上傳檔案,列出您想為此主題新增的觸發詞句。

    您可以在觸發字詞中包括標點符號,但最好使用短語句而不是長句子。 了解更多關於 設計有效觸發詞的文章。

上傳主題的觸發字詞

從主題觸發節點的字詞面板中,您可以新增或取代與該主題相關的觸發字詞集。

  1. 準備一個文字檔案 (最大 3 MB),列出您想要為主題新增的所有觸發字詞,每個字詞佔一行。

  2. 在新增字詞下,選擇上傳檔案。

  3. 在 [上傳檔案] 中,選取所需的選項:

    • 如果您想為您的主題新增新的觸發字詞,請選擇附加。
    • 若要用檔案中的清單取代所有現有的觸發字詞,請選擇替換。
  4. 將檔案拖曳到視窗上。 或者,選擇點擊瀏覽,導覽到您的檔案,然後選擇它。

  5. 檢視出現的觸發詞句,然後選擇 「新增」。

  6. 儲存您的主題。

下載主題的觸發字詞

從主題的觸發節點的字詞面板中,您可以下載與該主題相關的觸發字詞集。

  1. 在新增字詞下,選擇下載。

  2. 儲存產生的文字檔,或在文本編輯器中開啟它以檢閱其內容。 每個觸發字詞都會出現在單獨的行上。

觸發條件

指定觸發必須滿足的條件。 例如,您可能希望僅當員工使用的頻道為 Microsoft Teams 時才觸發觸發程序。

觸發條件的截圖。

如果你需要更複雜的條件,可以切換到 Power Fx 公式編輯器:先選擇 建構者 ,再選擇 公式。

螢幕擷取畫面顯示了前往公式編輯器的選項。

觸發優先順序

單一傳入活動(例如訊息)可以觸發多個觸發器。 觸發類型決定觸發順序。

執行順序:

  1. 活動發生
  2. 收到訊息時 / 發生自訂客戶端事件時 / 對話內容變更時 / 被調用時
  3. 代理程式選擇 / 使用者說出一句話

若存在多個相同類型的合格觸發程序,系統將依建立時間順序 (由舊至新) 執行觸發程序。

您可以設定優先順序屬性來明確確定執行順序。