建立和編輯主題

在 Copilot Studio 中，主題會定義代理程式交談的進展方式。

若要製作主題，您可以自訂提供的範本、從頭開始建立主題或描述您想要的內容，並讓 AI 為您建立主題。

在 Copilot Studio 中，主題表示使用者和代理程式之間交談串的某些部分。 您可以在製作畫布上定義和使用主題。主題包含一個或多個交談節點，其共同定義主題可以採用的交談路徑。 每個節點都會執行一項動作，例如傳送訊息或提出問題。

通常，一個主題有一組觸發字詞，這是客戶可能會輸入的與特定問題相關的字詞、關鍵字或問題。 Copilot Studio 代理程式使用自然語言理解客戶的訊息以及所有主題的觸發字詞，來找到要觸發的最佳主題。 訊息不需要完全符合主題的觸發字詞就能觸發主題。 例如，儲存時數的主題可能包括觸發字詞 check store hours。 如果客戶輸入「查看商店營業時間」，此字詞會觸發您的商店營業時間主題。

必要條件

• 若要建立代理程式，請參閱快速入門：建立和部署代理程式。

自然語言理解

代理程式使用自然語言理解 (NLU) 來解析客戶輸入的內容並找到最佳的觸發字詞或節點。

例如，使用者可能會鍵入「營業時間」。代理程式會將其與商店營業時間主題進行比對，並開始交談，詢問客戶對哪家商店感興趣，然後顯示該商店的營業時間。

測試代理程式窗格會顯示代理程式交談在每個步驟的進展。 您可以使用測試代理程式窗格來微調主題，而無需離開 Copilot Studio。

有關代理程式和主題限制，請參閱配額、限制、應用程式註冊、憑證和設定值。

Copilot Studio 中的主題

Web 應用程式

主題類型

代理程式可以包含兩種類型的主題：系統主題和自訂主題。 每個新代理程式都從一組預先定義的系統和自訂主題開始。

• 系統主題支援基本行為，例如與某人交談或結束交談的自訂要求。 某些系統主題具有觸發字詞，您可以自訂這些觸發字詞以滿足代理程式的需求。

  • 您無法建立系統主題。
  • 您無法刪除系統主題，但可加以停用。
  • 您可以對系統主題進行變更。 但是，在您能夠輕鬆建立完整的代理程式體驗之前，我們不建議編輯系統主題。

  如需詳細資訊，請參閱使用系統主題。

• 預先定義的自訂主題涵蓋常見行為，例如問候客戶、結束對話或重新開始對話。

  • 您可以變更預先定義的自訂主題或將它們從代理程式中完全刪除。
  • 所有您建立的主題都是自訂主題。

節點類型

可以使用以下類型的節點：

選項	Description
傳送訊息	傳送訊息給客戶。
提出問題	向客戶提出問題。
使用調適型卡片詢問	建立 JSON 片段以與其他應用程式交換。
使用條件製作	根據條件將交談分支。
變數管理	設定值、剖析值或清除所有變數。
管理主題	重新導向、轉移或結束主題或交談。
呼叫流程	呼叫類似 Power Automate 或 Excel Online 的流程，或者使用連接器或外掛程式。
進階者	生成式答案、 HTTP 要求、事件等。

提示

重新命名節點以使其更易於識別。 選擇節點的名稱欄位以直接更新名稱，或選擇節點的更多圖示 (...)，並從功能表中選擇重新命名。 您也可以在程式碼編輯器中重新命名節點。

無法重新命名觸發程序節點和前往步驟節點。

節點名稱的長度最多可達 500 個字元。

建立主題

1. 從代理程式頁面上的清單中開啟您的代理程式。 為了獲得更好的可見性，請暫時關閉測試您的代理程式面板。

2. 在頂端功能表列，選取主題。

3. 選取新增主題，然後選取從空白開始。

   觸發程序節點將顯示在創作畫布上，否則為空白主題。

4. 選取觸發程序節點的更多圖示 (...)，然後選取屬性。 將顯示識別的意圖屬性面板。

