Hinweis zum Ende des Supports: Am 15. September 2025 AWS wird der Support für Amazon Lex V1 eingestellt. Nach dem 15. September 2025 können Sie nicht mehr auf die Amazon-Lex-V1-Konsole oder die Amazon-Lex-V1-Ressourcen zugreifen. Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das [Amazon Lex V2-Handbuch](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # GetUtterancesView Verwenden Sie die `GetUtterancesView` Operation, um Informationen über die Äußerungen zu erhalten, die Ihre Benutzer gegenüber Ihrem Bot gemacht haben. Sie können diese Liste verwenden, um die Äußerungen zu optimieren, auf die Ihr Bot reagiert. Nehmen wir zum Beispiel an, dass Sie einen Bot erstellt haben, um Blumen zu bestellen. Nachdem Ihre Benutzer Ihren Bot eine Weile verwendet haben, können Sie mithilfe des `GetUtterancesView` Vorgangs überprüfen, welche Anfragen sie gestellt haben und ob sie erfolgreich waren. Möglicherweise stellen Sie fest, dass die Äußerung „Ich möchte Blumen“ nicht erkannt wird. Sie könnten diese Äußerung zur `OrderFlowers` Absicht hinzufügen, sodass Ihr Bot diese Äußerung erkennt. Nachdem Sie eine neue Version eines Bots veröffentlicht haben, können Sie Informationen über die alte und die neue Version abrufen, sodass Sie die Leistung der beiden Versionen vergleichen können. Statistiken zu den Äußerungen werden einmal täglich erstellt. Daten sind für die letzten 15 Tage verfügbar. Sie können in jeder Anfrage Informationen für bis zu 5 Versionen Ihres Bots anfordern. Amazon Lex gibt die häufigsten Äußerungen zurück, die der Bot in den letzten 15 Tagen erhalten hat. Die Antwort enthält Informationen über maximal 100 Äußerungen für jede Version. Unter den folgenden Bedingungen werden keine Statistiken zu Äußerungen generiert: + Das `childDirected` Feld wurde bei der Erstellung des Bots auf „true“ gesetzt. + Sie verwenden die Slot-Obfuscation mit einem oder mehreren Slots. + Sie haben sich von der Teilnahme an der Verbesserung von Amazon Lex abgemeldet. Diese Operation erfordert Berechtigungen für die Aktion `lex:GetUtterancesView`. ## Anforderungssyntax ``` GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1 ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [botname](#API_GetUtterancesView_RequestSyntax) ** Der Name des Bots, für den Informationen zu Äußerungen zurückgegeben werden sollen. Längenbeschränkungen: Mindestlänge von 2. Maximale Länge = 50 Zeichen. Pattern: `^([A-Za-z]_?)+$` Erforderlich: Ja ** [botVersions](#API_GetUtterancesView_RequestSyntax) ** Eine Reihe von Bot-Versionen, für die Informationen zu Äußerungen zurückgegeben werden sollen. Das Limit liegt bei 5 Versionen pro Anfrage. Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 5 Elemente. Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen. Pattern: `\$LATEST|[0-9]+` Erforderlich: Ja ** [statusType](#API_GetUtterancesView_RequestSyntax) ** Um Äußerungen zurückzugeben, die erkannt und verarbeitet wurden, verwenden Sie`Detected`. Um Äußerungen zurückzugeben, die nicht erkannt wurden, verwenden Sie. `Missed` Zulässige Werte: `Detected | Missed` Erforderlich: Ja ## Anforderungstext Der Anforderung besitzt keinen Anforderungstext. ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "botName": "string", "utterances": [ { "botVersion": "string", "utterances": [ { "count": number, "distinctUsers": number, "firstUtteredDate": number, "lastUtteredDate": number, "utteranceString": "string" } ] } ] } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [botName](#API_GetUtterancesView_ResponseSyntax) ** Der Name des Bots, für den Informationen zu Äußerungen zurückgegeben wurden. Typ: Zeichenfolge Längenbeschränkungen: Mindestlänge von 2. Maximale Länge = 50 Zeichen. Pattern: `^([A-Za-z]_?)+$` ** [utterances](#API_GetUtterancesView_ResponseSyntax) ** Eine Reihe von [UtteranceList](API_UtteranceList.md) Objekten, von denen jedes eine Liste von [UtteranceData](API_UtteranceData.md) Objekten enthält, die die Äußerungen beschreiben, die von Ihrem Bot verarbeitet wurden. Die Antwort enthält maximal 100 `UtteranceData` Objekte für jede Version. Amazon Lex gibt die häufigsten Äußerungen zurück, die der Bot in den letzten 15 Tagen erhalten hat. Typ: Array von [UtteranceList](API_UtteranceList.md)-Objekten ## Fehler ** BadRequestException ** Die Anfrage ist nicht korrekt formuliert. Beispielsweise ist ein Wert ungültig oder ein erforderliches Feld fehlt. Überprüfen Sie die Feldwerte und versuchen Sie es erneut. HTTP-Statuscode: 400 ** InternalFailureException ** Ein interner Amazon Lex Lex-Fehler ist aufgetreten. Versuchen Sie es erneut. HTTP Status Code: 500 ** LimitExceededException ** Die Anfrage hat ein Limit überschritten. Versuchen Sie es erneut. HTTP-Statuscode: 429 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView)