[Microsoft Copilot Studio ]创建和编辑主题

副驾驶可以包括两种类型的主题，系统主题和自定义主题。每个新副驾驶都从一组预定义的系统和自定义主题开始。

• 系统主题支持基本行为，例如与某人交谈或结束对话的自定义请求。一些系统主题有触发短语，您可以自定义这些短语以满足副驾驶的需求。
  • 您无法创建系统主题。
  • 您不能删除系统主题，但可以禁用它们。
  • 您可以更改系统主题。但是，在您能够轻松创建完整的副驾驶体验之前，我们不建议编辑系统主题。
  • 有关更多信息，请参阅使用系统主题。
• 预定义的自定义主题涵盖了常见行为，如问候客户、结束对话或重新开始对话。
  • 您可以更改预定义的自定义主题，也可以将其从副驾驶中完全删除。
  • 您创建的所有主题都是自定义主题。

The following types of node are available:

1. Open your copilot from the list on the Copilots page. For better visibility, close the Test your copilot panel for now.

2. On the top menu bar, select Topics.

3. Select Add a topic, and select From blank.

   A Trigger node appears on an otherwise blank topic authoring canvas.

4. Select the More icon (…) of the Trigger node, and then select Properties. The On Recognized Intent properties panel appears.

5. In the On Recognized Intent properties panel, select the Phrases area. The Phrases secondary panel appears.

6. Under Add phrases, enter a trigger phrase for your topic.

   Your copilot needs 5 to 10 trigger phrases to train the AI to understand your customers' responses. To add more trigger phrases, you can either:

   • Select the Add icon next to the text field, and enter the desired phrase.
   • Paste a set of trigger phrases, each one on a separate line, and select Enter.
   • Type a set of trigger phrases, pressing Shift+Enter after each one to place it on a separate line, and select Enter.

   You can include punctuation in a trigger phrase, but it's best to use short phrases rather than long sentences.

7. Select Details on the toolbar to open the Topic details panel.

8. Add your copilot topic details:

   • Enter a name to identify the topic, such as "Store hours." The Topics page lists all the topics defined in your copilot, by this name.
   • If desired, enter a display name that your copilot will show to the customer when it can't determine which topic matches the customer's message.
   • If desired, use the Description field to describe the purpose of the topic for yourself and other copilot makers on your team. Customers never see topic descriptions.

9. Select Save on the top menu bar to save your topic.

When you create a topic, a Trigger node automatically appears on the authoring canvas. You can then add different types of nodes to achieve the desired conversation path for your topic.

To add a node after another node or between two nodes on your topic authoring canvas:

1. Select the Add node icon below the node under which you want to add a new node.

2. Select the desired node type from the list that appears.

   

Select the menu icon (⋮) of the node you want to delete, and then select Delete.

You can use controls on the toolbar to cut, copy, paste, and delete the selected node or selected adjacent nodes.

The toolbar also has a control to undo an edit. Open the Undo menu to revert all actions back to the last save or to redo the previous action.

Once you use the Cut or Copy tools to place one or more nodes on the clipboard, there are two ways to paste them in the canvas:

• If you select a node and then select Paste, the nodes on the clipboard are inserted after the selected node.

• If you select the "+" to see the Add node menu, then select Paste, the node on the clipboard is inserted at that location.

Topics can have input and output parameters. When a topic redirects to another topic, you can use these parameters to pass information between the topics.

Additionally, if your copilot uses generative mode, it can automatically fill topic inputs from the conversation context, or after generating questions to gather values from users. This behavior is similar to how generative slot filling works for actions.

To learn more about input and output parameters for topics, see Manage topic inputs and outputs.

The code editor shows the topic in YAML, a markup language that's easy to read and understand. Use the code editor to copy and paste topics from other bots—even ones created by other authors.

In this example, you copy and paste YAML into the code editor to quickly add a topic that asks the customer for shipping information.

1. On the Topics page, select + Create > From blank.

2. In the upper-right corner of the authoring canvas, select the ... to see More options, then select Open code editor.

   

3. Select and delete the contents of the code editor. Then copy and paste the following YAML code:

   YAMLCopy
   

   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. Select Save, and then select Close code editor. The Question node now has many conditions to the question about shipping.

   

Test your copilot when you make changes to your topics, to make sure everything works as expected.

After you design and test your copilot, publish it to the web, mobile or native apps, or Microsoft Bot Framework channels.