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 aggiungere altre lingue.
Lingue radice e specifiche per le impostazioni internazionali
Esistono due categorie di lingue:
- Lingue principali: Si tratta di lingue come l'inglese (en) che non specificano un paese.
- Lingue specifiche per 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 fungono sia da lingua principale che da lingua specifica per la località. Esistono differenze significative tra le impostazioni internazionali per queste lingue, pertanto le impostazioni internazionali 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)
Dovresti progettare principalmente l'agente per le lingue principali e personalizzarlo per le lingue specifiche delle impostazioni internazionali solo se necessario.
Aggiungere una lingua
Per aggiungere una lingua o un locale con la console di Dialogflow CX:
- Apri la console Dialogflow CX.
- Scegli il Google Cloud progetto 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 della lingua. Quando crei un agente multilingue, devi fornire questi dati specifici per la lingua per ogni lingua. Quando selezioni una lingua dalla console o fornisci una lingua all'API, puoi accedere a questi dati specifici per la lingua indicata. 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 le t-shirt. L'agente è stato originariamente configurato in inglese, quindi l'entità ha 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.
| Entità | Sinonimi |
|---|---|
| XS | XS, extra pequeño |
| S | S, piccolo |
| M | M, medio |
| L | L, grande |
| XL | XL, extra grande |
Generare dati specifici per la lingua con l'AI
Conversational Agents (Dialogflow CX) ti offre la possibilità di velocizzare il processo di aggiunta di dati specifici per la lingua utilizzando la generazione di AI per fornire i dati al posto tuo, anziché inserirli manualmente. Questa operazione può essere eseguita a livello di intent, entità e evasione come funzionalità di anteprima.
Se scegli di non utilizzare la generazione AI, puoi comunque inserire manualmente i dati per le lingue non predefinite.
Generazione di intent AI
Genera automaticamente frasi di addestramento in una lingua non predefinita:
- Vai a Impostazioni agente > Lingue e assicurati di aver attivato una o più lingue non predefinite per l'agente.
- Vai al menu a discesa della lingua nella parte superiore della console e seleziona la lingua non predefinita che hai scelto.
- Vai alla scheda Gestisci, poi fai clic su Intent e scegli uno dei tuoi intent. Assicurati che il campo Descrizione sia compilato con una descrizione dello scopo dell'intent. La descrizione può essere nella tua lingua predefinita o nella lingua che stai visualizzando.
- Quando attivi una lingua non predefinita, Conversational Agents (Dialogflow CX) non traduce le frasi di addestramento esistenti nella nuova lingua. Per creare nuove frasi di addestramento nella nuova lingua, fai clic sul pulsante di opzione __ newly LLM-generated phrases. Il valore predefinito è 3. Per copiare e tradurre automaticamente le frasi di addestramento esistenti, seleziona Tutte le frasi di addestramento dalla tua lingua predefinita tradotte tramite la generazione dell'AI.
- Fai clic su + Aggiungi. Il numero specificato di frasi di addestramento viene generato e inserito nella tabella nella lingua selezionata. Assicurati di controllare l'accuratezza di tutte le frasi di addestramento generate.
(Anteprima) Generazione di AI per le entità
Genera e traduce automaticamente valori di riferimento e sinonimi in una lingua non predefinita:
- Vai a Impostazioni agente > Lingue e assicurati di aver attivato una o più lingue non predefinite per l'agente.
- Vai al menu a discesa della lingua nella parte superiore della console e seleziona la lingua non predefinita che hai scelto.
- Vai alla scheda Gestisci, poi fai clic su Tipi di entità e scegli uno dei tuoi tipi di entità.
- Quando attivi una lingua non predefinita, Conversational Agents (Dialogflow CX) non traduce automaticamente i valori di riferimento e i sinonimi esistenti. Per tradurre automaticamente questi valori nella nuova lingua, fai clic su + Copia dalla lingua predefinita. Tutti i dati originali del tipo di entità della lingua predefinita verranno tradotti nella nuova lingua e inseriti nella tabella. Tieni presente che la traduzione di più di 50 elementi alla volta può causare errori. Ogni valore di riferimento e sinonimo viene conteggiato come un elemento.
- Puoi anche aggiungere nuovi valori di riferimento facendo clic su + Aggiungi nuova voce. Puoi digitare un valore di riferimento nella lingua predefinita e sia il valore di riferimento sia i relativi sinonimi verranno tradotti automaticamente nella nuova lingua.
(Anteprima) Generazione di AI per il fulfillment
La generazione di AI è disponibile per i tipi di route, gruppi di route e gestione degli eventi fulfillment. Per maggiori informazioni su questi tipi di route, consulta la documentazione su route e gestori di eventi.
Questa funzionalità viene visualizzata solo se stai visualizzando l'agente in una lingua non predefinita e in uno dei tipi di itinerario specificati. Vai alla sezione Fulfillment dell'itinerario. Per copiare e tradurre automaticamente le risposte dell'agente dalla lingua predefinita alla lingua che stai visualizzando, fai clic su Copia e traduci. Tieni presente che la traduzione di più di 50 risposte alla volta può causare errori.
Dati specifici per la lingua quando utilizzi l'API
Per accedere ai dati specifici della lingua con l'API,
fornisci il parametro languageCode quando recuperi, 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 |
| 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 alla 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 |
| Vai | 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 separate per ogni lingua per accedere a tutti i dati specifici della lingua. Se le chiamate API aggiornano i dati generici della lingua, questi dati vengono aggiornati per tutte le lingue.
Testare 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 campo
queryInput.languageCode
del metodo detectIntent.
Per ulteriori informazioni, consulta il tipo
Sessions.
Seleziona un protocollo e una versione per il riferimento alla 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 linguistico 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 è attivato.
Attivare il rilevamento automatico della lingua
Devi attivare il rilevamento automatico della lingua sia a livello di agente sia 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 del flusso. Nel riquadro delle impostazioni del flusso, seleziona la casella accanto ad Attiva rilevamento e 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 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 il rilevamento automatico della lingua è attivato. Se il rilevamento automatico della lingua è disattivato, 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 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 fornite, anche se non è supportata dall'agente.
Integrazioni
Le interazioni con l'agente tramite integrazioni basate su testo utilizzano solo la lingua predefinita dell'agente.