View a markdown version of this page

Usando funções de serviço para o Amazon Lex V2 - 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á.

Usando funções de serviço para o Amazon Lex V2

O Amazon Lex V2 usa uma função de serviço do IAM para acessar outros serviços da AWS em seu nome em tempo de execução. A função de serviço fornece as permissões necessárias para criar e executar seu bot. Uma função de serviço é uma função padrão do IAM gerenciada pelo cliente em sua conta. Ele respeita as políticas de controle de serviços (SCPs) que você configura nas organizações da AWS e oferece controle total sobre as permissões que o Amazon Lex V2 usa.

AmazonLexServiceRole-

A função AmazonLexServiceRole - dá permissões para conectar seu bot a outros serviços necessários. Esse perfil inclui uma política de confiança para permitir que o serviço lexv2.amazonaws.com assuma o perfil e permissões para realizar as ações a seguir.

  • Se um bot estiver configurado para usar conversão de texto em fala, use o Amazon Polly para sintetizar a fala em todos os recursos do Amazon Lex V2 compatíveis com a ação.

  • Se um bot estiver configurado para usar a análise de sentimento do Amazon Comprehend, detecte o sentimento em todos os recursos do Amazon Lex V2 que a ação permite.

  • Se um bot estiver configurado para armazenar logs de áudio em um bucket do S3, coloque os objetos em um bucket especificado.

  • Se um bot estiver configurado para armazenar logs de áudio e texto, crie um fluxo de logs e coloque os logs em um grupo de logs especificado.

  • Se um bot estiver configurado para usar uma AWS KMS chave para criptografar dados, gere uma chave de dados específica.

  • Se um bot estiver configurado para usar os recursos de IA generativa do Amazon Bedrock, invoque os modelos, perfis de inferência e bases de conhecimento especificados do Amazon Bedrock.

Criar a função

O Amazon Lex V2 cria uma nova AmazonLexServiceRole função com um sufixo aleatório em sua conta quando você cria um bot e escolhe criar uma nova função. O Amazon Lex V2 modifica o perfil quando você adiciona recursos adicionais a um bot. Por exemplo, se você adicionar a análise de sentimento do Amazon Comprehend a um bot, o Amazon Lex V2 adicionará permissão para a comprehend:DetectSentiment ação à função de serviço.

Você também pode escolher uma função do IAM existente que você mesmo criou e configurou, desde que ela confie no principal de serviço do Amazon Lex V2 ()lexv2.amazonaws.com.

Editando ou excluindo a função

Como uma função de serviço é uma função padrão do IAM gerenciada pelo cliente, você a gerencia da mesma forma que qualquer outra função do IAM. Use o console do IAM, a CLI da AWS ou a API do IAM. Você pode revisar a política de confiança da função e as políticas de permissões anexadas a qualquer momento no console do IAM.

Importante

Antes de excluir uma função de serviço, certifique-se de que nenhum bot ainda a esteja usando. A exclusão de uma função da qual um bot depende faz com que ele perca as permissões necessárias para ser executado.

Regiões suportadas para funções de serviço do Amazon Lex V2

O Amazon Lex V2 oferece suporte ao uso de funções de serviço em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte Regiões e endpoints da AWS.