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

# Enunciados de amostra
<a name="sample-utterances"></a>

Você cria exemplos de enunciados que são variações de frases que se espera que os usuários usem para iniciar uma intenção. Por exemplo, para uma intenção **BookFlight**, você pode incluir frases como as seguintes:

1. Quero reservar um voo

1. me ajude a pegar um voo.

1. passagens aéreas, por favor\$1

1. voo de \$1*DepartureCity*\$1 para \$1*DestinationCity*\$1

Você deve fornecer 10 ou mais enunciados de amostra. Forneça amostras que representem uma ampla variedade de estruturas de frases e palavras que os usuários possam pronunciar. Considere também frases incompletas, como nos exemplos 3 e 4 acima. *Você também pode usar espaços definidos para a intenção em um enunciado de amostra colocando colchetes ao redor do nome do slot, como em \$1DepartureCity\$1 no exemplo 4.* Se incluir nomes de slots em um exemplo de enunciado, o Amazon Lex V2 preenche os espaços da intenção com os valores que o usuário fornece no enunciado.

Uma variedade de exemplos de declarações ajuda o Amazon Lex V2 a generalizar para reconhecer efetivamente que o usuário deseja iniciar a intenção.

Você pode adicionar exemplos de expressões no editor de intenções, no Visual Conversation Builder ou com as operações da API [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) ou [UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html). Também é possível gerar exemplos de enunciados automaticamente aproveitando os recursos de IA generativa do Amazon Bedrock. Para obter mais informações, consulte [Use a geração de enunciados para gerar exemplos de enunciados para reconhecimento de intenção](utterance-generation.md).

**Usar o editor de intenções ou o Visual Conversation Builder**

1. No editor de intenções, navegue até a seção **Enunciados de amostra**. No Visual Conversation Builder, encontre a seção **Enunciados de amostra** no bloco **Iniciar**.

1. Na caixa com o texto transparente **I want to book a flight**, digite um enunciado de amostra. Selecione **Adicionar enunciado** para adicionar o enunciado.

1. Visualize os exemplos de enunciados adicionados no modo **Visualização** ou **Texto sem formatação**. Em **Texto sem formatação**, cada linha é um enunciado separado. No **Modo de visualização**, passe o mouse sobre um enunciado para revelar as seguintes opções:
   + Selecione a caixa de texto para editar o enunciado.
   + Selecione o botão x à direita da caixa de texto para excluir o enunciado.
   + Arraste o botão à esquerda da caixa de texto para alterar a ordem dos exemplos de enunciados.

1. Use a barra de pesquisa na parte superior para pesquisar seus exemplos de enunciados e o menu suspenso ao lado dela para classificar pela ordem em que você adicionou os enunciados ou em ordem alfabética.

**Usar uma operação de API**

1. Crie uma nova intenção com a operação [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) ou atualize uma existente com a operação [UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html).

1. A solicitação da API inclui um campo `sampleUtterances`, que mapeia para uma matriz de objetos [SampleUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_SampleUtterance.html).

1. Para cada enunciado de amostra que você deseja adicionar, anexe um objeto `SampleUtterance` à matriz. Adicione o exemplo de expressão como o valor do campo `utterance`.

1. Para editar e excluir exemplos de enunciados, envie uma solicitação `UpdateIntent`. A lista de enunciados fornecida no campo `sampleUtterances` substitui os enunciados existentes.
**Importante**  
Qualquer campo que você deixar em branco na solicitação `UpdateIntent` fará com que as configurações existentes na intenção sejam excluídas. Use a operação [DescribeIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeIntent.html) para retornar a configuração do bot e copiar todas as configurações que não deseja que sejam excluídas na solicitação `UpdateIntent`.