GetUtterancesView - Amazon Lex V1
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.

 

Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.

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 o enunciado “Eu quero flores” não está sendo reconhecida. Você pode adicionar esse enunciado à intenção OrderFlowers para que seu bot reconheça esse enunciado.

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 enunciado 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 enunciado 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

O nome do bot para o qual as informações do enunciado devem ser retornadas.

Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.

Padrão: ^([A-Za-z]_?)+$

Exigido: Sim

botVersions

Uma matriz de versões de bot para o qual as informações do enunciado 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 tamanho: o tamanho mínimo é 1. Comprimento máximo de 64.

Padrão: \$LATEST|[0-9]+

Exigido: Sim

statusType

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 tiver êxito, o serviço enviará de volta uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

botName

O nome do bot para o qual as informações do enunciado foram retornadas.

Tipo: string

Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.

Padrão: ^([A-Za-z]_?)+$

utterances

Uma matriz de objetos UtteranceList, cada um contendo uma lista de UtteranceData 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

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 um dos AWS SDKs específicos da linguagem, consulte o seguinte: