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 della directory principale e specifiche delle impostazioni internazionali
Esistono due categorie di lingue:
- Lingue principali: si tratta di lingue, ad esempio l'inglese (en), per le quali non è specificata alcuna impostazione internazionale.
- Lingue specifiche delle località: si tratta di lingue, ad esempio Inglese-USA (en-US), che specificano le impostazioni internazionali di una regione o di un paese specifico.
Alcune lingue agiscono sia come root sia in base alle impostazioni internazionali. Esistono differenze significative tra le impostazioni internazionali di queste lingue, pertanto 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 principali e personalizzarlo solo per lingue specifiche per le impostazioni internazionali in base alle tue esigenze.
Aggiungi una lingua
Per aggiungere una lingua o un'impostazione internazionale con la console di 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 della lingua. Quando crei un agente multilingue, devi fornire questi dati specifici per ogni lingua. Quando selezioni una lingua dalla console o ne fornisci una 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 per 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. Poiché l'agente era originariamente configurato in inglese, 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 ai 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 la versione per il riferimento EntityType:
| Protocollo | V3 | Versione 3 beta 1 |
|---|---|---|
| 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 la versione per il riferimento all'intent:
| Protocollo | V3 | Versione 3 beta 1 |
|---|---|---|
| REST | Risorsa intent | Risorsa intent |
| RPC | Interfaccia dell'intent | Interfaccia dell'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 la versione per il riferimento della pagina:
| Protocollo | V3 | Versione 3 beta 1 |
|---|---|---|
| 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 |
Devi effettuare chiamate API distinte per ogni lingua, in modo da accedere a tutti i dati specifici della lingua. Se le chiamate API aggiornano dati generici per la lingua, questi dati vengono aggiornati per tutte le lingue.
Esegui un test nel simulatore
Quando utilizzi il simulatore, scegli la lingua che vuoi usare selezionandola sotto il nome dell'agente.
Fornisci un linguaggio utilizzando l'API
Quando invii richieste tramite l'API, imposta il campo
queryInput.languageCode
del metodo detectIntent.
Per ulteriori informazioni, consulta il
tipo di Sessions.
Seleziona un protocollo e la versione come riferimento per la sessione:
| Protocollo | V3 | Versione 3 beta 1 |
|---|---|---|
| REST | Risorsa sessione | Risorsa sessione |
| RPC | Interfaccia della sessione | Interfaccia della 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 |
Richieste che non indicano 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 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 fornita, anche se quest'ultima non è supportata dall'agente.
Integrazioni
Le interazioni con l'agente tramite integrazioni basate su testo utilizzano solo la lingua predefinita dell'agente.