CreateIntentVersion - 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á.

CreateIntentVersion

Cria uma nova versão de uma intenção com base na versão $LATEST da intenção. Se a versão $LATEST desta intenção não tiver sido alterada desde que você a criou, o Amazon Lex não criará uma nova versão. Ele retorna a última versão criada.

nota

Você pode atualizar apenas a versão $LATEST da intenção. Você não pode atualizar as versões numeradas que você cria com a operação CreateIntentVersion.

Quando você cria uma versão de uma intenção, o Amazon Lex define a versão como 1. As versões subsequentes são incrementadas em 1. Para ter mais informações, consulte Versionamento.

Essa operação exige permissões para executar a ação lex:CreateIntentVersion.

Sintaxe da Solicitação

POST /intents/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

name

O nome da intenção da qual você deseja criar uma nova versão. O nome diferencia maiúsculas e minúsculas.

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.

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

Exigido: Sim

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

checksum

Soma de verificação da versão $LATEST da intenção que deve ser usada para criar a nova versão. Se você especificar uma soma de verificação e a versão $LATEST da intenção tiver uma soma de verificação diferente, o Amazon Lex retornará uma exceção PreconditionFailedException e não publicará uma nova versão. Se você não especificar uma soma de verificação, o Amazon Lex publicará a versão $LATEST.

Tipo: String

Obrigatório: não

Sintaxe da Resposta

HTTP/1.1 201
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

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

checksum

Soma de verificação da versão de intenção criada.

Tipo: String

conclusionStatement

Depois que a função do Lambda especificada no campo fulfillmentActivity cumpre a intenção, o Amazon Lex transmite essa declaração ao usuário.

Tipo: objeto Statement

confirmationPrompt

Se definido, o prompt que o Amazon Lex usa para confirmar a intenção do usuário antes de atendê-la.

Tipo: objeto Prompt

createdDate

A data em que a intenção foi criada.

Tipo: Timestamp

description

Uma descrição da intenção.

Tipo: String

Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.

dialogCodeHook

Se definido, o Amazon Lex invoca essa função do Lambda para cada entrada do usuário.

Tipo: objeto CodeHook

followUpPrompt

Se definido, o Amazon Lex usa esse prompt para solicitar atividades adicionais do usuário depois que a intenção for atendida.

Tipo: objeto FollowUpPrompt

fulfillmentActivity

Descreve como a intenção é atendida.

Tipo: objeto FulfillmentActivity

inputContexts

Uma matriz de objetos InputContext que lista os contextos que devem estar ativos para que o Amazon Lex escolha a intenção em uma conversa com o usuário.

Tipo: matriz de InputContext objetos

Membros da Matriz: número mínimo de 0 itens. Número máximo de 5 itens.

kendraConfiguration

Informações de configuração, se houver, para conectar um índice do Amazon Kendra com a intenção AMAZON.KendraSearchIntent.

Tipo: objeto KendraConfiguration

lastUpdatedDate

A data em que a intenção foi atualizada.

Tipo: Timestamp

name

O nome da intenção.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.

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

outputContexts

Uma matriz de objetos OutputContext que lista os contextos que a intenção ativa quando a intenção é atendida.

Tipo: matriz de objetos OutputContext

Membros da Matriz: número mínimo de 0 itens. Número máximo de 10 itens.

parentIntentSignature

Um identificador exclusivo de uma intenção integrada.

Tipo: string

rejectionStatement

Quando o usuário responde “não” à pergunta definida em confirmationPrompt, o Amazon Lex responde com essa mensagem para confirmar que a intenção foi cancelada.

Tipo: objeto Statement

sampleUtterances

Uma matriz de exemplos de declarações configuradas para a intenção.

Tipo: matriz de strings

Membros da Matriz: número mínimo de 0 itens. Número máximo de 1.500 itens.

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 200.

slots

Uma variedade de tipos de slots que define as informações necessárias para atender a intenção.

Tipo: matriz de objetos Slot

Membros da Matriz: número mínimo de 0 itens. Número máximo de 100 itens.

version

O número da versão atribuída à nova versão da intenção.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

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

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

ConflictException

Houve um conflito ao processar a solicitação. Tente sua solicitação novamente.

Código de Status HTTP: 409

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

NotFoundException

O atributo especificado na solicitação não foi encontrado. Verifique o atributo e tente novamente.

Código de Status HTTP: 404

PreconditionFailedException

A soma de verificação do atributo que você está tentando alterar não corresponde à soma de verificação na solicitação. Verifique a soma de verificação e tente novamente.

Código de status HTTP: 412

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: