Auto speech adaptation

When performing a detect intent request, you can optionally supply speech context to provide hints to the speech recognizer. These hints can help with recognition in a specific conversation state.

The auto speech adaptation feature improves the speech recognition accuracy of your agent by automatically using agent entities, training phrases, and conversation state as speech context hints for all detect intent requests. This feature is enabled by default.

Enable or disable auto speech adaptation

To enable or disable auto speech adaptation:

  1. Go to the Dialogflow ES Console
  2. Select your agent near the top of the left sidebar menu
  3. Click the settings button next to the agent name
  4. Select the Speech tab
  5. Scroll to the Improve Speech Recognition Quality section
  6. Toggle Enable Auto Speech Adaptation on or off

Example speech recognition improvements

With auto speech adaptation enabled, you can build your agent in ways to take advantage of it. The following examples show how speech recognition may be improved with certain changes to your agent:

  1. If you define a training phrase that uses the @sys.number system entity, and the end user says "two", it may be recognized as "to", "too", "2", or "two". With auto speech adaptation enabled, Dialogflow uses the @sys.number entity as a hint during speech recognition, and the parameter is recognized as "two" or "2".

  2. If you define training phrases with a phrase like "stuffy nose", a similar sounding user utterance is reliably recognized as "stuffy nose" and not "stuff he knows".

  3. If you define entities for product or service names offered by your company, and the end user mentions these terms in an utterance, they are more likely to be recognized.

  4. User utterances with consecutive but distinct number entities can be ambiguous. For example, "I want two sixteen packs" might mean 2 quantities of 16 packs, or 216 quantities of packs. Speech Adaptation can help disambiguate these cases if you set up entities with spelled-out values:

    • Define a quantity entity with entries:
    • Define a product or size entity with entries:
      sixteen pack
      two ounce
      five liter
    • Only entity synonyms are used in speech adaptation, so you can define an entity with reference value 1 and single synonym one to simplify your fulfillment logic.
  5. You can use auto speech adaptation with Regexp entities. You can use these features together to capture alphanumeric or digit sequences.

    • Special characters and punctuation like ` ~ ! @ # $ % ^ & * ( ) - _ = + , . < > / ? ; ' : " [ ] { } \ | are not supported.
    • \s* and \s? are allowed, but \s is not.
    • You can add additional regexp entity entries that do not conform to these specificactions. You will benefit from auto speech adaptation so long as at least one of your entries conforms.

    For example, you can use regular expressions like the following to capture alphanumeric sequences:


    The following regular expressions will adapt for digit sequences:


    Also consider using @sys.number-sequence for accepting any digit sequence, and for a localized phone number recognizer.


The following limitations apply:

  1. Auto speech adaptation does not work for Actions on Google (Google Assistant), because speech recognition is performed by Actions on Google before sending data to Dialogflow.

  2. Auto speech adaptation's built-in support for system and regexp entities varies by language. Check Speech class tokens' $OOV_CLASS_ALPHANUMERIC_SEQUENCE and $OOV_CLASS_DIGIT_SEQUENCE for supported languages. If your language is not listed, you can work around this limitation. For example, if you want an employee ID that is three letters followed by three digits to be accurately recognized, you could build your agent with the following entities and parameters:

    • Define a digit entity that contains 10 entity entries (with synonyms):
      0, 0
      1, 1
      9, 9
    • Define a letter entity that contains 26 entity entries (with synonyms):
      A, A
      B, B
      Z, Z
    • Define a employee-id entity that contains a single entity entry (without synonyms):
      @letter @letter @letter @digit @digit @digit
    • Use @employee-id as a parameter in a training phrase.