Agentes multilíngues

O Dialogflow é compatível com vários idiomas. Para ter acesso à lista completa, consulte a página de referência de idiomas. O idioma escolhido ao criar o agente é definido como o padrão, mas é possível adicionar outros idiomas.

Idiomas base e específicos de localidade

Há duas categorias de idiomas:

  • Idiomas base: são idiomas como o inglês (en) que não especificam uma localidade.
  • Idiomas específicos de localidade: são idiomas como o inglês norte-americano (en-US) que especificam uma localidade, como uma região ou país específico.

Alguns idiomas podem ser base e específicos de localidade. Há diferenças significativas entre as localidades desses idiomas, de modo que essas localidades não podem compartilhar um idioma base comum. Exemplos:

  • Chinês cantonês (zh-HK)
  • Chinês simplificado (zh-CN)
  • Chinês tradicional (zh-TW)
  • Português brasileiro (pt-BR)
  • Português de Portugal (pt)

Projete seu agente principalmente para idiomas base e o personalize apenas para idiomas específicos de localidade, conforme necessário.

Adicionar um idioma

Para adicionar um idioma ou localidade ao Console do Dialogflow:

  1. No menu da barra lateral à esquerda, clique no botão de adição de idioma ao lado dos idiomas atuais.
    Isso vai direcionar você para a guia Idiomas das configurações do agente.
  2. Escolha um idioma no menu suspenso Selecionar um idioma extra.
  3. Para adicionar uma localidade, passe o cursor sobre o idioma base e clique em + Add locale.
  4. Clique em Save.

Dados específicos de idioma

A maioria dos dados de agentes é comum para todos os idiomas de um agente multilíngue. No entanto, o texto usado para interagir com um usuário final depende de um idioma específico. Ao criar um agente multilíngue, você precisa fornecer esses dados específicos para cada idioma. Ao selecionar um idioma no console ou fornecer um idioma à API, você pode acessar esses dados específicos do idioma para o idioma especificado. Veja a seguir uma lista completa de dados específicos do idioma:

Para acessar dados específicos do idioma com o console, clique no botão de idioma abaixo do nome do agente.

Por exemplo, o tipo de entidade size abaixo é usado para pedir camisetas. O agente foi originalmente configurado em inglês. Portanto, a entidade tem entradas como “S” com o sinônimo “small” (pequeno). Quando o idioma espanhol é adicionado, a entidade é criada pelo Dialogflow para o novo idioma, mas é necessário fornecer entradas de entidade em espanhol.

Captura de tela de entidade

Para acessar dados específicos da linguagem com a API, forneça o parâmetro languageCode ao receber, criar ou atualizar tipos EntityType ou Intent.

É necessário fazer chamadas de API separadas para cada idioma para acessar todos os dados específicos do idioma. Se a API chamar dados de atualização de idioma genérico, esses dados serão atualizados para todos os idiomas.

Testar no simulador

Ao usar o simulador, escolha o idioma que você quer usar, selecionando-o abaixo do nome do agente.

Fornecer um idioma usando a API

Ao enviar solicitações por meio da API, defina o campo queryInput.input.languageCode do método detectIntent. Para ver mais informações, consulte o tipo Sessions.

Solicitações que não fornecem o idioma de um agente

Quando o Dialogflow recebe uma solicitação que não fornece um idioma compatível com o agente, as seguintes regras são aplicadas:

  • Quando uma solicitação não fornece um idioma, o Dialogflow determina automaticamente ao idioma de entrada e responde se a detecção automática de idioma estiver ativada. Se o idioma for automático estiver desativada, o Dialogflow processará a solicitação usando o idioma de destino.
  • Quando uma solicitação fornece um idioma específico da localidade que não é compatível com o agente, mas o idioma base associado é, o Dialogflow processa a solicitação usando o idioma base.
  • A extração de entidade do sistema é uma exceção à regra anterior. Ela usa o idioma específico da localidade fornecido, mesmo que ele não seja compatível com o agente.

Integrações

As interações de agentes por meio de integrações de gateway de telefone e baseadas em texto usam apenas o idioma padrão do agente.