O Dialogflow é compatível com muitos idiomas. Para ver a lista completa, consulte a página de referência de idiomas. O idioma que escolher quando criar um agente é definido como o idioma predefinido. Pode adicionar idiomas adicionais.
Âmbito da seleção de idioma na consola e na API
Quando seleciona um idioma na consola ou na API, esta seleção afeta apenas os fluxos do agente. Para a seleção de idioma com guias interativos, consulte o apoio técnico de idiomas dos guias interativos.
Idiomas raiz e específicos do local
Existem duas categorias de idiomas:
- Idiomas raiz: estes são idiomas como o inglês (en) que não especificam um local.
- Idiomas específicos do local: estes são idiomas como inglês (EUA) (en-US) que especificam um local como uma região ou um país específico.
Alguns idiomas funcionam como raiz e específicos da localização. Existem diferenças significativas entre os locais destes idiomas, pelo que os locais não podem partilhar um idioma-raiz comum. Exemplos:
- Chinês-cantonês (zh-HK)
- Chinês simplificado (zh-CN)
- Chinês-tradicional (zh-TW)
- Português do Brasil (pt-BR)
- Português-Portugal (pt)
Deve conceber principalmente o seu agente para idiomas raiz e apenas personalizar para idiomas específicos do local, conforme necessário.
Adicione um idioma
Para adicionar um idioma ou uma região com a consola do Dialogflow CX:
- Abra a consola do Dialogflow CX.
- Escolha o Google Cloud projeto para o agente.
- Encontre o agente na lista.
- Clique no nome a apresentar do agente.
- Clique em Definições do agente.
- Clique no separador Idiomas.
- Adicione ou remova idiomas conforme necessário.
- Clique em Guardar.
Dados específicos do idioma
A maioria dos dados dos agentes é comum a todos os idiomas de um agente multilingue. No entanto, o texto usado para interagir com um utilizador final é específico do idioma. Ao criar um agente multilingue, tem de fornecer estes dados específicos do idioma para cada idioma. Quando seleciona um idioma na consola ou fornece um idioma à API, pode aceder a estes dados específicos do idioma em questão. Segue-se uma lista completa de dados específicos do idioma:
Para aceder a dados específicos do idioma com a consola, clique no botão de idioma na parte superior da consola.
Por exemplo, o tipo de entidade size abaixo é usado para encomendar t-shirts. O agente foi originalmente configurado em inglês, pelo que a entidade tem entradas como "S" com o sinónimo "small". Quando o espanhol é adicionado como idioma, a entidade é criada pelo Dialogflow para o novo idioma, mas tem de fornecer entradas de entidades em espanhol.
| Entidade | Sinónimos |
|---|---|
| XS | XS, extra pequeno |
| S | S, pequeño |
| M | M, medio |
| L | L, grande |
| XL | XL, extra grande |
Gere dados específicos do idioma com a IA
Os agentes conversacionais (Dialogflow CX) oferecem-lhe a opção de acelerar o processo de adição de dados específicos do idioma através da geração de IA para fornecer os dados, em vez de os introduzir manualmente. Isto pode ser feito ao nível da intenção, da entidade e do preenchimento como uma funcionalidade de pré-visualização.
Se optar por não usar a geração de IA, pode continuar a introduzir manualmente os dados para idiomas não predefinidos.
Geração de IA de intenção
Gerar automaticamente expressões de preparação num idioma não predefinido:
- Aceda a Definições do agente > Idiomas e certifique-se de que tem um ou mais idiomas não predefinidos ativados para o seu agente.
- Navegue até ao menu pendente de idiomas na parte superior da consola e selecione o idioma não predefinido escolhido.
- Navegue para o separador Gerir, clique em Intenções e escolha uma das suas intenções. Certifique-se de que o campo Descrição está preenchido com uma descrição da finalidade da intenção. A descrição pode estar no seu idioma predefinido ou no idioma em que está a ver o conteúdo.
- Quando ativa um idioma não predefinido, os agentes conversacionais (Dialogflow CX) não traduzem nenhuma das expressões de treino existentes para o novo idioma. Para criar novas expressões de treino no novo idioma, clique no botão radial __ expressões recém-geradas pelo MDG. O valor predefinido é 3. Para copiar e traduzir automaticamente as suas expressões de treino existentes, selecione Todas as expressões de treino do seu idioma predefinido traduzidas pela geração de IA.
- Clique em + Adicionar. O número especificado de expressões de preparação é gerado e preenchido na tabela no idioma que selecionou. Certifique-se de que revisa todas as expressões de preparação geradas para garantir a precisão.
(Pré-visualização) Geração de IA de entidades
Gerar e traduzir automaticamente valores de referência e sinónimos num idioma não predefinido:
- Aceda a Definições do agente > Idiomas e certifique-se de que tem um ou mais idiomas não predefinidos ativados para o seu agente.
- Navegue para o menu pendente de idiomas na parte superior da consola e selecione o idioma não predefinido escolhido.
- Navegue para o separador Gerir e, de seguida, clique em Tipos de entidades e escolha um dos seus tipos de entidades.
- Quando ativa um idioma não predefinido, os agentes conversacionais (Dialogflow CX) não traduzem automaticamente os valores de referência e os sinónimos existentes. Para traduzir automaticamente estes valores para o novo idioma, clique em + Copiar do idioma predefinido. Todos os dados originais do tipo de entidade do idioma predefinido são traduzidos para o novo idioma e preenchidos na tabela. Tenha em atenção que a tradução de mais de 50 itens de cada vez pode causar erros. Cada valor de referência e sinónimo é contabilizado como um item.
- Também pode adicionar novos valores de referência clicando em + Adicionar nova entrada. Pode escrever um valor de referência no seu idioma predefinido, e o valor de referência e os respetivos sinónimos são traduzidos automaticamente para o novo idioma.
(Pré-visualização) Geração de IA de processamento
A geração de IA está disponível para tipos de preenchimento de rotas, grupos de rotas e processadores de eventos. Para mais informações sobre estes tipos de percursos, consulte a documentação sobre percursos e controladores de eventos.
Esta funcionalidade só é apresentada se estiver a ver o agente num idioma não predefinido e num dos tipos de trajeto especificados. Navegue para a secção Cumprimento do trajeto. Para copiar e traduzir automaticamente as respostas do agente do seu idioma predefinido para o idioma que está a ver, clique em Copiar e traduzir. Tenha em atenção que a tradução de mais de 50 respostas de cada vez pode originar erros.
Dados específicos do idioma quando usa a API
Para aceder a dados específicos de um idioma com a API, forneça o parâmetro languageCode quando obtiver, criar ou atualizar os tipos EntityType, Intent ou Page.
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 | Não disponível |
| C# | EntityTypesClient | Não disponível |
| Ir | EntityTypesClient | Não disponível |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | Não disponível | Não disponível |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | Não disponível | Não disponível |
Selecione um protocolo e uma versão para a referência de intenção:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de intenção | Recurso de intenção |
| RPC | Interface de intenção | Interface de intenção |
| C++ | IntentsClient | Não disponível |
| C# | IntentsClient | Não disponível |
| Ir | IntentsClient | Não disponível |
| Java | IntentsClient | IntentsClient |
| Node.js | IntentsClient | IntentsClient |
| PHP | Não disponível | Não disponível |
| Python | IntentsClient | IntentsClient |
| Ruby | Não disponível | Não disponível |
Selecione um protocolo e uma versão para a Referência da página:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de página | Recurso de página |
| RPC | Interface de página | Interface de página |
| C++ | PagesClient | Não disponível |
| C# | PagesClient | Não disponível |
| Ir | PagesClient | Não disponível |
| Java | PagesClient | PagesClient |
| Node.js | PagesClient | PagesClient |
| PHP | Não disponível | Não disponível |
| Python | PagesClient | PagesClient |
| Ruby | Não disponível | Não disponível |
Tem de fazer chamadas API separadas para cada idioma para aceder a todos os dados específicos do idioma. Se as chamadas da API atualizarem dados genéricos de idioma, esses dados são atualizados para todos os idiomas.
Teste no simulador
Quando usar o simulador, escolha o idioma que quer usar selecionando-o abaixo do nome do agente.
Forneça um idioma através da API
Quando enviar pedidos através 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 da sessão:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de sessão | Recurso de sessão |
| RPC | Interface de sessão | Interface de sessão |
| C++ | SessionsClient | Não disponível |
| C# | SessionsClient | Não disponível |
| Ir | SessionsClient | Não disponível |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Não disponível | Não disponível |
| Python | SessionsClient | SessionsClient |
| Ruby | Não disponível | Não disponível |
Deteção automática de idioma
Se o idioma da consulta do utilizador final for diferente do idioma especificado no pedido, o Dialogflow pode detetá-lo e mudar automaticamente para o idioma do utilizador final. Consulte a página de referência de idiomas para ver uma lista
de idiomas disponíveis para esta funcionalidade. O campo LanguageInfo num elemento
WebhookRequest
identifica o idioma de entrada, o idioma resolvido e a pontuação de confiança quando a
deteção de idioma está ativada.
Ative a deteção automática de idioma
Tem de ativar a deteção automática de idiomas ao nível do agente e do fluxo.
Aceda às Definições do agente e selecione o separador Idiomas.
Selecione a caixa junto a Ativar deteção e mudança automática de idioma para ativar esta funcionalidade para o agente. Clique em Guardar para guardar as alterações.
Selecione um fluxo e navegue para Definições do fluxo. No painel de definições do fluxo, selecione a caixa junto a Ativar deteção e comutação automática de idioma.
No menu pendente Idiomas, selecione os idiomas nos quais quer que o Dialogflow consiga responder. Certifique-se de que seleciona apenas idiomas suportados pela funcionalidade de deteção automática de idiomas.
Clique em Guardar para guardar as alterações.
Pedidos que não indicam o idioma de um agente
Quando o Dialogflow recebe um pedido que não fornece um idioma suportado pelo agente, aplicam-se as seguintes regras:
- Quando um pedido não fornece um idioma, o Dialogflow determina automaticamente o idioma de entrada e responde nesse idioma se a deteção automática do idioma estiver ativada. Se a deteção automática de idioma estiver desativada, o Dialogflow processa o pedido com o idioma predefinido.
- Quando um pedido fornece um idioma específico da região que não é suportado pelo agente, mas o idioma raiz associado é suportado pelo agente, o Dialogflow processa o pedido através do idioma raiz.
- A extração de entidades do sistema é uma exceção à regra anterior. A extração de entidades do sistema usa o idioma específico do local fornecido, mesmo que o idioma específico do local não seja suportado pelo agente.
Integrações
As interações do agente através de integrações baseadas em texto usam apenas o idioma predefinido do agente.