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. Abra o Console do Dialogflow CX.
  2. Escolha o projeto do Google Cloud para o agente.
  3. Encontre o agente na lista.
  4. Clique no nome de exibição do agente.
  5. Clique em Configurações do agente.
  6. Clique na guia Idiomas.
  7. Adicione ou remova idiomas conforme necessário.
  8. 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 de um idioma com o console, clique no botão de idioma na parte superior do console.

Captura de tela do idioma selecionado

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, Intent ou PageIntent.

Selecione um protocolo e uma versão para a referência EntityType:

Protocolo V3 V3beta1
REST Recurso EntityType Recurso EntityType
RPC Interface de EntityType Interface de EntityType
C++ EntityTypesClient Indisponível
C# EntityTypesClient Indisponível
Go EntityTypesClient Indisponível
Java EntityTypesClient EntityTypesClient
Node.js EntityTypesClient EntityTypesClient
PHP Indisponível Indisponível
Python EntityTypesClient EntityTypesClient
Ruby Indisponível Indisponível

Selecione um protocolo e uma versão para a referência de intent:

Protocolo V3 V3beta1
REST Recurso de intent Recurso de intent
RPC Interface da intent Interface da intent
C++ IntentsClient Indisponível
C# IntentsClient Indisponível
Go IntentsClient Indisponível
Java IntentsClient IntentsClient
Node.js IntentsClient IntentsClient
PHP Indisponível Indisponível
Python IntentsClient IntentsClient
Ruby Indisponível Indisponível

Selecione um protocolo e uma versão para a referência da página:

Protocolo V3 V3beta1
REST Recurso da página Recurso da página
RPC (remote procedure call) Interface da página Interface da página
C++ PagesClient Indisponível
C# PagesClient Indisponível
Go PagesClient Indisponível
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Indisponível Indisponível
Python PagesClient PagesClient
Ruby Indisponível Indisponível

É 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.languageCode do método detectIntent. Para mais informações, consulte o tipo Sessions.

Selecione um protocolo e uma versão para a referência de sessão:

Protocolo V3 V3beta1
REST Recurso da sessão Recurso da sessão
RPC (remote procedure call) Interface da sessão Interface da sessão
C++ SessionsClient Indisponível
C# SessionsClient Indisponível
Go SessionsClient Indisponível
Java SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP Indisponível Indisponível
Python SessionsClient SessionsClient
Ruby Indisponível Indisponível

Detecção automática de idioma

Se o idioma da consulta do usuário final for diferente do idioma especificado na solicitação, o Dialogflow poderá detectá-lo e mudar automaticamente para o idioma do usuário final. Consulte a de referência de idiomas para uma lista. de idiomas disponíveis para esse recurso. O campo LanguageInfo em um WebhookRequest identifica o idioma de entrada, o idioma resolvido e a pontuação de confiança quando a detecção de idioma está ativada.

Ativar a detecção automática de idioma

É necessário ativar a detecção automática de idioma nos níveis do agente e do fluxo.

  1. Acesse Configurações do agente e selecione a guia Idiomas.

  2. Marque a caixa ao lado de Ativar a detecção automática de idioma e trocar para ativar esse recurso para o agente. Clique em Salvar para salvar as mudanças.

  3. Selecione um fluxo e acesse Configurações de fluxo. No painel de configurações de fluxo, Marque a caixa ao lado de Ativar a detecção e troca de idioma automáticas.

  4. No menu suspenso Idiomas, selecione os idiomas em que você quer usar o Dialogflow. possam responder. Selecione apenas os idiomas que são compatível com o recurso de detecção automática de idioma.

  5. Clique em Salvar.

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 a detecção automática de idioma estiver desativada, o Dialogflow vai processar 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 agente por meio de integrações baseadas em texto usam apenas o idioma padrão do agente.