Agenti multilingue

Dialogflow supporta molti linguaggi. Per l'elenco completo, consulta la pagina di riferimento dei linguaggi. La lingua scelta durante la creazione di un agente viene impostata come lingua predefinita e puoi aggiungere altre lingue.

Lingue root e specifiche per le impostazioni internazionali

Esistono due categorie di lingue:

  • Lingue root: sono lingue come inglese (en) che non specificano le impostazioni internazionali.
  • Lingue specifiche per le impostazioni internazionali: sono lingue come inglese-Stati Uniti (en-US) che specificano le impostazioni internazionali come regione o paese specifico.

Alcune lingue fungono sia da root sia da specifiche per le impostazioni internazionali. Esistono differenze significative tra le impostazioni internazionali per queste lingue, pertanto le impostazioni internazionali non possono condividere una lingua root comune. Esempi:

  • Cinese cantonese (zh-HK)
  • Cinese semplificato (zh-CN)
  • Cinese tradizionale (zh-TW)
  • Portoghese brasiliano (pt-BR)
  • Portoghese portoghese (pt)

Dovresti progettare principalmente l'agente per le lingue root e personalizzarlo solo per le lingue specifiche per le impostazioni internazionali, se necessario.

Aggiungere una lingua

Per aggiungere una lingua o impostazioni internazionali con la console di Dialogflow ES:

  1. Nel menu della barra laterale a sinistra, fai clic sul pulsante Aggiungi lingua accanto alle lingue esistenti.
    Viene visualizzata la scheda Lingue delle impostazioni dell'agente.
  2. Scegli una lingua dal menu a discesa Seleziona lingua aggiuntiva.
  3. Per aggiungere impostazioni internazionali, passa il mouse sopra una lingua root e fai clic su + Aggiungi impostazioni internazionali.
  4. Fai clic su Salva.

Dati specifici per lingua

La maggior parte dei dati dell'agente è comune a tutte le lingue di un agente multilingue. Tuttavia, il testo utilizzato per interagire con un utente finale è specifico per la lingua. Quando crei un agente multilingue, devi fornire questi dati specifici per la lingua per ogni lingua. Quando selezioni una lingua dalla console o fornisci una lingua all'API, puoi accedere a questi dati specifici per la lingua. Di seguito è riportato un elenco completo dei dati specifici per la lingua:

Per accedere ai dati specifici per la lingua con la console, fai clic sul pulsante della lingua sotto il nome dell'agente.

Ad esempio, il tipo di entità size riportato di seguito viene utilizzato per ordinare le t-shirt. L'agente è stato originariamente configurato in inglese, quindi l'entità ha voci come "S" con il sinonimo "small". Quando viene aggiunto lo spagnolo come lingua, l'entità viene creata da Dialogflow per la nuova lingua, ma devi fornire le voci dell'entità in spagnolo.

Entità Sinonimi
XS XS, extra pequeño
S S, pequeño
M M, medio
L L, grande
XL XL, extra grande

Dati specifici per la lingua quando si utilizza l'API

Per accedere ai dati specifici per la lingua con l'API, fornisci il parametro languageCode quando recuperi, crei o aggiorni EntityType o Intent tipi.

Devi effettuare chiamate API separate per ogni lingua per accedere a tutti i dati specifici per la lingua. Se le chiamate API aggiornano i dati generici della lingua, questi dati vengono aggiornati per tutte le lingue.

Test nel simulatore

Quando utilizzi il simulatore, scegli la lingua che vuoi utilizzare selezionandola sotto il nome dell'agente.

Fornire una lingua utilizzando l'API

Quando invii richieste tramite l'API, imposta il queryInput.input.languageCode campo del metodo detectIntent. Per ulteriori informazioni, consulta il Sessions tipo.

Richieste che non forniscono la lingua di un agente

Quando Dialogflow riceve una richiesta che non fornisce una lingua supportata dall'agente, si applicano le seguenti regole:

  • Quando una richiesta non fornisce una lingua, Dialogflow determina automaticamente la lingua di input e risponde in quella lingua se il rilevamento automatico della lingua è attivato. Se il rilevamento automatico della lingua è disattivato, Dialogflow gestisce la richiesta utilizzando la lingua predefinita.
  • Quando una richiesta fornisce una lingua specifica per le impostazioni internazionali non supportata dall'agente, ma la lingua root associata è supportata dall'agente, Dialogflow gestisce la richiesta utilizzando la lingua root.
  • L'estrazione delle entità di sistema è un'eccezione alla regola precedente. L'estrazione delle entità di sistema utilizza la lingua specifica per le impostazioni internazionali fornita, anche se la lingua specifica per le impostazioni internazionali non è supportata dall'agente.

Integrazioni

Le interazioni con gli agenti tramite le integrazioni del gateway basato su testo e telefono utilizzano solo la lingua predefinita dell'agente.