Paramètres des conseils

Pour améliorer la précision du post-traitement et mieux répondre à l'intention de l'utilisateur, le Smart Formatter prend désormais en charge un nouveau paramètre hints. Le paramètre hints permet de guider le formatage en indiquant le type d'attribut attendu. Ce paramètre permet au formateur d'interpréter et de structurer les données plus efficacement, en particulier lorsque les données saisies par l'utilisateur sont ambiguës ou peu structurées.

Valeurs prises en charge

Le paramètre hints prend en charge les valeurs suivantes :

Valeurs prises en charge pour le paramètre hints
Conseil Description Résoudre les ambiguïtés Exemple
date Formate l'entrée sous forme de date. Fait la différence entre les expressions numériques et les références à des dates. Par exemple, une entrée vocale telle que six twenty seven twenty fourteen peut être interprétée soit comme un nombre, soit comme une date. Lorsque l'indice date est spécifié, il est correctement formaté en tant que date. six twenty seven twenty fourteen est formaté comme 06/27/2014.
alphanum Formate l'entrée sous forme de chaîne alphanumérique (lettres et chiffres combinés). Dans une entrée audio, lorsqu'un locuteur dit o, il peut faire référence à la lettre o ou au chiffre 0. En spécifiant l'indice alphanum, le Smart Formatter conserve o en tant que lettre au lieu de la convertir en zéro. A o 5 B est formaté comme Ao5B.

Outre les paramètres date et alphanum, le paramètre hints prend également en charge les valeurs suivantes :

  • number- Interpréter correctement les séquences numériques dans des contextes ambigus.
  • email- Résout les ambiguïtés dans les adresses électroniques parlées.
  • phonenumber- Distingue les numéros de téléphone des autres expressions numériques.

En spécifiant un indice, les développeurs peuvent améliorer la capacité du formateur à fournir des résultats qui correspondent mieux aux attentes de l'utilisateur. Pour plus d'informations sur le formateur intelligent, voir Formateur intelligent.

Utilisation du paramètre hints

Le paramètre hints ne fonctionne que lorsque le formatage intelligent est activé avec la version 2.0. Pour l'utiliser, vous devez inclure les paramètres suivants dans votre demande :

  • smart_formatting=true
  • smart_formatting_version=2.0

Actuellement, date et alphanum sont les indices pris en charge.

Exemple de demande :

curl -X POST -u "apikey:<apikey>"
-H "Content-Type: audio/wav"
--data-binary @{path}New_Recording.wav  
"{URL}/v1/recognize?model=en-US&hints=date&smart_formatting=true&smart_formatting_version=2.0"

Exemple de réponse :

text msg received %s {
   "result_index": 0,
   "results": [
      {
         "final": true,
         "alternatives": [
            {
               "transcript": "9/9/88 ",
               "confidence": 0.93
            }
         ]
      }
   ]
}

Attribut strict

L'attribut strict peut être utilisé avec n'importe quel indice pour supprimer le contexte indésirable ou supplémentaire de la sortie. Il permet de produire un résultat plus concis et plus précis lorsque l'entrée de l'utilisateur contient des mots supplémentaires qui ne sont pas nécessaires dans le résultat formaté.

Exemple de demande :

curl -X POST -u "apikey:<apikey>"  
-H "Content-Type: audio/wav"  
--data-binary @{path}New_Recording.wav  
"{URL}/v1/recognize?model=en-US&hints=date,strict&smart_formatting=true&smart_formatting_version=2.0"

Par exemple, si l'entrée est My Birthday is on June twenty seven two thousand fourteen, la sortie avec l'attribut date est My Birthday is on 06/27/2014. La sortie avec les attributs date et strict est 06/27/2014. L'attribut strict permet de s'assurer que seule la valeur formatée essentielle est renvoyée, en supprimant le contexte environnant le cas échéant.

Langues prises en charge

Le paramètre hints prend actuellement en charge l'anglais (US) (en-US).