Agenti multilingue

Dialogflow supporta molte lingue. Per l'elenco completo, vedi pagina di riferimento delle lingue. La lingua scelta durante la creazione di un agente viene impostata come lingua predefinita, e potrai aggiungere altre lingue.

Lingue di origine e specifiche per le impostazioni internazionali

Esistono due categorie di lingue:

• Lingue principali: si tratta di lingue come Inglese (en) che non specificano una locale.
• Lingue specifiche per le lingue: Si tratta di lingue, ad esempio l'inglese americano (en-US) in cui viene specificata una lingua di una regione o di un paese specifici.

Alcune lingue funzionano sia come principale che per quelle specifiche per le impostazioni internazionali. Ci sono differenze significative tra le impostazioni internazionali per queste lingue, pertanto le impostazioni internazionali non possono condividere una lingua radice comune. Esempi:

• Cinese cantonese (zh-HK)
• Cinese semplificato (zh-CN)
• Cinese tradizionale (zh-TW)
• Portoghese-Brasile (pt-BR)
• Portoghese-Portogallo (pt)

Dovresti progettare l'agente principalmente per le lingue di base e personalizzarlo solo per le lingue specifiche della località, se necessario.

Aggiungere una lingua

Punto chiave: come best practice, devi completare l'agente nella lingua predefinita prima di aggiungere altre lingue.

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

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

Dati specifici per lingua

Nota: le informazioni contenute in questa sezione si applicano sia a specifiche delle impostazioni internazionali e principali. Ad esempio: en, en-US ed en-GB dispongono ciascuno di dati univoci per le frasi di addestramento per intent.

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 ogni lingua. Quando selezioni una lingua dalla console o fornire un linguaggio all'API, puoi accedere a questi dati specifici per la lingua in questione. Di seguito è riportato un elenco completo dei dati specifici per lingua:

• Frasi per l'addestramento dell'intent
• Risposte relative all'intent
• Voci entità

Per accedere a dati specifici per 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 t-shirt. L'agente è stato inizialmente configurato in inglese, quindi l'entità contiene voci come "S" con il sinonimo "small". Quando lo spagnolo viene aggiunto come lingua, l'entità viene creata da Dialogflow per la nuova lingua, ma devi fornire le voci dell'entità in spagnolo.

Per accedere a dati specifici per lingua con l'API, Fornisci il parametro languageCode durante il recupero, la creazione o l'aggiornamento EntityType o Intent di testo.

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

Esegui un 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 valore queryInput.input.languageCode del metodo detectIntent. Per ulteriori informazioni, consulta Tipo di Sessions.

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 specifica una lingua, Dialogflow determina automaticamente la lingua di input e risponde in quella lingua se il rilevamento automatico della lingua è attivo. Se la lingua impostata è disabilitato, Dialogflow gestisce la richiesta utilizzando il valore predefinito lingua.
• Quando una richiesta specifica una lingua specifica per le impostazioni internazionali che non è supportata dall'agente, ma la lingua principale associata è supportata dall'agente, Dialogflow gestisce la richiesta utilizzando la lingua principale.
• L'estrazione delle entità di sistema è un'eccezione alla regola precedente. L'estrazione delle entità di sistema utilizza la lingua anche se la lingua specifica delle impostazioni internazionali non è supportata dall'agente.

Integrazioni

Le interazioni con gli agenti tramite integrazioni basate su testo e gateway telefonico utilizzano solo la lingua predefinita dell'agente.