AMAZON.BedrockAgentIntent - Guia do desenvolvedor

AMAZON.BedrockAgentIntent

nota

Antes de aproveitar os recursos de IA generativa, você deve atender aos seguintes pré-requisitos:

  1. Navegue até o console do Amazon Bedrock e inscreva-se para acessar o modelo Anthropic Claude que você pretende usar (para obter mais informações, consulte Acesso ao modelo). Para obter informações sobre preços para usar o Amazon Bedrock, consulte Definição de preços do Amazon Bedrock.

  2. Ative os recursos de IA generativa para a localidade do seu bot. Para isso, siga as etapas em Otimizar a criação de bots Lex V2 e o desempenho usando IA generativa.

Ativa os atendentes do Amazon Bedrock definidos na intenção de atender a solicitações de cliente e ativa fluxos de trabalho dos atendentes para realizar a tarefa definida. Este atributo está disponível em todas as localidades compatíveis com o Amazon Lex V2 e em todas as regiões comerciais onde os atendentes do Amazon Lex V2 e do Amazon Bedrock estejam presentes.

Se estiver substituindo FallbackIntent, essa intenção será ativada quando um enunciado não for classificado em nenhuma das outras intenções presentes no bot. Do contrário, ela só será ativada quando um enunciado for classificado nessa intenção. É importante observar que essa intenção não será ativada para enunciados perdidos ao elicitar um valor de slot.

Uma vez reconhecido pelo bot do Amazon Lex V2, o AMAZON.BedrockAgentIntent ativa o BedrockAgent definido ou BedrockKnowledgeBase para responder ao cliente. Se você estiver usando atendentes do Amazon Bedrock, a conversa permanecerá no BedrockAgentIntent e as solicitações do usuário serão retransmitidas para os atendentes, até que o atendente do Amazon Bedrock determine que a conversa está marcada como FINISH. É só após isso que o Amazon Lex V2 assume o controle da conversa e segue as próximas etapas definidas no AMAZON.BedrockAgentIntent.

Responde às perguntas do cliente usando atendentes do Amazon Bedrock e bases de conhecimento para responder às perguntas do cliente e dar respostas detalhadas.

Atenção

Você não pode usar o AMAZON.BedrockAgentIntent sem enunciados de amostra, AMAZON.QnAIntent sem enunciados de amostra e o AMAZON.KendraSearchIntent na mesma localidade do bot.

Se você selecionar essa intenção, configure os campos a seguir e selecione Adicionar para adicionar a intenção.

  • ID do atendente do Amazon Bedrock: o identificador do atendente do Amazon Bedrock. Escolha o Bedrock Agent que você deseja usar.

  • ID de alias do atendente do Amazon Bedrock: o identificador de alias do atendente do Amazon Bedrock.

Importante

Ao criar o atendente do Amazon Bedrock a ser usado com o Amazon Lex V2, verifique se a Entrada do usuário em Configurações adicionais é ENABLED. Esta configuração é fundamental para permitir aos atendentes fazer perguntas de esclarecimento ou acompanhamento, além de permitir que o Amazon Lex V2 delegue novamente aos atendentes a conclusão da tarefa correspondente.

(Opcional) Você também pode adicionar um BedrockAgentIntent com estas opções:

  • Modelo do Amazon Bedrock: escolha o fornecedor e o modelo base a ser usado para essa intenção. Atualmente, alguns modelos Anthropic Claude são compatíveis.

  • Base de conhecimento do Amazon Bedrock: se você escolher essa opção, especifique o ID da base de conhecimento do Amazon Bedrock. Você pode encontrar o ID verificando a página de detalhes da base de conhecimento do Amazon Bedrock no console ou enviando uma solicitação GetKnowledgeBase.

As respostas do BedrockAgentIntent serão armazenadas nos atributos da sessão e da solicitação, conforme mostrado abaixo:

  • x-amz-lex:bedrock-agent-search-response: a resposta do atendente do Amazon Bedrock para a pergunta ou o enunciado.

  • x-amz-lex:bedrock-knowledge-base-search-response-source: aponta para o documento, ou a lista de documentos, usado para gerar a resposta caso esteja usando a configuração da base de conhecimento do Amazon Bedrock.

  • x-amz-lex:bedrock-agent-action-group-invocation-input: objeto contendo valores de entrada coletados pelo grupo de ações do atendente. Para obter mais informações sobre grupos de ações do atendente, consulte ActionGroupInvocationInput.

  • x-amz-lex:bedrock-agent-knowledge-base-lookup-input: objeto contendo os detalhes relacionados à pesquisa da base de conhecimento do Amazon Bedrock.

  • x-amz-lex:bedrock-agent-agent-collaborator-details: objeto contendo detalhes da entrada e da saída dos atendentes secundários que foram invocados como parte das invocações de colaboração multiagente.

Para obter mais informações, consulte Uso do BedrockAgentIntent para usar um Bedrock Agent no Amazon Lex V2.