Não importa qual abordagem você usa para localizar um assistente digital, é necessário configurar um serviço de tradução. São estas as etapas:

1. Se você ainda não tiver feito isso, configure um serviço de tradução para sua instância do Assistente Digital:
   1. Clicando em para abrir o menu lateral e selecionando Definições > Serviço de Tradução.
   2. Clicando em + Serviço.
   3. Digitando o URL e o token de Autorização para o serviço Microsoft Translator ou a API do Google Translation na caixa de diálogo Serviços de Tradução.
   Consulte a documentação do Microsoft Translator e da API do Google Translation para saber como obter o URL e o token de acesso.

   Observação
   
   Para usar a API do Google Translation, gere a Chave de API. Você cria essa chave na Console do GCP ( APIs e serviços > Credenciais). Para saber mais, consulte a Documentação do Google Cloud Platform.
2. Defina o serviço de tradução em seu assistente digital desta forma:
   1. Clicando em para abrir o menu lateral, selecionando Desenvolvimento > Assistentes Digitais e selecionando seu assistente digital.
   2. Na barra de navegação esquerda do assistente digital, clicando no ícone Definições () e selecionando a guia Geral.
   3. Navegando até a lista drop-down Serviço de Tradução e selecionando o serviço de tradução.

Por padrão, se um assistente digital for configurado com um serviço de tradução, o assistente digital detectará o idioma do usuário da mesma forma que uma habilidade faz com o componente System.DetectLanguage.

No entanto, você também precisa se certificar de que as habilidades no assistente digital usam o idioma detectado pelo assistente digital. Quando uma habilidade faz parte de um assistente digital, ele traduz a entrada do usuário para o inglês e passa esse texto traduzido em inglês para a habilidade. Portanto, por padrão, o componente System.DetectLanguage da habilidade detectaria inglês como idioma e definiria a variável profile.LanguageTag como inglês, mesmo que o texto inserido pelo usuário não fosse em inglês. Para impedir essa alternância de volta para inglês, você precisa adicionar a seguinte propriedade ao componente System.DetectLanguage em cada habilidade:

      useExistingProfileLanguageTag: true

Isso garante que a habilidade respeitará o valor da variável profile.LanguageTag definida pelo assistente digital.

Veja um exemplo do componente System.DetectLanguage de uma habilidade com a propriedade useExistingProfileLanguageTag definida:

  detectLang:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions: {}

Para texto em seu assistente digital que é apresentado aos usuários, você pode usar uma destas abordagens de tradução:

• Use o serviço de tradução configurado para o assistente digital.

  Se você usar essa abordagem, só precisará que suas mensagens de saída estejam em inglês. Nenhuma outra configuração é necessária. O serviço de tradução configurado traduzirá automaticamente quaisquer mensagens de saída para o idioma do usuário.

• Use um pacote de recursos para traduzir as mensagens de saída.
  Observação
  
  Para qualquer mensagem de saída que não tenha uma referência a uma chave de pacote de recursos, o serviço de tradução será usado automaticamente para traduzir as mensagens.

Quando desejar controlar a elaboração de respostas do seu assistente digital (em vez de depender do texto fornecido pelo serviço de tradução), use pacotes de recursos. Você poderá fornecer pacotes de recursos para quantos idiomas precisar.

O processo de tradução com pacotes de recursos consiste em executar as seguintes etapas:

• Identifique os campos e propriedades que precisam ser traduzidos.
• Crie um pacote de recursos.
• No pacote de recursos, para cada um dos itens a ser traduzido, crie chaves, valores para o idioma padrão e traduções para esses valores em quantos idiomas você precisar.
• Para os campos e propriedades para os quais você forneceu traduções, informe referências à chave do pacote de recursos correspondente. Para strings simples, use o seguinte formato de expressão (em que rb é um identificador reservado para o pacote de recursos):

  ${rb.BundleKeyName}

  Para propriedades que usam variáveis, use o seguinte formato de expressão:

  ${rb('bundleKey', '${variableForParam0}', '${variableForParam1}')}

Em assistentes digitais de vários idiomas (e em um único idioma que não seja o inglês), a chamada explícita de habilidades é reconhecida pelo assistente digital no idioma detectado e em inglês.