Dialogflow supporta molte lingue. Per l'elenco completo, consulta la pagina di riferimento delle lingue. La lingua che scegli durante la creazione di un agente è impostata come lingua predefinita e puoi aggiungere altre lingue.
Lingue principali e specifiche per le impostazioni internazionali
Esistono due categorie di lingue:
- Lingue principali: si tratta di lingue, come l'inglese (en), che non specificano impostazioni internazionali.
- Lingue specifiche di una regione: si tratta di lingue, ad esempio Inglese-USA (en-US), che specificano un'impostazione internazionale come una regione o un paese specifico.
Alcune lingue agiscono da radice sia specifiche per le impostazioni internazionali. Esistono 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)
Progetta l'agente principalmente per le lingue radice e personalizzalo solo per lingue specifiche per le impostazioni internazionali.
Aggiungi una lingua
Per aggiungere una lingua o impostazioni internazionali con la console di Dialogflow:
- Nel menu della barra laterale sinistra, fai clic sul pulsante Aggiungi lingua add accanto alle lingue esistenti.
Si aprirà la scheda Lingue delle impostazioni dell'agente. - Scegli una lingua dal menu a discesa Seleziona un'altra lingua.
- Per aggiungere delle impostazioni internazionali, passa il mouse sopra una lingua principale e fai clic su + Aggiungi impostazioni internazionali.
- Fai clic su Salva.
Dati specifici per lingua
La maggior parte dei dati degli agenti è comune per 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 dati specifici per ogni lingua. Quando selezioni una lingua dalla console o fornisci una lingua all'API, puoi accedere ai dati specifici della lingua per quella determinata lingua. Di seguito è riportato un elenco completo dei dati specifici per le diverse lingue:
Per accedere ai dati specifici della 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 era inizialmente 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.
Per accedere a dati specifici per un linguaggio con l'API, fornisci il parametro languageCode durante il recupero, la creazione o l'aggiornamento dei tipi di EntityType o Intent.
Occorre effettuare chiamate API separate per ogni lingua, in modo da accedere a tutti i dati specifici. Se le chiamate API aggiornano i dati generici della lingua, questi dati vengono aggiornati per tutte le lingue.
Esegui un test nel simulatore
Quando utilizzi il simulatore, scegli la lingua da utilizzare selezionandola sotto il nome dell'agente.
Fornisci un linguaggio utilizzando l'API
Quando invii le richieste tramite l'API, imposta il campo queryInput.input.languageCode del metodo detectIntent.
Per maggiori informazioni, consulta il
tipo di Sessions.
Richieste che non indicano la lingua dell'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 è abilitato. Se il rilevamento automatico della lingua è disabilitato, 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 radice 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 specifica della lingua, anche se quella specifica dell'impostazione internazionale non è supportata dall'agente.
Integrazioni
Le interazioni con l'agente tramite integrazioni basate su testo e gateway telefonici utilizzano solo la lingua predefinita dell'agente.