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
**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)
# Exemplos de descrições de bots para construtor de bots descritivo
Aqui estão alguns exemplos úteis de descrições de bots que você pode usar com o construtor de bots descritivo no Amazon Lex V2.
| Industry | Exemplos de prompt |
| --- | --- |
| Serviços financeiros | Somos um serviço financeiro de cartões que ajuda os usuários a realizar tarefas quando recebem um novo cartão, como ativar o cartão, enviar um e-mail ou um PIN, verificar um novo cartão (usando um código postal). Também os ajudamos nas tarefas associadas ao cartão existente, como perguntar sobre os benefícios do cartão de crédito, informar perda de cartão, solicitar um novo cartão, redefinir o PIN do cartão ou pagar a fatura do cartão. |
| Serviços de alimentação | Quero um bot para ajudar os clientes a fazer pedidos de comidas (usando ID do item, quantidade, tamanho), verificar o status do pedido e cancelar um pedido. Use a ID do pedido para indexar pedidos. |
| Companhia aérea | Somos um domínio de companhia aérea que ajuda os usuários a reservar passagens aéreas, verificar detalhes de uma reserva, obter o recibo de um voo reservado, consultar o status do voo, reagendar voos reservados, obter detalhes do voo e cancelar voos reservados. Também é possível gerar intenções adicionais se elas oferecerem suporte às funções na descrição do domínio. |
| Seguros | Objetivo: Somos uma seguradora que vende apólices de seguro para automóveis, residências e pensões. Quero um bot que possa verificar o status da solicitação, registrar uma solicitação, fazer pagamentos de apólices e cancelar uma apólice. Usamos policy\$1id e os últimos 4 do SSN para identificação e validação da conta. Espero que o bot tenha pelo menos as seguintes intenções e slots: autenticação - policy\$1id, último SSNpolicy tipo 4: carro, casa, anuidadeStatus da política: saldo do cheque, data de vencimento do cheque, cobertura do chequefaça um pagamento: pagamento único, parcelas, valor |
| Gerenciamento de veículos | Estamos criando um bot Towed Cars Lookup que ajuda os motoristas de uma cidade que tiveram o carro guinchado a descobrir onde está o carro. Esse bot deve perguntar o endereço ou local de onde o automóvel foi guinchado e detalhes sobre o veículo, como placa e a marca, o modelo e o ano de fabricação do carro. O bot deve responder com a localização de onde o carro guinchado está estacionado e o horário de funcionamento. |
| Viajar | Sou agente de viagens e quero um bot para ajudar meus clientes a reservar uma viagem para a Disney. A Disney tem vários parques em todo o mundo e também tem hotéis, restaurantes e entretenimento especial que podem ser reservados. Os usuários do bot devem poder modificar ou cancelar a reserva. As reservas devem incluir, no mínimo, o parque, as datas e o hotel. Refeições ou entretenimento podem ser incluídos opcionalmente, e podem ser adicionados ou alterados posteriormente. |
# Permissões necessárias para criar um bot com descrição em linguagem natural no Lex V2
+ Para acessar esse recurso no console Amazon Lex V2, certifique-se de que sua função de console tenha as permissões `bedrock:ListFoundationModels` e `bedrock:ListInferenceProfiles`.
+ O perfil do IAM associado ao bot deve ter a permissão `bedrock:InvokeModel`. Quando você habilita o recurso com o console do Amazon Lex, a política é adicionada automaticamente à função do bot, desde que o bot esteja usando uma função vinculada ao serviço gerada pelo Amazon Lex.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": [
"arn:aws:bedrock:us-east-1::foundation-model/model-id"
]
}
]
}
```
------