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. Por exemplo:

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

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:

• 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

Acessar a referência da API Intent Acessar a referência da API Page

É 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

Detecção automática de idioma

Se o idioma de consulta do usuário final for diferente do especificado na solicitação, o Dialogflow poderá detectá-lo e alternar automaticamente para esse idioma. Consulte a página de referência de idiomas para ver uma lista dos 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 detecção automática de idiomas

Ative 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 alternância e detecção automática de idioma para ativar esse recurso para o agente. Clique em Salvar para manter as mudanças.

3. Selecione um fluxo e navegue até Flow settings. No painel de configurações de fluxo, marque a caixa ao lado de Ativar a detecção e a troca automática de idiomas.

4. No menu suspenso Idiomas, selecione os idiomas que você quer que o Dialogflow responda. Selecione apenas os idiomas compatíveis com o recurso de detecção automática de idiomas.

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