Aqui estão as etapas iniciais para configurar um assistente digital no modo de idioma Suportado Nativamente:

1. Clique em para abrir o menu lateral, selecione Desenvolvimento > Assistentes Digitais e clique em Novo Assistente Digital.

2. Preencha a caixa de diálogo, prestando atenção especial a estes campos:
   • Versão da Plataforma: A versão da plataforma afeta o comportamento de seus assistentes digitais; por exemplo, o modo como o mecanismo NLU (Natural Language Understanding) resolve intenções e quais idiomas são suportados de forma nativa.

     No modo de idioma suportado nativamente, defina-o como 20.12 ou superior.

     Consulte Versão da Plataforma.

   • Idioma Principal: Isso determina o idioma padrão do assistente digital e se o assistente digital usará suporte nativo para esse idioma ou dependerá de um serviço de tradução.

     Nesse campo, selecione um dos idiomas na seção Suportado Automaticamente da lista drop-down.

3. Se você precisar adicionar outros idiomas ao assistente digital:
   1. Na navegação esquerda do assistente digital recém-criado, clique em .
   2. Clique em Adicionar Idioma e selecione o idioma que deseja adicionar.

Em assistentes digitais baseados no suporte ao idioma nativo do Oracle Digital Assistant, os idiomas configurados para o assistente digital devem corresponder aos idiomas configurados para as habilidades.

Para ajudar a monitorar se os idiomas configurados para as habilidades e o assistente digital estão alinhados, uma verificação é executada sempre que você adiciona um idioma ou uma habilidade ao assistente digital e cada idioma é marcado como Completo ou Em Andamento:

• Os idiomas completos são aqueles nos quais cada uma das habilidades do assistente digital está configurada para esse idioma.
• Os idiomas em andamento são aqueles para os quais uma ou mais habilidades não estão configuradas.

Você pode encontrar a lista de idiomas completos e em andamento na guia Geral da página Definições do assistente digital ().

Se você quiser aproveitar o suporte ao idioma nativo do Oracle Digital Assistant em um assistente digital que já foi configurado para usar um serviço de tradução, siga estas etapas gerais:

1. Para todas as habilidades do assistente digital, crie versões que usem o suporte ao idioma nativo.

   Consulte Criar uma Habilidade com Idiomas Suportados Nativamente.

   Para obter a lista de idiomas suportados nativamente, consulte Idiomas Suportados Nativamente. (Se qualquer um dos idiomas que você deseja suportar não estiver nessa lista, continue usando o modo de serviço de tradução.)

2. Crie uma nova versão ou clone do assistente digital.

   1. Clique em para abrir o menu lateral e selecione Desenvolvimento > Assistentes Digitais.

   2. No mosaico do assistente digital que você deseja criar versão ou clonar, clique em e selecione Versão ouClone.

   3. Preencha os campos obrigatórios e clique em Criar.

3. Remova todas as habilidades da nova versão ou clone que você acabou de criar.

   Isso é necessário porque você não poderá criar o assistente digital para usar o suporte ao idioma nativo se ele contiver habilidades que estejam no modo de serviço de tradução.

4. Crie uma nova versão ou clone desse assistente digital modificado, selecione a Versão da Plataforma 20.12 ou superior e selecione o modo de idioma Suportado Nativamente.

   Com esta etapa, você consegue preservar a configuração feita para o assistente digital, mesmo que tenha de identificar as habilidades separadamente.

5. Adicione as versões de suporte ao idioma nativo das habilidades ao assistente digital.

Em assistentes digitais (ou habilidades independentes) que usam vários idiomas suportados nativamente, o assistente digital pode detectar automaticamente o idioma do usuário no início da sessão. Veja como funciona:

• O idioma é detectado automaticamente para assistentes digitais e habilidades configurados com vários idiomas suportados nativamente.
  • Se houver apenas um idioma (suportado nativamente) no assistente digital, a detecção de idioma será desativada.
  • Se o assistente digital usar um serviço de tradução, o serviço identificará a detecção do idioma, não o assistente digital.
• O idioma não será detectado automaticamente se o assistente digital for acessado por meio de um canal em que a variável profile.languageTag ou profile.locale foi definida.
• O idioma é detectado na primeira declaração da conversa e não será atualizado na sessão, mesmo que o usuário alterne os idiomas.
• Por padrão, a sessão do canal dura 7 dias antes de expirar.

Estas são as etapas iniciais para configurar um assistente digital de idioma único que não seja o inglês no modo de idioma Serviço de Tradução:

1. Clique em para abrir o menu lateral, selecione Desenvolvimento > Assistentes Digitais e clique em Novo Assistente Digital.

