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

Migração de uma função do Lambda do Amazon Lex V1 para o Amazon Lex V2

O Amazon Lex V2 permite somente uma função do Lambda para cada linguagem em um bot. A função do Lambda e suas configurações são definidas para o alias de bot que você usa no runtime.

A função do Lambda é invocada para todas as intenções nessa linguagem se os hooks de diálogo e código de atendimento estiverem habilitados para a intenção.

As funções do Lambda do Amazon Lex V2 têm um formato de mensagem de entrada e saída diferente do Amazon Lex V1. Essas são as diferenças no formato de entrada da função do Lambda.

Essas são as diferenças no formato de entrada da função do Lambda.

Quando você cria um bot com as APIs do Amazon Lex V2, há somente uma função do Lambda por alias de bot por linguagem, em vez de uma função do Lambda para cada intenção. Se quiser continuar usando funções separadas, você pode criar uma função de roteamento que ativa uma função separada para cada intenção. A seguir há uma função de roteamento que você pode usar ou modificar para seu aplicativo.

import os
import json
import boto3

# reuse client connection as global
client = boto3.client('lambda') 

def router(event):
    intent_name = event['sessionState']['intent']['name']
    fn_name = os.environ.get(intent_name)
    print(f"Intent: {intent_name} -> Lambda: {fn_name}")
    if (fn_name):
        # invoke lambda and return result
        invoke_response = client.invoke(FunctionName=fn_name, Payload = json.dumps(event))
        print(invoke_response)
        payload = json.load(invoke_response['Payload'])
        return payload
    raise Exception('No environment variable for intent: ' + intent_name)
    
def lambda_handler(event, context):
    print(event)
    response = router(event)
    return response

Lista de campos atualizados

As tabelas a seguir fornecem informações detalhadas sobre os campos atualizados na solicitação e na resposta do Amazon Lex V2. Você pode usar essas tabelas para mapear campos entre as versões.

Solicitação

Os campos a seguir foram atualizados no formato de solicitação da função do Lambda.

Contextos ativos

A estrutura activeContexts agora faz parte da estrutura sessionState.

Intenções alternativas

A lista de interpretações do índice 1 ao N contém a lista de intenções alternativas previstas pelo Amazon Lex V2, junto com suas pontuações de confiança. O recentIntentSummaryView é removido da estrutura de solicitações no Amazon Lex V2. Para ver os detalhes do recentIntentSummaryView, use a operação GetSession.

Bot

No Amazon Lex V2, bots e aliases têm identificadores. O ID do bot faz parte da entrada do codehook. O ID do alias está incluído, mas não o nome do alias. O Amazon Lex V2 oferece suporte a várias localidades para o mesmo bot, portanto, a ID de localidade é incluída.

Intenção atual

A sessionState.intent estrutura contém os detalhes da intenção ativa. O Amazon Lex V2 também retorna uma lista de todas as intenções, incluindo intenções alternativas, na estrutura interpretations. O primeiro elemento na lista de interpretações é sempre o mesmo que sessionState.intent.

Ação do diálogo

O campo confirmationStatus agora faz parte da estrutura sessionState.

Amazon Kendra

O campo kendraResponse agora faz parte das estruturas sessionState e interpretations.

Sentimento

A estrutura sentimentResponse é movida para a nova estrutura interpretations.

Slots

O Amazon Lex V2 fornece um único objeto slots dentro da estrutura sessionState.intent que contém os valores resolvidos, o valor interpretado e o valor original do que o usuário disse. O Amazon Lex V2 também oferece suporte a slots de vários valores definindo o slotShape como List e definindo a lista values. Os slots de valor único são compatíveis pelo campo value, presume-se que sua forma seja Scalar.

Outros

O campo sessionId do Amazon Lex V2 é igual ao campo userId no Amazon Lex V1. O Amazon Lex V2 também envia o nome inputMode do chamador: texto, DTMF ou fala.

Resposta

Os campos a seguir foram atualizados no formato de solicitação da função do Lambda.

Contextos ativos

A estrutura activeContexts é movida para a estrutura sessionState.

Ação do diálogo

A estrutura dialogAction é movida para a estrutura sessionState. Agora você pode especificar múltiplas mensagens em uma ação de diálogo, e a estrutura genericAttachments agora é a estrutura imageResponseCard.

Intenções e slots

Os campos de intenção e slots que faziam parte da estrutura dialogAction agora fazem parte da estrutura sessionState.

Outros

A estrutura sessionAttributes agora faz parte da estrutura sessionState. A estrutura recentIntentSummaryReview não existe mais.