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

Ponto principal: uma prática recomendada é preencher seu agente com o idioma padrão antes de adicionar outros idiomas.

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

Observação: as informações nesta seção se aplicam a idiomas específicos de localidade e raízes. Por exemplo, en, en-US e en-GB têm dados exclusivos para frases de treinamento de intent.

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:

• frases de treinamento de intent
• respostas de fulfillment
• entradas de entidade

Para acessar dados específicos de um idioma com o console, clique no botão de idioma na parte superior do console.

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.

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. Acessar a referência da API EntityType

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

Fechar

Acessar a referência da API Intent

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

Fechar

Acessar a referência da API Page

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

Fechar

É 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. Acessar a referência da API Session

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

Fechar

Detecção automática de idioma

Observação: esse recurso está disponível apenas para conversas de chat.

Observação: no momento, a detecção de idioma só oferece suporte à identificação de idiomas com diferenças estruturais importantes, e não a variantes do mesmo idioma. Isso significa que o Dialogflow pode diferenciar entre idiomas como ["en", "pt-br"], mas não entre variantes do mesmo idioma, como ["zh-tw", "zh-cn"] ou ["pt", "pt-br"].

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 página Referência de idiomas para conferir 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 e troca automática de idioma para ativar esse recurso para o agente. Clique em Salvar para salvar as mudanças.

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

4. No menu suspenso Languages, selecione os idiomas em que você quer que o Dialogflow responda. Selecione apenas os idiomas que são compatíveis 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 o idioma de entrada e responde nesse idioma 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.