Agentes multilingues

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.

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 ES:

  1. No menu da barra lateral do lado esquerdo, clique no botão adicionar idioma junto aos idiomas existentes.
    Isto permite aceder ao separador Idiomas das definições do agente.
  2. Escolha um idioma no menu pendente Selecionar idioma adicional.
  3. Para adicionar um local, passe o cursor do rato sobre um idioma base e clique em + Adicionar local.
  4. 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 abaixo do nome do agente.

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

Dados específicos do idioma quando usa a API

Para aceder a dados específicos do idioma com a API, forneça o parâmetro languageCode quando obtiver, criar ou atualizar os tipos EntityType ou Intent.

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.input.languageCode do método detectIntent. Para mais informações, consulte o tipo Sessions.

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 com agentes através de integrações baseadas em texto e na gateway de telefone usam apenas o idioma predefinido do agente.