What's an intent?

For an explanation of an intent, see here.

For some practice with intents, complete the Getting Started with Bot Building tutorial series.

Add an intent

To add an intent

  1. Access Intent Manager.
  2. Locate the domain list in the Intent Manager dashboard.
  3. Select the name of the relevant domain, and then select Build from the menu that appears.
  4. On the Intents page, click Add Intent in the upper-right corner.
  5. Specify the following:

    • Intent name: Enter the intent name. To name an intent, use a short phrase that describes the intent. Typically, an intent name has both a verb and a noun (e.g., "report login problem"). A domain can have dozens of intents, so using a standard naming convention is important for being able to easily sort and find intents.
    • Intent display name: Enter the display name.
    • Description: Enter a short phrase describing the intent. While this field is optional, it's often useful. Many intent names can be technical. A description adds clarity and is particularly helpful to a person not familiar with the domain.
    • Intent type: Select either "Intent" or "Meta Intent." For an introduction to meta intents, see here.
    • Training: Enter as many training phrases as possible. The NLU engine uses training phrases in order to match a user's utterance with an intent. The more training phrases you include, the more likely it is that the NLU engine will accurately match the user's intent. Generally speaking, the phrases should be complete sentences (not long paragraphs, and not keywords). As an example, assume you have a "Check bill" intent. You might add the following training phrases, among others:
      • I want to check the status of my bill
      • Tell me what my bill is
      • I need to look into what's going with my bill

      For best practices, see here.

  6. Click Save.
  7. Train the domain so that the addition is reflected in a new model version.

Generate training phrases

Adding training phrases to an intent can sometimes be a challenge, so Intent Manager includes a tool to help with this. Within an intent, provide just a single training phrase as the input, and the tool automatically generates additional phrases that are similar in meaning. The suggestions are based on actual utterances by your users.

Generating training phrases is useful when:

Note:

  • This feature is only available for English-language domains.
  • To use this feature, Intent Manager's Intent Analyzer feature must be enabled for your account, and at least one domain (any domain) in Intent Manager must have Intent Tracking enabled (here), as the feature makes use of the data that it captures.
  • If you’ve enabled Intent Analyzer recently, expect the tool’s results to improve over time as more data is captured.
  • If you're a new customer, expect no results until suggestions can be offered based on utterances by your users. And here again, expect the tool's results to improve over time.

To generate training phrases

  1. Access Intent Manager.
  2. Locate the domain list in the Intent Manager dashboard.
  3. Select the name of the relevant domain, and then select Build from the menu that appears.
  4. On the Intents page, select the intent.
  5. Beside an existing training phrase (you’ll need to add at least one to the intent), click .

  6. Review the generated phrases, and select the ones you want to add to the domain. You might also want to refine the spelling or punctuation. The phrases are based on actual consumer utterances, so they might contain misspellings or poor grammar. (See the FAQs farther below regarding typos and misspellings.)

  7. Click Add.
  8. Back on the Intents page, click Save to save the change.
  9. Retrain the domain.

Delete an intent

Deleting an intent is a non-recoverable action, so be certain about doing so before taking this action.

Ensure the intent isn't being used by any bots or knowledge bases before you delete it.

To delete an intent

  1. Access Intent Manager.
  2. Locate the domain list in the Intent Manager dashboard.
  3. Select the name of the relevant domain, and then select Build from the menu that appears.
  4. On the Intents page, select the intent.
  5. Click (3-dot icon), and select Delete.
  6. In the confirmation dialog, click Yes.
  7. Train the domain so that the deletion is reflected in a new model version.