2. Preencha a caixa de diálogo, prestando atenção especial a estes campos:
   • Versão da Plataforma: A versão da plataforma afeta o comportamento de seus assistentes digitais; por exemplo, o modo como o mecanismo NLU (Natural Language Understanding) resolve intenções e quais idiomas são suportados de forma nativa.

     Se você estiver começando com um novo assistente digital, selecione a versão mais recente disponível, pois o suporte para essa versão vai durar mais.

     Consulte Versão da Plataforma.

   • Idioma Principal: Este campo só será exibido se você tiver selecionado a Plataforma Versão 20.12 ou superior.

     Nesse campo, selecione o idioma de destino na seção Serviço de Tradução da lista drop-down.

     Cuidado:

     Certifique-se de ter selecionado na seção Serviço de Tradução. Se você selecionar na seção Suportado Nativamente, o assistente digital só aceitará habilidades que usem o modo Suportado Nativamente.

     Se esse campo não for exibido, o idioma do assistente digital será determinado pelo idioma da primeira habilidade adicionada a ele. Nesse caso, esse idioma é conhecido como idioma predominante em vez de idioma principal.

Estas são as etapas iniciais para configurar um assistente digital de vários idiomas no modo de idioma Serviço de Tradução:

1. Clique em para abrir o menu lateral, selecione Desenvolvimento > Assistentes Digitais e clique em Novo Assistente Digital.

2. Preencha a caixa de diálogo, prestando atenção especial a estes campos:
   • Versão da Plataforma: A versão da plataforma afeta o comportamento de seus assistentes digitais; por exemplo, o modo como o mecanismo NLU (Natural Language Understanding) resolve intenções e quais idiomas são suportados de forma nativa.

     Se você estiver começando com um novo assistente digital, selecione a versão mais recente disponível, pois o suporte para essa versão vai durar mais.

     Consulte Versão da Plataforma.

   • Idioma Principal: Este campo só será exibido se você tiver selecionado a Plataforma Versão 20.12 ou superior.

     Neste campo, selecione Inglês na seção Serviço de Tradução da lista drop-down.

     Cuidado:

     Certifique-se de ter selecionado na seção Serviço de Tradução. Se você selecionar na seção Suportado Nativamente, o assistente digital só aceitará habilidades que usem o modo Suportado Nativamente.

     Se esse campo não for exibido, o idioma do assistente digital será determinado pelo idioma da primeira habilidade adicionada a ele. Nesse caso, esse idioma é conhecido como idioma predominante em vez de idioma principal.

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 Detectar Idioma.

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 Detectar Idioma 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 evitar que essa alternância volte para o inglês em uma habilidade com um fluxo de caixas de diálogo desenvolvido no modo Visual, defina a propriedade Tag de Idioma do Perfil Existente do componente Detect Language como True em cada habilidade.

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

Para impedir essa alternância de volta para inglês em uma habilidade baseada em YAML, você precisa adicionar a seguinte propriedade ao componente System.DetectLanguage em cada habilidade:

      useExistingProfileLanguageTag: true

Este é um exemplo do componente System.DetectLanguage de uma habilidade baseada em YAML com a propriedade useExistingProfileLanguageTag definida:

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

Em texto visível para o usuário em um assistente digital que usa um serviço de tradução, 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.

Em assistentes digitais que usam um serviço de tradução, a chamada explícita de habilidades é reconhecida pelo assistente digital no idioma detectado e em inglês.

Você pode encontrar as strings traduzíveis nos dois lugares a seguir:

• Na página Habilidades () do assistente digital.

  Aqui você encontrará as strings que são usadas principalmente para os cartões de ajuda que são exibidos quando um usuário pede ajuda no assistente digital e quando o assistente digital recebe o usuário pela primeira vez.

  Para cada habilidade, você pode traduzir

  • Os campos Descrição de Uma Sentença, Descrição e Chamada.
  • As Declarações de Exemplo.
• Na página Definições (), na guia Configurações, na seção Parâmetros da Conversa. A partir da versão 21.04 da plataforma, as entradas do pacote de recursos são criadas automaticamente para essas definições.

As chaves de pacotes de recursos são usadas para identificar texto de saída que precisa ser traduzido e fornecer valores em um ou mais idiomas. Para assistentes digitais que usam a versão 21.04 ou mais recente da plataforma, as chaves são geradas automaticamente para as definições de configuração do assistente digital. Para outras strings (e para definições de configuração em assistentes digitais que estão na versão 21.02 ou anterior da plataforma), crie as chaves manualmente.

