Dialogflow supporta molte lingue. Per l'elenco completo, consulta la pagina di riferimento delle lingue. La lingua scelta durante la creazione di un agente viene impostata come lingua predefinita e puoi aggiungerne altre.
Lingue di origine e specifiche per le impostazioni internazionali
Esistono due categorie di lingue:
- Lingue principali: si tratta di lingue come l'inglese (en) per le quali non viene specificata una lingua.
- Lingue specifiche delle località: si tratta di lingue come l'inglese-USA (en-US) in cui viene specificata una lingua come regione o paese specifici.
Alcune lingue funzionano sia come principale che per quelle specifiche per le impostazioni internazionali. Esistono differenze significative tra le impostazioni internazionali per queste lingue, pertanto non possono condividere una lingua principale 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 principali e personalizzalo solo per le lingue specifiche delle impostazioni internazionali, se necessario.
Aggiungi una lingua
Per aggiungere una lingua o un'impostazione internazionale con la console Dialogflow:
- Apri la console Dialogflow CX.
- Scegli il progetto Google Cloud per l'agente.
- Trova l'agente nell'elenco.
- Fai clic sul nome visualizzato dell'agente.
- Fai clic su Agent Settings (Impostazioni agente).
- Fai clic sulla scheda Lingue.
- Aggiungi o rimuovi le lingue in base alle esigenze.
- 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 a questi dati specifici per la lingua in questione. Di seguito è riportato un elenco completo dei dati specifici per lingua:
Per accedere a dati specifici di una lingua con la console, fai clic sul pulsante della lingua nella parte superiore della console.
Ad esempio, il tipo di entità size riportato di seguito viene utilizzato per ordinare le t-shirt. L'agente era originariamente configurato in inglese, quindi l'entità ha voci come "S" con sinonimo "small". Quando si aggiunge lo spagnolo come lingua, l'entità viene creata da Dialogflow per la nuova lingua, ma devi fornire le voci delle entità in spagnolo.
![Screenshot dell'entità](https://cloud.google.com/static/dialogflow/cx/docs/images/spanish-size-entity.png?authuser=0000&hl=it)
Per accedere a dati specifici per lingua con l'API,
fornisci il parametro languageCode
durante il recupero, la creazione o l'aggiornamento dei tipi
EntityType
, Intent
o Page
.
Seleziona un protocollo e una versione per il riferimento a EntityType:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa EntityType | Risorsa EntityType |
RPC | Interfaccia EntityType | Interfaccia EntityType |
C++ | EntityTypesClient | Non disponibile |
C# | EntityTypesClient | Non disponibile |
Go | EntityTypesClient | Non disponibile |
Java | EntityTypesClient | EntityTypesClient |
Node.js | EntityTypesClient | EntityTypesClient |
PHP | Non disponibile | Non disponibile |
Python | EntityTypesClient | EntityTypesClient |
Ruby | Non disponibile | Non disponibile |
Seleziona un protocollo e una versione per il riferimento per intent:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa per intent | Risorsa per intent |
RPC | Interfaccia per intent | Interfaccia per intent |
C++ | IntentsClient | Non disponibile |
C# | IntentsClient | Non disponibile |
Go | IntentsClient | Non disponibile |
Java | IntentsClient | IntentsClient |
Node.js | IntentsClient | IntentsClient |
PHP | Non disponibile | Non disponibile |
Python | IntentsClient | IntentsClient |
Ruby | Non disponibile | Non disponibile |
Seleziona un protocollo e una versione per il riferimento della pagina:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa della pagina | Risorsa della pagina |
RPC | Interfaccia della pagina | Interfaccia della pagina |
C++ | PagesClient | Non disponibile |
C# | PagesClient | Non disponibile |
Go | PagesClient | Non disponibile |
Java | PagesClient | PagesClient |
Node.js | PagesClient | PagesClient |
PHP | Non disponibile | Non disponibile |
Python | PagesClient | PagesClient |
Ruby | Non disponibile | Non disponibile |
Per accedere a tutti i dati specifici per ogni lingua, devi effettuare chiamate API distinte. Se le chiamate API aggiornano dati generici linguistici, 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.
Fornire una lingua utilizzando l'API
Quando invii richieste tramite l'API, imposta il campo queryInput.languageCode
del metodo detectIntent
.
Per maggiori informazioni, consulta il
tipo di Sessions
.
Seleziona un protocollo e una versione per il riferimento sessione:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa di sessione | Risorsa di sessione |
RPC | Interfaccia di sessione | Interfaccia di sessione |
C++ | SessionsClient | Non disponibile |
C# | SessionsClient | Non disponibile |
Go | SessionsClient | Non disponibile |
Java | SessionsClient | SessionsClient |
Node.js | SessionsClient | SessionsClient |
PHP | Non disponibile | Non disponibile |
Python | SessionsClient | SessionsClient |
Ruby | Non disponibile | Non disponibile |
Rilevamento automatico della lingua
Se la lingua delle query dell'utente finale è diversa da quella specificata nella richiesta, Dialogflow può rilevarla e passare automaticamente alla lingua dell'utente finale. Consulta la pagina di riferimento alla lingua per un elenco delle lingue disponibili per questa funzionalità. Il campo LanguageInfo
in un
WebhookRequest
identifica la lingua di input, la lingua risolta e il punteggio di confidenza quando
il rilevamento della lingua è abilitato.
Attiva rilevamento automatico lingua
Devi abilitare il rilevamento automatico della lingua sia a livello di agente che a livello di flusso.
Vai a Impostazioni agente e seleziona la scheda Lingue.
Seleziona la casella accanto ad Attiva rilevamento e cambio automatico della lingua per abilitare questa funzionalità per l'agente. Fai clic su Salva per salvare le modifiche.
Seleziona un flusso e vai a Impostazioni flusso. Nel riquadro delle impostazioni del flusso, seleziona la casella accanto ad Attiva rilevamento e cambio automatico lingua.
Nel menu a discesa Lingue, seleziona le lingue in cui vuoi che Dialogflow possa rispondere. Assicurati di selezionare solo le lingue supportate dalla funzionalità di rilevamento automatico delle lingue.
Fai clic su Salva per salvare le modifiche.
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 è abilitato il rilevamento automatico della lingua. 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 che non è supportata dall'agente, ma la lingua radice associata è supportata dall'agente, Dialogflow gestisce la richiesta utilizzando la lingua radice.
- 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 questa non è supportata dall'agente.
Integrazioni
Le interazioni con l'agente tramite integrazioni basate su testo utilizzano solo la lingua predefinita dell'agente.