Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 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'`GetUtterancesView`opé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'`OrderFlowers`intention 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 entre les 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](#API_GetUtterancesView_RequestSyntax) ** 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](#API_GetUtterancesView_RequestSyntax) ** 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 caractères. Modèle : `\$LATEST|[0-9]+` Obligatoire : oui ** [statusType](#API_GetUtterancesView_RequestSyntax) ** 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](#API_GetUtterancesView_ResponseSyntax) ** 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](#API_GetUtterancesView_ResponseSyntax) ** Un tableau d'[UtteranceList](API_UtteranceList.md)objets contenant chacun une liste d'[UtteranceData](API_UtteranceData.md)objets 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](API_UtteranceList.md) ## 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 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView)