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 add 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 Salvar.

Intent multilíngue e dados de entidade

Para dados de intent e entidade, alguns dados são comuns para todos os idiomas de um agente multilíngue e alguns dados são específicos do idioma.

Dados genéricos de intent e entidade

Os dados de intent e entidade genéricos de linguagem são comuns para todos os idiomas compatíveis com um agente. Mesmo que um idioma específico seja selecionado no console ou fornecido à API, esses dados são compartilhados para todos os idiomas. Por exemplo, os seguintes dados são genéricos:

Dados de intent e de entidade específicos do idioma

Os dados de entidade e intent específicos do idioma são exclusivos para cada idioma compatível com um agente. Forneça esses dados separadamente para cada idioma. Ao selecionar um idioma no console ou fornecer um idioma à API, você pode acessar esses dados 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, a entidade size abaixo é usada 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.

Para acessar dados específicos da linguagem com a API, forneça o parâmetro language_code 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 languageCode. Para mais informações, consulte o método detectIntent do recurso Sessions.

Solicitações que não fornecem um idioma compatível

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 processa a solicitação usando o idioma padrão.
  • 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.