

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 uma descrição para criar um bot no Lex V2 com o criador de bots descritivo
<a name="nld-bots"></a>

**nota**  
Antes de aproveitar os recursos de IA generativa, você deve atender aos seguintes pré-requisitos:  
Para obter informações sobre preços para usar o Amazon Bedrock, consulte [Definição de preços do Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
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](generative-features.md). 

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](how-languages.md)).

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 no Lex V2](nld-permissions.md).

1. Decida a descrição a ser usada. É possível consultar [Exemplos de descrições de bots para construtor de bots descritivo](nld-examples.md) 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 Amazon Lex V2 em [https://console.aws.amazon.com/lexv2/casa](https://console.aws.amazon.com/lexv2/home).

1. Na página **Bots**, selecione **Criar bot**.

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

1. 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**.

1. 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 [Uso de pontuações de confiança de intenção para melhorar a seleção de intenção com o Lex V2](using-intent-confidence-scores.md)).

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

1. Selecione um fornecedor de modelo e um modelo em **Selecionar modelo**.

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

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

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

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

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

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

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

1. 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**.

   1. 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 [CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html)solicitação para criar um novo bot. Em seguida, envie uma [CreateBotLocale](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotLocale.html)solicitação para criar uma localidade para o bot.

1. Envie uma [StartBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StartBotResourceGeneration.html)solicitação, especificando o 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.

1. Anote o valor do `generationId` na resposta.

1. Envie uma [DescribeBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotResourceGeneration.html)solicitação usando o `generationId` que você recebeu na `StartBotResourceGeneration` resposta. Inclua a ID, a versão e a localidade do bot.

1. 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html).

**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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html).

1. É 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.

1. Para importar a definição do bot, siga as etapas em [Importação de bots do Lex V2](import.md).

1. Após a importação, você pode modificar as intenções e os slots gerados usando as [UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html)operações [UpdateSlot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlot.html), e. [UpdateSlotType](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlotType.html)

Para listar metadados sobre todos os itens gerados para uma localidade de bot, use a [ListBotResourceGenerations](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListBotResourceGenerations.html)operação. 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.

------

**Topics**
+ [Exemplos de descrições de bots para construtor de bots descritivo](nld-examples.md)
+ [Permissões necessárias para criar um bot com descrição em linguagem natural no Lex V2](nld-permissions.md)