Usar o construtor de bots descritivo - 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á.

Usar o construtor de bots descritivo

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 e o desempenho com IA generativa.

O construtor de bots descritivo permite que você aproveite o acesso do Amazon Bedrock a grandes modelos de linguagem para melhorar a eficiência do processo de criação de bots. Você fornece um prompt usando linguagem natural que inclui a finalidade do bot e as ações que ele deve realizar. O Amazon Lex V2 aproveita os recursos do Amazon Bedrock para gerar intenções e tipos de slots relevantes para seu bot com base na sua descrição. Depois de escolher as intenções e os tipos de slots que deseja manter, você pode então iterar no bot para modificá-lo de acordo com seu caso de uso específico. O construtor de bots descritivo economiza seu tempo, permitindo que você evite a necessidade de criar intenções e tipos de slots manualmente para o bot.

O construtor de bots descritivo está disponível nas localidades em inglês (veja as localidades que começam com en_ na tabela em Idiomas e locais aceitos pelo Amazon Lex V2).

Antes de criar o bot, faça o seguinte:

  1. Verifique se sua função tem as permissões corretas revisando as etapas em Permissões necessárias para criar um bot com descrição em linguagem natural.

  2. Decida a descrição a ser usada. É possível consultar Exemplos de descrições de bot para obter exemplos de descrições de bots.

Crie um bot usando linguagem natural para descrever o que o bot deve ser capaz de fazer. O Amazon Lex V2 invoca os modelos do Amazon Bedrock para gerar intenções e tipos de slots adequados ao caso de uso do seu bot. Você pode criar o bot com o console ou a API.

Console

Criar um bot usando o construtor de bots descritivo

  1. Faça login no AWS Management Console e abra o console do Amazon Lex V2 em https://console.aws.amazon.com/lexv2/home.

  2. Na página Bots, selecione Criar bot.

  3. Para o Método de criação, escolha Construtor de bots descritivo – GenAI.

  4. Dê ao seu bot um nome e uma descrição opcional, configure as permissões do IAM e escolha se o bot está sujeito à COPPA ou não. Depois, selecione Próximo.

  5. Selecione um idioma para criar o bot, uma voz para o bot e um limite de confiança para a classificação da intenção (para obter mais informações, consulte Usar pontuações de confiança de intenção).

  6. Em Criador de bots descritivo – GenAI, forneça uma descrição para o bot que deseja criar. A descrição deve ser detalhada e precisa para ajudar a gerar intenções adequadas e suficientes para o bot. Inclua uma lista de ações para melhorar o processo de criação da intenção.

  7. Selecione um fornecedor de modelo e um modelo em Selecionar modelo.

  8. Para criar o bot em outra localidade, escolha Adicionar outro idioma. Quando terminar de adicionar idiomas, selecione Concluído. O Amazon Lex V2 cria o bot e o construtor de bots descritivo gera intenções e slots para ele. Quando a localidade é gerada, o banner muda de azul para verde. Selecione Revisar para ver as intenções geradas e os tipos de slots.

    nota

    Atualmente, o construtor de bots descritivo está disponível somente em localidades em inglês. No entanto, você pode copiar um bot para um local diferente do inglês depois de criá-lo.

Revise as intenções geradas e os tipos de slots e adicione-os ao bot

  1. Se houver intenções e tipos de slots suficientes aplicáveis ao caso de uso do bot, você poderá revisar as intenções geradas.

    1. Revise as Intenções geradas.

      1. Escolha uma caixa de seleção ao lado de uma intenção para removê-la da lista de intenções a serem adicionadas ao bot.

      2. Escolha um nome de intenção para ver os Exemplos de enunciados e os Slots gerados para a intenção.

      3. Por padrão, todos os enunciados e slots estão selecionados. Escolha uma caixa de seleção para remover esse item da intenção. Selecione Adicionar à seleção para manter os itens marcados na intenção.

    2. Revise os Tipos de slots gerados.

      1. Marque uma caixa de seleção ao lado de um tipo de slot para removê-lo da lista de intenções a serem adicionadas ao bot.

      2. É possível adicionar valores a um tipo de slot depois de adicioná-lo ao bot

  2. Quando tiver escolhido as intenções e os tipos de slots que deseja, selecione Adicionar intenções e tipos de slots na parte superior da página para adicionar as intenções e os tipos de slots ao bot.

  3. Após a adição dos recursos, um banner verde de êxito será exibido. Acesse Intenções e Tipos de slot para editar os gerados e adicionar mais valores.

  4. Se as Intenções geradas e os Tipos de slots gerados forem, em sua maioria, inaplicáveis ao bot que você deseja criar, execute as etapas a seguir.

    1. Selecione Nova geração na seção Detalhes do construtor de bots descritivo.

    2. Reescreva o prompt e selecione Gerar novamente para gerar novas intenções e tipos de slots. Os resultados serão diferentes se você usar um modelo diferente.

      Importante

      Não há garantia de que as mesmas intenções e slots serão gerados. Você será cobrado toda vez que gerar novamente as intenções e os tipos de slots.

API

Criar o bot usando descrição em linguagem natural

Quando você usa o construtor de bots descritivo por meio da API, ele cria uma definição de bot em um arquivo .zip em um bucket do Amazon S3. Baixe esse arquivo e importe a definição do bot para o Amazon Lex V2 para criar o bot.

  1. Envie uma solicitação do CreateBot para criar um bot. Depois, envie uma solicitação createBotLocale para criar uma localidade para o bot.

  2. Envie uma solicitação StartBotResourceGeneration, especificando a ID, a versão e a localidade do bot. Use DRAFT para a versão bot. Forneça sua solicitação no campo generationInputPrompt. A descrição deve ser detalhada e precisa para ajudar a gerar intenções adequadas e suficientes para o bot. Inclua uma lista de ações para melhorar o processo de criação da intenção.

  3. Anote o valor do generationId na resposta.

  4. Envie uma solicitação DescribeBotResourceGeneration usando a generationId que você recebeu na resposta StartBotResourceGeneration. Inclua a ID, a versão e a localidade do bot.

  5. Se a generationStatus na resposta DescribeBotResourceGeneration for Complete, o campo generatedBotLocaleUrl também será preenchido. Use esse URI do Amazon S3 para baixar a definição do bot seguindo as etapas em Baixar um objeto.

Verificar a definição de bot gerada e importá-la

  1. Use esse URI do generationStatus na resposta DescribeBotResourceGeneration para baixar a definição do bot seguindo as etapas em Baixar um objeto.

  2. É possível modificar diretamente o conteúdo gerado para o caso de uso específico do seu bot editando o arquivo. Também é possível enviar outra solicitação StartBotResourceGeneration para gerar novamente intenções e slots.

    Importante

    Não há garantia de que as mesmas intenções e slots serão gerados. Você será cobrado toda vez que gerar novamente as intenções e os tipos de slots.

  3. Para importar a definição do bot, siga as etapas em Importação.

  4. Após a importação, é possível modificar as intenções e os slots gerados usando as operações UpdateIntent, UpdateSlot e UpdateSlotType.

Para listar metadados sobre todos os itens gerados para uma localidade de bot, use a operação ListBotResourceGenerations. Use qualquer um dos valores generationId retornados em uma solicitação DescribeBotResourcGeneration para recuperar o URI do Amazon S3 para uma definição de bot gerada.