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:
- Abra o Console do Dialogflow CX.
- Escolha o projeto do GCP 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.
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 |
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 a processa 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.