GetUtterancesView - Amazon Lex V1
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

GetUtterancesView

Utilisez cette GetUtterancesView opération pour obtenir des informations sur les déclarations que vos utilisateurs ont adressées à votre bot. Vous pouvez utiliser cette liste pour ajuster les énoncés auxquels votre bot répond.

Supposons, par exemple, que vous ayez créé un robot pour commander des fleurs. Une fois que vos utilisateurs ont utilisé votre bot pendant un certain temps, utilisez l'GetUtterancesViewopération pour voir les demandes qu'ils ont faites et si elles ont abouti. Vous constaterez peut-être que l'énoncé « Je veux des fleurs » n'est pas reconnu. Vous pouvez ajouter cet énoncé à l'OrderFlowersintention afin que votre bot le reconnaisse.

Après avoir publié une nouvelle version d'un bot, vous pouvez obtenir des informations sur l'ancienne version et la nouvelle afin de pouvoir comparer les performances des deux versions.

Les statistiques d'énoncés sont générées une fois par jour. Les données sont disponibles pour les 15 derniers jours. Vous pouvez demander des informations pour un maximum de 5 versions de votre bot par demande. Amazon Lex renvoie les énoncés les plus fréquemment reçus par le bot au cours des 15 derniers jours. La réponse contient des informations concernant un maximum de 100 énoncés pour chaque version.

Les statistiques d'énoncé ne sont pas générées dans les conditions suivantes :

  • Le childDirected champ était défini sur true lors de la création du bot.

  • Vous utilisez l'obfuscation des emplacements avec un ou plusieurs emplacements.

  • Vous avez choisi de ne pas participer à l'amélioration d'Amazon Lex.

Cette opération exige des autorisations pour l'action lex:GetUtterancesView.

Syntaxe de la demande

GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

botname

Nom du bot pour lequel les informations d'énoncé doivent être renvoyées.

Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.

Modèle : ^([A-Za-z]_?)+$

Obligatoire : oui

botVersions

Tableau de versions de robots pour lesquelles les informations d'énoncé doivent être renvoyées. La limite est de 5 versions par demande.

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 5 éléments.

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

Modèle : \$LATEST|[0-9]+

Obligatoire : oui

statusType

Pour renvoyer des énoncés reconnus et traités, utilisez. Detected Pour renvoyer des énoncés qui n'ont pas été reconnus, utilisez. Missed

Valeurs valides : Detected | Missed

Obligatoire : oui

Corps de la demande

La demande n’a pas de corps de requête.

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "utterances": [ 
      { 
         "botVersion": "string",
         "utterances": [ 
            { 
               "count": number,
               "distinctUsers": number,
               "firstUtteredDate": number,
               "lastUtteredDate": number,
               "utteranceString": "string"
            }
         ]
      }
   ]
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

botName

Nom du bot pour lequel les informations d'énoncé ont été renvoyées.

Type : chaîne

Contraintes de longueur : longueur minimale de 2. Longueur maximale de 50.

Modèle : ^([A-Za-z]_?)+$

utterances

Tableau d'UtteranceListobjets contenant chacun une liste d'UtteranceDataobjets décrivant les énoncés traités par votre bot. La réponse contient un maximum de 100 UtteranceData objets pour chaque version. Amazon Lex renvoie les énoncés les plus fréquemment reçus par le bot au cours des 15 derniers jours.

Type : tableau d’objets UtteranceList

Erreurs

BadRequestException

La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez.

Code d’état HTTP : 400

InternalFailureException

Une erreur interne Amazon Lex s'est produite. Réessayez votre demande.

Code d’état HTTP : 500

LimitExceededException

La demande a dépassé une limite. Réessayez votre demande.

Code d’état HTTP : 429

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :