Dialogflow supporta molti linguaggi. Per l'elenco completo, consulta la pagina di riferimento delle lingue. La lingua scelta durante la creazione di un agente viene impostata come predefinita e puoi aggiungere altre lingue.
Lingue principali e specifiche per le impostazioni internazionali
Esistono due categorie di lingue:
- Lingue di base: si tratta di lingue come Inglese (en) che non specificano una locale.
- Lingue specifiche per le impostazioni internazionali: si tratta di lingue come Inglese-Stati Uniti (en-US) che specificano un'impostazione internazionale come una regione o un paese specifico.
Alcune lingue agiscono sia come lingue principali sia come lingue 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 brasiliano (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
Per aggiungere una lingua o una impostazioni internazionali 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 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 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 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 ai dati specifici per 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 t-shirt. L'agente è stato configurato inizialmente 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 ai dati specifici per lingua con l'API,
fornisci il parametro languageCode quando ottieni, crei o aggiorni
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 |
| Vai | 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 all'intent:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa intent | Risorsa intent |
| RPC | Interfaccia Intent | Interfaccia Intent |
| C++ | IntentsClient | Non disponibile |
| C# | IntentsClient | Non disponibile |
| Vai | 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 pagina:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa pagina | Risorsa pagina |
| RPC | Interfaccia della pagina | Interfaccia della pagina |
| C++ | PagesClient | Non disponibile |
| C# | PagesClient | Non disponibile |
| Vai | 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 lingua, devi effettuare chiamate API separate per ogni lingua. Se le chiamate dell'API aggiornano i dati generici per lingua, questi dati vengono aggiornati per tutte le lingue.
Eseguire il 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
queryInput.languageCode
campo del metodo detectIntent.
Per ulteriori 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 della sessione | Interfaccia della sessione |
| C++ | SessionsClient | Non disponibile |
| C# | SessionsClient | Non disponibile |
| Vai | 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 della query dell'utente finale è diversa da quella specificata nella richiesta, Dialogflow può rilevarla e passare automaticamente alla lingua dell'utente finale. Consulta la pagina Riferimento alle lingue 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 attendibilità quando
è attivato il rilevamento della lingua.
Attivare il rilevamento automatico della lingua
Devi attivare 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 attivare 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 passaggio automatico della lingua.
Nel menu a discesa Lingue, seleziona le lingue in cui vuoi che Dialogflow possa rispondere. Assicurati di selezionare solo le lingue che sono supportate dalla funzionalità di rilevamento automatico della lingua.
Fai clic su Salva per salvare le modifiche.
Richieste che non forniscono la lingua di un agente
Quando Dialogflow riceve una richiesta che non specifica 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 il rilevamento automatico della lingua è disabilitato, Dialogflow gestisce la richiesta utilizzando la lingua predefinita.
- 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 di 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 non è supportata dall'agente.
Integrazioni
Le interazioni con gli agenti tramite integrazioni basate su testo utilizzano solo la lingua predefinita dell'agente.