

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

# Resolva entradas ambíguas do usuário com a desambiguação de intenção
<a name="generative-intent-disambiguation"></a>

A desambiguação de intenção é uma melhoria da NLU assistida que ajuda a resolver entradas ambíguas do usuário quando várias intenções podem coincidir. Quando ativado, o sistema apresenta perguntas esclarecedoras aos usuários, ajudando-os a especificar sua intenção exata para melhorar a precisão da conversa. O sistema usa um modelo de linguagem grande (LLM) que analisa os nomes e as descrições das intenções como contexto e, com base na ambigüidade da expressão do usuário, retorna as intenções correspondentes mais prováveis. O LLM avalia se a entrada do usuário corresponde claramente a uma única intenção ou a várias intenções e é ambígua o suficiente para exigir desambiguação e, em seguida, fornece as intenções do candidato.

O recurso Intent Disambiguation está disponível em inglês, espanhol, português, catalão, francês, italiano, alemão, chinês, japonês e coreano. Especificamente, ele suporta localidades que começam com`en_`,, `pt_` (pt\$1BR`es_`, pt\$1PT), (ca\$1ES), `ca_` (fr\$1CA, fr\$1FR), `fr_` (it\$1IT), (de\$1AT, de\$1DE), `it_` (zh\$1CN, `de_` zh\$1HK) e. `zh_` `ja_JP` `ko_KR` Para obter a lista completa de localidades compatíveis, consulte a tabela em[Idiomas e locais aceitos pelo Amazon Lex V2](how-languages.md).

Você pode configurar as seguintes opções para a desambiguação de intenção:

**Número de opções de intenção**

Configure o número máximo de intenções (2 a 5) a serem apresentadas aos usuários quando a desambiguação for necessária. Essa configuração determina quantas opções de intenção serão mostradas aos usuários quando o sistema detectar uma entrada ambígua. O valor padrão é 3, o que fornece um bom equilíbrio entre oferecer opções suficientes aos usuários e manter a seleção gerenciável.

**Mensagem de desambiguação**

 Forneça uma mensagem personalizada que será exibida antes de apresentar as opções de desambiguação aos usuários. Essa mensagem ajuda a definir o contexto para os usuários e pode ser personalizada para combinar com o tom e a marca do seu bot. Se não for especificado, uma mensagem padrão será usada.

**Nomes de exibição da intenção**

Configure nomes de exibição fáceis de usar para suas intenções de melhorar a experiência de desambiguação. Isso é recomendado quando seus nomes de intenção são técnicos ou não são adequados para exibição para usuários finais. Os nomes de exibição serão exibidos aos usuários durante a desambiguação, em vez do nome da intenção técnica.

------
#### [ Console ]

**Usando a desambiguação de intenção com seu bot Amazon Lex V2**

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 o bot que você deseja usar com Intent Disambiguation.

1. Na página **Localidade do bot**, clique em **Configurar** na seção **NLU assistida**.

1. Ative a [NLU assistida](assisted-nlu.md) e selecione o modo primário ou alternativo (a desambiguação de intenção funciona com os dois modos).

1. Na seção **Desambiguação de Intenção** dentro da configuração de NLU Assistida, use o botão de alternância para ativar o recurso de Desambiguação de Intenção.

1. Defina as seguintes configurações opcionais:
   + **Número de opções de intenção:** selecione o número máximo de intenções (2 a 5) a serem apresentadas aos usuários durante a desambiguação. O padrão é três.
   + **Mensagem de desambiguação:** forneça uma mensagem personalizada que será exibida ao apresentar as opções de intenção. Se não for especificado, uma mensagem padrão será usada.

1. Clique em **Salvar** para aplicar a configuração.

1. Opcionalmente, configure os nomes de exibição de intenção para uma melhor experiência do usuário:

   1. Navegue até cada intenção em seu bot que você deseja configurar.

   1. Na página do Editor de intenções, localize o campo **Nome de exibição**.

   1. Insira um nome fácil de usar que será mostrado aos usuários durante a desambiguação, em vez do nome da intenção.

1. Crie o bot para ver as mudanças refletidas em seu bot em tempo de execução.

------

**Orientação para melhorar a eficácia do seu bot ao usar o recurso de desambiguação de intenção**

As melhores práticas a seguir podem ajudá-lo a maximizar a eficácia do recurso de desambiguação de intenção:

1. **Nomes e descrições de intenções claras:** Certifique-se de que os nomes e descrições das intenções sejam limpos, claros e não se sobreponham a outras intenções, pois essas são as principais entradas fornecidas ao LLM para desambiguação.

1. **Nomes de exibição descritivos:** se os nomes de intenção atuais forem técnicos, use nomes de exibição descritivos que comuniquem claramente a finalidade da intenção. Os nomes de exibição devem ser semelhantes ou corresponder aos nomes das intenções.

1. **Intenções máximas apropriadas:** defina o número máximo de opções de intenção com base em suas preferências e testes.

1. **Mensagens personalizadas: crie mensagens** concisas de desambiguação que reconheçam a entrada do usuário e levem às opções de intenção.

1. **Cenários de teste:** teste com expressões ambíguas para garantir que a experiência de desambiguação seja natural com nomes de intenções ou nomes de exibição de intenções e mensagens personalizadas, e verifique se as opções de intenção corretas estão sendo apresentadas durante a solicitação de desambiguação.

**Importante**  
Habilite esse atributo em uma versão preliminar do bot. Teste antes de usá-lo em um alias de produção.

## Desativando a intenção (desambiguação)
<a name="disable-generative-intent-disambiguation"></a>

Para desativar o recurso de desambiguação de intenção, siga estas etapas:

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 o bot.

1. Na página **Localidade do bot**, clique em **Configurar** na seção **NLU assistida**.

1. **Na seção **Desambiguação de intenção** na configuração da NLU assistida, desative o recurso de desambiguação de intenção e clique em Salvar.**

1. Crie o bot para aplicar as alterações.