Quando um assistente digital recebe o usuário ou apresenta informações de ajuda para as habilidades que ele contém, ele usa valores da página Habilidades no assistente digital para preencher os cartões de boas-vindas e de ajuda. Você pode traduzir as informações que aparecem nesses cartões de ajuda editando alguns campos na página Habilidades.

1. Na navegação esquerda do assistente digital, clique em
2. Selecione uma habilidade.
3. Atualize os campos Descrição de Uma Sentença, Descrição e Chamadacom referências a pacotes de recursos no form:

   ${rb.BundleKeyName}

   Por exemplo, você pode usar o seguinte para uma referência a uma chave para a descrição de uma linha de uma habilidade de pizza.

   ${rb.PizzaSkillShortDescription}

4. Na seção Exemplos da página, passe o mouse sobre um exemplo, clique no ícone Editar e substitua o texto por uma referência a uma chave de pacote de recursos como acima.
5. Repita a etapa anterior para as outras declarações de exemplo da habilidade.
6. Repita as quatro etapas anteriores para cada habilidade.

Os assistentes digitais têm várias propriedades de configuração que são usadas para exibir vários prompts e mensagens.

Para definir a saída de uma propriedade de configuração, você menciona a variável do pacote de recursos e a chave de mensagem. Por exemplo: ${rb('WhatType')}. Você também pode usar notação de ponto, por exemplo: ${rb.WhatType}

1. Na barra de navegação esquerda do assistente digital, clique no ícone Definições () e selecione a guia Configurações.

2. Para as propriedades na seção Parâmetros da Conversa da página, informe as referências às chaves do pacote de recursos que você definiu para cada uma delas.

   Por exemplo, se você tiver uma chave em seu pacote de recursos chamada daAcknowledgementResponse para a propriedade Resposta de Confirmação, informe o seguinte no campo Resposta de Confirmação:

   ${rb('daAcknowledgementResponse')}

Você também pode usar parâmetros em valores para chaves de pacotes, o que permite o uso de variáveis do sistema na saída. Por exemplo, o valor padrão da propriedade Confirmação do Fluxo de Saída é:

Exited ${system.routingFromIntent} in ${system.routingFromSkill}.

Você pode preservar as referências às variáveis do sistema (nesse caso, system.routingFromIntent e system.routingFromSkill) em suas respostas traduzidas, fazendo o seguinte:

1. No valor da chave do pacote de recursos correspondente, insira {0}, {1} etc. como códigos de substituição para cada variável do sistema. Por exemplo, na entrada em inglês (ou padrão) criada para a propriedade Confirmação de Fluxo de Saída, você pode usar o seguinte texto:

   Exited {0} in {1}.

2. Em seguida, no valor da propriedade, informe a referência à chave do pacote no seguinte formato:

   ${rb('bundleKey', '${systemVariableForParam0}', '${systemVariableForParam1}')}

   Por exemplo, esta é a aparência da propriedade Confirmação do Fluxo de Saída (em que daExitFlowConfirmation é a chave do pacote correspondente):

   ${rb('daExitFlowConfirmation', '${system.routingFromIntent}', '${system.routingFromSkill}')}

Você pode exportar e importar pacotes de recursos na forma de um arquivo CSV, o que permite trabalhar com os pacotes off-line.

O arquivo CSV precisa ter as seguintes colunas:

• languageTag
• key
• message
• annotation

Para exportar um arquivo CSV com o pacote de recursos existente:

• Na página Pacote de Recursos da habilidade ou do assistente digital, clique em para exportar um arquivo CSV com o pacote de recursos existente.

  Mesmo que você ainda não tenha adicionado chaves ao pacote de recursos, um arquivo com o formato necessário do CSV será exportado.

Para importar um arquivo de pacote de recursos:

• Na página Pacote de Recursos da habilidade ou do assistente digital, clique em .

A partir da versão 21.04 da plataforma, as entradas do pacote de recursos são criadas automaticamente para definições de configuração do assistente digital. Se seu assistente digital for baseado na plataforma versão 21.02 ou anterior, você poderá fazer upgrade para a versão 21.04 ou posterior para que essas entradas sejam geradas para você.

Aqui está uma lista de todas as entradas do pacote de recursos do sistema para assistentes digitais, juntamente com seus valores padrão.

Se você quiser usar entradas de pacote de recursos para suas definições de configuração sem fazer upgrade da versão de plataforma do assistente digital para a versão 21.04 ou mais recente, aqui está uma lista das propriedades de personalização que você pode traduzir junto com os nomes sugeridos para as chaves de pacote e as expressões que você usaria para fazer referência a essas chaves de pacote dos campos das propriedades.