Configurar e criar agentes multilíngues

Os agentes multilíngues são agentes que podem se comunicar com os clientes em diferentes idiomas, mantendo todo o conteúdo em um único agente. Em muitos casos, eles podem detectar automaticamente o idioma desejado com base na configuração do navegador da Web do usuário agente e responder no mesmo idioma, proporcionando uma experiência mais personalizada e envolvente para os clientes.

Para obter a lista de idiomas com suporte, consulte Suporte a idiomas.

Configurando um agente multilíngue

Quando um agente é inicialmente criado, um idioma principal é definido. Para obter mais informações sobre como selecionar o idioma principal do agente, consulte Suporte a idiomas.

Para habilitar um agente multilíngue:

1. Com um agente aberto, selecione Configurações na parte superior da página e selecione Idiomas.

2. Selecione Adicionar Idiomas na página Configurações.

   

3. Escolha os idiomas que deseja adicionar ao agente no painel Adicionar idiomas e selecione Adicionar idiomas na parte inferior.

4. Confirme se a lista de idiomas está correta na página Idiomas.

   

Gerenciando a localização em um agente multilíngue

Para adicionar as cadeias de caracteres de localização ao agente multilíngue:

1. Com um agente aberto, selecione Configurações na parte superior da página e selecione Idiomas.

2. Na página Idiomas na tabela de idiomas secundários adicionados, selecione Carregar na coluna Localização do idioma que deseja atualizar.

3. Na página Atualizar localizações para o idioma secundário selecionado, selecione o formato JSON ou ResX para baixar o arquivo de localização atual para esse idioma.

   

   Observação

   O arquivo baixado contém o conteúdo de localização mais recente para o agente. Se você precisar baixar versões anteriores do arquivo de localização, abra a solução do agente para baixar versões anteriores.

4. Abra o arquivo baixado e substitua as strings do idioma principal pelo texto traduzido apropriado.

5. Retorne à página Atualizar localizações, selecione Procurar e carregue o arquivo traduzido.

6. Feche a página Atualizar localizações.

Atualizando conteúdo localizado

Quando você baixa pela primeira vez o arquivo de localização para um idioma secundário, as cadeias de caracteres estão no idioma principal. Depois de baixar um arquivo de localização, use-o com seu processo de localização preferido.

Se você fizer alterações nas cadeias de caracteres do idioma principal, também precisará atualizar o conteúdo localizado no idioma secundário. Esse processo inclui conteúdo novo e conteúdo modificado. As alterações incrementais não são traduzidas automaticamente. Você deve baixar o arquivo JSON ou ResX do idioma secundário e atualizar as cadeias de caracteres não traduzidas usando seu processo de localização preferido.

O cenário a seguir é típico do fluxo de trabalho para conteúdo traduzido. Você traduziu anteriormente seu idioma principal (en-US) para um idioma secundário (fr-FR) e adicionou e modificou conteúdo no idioma principal. Quando você baixa o arquivo de localização do idioma secundário, todo o novo conteúdo está no idioma principal (en-US). No entanto, o conteúdo modificado ainda aparece no idioma secundário. Como o conteúdo modificado está usando a mesma ID, você deve comparar o novo arquivo com o arquivo carregado anteriormente.

Considerações sobre criação para agentes multilíngues

Ao criar, você pode configurar o agente para alterar o idioma falado atual no meio de uma conversa. Essa lógica pode residir em qualquer tópico do agente. No entanto, a melhor prática é alternar o idioma diretamente após um nó de Pergunta, o que garante que todas as mensagens a seguir até o próximo nó de Pergunta estejam no mesmo idioma.

Para alterar o idioma atual do agente, você pode definir o valor da User.Language variável para um dos idiomas secundários do agente. Essa seleção altera o idioma falado pelo seu agente imediatamente.

Testando um agente multilíngue

Para testar um agente multilíngue:

1. Abra o painel Testar seu agente.

2. Abra o menu na parte superior do agente de teste e selecione um dos idiomas secundários.

   

3. O teste agente se recarrega, desta vez usando o idioma secundário selecionado. A tela de criação mostra o idioma secundário.

4. Para testar o agente, insira uma mensagem no idioma secundário.

Você também pode definir o idioma do navegador para o idioma secundário suportado pelo agente e abrir o site de demonstração do agente. O site de demonstração é aberto no idioma secundário e o agente conversa usando as cadeias de caracteres do idioma secundário.

Comportamento agente multilíngue para idiomas que não estão configurados

Se o usuário de um agente tiver seu navegador configurado para um idioma para o qual o agente não foi configurado, o agente sempre retornará ao idioma principal.

Comportamento do agente multilíngue para traduções ausentes

Se o autor do agente fizer uma alteração no agente no idioma principal e não carregar as traduções, o agente mostrará as alterações não traduzidas em seu idioma principal. Certifique-se sempre de que as traduções estejam atualizadas depois de fazer alterações no agente no idioma principal.

Erros ao publicar um agente multilíngue

Quando você tenta publicar um agente multilíngue, se você vir a mensagem de erro "Validação para o bot falhou" com o código de erro de resposta bruta, SynonymsNotUnique seu arquivo de localização secundário contém sinônimos duplicados ou um sinônimo que corresponde a um DisplayName valor. Esse erro geralmente é encontrado quando um nó contém um Entity.Definition.'closedListItem' onde um dos seguintes cenários ocorreu:

• Um dos Synonyms elementos não é único.
• Um dos Synonyms elementos tem o mesmo valor que o DisplayName elemento.

Todos os Synonyms para a mesma entidade devem ser exclusivos e ter um nome diferente do elemento DisplayName.

Para corrigir o erro, revise o arquivo JSON ou ResX da linguagem secundária e identifique quaisquer instâncias em que essa condição possa estar presente.

Conteúdo relacionado

• Suporte a idiomas