Invocar hook de código de diálogo - Guia do desenvolvedor

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

Invocar hook de código de diálogo

Em cada etapa da conversa, quando o Amazon Lex envia uma mensagem ao usuário, você pode usar uma função do Lambda como a próxima etapa da conversa. Você pode usar a função para implementar a lógica de negócios com base no estado atual da conversa.

A função do Lambda que é executada está associada ao alias do bot que você está usando. Para invocar a função do Lambda em todos os hooks de código de diálogo em sua intenção, você deve selecionar Usar uma função Lambda para inicializar e validar a intenção. Mais informações sobre como escolher uma função do Lambda, ver Criar e anexar uma função do Lambda a um alias de bot.

Há duas etapas para usar uma função do Lambda. Primeiro, você deve ativar o hook do código de diálogo em qualquer ponto da conversa. Segundo, você deve definir a próxima etapa da conversa para usar o hook de código de diálogo.

A imagem a seguir mostra o hook do código de diálogo ativado.

Mostra que o hook do código de resposta condicional está ativo.

Em seguida, defina o hook de código como a próxima ação para a etapa da conversa. Você pode fazer isso configurando a próxima etapa da conversa para Invocar o hook de código de diálogo. A imagem a seguir mostra uma ramificação condicional em que invocar o hook do código de diálogo é a próxima etapa do caminho padrão da conversa.

Ramificação condicional mostrando um hook de código como a próxima etapa da conversa.

Quando os hooks de código estão ativos, você pode definir três respostas para retornar ao usuário:

  • Sucesso: enviado quando a função do Lambda foi concluída com sucesso.

  • Falha: enviado se houve um problema com a execução da função do Lambda ou se a função do Lambda retornou um valor intent.state de Failed.

  • Tempo limite: enviado se a função do Lambda não for concluída no período de tempo limite configurado.

Fluxograma mostrando as opções disponíveis para mensagens após a execução de uma função do Lambda.

Escolha o hook de código de diálogo do Lambda e, em seguida, escolha Opções avançadas para ver as três opções de respostas que correspondem à invocação da função do Lambda. É possível definir valores, configurar as próximas etapas e aplicar condições correspondentes a cada resposta para criar o fluxo de conversação. Na ausência de uma condição ou de uma próxima etapa explícita, o Amazon Lex V2 decide a próxima etapa com base no estado atual da conversa.

Na página de opções avançadas, você também pode optar por ativar ou desativar a invocação da função do Lambda. Quando a função é ativada, o hook do código de diálogo é invocado com a invocação do Lambda, seguida pela mensagem de sucesso, falha ou tempo limite com base nos resultados da invocação do Lambda. Quando a função está desativada, o Amazon Lex V2 não executa a função do Lambda e age como se o hook do código de diálogo tivesse sido bem-sucedido.

Você também pode definir um rótulo de invocação que é enviado para a função do Lambda quando ela é invocada por essa mensagem. Isso pode ajudar a identificar a seção da sua função do Lambda a ser executada.

nota

Em 17 de agosto de 2022, o Amazon Lex V2 lançou uma mudança na forma como as conversas são gerenciadas com o usuário. Essa alteração oferece mais controle sobre o caminho que o usuário percorre na conversa. Para ter mais informações, consulte Compreender o gerenciamento do fluxo de conversas. Os bots criados antes de 17 de agosto de 2022 não são compatíveis com mensagens de hook de código de diálogo, definição de valores, configuração das próximas etapas e adição de condições.