5. 在辨識意圖屬性面板中，選取字詞區域。 此時將顯示字詞輔助面板。

6. 在新增字詞下，輸入主題的觸發字詞。

   您的代理程式需要 5 到 10 個觸發字詞來訓練 AI 理解客戶的反應。 若要新增更多觸發字詞，您可以：

   • 選取文字欄位旁邊的新增圖示 ，然後輸入所需的字詞。
   • 貼上一組觸發字詞 (每個觸發字詞佔一行)，然後選擇輸入。
   • 輸入一組觸發字詞，在每個觸發字詞後按 Shift+Enter 將其放在單獨的行上，然後選擇輸入。

   您可以在觸發字詞中包括標點符號，但是最好使用短片語而不是長句。

7. 選取工具列上的詳細資料，以開啟主題詳細資料面板。

8. 新增您的代理程式主題詳細資訊：

   • 輸入名稱來識別主題，例如「商店營業時間」。主題頁面會列出您的代理程式中根據此名稱定義的所有主題。
   • 如果需要，請輸入顯示名稱，以便在代理程式無法確定哪個主題與客戶訊息相符時向客戶顯示。
   • 如果需要，請使用描述欄位為您自己和團隊中的其他代理程式製作者描述主題的用途。 客戶永遠不會看到主題描述。

9. 選取頂端功能表列上的儲存以儲存您的主題。

重要

避免在主題名稱中使用句點 (.)。 無法匯出包含任何主題名稱中帶有句點的代理程式的解決方案。

設計主題交談路徑

建立主題時，這會自動在製作畫布上顯示觸發程序節點。 然後，您可以新增不同類型的節點，以實現主題所需的交談路徑。

若要在主題製作畫布上的另一個節點之後或兩個節點之間新增節點，請執行以下操作：

1. 在要新增節點的節點下方，選擇新增節點圖示 。

2. 從顯示的清單中選擇所需的節點類型。

   

刪除節點

選擇要刪除的節點的更多圖示 (...)，然後選擇刪除。

編輯畫布上節點的控制項

您可以使用工具列中的控制項，剪下、複製、貼上和刪除選取的節點或選取的相鄰節點。

工具列還有一個用於復原編輯的控制項。 開啟復原功能表，將所有動作還原到上次儲存或重做先前的動作。

貼上節點

使用剪下或複製工具將一個或多個節點放置到剪貼簿後，有兩種方法可將它們貼到畫布中：

• 如果選取節點，然後選取貼上，就會在選取的節點之後插入剪貼簿中的節點。

• 如果您選取 + 查看新增節點功能表，然後選取 貼上，則剪貼簿上的節點將插入到那個位置。

為主題新增輸入和輸出參數

主題可以有輸入和輸出參數。 當主題重新導向到另一個主題時，您可以使用這些參數在主題之間傳遞資訊。

此外，如果您的代理程式使用生成式模式，它可以自動填入交談上下文中的主題輸入，或在生成問題後從使用者收集值。 此行為類似於動作的生成空格填寫的運作方式。

若要了解有關主題輸入和輸出參數的詳細資訊，請參閱管理主題輸入和輸出。

使用程式碼編輯器編輯主題

程式碼編輯器會以 YAML 這個易於閱讀和理解的標記語言來顯示主題。 您可以使用程式碼編輯器，從其他 Bot (甚至是由其他作者所建立的 Bot) 複製和貼上主題。

重要

不完全支援在程式碼編輯器中整體設計主題和貼上複雜主題。

在此範例中，您將 YAML 複製並貼上到程式碼編輯器中，以快速新增詢問客戶運送資訊的主題。

1. 在主題頁面上，選擇 + 建立>從空白。

2. 在製作畫布的右上角，選擇更多，然後選擇開啟程式碼編輯器。

   

3. 選取並刪除程式碼編輯器的內容。 然後複製並貼上以下 YAML 程式碼：

   kind: AdaptiveDialog
   beginDialog:
     kind: OnRecognizedIntent
     id: main
     intent:
       displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
       triggerQueries:
         - Buy items
         - Buy online
         - Buy product
         - Purchase item
         - Order product
   
     actions:
       - kind: SendMessage
         id: Sjghab
         message: I am happy to help you place your order.
   
       - kind: Question
         id: eRH3BJ
         alwaysPrompt: false
         variable: init:Topic.State
         prompt: To what state will you be shipping?
         entity: StatePrebuiltEntity
   
       - kind: ConditionGroup
         id: sEzulE
         conditions:
           - id: pbR5LO
             condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
   
         elseActions:
           - kind: SendMessage
             id: X7BFUC
             message: There will be an additional shipping charge of $27.50.
   
           - kind: Question
             id: 6lyBi8
             alwaysPrompt: false
             variable: init:Topic.ShippingRateAccepted
             prompt: Is that acceptable?
             entity: BooleanPrebuiltEntity
   
           - kind: ConditionGroup
             id: 9BR57P
             conditions:
               - id: BW47C4
                 condition: =Topic.ShippingRateAccepted = true
   
             elseActions:
               - kind: SendMessage
                 id: LMwySU
                 message: Thank you and please come again.
   

4. 選取儲存，然後選取關閉程式碼編輯器。 問題節點現在對有關運送的問題有許多條件。

   

測試並發佈您的代理程式

當您變更主題時測試您的代理程式，以確保一切都能如期運作。

設計並測試代理程式後，將其發佈到 Web、行動或本機應用程式或 Microsoft Bot Framework 頻道。

傳統

使用系統及範例主題

建立機器人時，會為您建立數個主題。

這些自動建立的主題會分為兩個類別：

• 課程主題可協助您了解使用節點建立機器人交談的簡單到複雜的方式。

  您可以編輯課程主題或將其全部刪除。

• 系統主題是您在機器人交談期間可能需要的主題。

  您無法刪除或停用系統主題或編輯其觸發字詞。 不過，您可以在製作畫布上自訂節點。 建議您在熟悉建立端對端機器人交談之前，不要自訂這些主題。

建立主題

1. 從導覽功能表中，依序選取主題、+ 新增主題、從頭開始。

   這會打開觸發字詞窗格。

2. 在新增字詞區段為主題新增多個觸發字詞。

   

   您可以為主題指定一個以上的觸發字詞，每個字詞使用一個新行。 您可以在觸發字詞中包括標點符號，但是最好使用短片語而不是長句。

3. 在頂部列中，編輯主題的標題並為其命名。

   

4. 按 Enter 或選取儲存圖示以儲存變更。

5. 選取詳細資料圖示。 您也可以在此編輯名稱並新增顯示名稱和描述。

   顯示名稱會告訴機器人此人正在詢問哪個主題。

   描述會描述您自己和其他機器人製作者的主題用途。 此描述不會顯示給使用者。

   

6. 選取儲存將主題新增至主題清單。

設計主題的交談路徑

1. 在主題清單中，選取您要編輯的主題。 您會看到主題的觸發字詞。 您可以在此定義客戶和代理程式之間的交談路徑。

   對於現有或系統主題，會自動建立多個節點。 您可以象編輯其他節點一樣編輯這些節點。

   當您建立新的主題時，會為您插入觸發節點和空白訊息節點。

2. 若要新增節點，請選取 +，在節點之間或之後選取新增節點。

   

3. 若要變更節點之間的路徑，請將節點頂部的小圓圈 (其節點錨點) 拖曳到畫布中的新位置。 虛線代表原始路徑。

   

插入節點

在觸發字詞節點或訊息節點之間新增節點時，您可以：

• 提出問題
• 呼叫動作
• 顯示訊息
• 重新導向至其他主題
• 結束交談

提出問題

1. 選擇 + 新增節點功能表的提出問題選項，以新增新的問題節點。 這將出現一個問題節點。

   

2. 在提出問題欄位中輸入問題字詞。

   例如，如果使用者想知道商店的營業時間，機器人的問題可能會是您需要哪個商店位置？

3. 在確認底下，為使用者的回應選取一個選項，例如多選擇選項。

   該選項決定使用者回覆時機器人應該聽什麼。 如需詳細資訊，請參閱在交談中使用實體。

4. 在使用者選項底下，輸入對機器人問題的預期答案。

   例如，如果您在識別中選取多選擇選項，則選項可能包括商店位置，例如西雅圖、貝爾維尤，或者 柯克蘭。

   

   每個選項都會以聊天中的多選按鈕形式呈現給使用者，但是使用者也可以輸入其回答。

5. (選用) 將使用者回覆儲存在變數中供稍後使用。

根據客戶的回覆，交談編輯器會在交談中建立不同的路徑。 交談路徑會將客戶引導至每個回覆的適當解決方案。 您可以新增節點來建立分支邏輯，並指定機器人應對每個路徑或變數回應的內容。

呼叫動作

若要呼叫 Power Automate 流程並插入驗證節點，請從「+」新增節點功能表中選取呼叫動作。

如果您的機器人啟用了語音式功能，您會看到更多動作。

顯示訊息

1. 若要指定機器人的回覆，請選取 + 新增節點，然後選取顯示訊息以新增訊息節點。

2. 在文字方塊中輸入您希望機器人說出的訊息。

   您可以套用某些基本格式設定，例如粗體、斜體、已排序和無排序清單以及超連結。 您也可以使用在機器人交談中的其他地方定義的變數。

重新導向至其他主題

1. 若要將機器人移至不同主題，請選取 + 新增節點，然後選取重新導向至其他主題。 這將顯示主題清單。

2. 選取機器人應導向的主題。 例如，如果使用者詢問商店的營業時間，您可以將他們傳送至有關商店關閉的主題。

   

重新導向的主題是副主題。

您可以在副主題的節點下插入更多節點。

當副主題的路徑完成時，機器人會返回原始主題。 然後，機器人會遵循該副主題節點下的節點。

不過，如果您重新導向至以下任一系統主題，整個交談就會結束。

• 交談結束
• 確認成功
• 確認失敗
• 再見
• 呈報
• 重新開始 (也重新設定任何全域變數)

結束交談

交談結束時您可以進行調查，詢問使用者他們的問題是否得到回答或解決。 回覆會收集在客戶滿意度分析頁面上。

如果您使用的是適當的客戶服務入口網站 (例如 Customer Service 全通路)，也可以讓交談移交給即時助理。

在解決使用者問題或回答問題的回覆結束時，新增結束交談節點。

• 若要以客戶滿意度問卷結束，請選取結束時包含問卷。

• 若要插入與您的已設定的移交產品連結的移交節點，請選取轉接專員。

  (選用) 輸入私人訊息給專員。

  

新增條件

1. 若要根據變數新增分支邏輯，請選取 + 新增節點以新增節點。

2. 選取新增條件。

3. 選取根據條件進行分支。

4. 選取決定機器人交談此時是否應該分支的變數。

   例如，如果您設定使用者驗證，則在使用者登入時您可能需要不同的訊息。

刪除節點

選取要刪除節點的功能表圖示 (⋮)，然後選取刪除。

測試並行佈您的機器人

當您變更主題時測試您的代理程式，以確保一切都能如期運作。

在設計並測試機器人之後，請將其發佈至 Web、行動裝置或原生應用程式或 Microsoft Bot Framework 管道。

Teams

設計主題的交談路徑 - Teams

1. 在代理程式的主題清單中，選擇您要編輯的主題。 例如，您可能想要編輯主題商店營業時間。

   

   打開後，您會看到主題的觸發字詞。 您可以在此製作畫布上定義客戶與機器人之間的交談路徑。

   當您建立新的主題時，會為您插入觸發字詞節點和空白訊息節點。

   對於現有主題或系統主題，每個新主題都會自動建立多個節點。 如有需要，您可以編輯這些節點。

2. 您可以在節點之間或節點之後選取 + 新增節點來新增更多節點。

   

3. 若要變更節點之間的路徑，請拖曳節點錨點 (節點頂部的小圓圈)。 您會看到一條虛線，指示原始路徑。

   

插入節點 - Teams

將節點新增至觸發字詞節點時，可以從五個不同的選項中進行選取：

• 提出問題
• 呼叫動作
• 顯示訊息
• 重新導向至其他主題
• 結束交談

如果您想重新導向主題，可以前往另一個主題。

提出問題 - Teams

1. 選擇 + 新增節點功能表的提出問題選項以新增新的問題節點。 這將出現一個問題節點。

   

2. 在提出問題欄位中輸入問題字詞。

   例如，如果使用者想知道商店的營業時間，機器人的問題可能會是您需要哪個商店位置？

3. 在確認底下，為使用者的回應選取一個選項，例如多選擇選項。

   該選項決定使用者回覆時機器人應該聽什麼。 如需詳細資訊，請參閱在交談中使用實體。

4. 在使用者選項底下，輸入對機器人問題的預期答案。

   例如，如果您在識別中選取多選擇選項，則選項可能包括商店位置，例如西雅圖、貝爾維尤，或者 柯克蘭。

   

   每個選項都會以聊天中的多選按鈕形式呈現給使用者，但是使用者也可以輸入其回答。

5. (選用) 將使用者回覆儲存在變數中供稍後使用。

根據客戶的回覆，交談編輯器會在交談中建立不同的路徑。 交談路徑會將客戶引導至每個回覆的適當解決方案。 您可以新增節點來建立分支邏輯，並指定機器人應對每個路徑或值做出什麼回應。

新增條件 - Teams

在某些節點類型上，您可以新增條件。

1. 若要根據變數新增分支邏輯，請選取 + 新增節點功能表，然後選取新增條件以新增節點。 這會顯示幾個條件節點。

2. 選擇您要用來判斷機器人交談是否應在此位置進行分支的變數。

   

呼叫動作 - Teams

您可以在 + 新增節點功能表中選取呼叫動作，來呼叫 Power Automate 流程。

顯示訊息 - Teams

訊息可以指定機器人對使用者的回應。

1. 選取 + 新增節點功能表，然後選取顯示訊息以新增新的訊息節點。

2. 在文字方塊中輸入您希望機器人說什麼。 您可以套用某些基本格式設定，例如粗體、斜體、已排序和無排序清單以及超連結。

   您也可以在機器人交談中使用您在其他地方定義的變數。

結束交談 - Teams

您可以選擇結束對話作為機器人交談的最終節點。

有兩個選項：

• 以問卷結束會顯示一則問卷，詢問使用者其問題是否已獲得正確解答或已解決。 這項資訊會在客戶滿意度分析頁面中收集。

  

• 轉接專員可讓您輸入私人訊息給專員，以發起與使用者的聯繫。

重新導向至其他主題 - Teams

若要自動將機器人移至個別主題，請選取新增節點 (+) 以新增節點，然後重新導向至其他主題。

在彈出式視窗功能表中，選取機器人應轉向的主題。 例如，如果他們要求該商店的營業時間，您可能會想將使用者傳送至關於商店打烊時間的特定主題。

當機器人移至另一個主題時，機器人將會藉由交談路徑移至該主題，然後返回原始主題 (在其離開的位置)。

您可以將重新導向主題視為副主題。

不過，如果您重新導向至下列任一系統主題，整個交談就會結束：

• 重新開始 (重新設定所有全域變數)
• 呈報
• 交談結束
• 確認失敗
• 確認成功
• 再見

使用變數

您可以在機器人交談中使用您在其他地方定義的變數。

刪除節點 - Teams

選取要刪除節點的功能表圖示 (⋮)，然後選取刪除。

測試並行佈您的機器人 - Teams

對主題進行變更後，測試您的代理程式，以確保一切都能如期運作。

在完成設計和測試機器人之後，您可以發佈機器人，讓其他團隊中的成員可以使用機器人。