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 CX:
- Abra o console do Dialogflow CX.
- Escolha o projeto Google Cloud para o agente.
- Encontre o agente na lista.
- Clique no nome de exibição do agente.
- Clique em Configurações do agente.
- Clique na guia Idiomas.
- Adicione ou remova idiomas conforme necessário.
- 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.
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.
| Entidade | Sinônimos |
|---|---|
| XS | XS, extra pequeño |
| S | S, pequeño |
| M | M, medio |
| L | L, grande |
| XL | GG, extragrande |
Gerar dados específicos de idioma com IA
Os agentes de conversação (Dialogflow CX) oferecem a opção de acelerar o processo de adição de dados específicos do idioma usando a geração de IA para fornecer os dados, em vez de inseri-los manualmente. Isso pode ser feito nos níveis de intenção, entidade e atendimento como um recurso de prévia.
Se você não quiser usar a geração de IA, ainda poderá inserir manualmente os dados para idiomas que não são os padrões.
Geração de IA com base em intent
Gerar automaticamente frases de treinamento em um idioma diferente do padrão:
- Acesse Configurações do agente > Idiomas e verifique se você ativou um ou mais idiomas não padrão para o agente.
- Navegue até o menu suspenso de idiomas na parte de cima do console e selecione o idioma não padrão escolhido.
- Navegue até a guia Gerenciar, clique em Intents e escolha uma das suas intents. Verifique se o campo Descrição está preenchido com uma descrição da finalidade da intenção. A descrição pode estar no seu idioma padrão ou no idioma em que você está visualizando.
- Quando você ativa um idioma que não é o padrão, os agentes de conversação (Dialogflow CX) não traduzem nenhuma frase de treinamento para o novo idioma. Para criar novas frases de treinamento no novo idioma, clique no botão de opção __ frases recém-geradas pela LLM. O valor padrão é 3. Para copiar e traduzir automaticamente as frases de treinamento atuais, selecione Todas as frases de treinamento do seu idioma padrão traduzidas pela geração de IA.
- Clique em + Adicionar. O número especificado de frases de treinamento é gerado e preenchido na tabela no idioma selecionado. Revise todas as frases de treinamento geradas para garantir a precisão.
(Prévia) Geração de IA de entidades
Gerar e traduzir automaticamente valores de referência e sinônimos em um idioma diferente do padrão:
- Acesse Configurações do agente > Idiomas e verifique se você ativou um ou mais idiomas não padrão para o agente.
- Navegue até o menu suspenso de idiomas na parte de cima do console e selecione o idioma não padrão escolhido.
- Acesse a guia Gerenciar, clique em Tipos de entidade e escolha um dos seus tipos de entidade.
- Quando você ativa um idioma que não é o padrão, os agentes de conversação (Dialogflow CX) não traduzem automaticamente os valores de referência e sinônimos existentes. Para traduzir automaticamente esses valores para o novo idioma, clique em + Copiar do idioma padrão. Todos os dados originais do tipo de entidade do idioma padrão serão traduzidos para o novo idioma e preenchidos na tabela. Traduzir mais de 50 itens por vez pode causar erros. Cada valor de referência e sinônimo conta como um item.
- Você também pode adicionar novos valores de referência clicando em + Adicionar nova entrada. Você pode digitar um valor de referência no seu idioma padrão, e tanto o valor de referência quanto os sinônimos serão traduzidos automaticamente para o novo idioma.
(Prévia) Geração de IA de atendimento
A geração de IA está disponível para tipos de fulfillment de rota, grupos de rotas e manipuladores de eventos. Para mais informações sobre esses tipos de rotas, consulte a documentação de rotas e processadores de eventos.
Esse recurso só vai aparecer se você estiver visualizando o agente em um idioma diferente do padrão e em um dos tipos de trajeto especificados. Navegue até a seção Fulfillment da rota. Para copiar e traduzir automaticamente as respostas do agente do seu idioma padrão para o idioma que você está usando, clique em Copiar e traduzir. Traduzir mais de 50 respostas por vez pode causar erros.
Dados específicos de idioma ao usar a API
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 EntityType | Interface 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á detectar e mudar automaticamente para o idioma do usuário final. Consulte a página de 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
Você precisa ativar a detecção automática de idioma nos níveis do agente e do fluxo.
Acesse Configurações do agente e selecione a guia Idiomas.
Marque a caixa ao lado de Ativar a detecção e troca automática de idioma para ativar esse recurso no agente. Clique em Salvar para armazenar as mudanças.
Selecione um fluxo e acesse Configurações de fluxo. No painel de configurações do fluxo, marque a caixa ao lado de Ativar a detecção e troca automática de idioma.
No menu suspenso Idiomas, selecione os idiomas em que você quer que o Dialogflow responda. Selecione apenas idiomas compatíveis com a detecção automática.
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 nele 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.