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:
- 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 Impostazioni agente.
- Fai clic sulla scheda Lingue.
- Aggiungi o rimuovi 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 ai dati specifici della lingua per quella determinata lingua. Di seguito è riportato un elenco completo dei dati specifici per le diverse lingue:
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. 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 ai dati specifici della lingua con l'API,
fornisci il parametro languageCode quando crei, crei o aggiorni i tipi
EntityType, Intent o Page.
Seleziona un protocollo e una versione per il riferimento 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 dell'intent:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| 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 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 |
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.languageCode del metodo detectIntent.
Per maggiori informazioni, consulta il
tipo Sessions.
Seleziona un protocollo e una versione per il riferimento sessione:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa sessione | Risorsa sessione |
| RPC | Interfaccia sessione | Interfaccia 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ò rilevarlo e passare automaticamente a quella dell'utente finale. Consulta la pagina di riferimento delle lingue per un elenco delle lingue disponibili per questa funzionalità. Il campo LanguageInfo in WebhookRequest identifica la lingua di input, la lingua risolta e il punteggio di confidenza quando il rilevamento della lingua è abilitato.
Attiva rilevamento automatico della lingua
Devi abilitare il rilevamento automatico della lingua sia a livello di agente che di flusso.
Vai a Impostazioni agente e seleziona la scheda Lingue.
Seleziona la casella accanto ad Attiva il rilevamento e il 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 il rilevamento e il cambio automatico della 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 della lingua.
Fai clic su Salva per salvare le modifiche.
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 utilizzano solo la lingua predefinita dell'agente.