Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso. As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # GetUtterancesView Use a operação `GetUtterancesView` para obter informações sobre as declarações que seus usuários fizeram ao seu bot. Você pode usar essa lista para ajustar as declarações aos quais seu bot responde. Por exemplo, digamos que você crie um bot para pedir flores. Depois que seus usuários usarem seu bot por um tempo, use a operação `GetUtterancesView` para ver as solicitações que eles fizeram e se foram bem-sucedidas. Você pode descobrir que a declaração “Eu quero flores” não está sendo reconhecida. Você pode adicionar essa declaração à intenção `OrderFlowers` para que seu bot reconheça essa declaração. Depois de publicar uma nova versão de um bot, você pode obter informações sobre a versão antiga e a nova para poder comparar o desempenho entre as duas versões. As estatísticas de declaração são geradas uma vez por dia. Os dados ficam disponíveis nos últimos 15 dias. Você pode solicitar informações de até 5 versões do seu bot em cada solicitação. O Amazon Lex retorna as declarações mais frequentes recebidas pelo bot nos últimos 15 dias. A resposta contém informações sobre um máximo de 100 declarações para cada versão. As estatísticas de declaração não são geradas nas seguintes condições: + O campo `childDirected` foi definido como verdadeiro quando o bot foi criado. + Você está usando a ofuscação de slots com um ou mais slots. + Você optou por não participar da melhoria do Amazon Lex. Essa operação exige permissões para a ação `lex:GetUtterancesView`. ## Sintaxe da Solicitação ``` GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1 ``` ## Parâmetros da Solicitação de URI A solicitação usa os seguintes parâmetros de URI: ** [botname](#API_GetUtterancesView_RequestSyntax) ** O nome do bot para o qual as informações da declaração devem ser retornadas. Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50. Padrão: `^([A-Za-z]_?)+$` Obrigatório: Sim ** [botVersions](#API_GetUtterancesView_RequestSyntax) ** Uma matriz de versões de bot para o qual as informações da declaração devem ser retornadas. O limite é de 5 versões por solicitação. Membros da Matriz: número mínimo de 1 item. Número máximo de 5 itens. Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 64. Padrão: `\$LATEST|[0-9]+` Obrigatório: Sim ** [statusType](#API_GetUtterancesView_RequestSyntax) ** Para retornar declarações que foram reconhecidas e tratadas, use `Detected`. Para retornar declarações que não foram reconhecidas, use `Missed`. Valores válidos: `Detected | Missed` Obrigatório: Sim ## Corpo da Solicitação Essa solicitação não tem corpo. ## Sintaxe da resposta ``` HTTP/1.1 200 Content-type: application/json { "botName": "string", "utterances": [ { "botVersion": "string", "utterances": [ { "count": number, "distinctUsers": number, "firstUtteredDate": number, "lastUtteredDate": number, "utteranceString": "string" } ] } ] } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [botName](#API_GetUtterancesView_ResponseSyntax) ** O nome do bot para o qual as informações da declaração foram retornadas. Tipo: string Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50. Padrão: `^([A-Za-z]_?)+$` ** [utterances](#API_GetUtterancesView_ResponseSyntax) ** Uma matriz de objetos [UtteranceList](API_UtteranceList.md), cada um contendo uma lista de [UtteranceData](API_UtteranceData.md) objetos descrevendo as declarações que foram processadas pelo seu bot. A resposta contém no máximo 100 objetos `UtteranceData` para cada versão. O Amazon Lex retorna as declarações mais frequentes recebidas pelo bot nos últimos 15 dias. Tipo: matriz de objetos [UtteranceList](API_UtteranceList.md) ## Erros ** BadRequestException ** A solicitação não está bem formada. Por exemplo, um valor é inválido ou um campo obrigatório está faltando. Verifique os valores dos campos e tente novamente. Código de status HTTP: 400 ** InternalFailureException ** Ocorreu um erro interno do Amazon Lex. Tente sua solicitação novamente. Código de status HTTP: 500 ** LimitExceededException ** A solicitação excedeu um limite. Tente sua solicitação novamente. Código de status HTTP: 429 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView)