Ecco i passaggi iniziali per impostare un assistente digitale in modalità lingua supportata in modo nativo:

1. Fare clic su per aprire il menu laterale, selezionare Sviluppo > Assistenti digitali e fare clic su Nuovo assistente digitale.

2. Completare la finestra di dialogo prestando particolare attenzione a questi campi:
   • Versione piattaforma: la versione della piattaforma influisce sul comportamento degli assistenti digitali, ad esempio il modo in cui il motore NLU (Natural Language Understanding) risolve gli intenti e quali lingue sono supportate in maniera nativa.

     Per la modalità lingua supportata in modo nativo, è necessario impostarla su 20.12 o versione successiva.

     Vedere Versione piattaforma.

   • Lingua principale: determina sia la lingua predefinita per l'assistente digitale che se l'assistente digitale utilizzerà il supporto nativo per tale lingua o si baserà su un servizio di traduzione.

     In questo campo è necessario selezionare una delle lingue nella sezione Supportate in modo nativo dell'elenco a discesa.

3. Se è necessario aggiungere altre lingue all'assistente digitale:
   1. Nella navigazione a sinistra dell'assistente digitale appena creato, fare clic su .
   2. Fare clic su Aggiungi lingua e selezionare la lingua che si desidera aggiungere.

Negli assistenti digitali basati sul supporto della lingua nativa di Oracle Digital Assistant, le lingue configurate per l'assistente digitale devono corrispondere alle lingue configurate per le competenze.

Per monitorare se le lingue configurate per gli skill e l'assistente digitale sono allineate, viene eseguito un controllo ogni volta che si aggiunge una lingua o uno skill all'assistente digitale e ogni lingua viene contrassegnata come Completa o In corso:

• Le lingue complete sono quelle in cui le competenze di ciascun assistente digitale sono configurate per quella lingua.
• Le lingue in corso sono quelle per le quali non sono configurate una o più competenze.

È possibile trovare l'elenco delle lingue complete e in corso nella scheda Generale della pagina Impostazioni dell'assistente digitale ().

Se si desidera usufruire del supporto della lingua nativa di Oracle Digital Assistant in un assistente digitale già configurato per l'utilizzo di un servizio di traduzione, attenersi alla procedura generale riportata di seguito.

1. Per tutte le competenze nell'assistente digitale, creare versioni che utilizzano il supporto della lingua nativa.

   Vedere Creazione di una competenza con lingue supportate in modo nativo.

   Per l'elenco delle lingue supportate in modo nativo, vedere Lingue supportate in modo nativo. Se una qualsiasi delle lingue che si desidera supportare non è inclusa in tale elenco, è necessario continuare a utilizzare la modalità del servizio di traduzione.

2. Creare una nuova versione o una copia dell'assistente digitale.

   1. Fare clic su per aprire il menu laterale e selezionare Sviluppo > Assistenti digitali.

   2. Nella casella relativa all'assistente digitale di cui si desidera eseguire la versione o la copia, fare clic su e selezionare Versione o Duplica.

   3. Compilare i campi obbligatori e fare clic su Crea.

3. Rimuovere tutti gli skill dalla nuova versione o dal clone appena creato.

   Ciò è necessario perché non è possibile creare l'assistente digitale per utilizzare il supporto della lingua nativa se contiene competenze in modalità servizio di traduzione.

4. Creare una nuova versione o una copia di tale assistente digitale modificato, selezionare la versione della piattaforma 20.12 o successiva e selezionare la modalità di lingua supportata in modo nativo.

   Con questo passaggio, è possibile conservare la configurazione eseguita per l'assistente digitale, anche se è necessario gestire le competenze separatamente.

5. Aggiungere le versioni di supporto in lingua nativa delle competenze all'assistente digitale.

Negli assistenti digitali (o skill standalone) che utilizzano più lingue supportate in modo nativo, l'assistente digitale può rilevare automaticamente la lingua dell'utente all'inizio della sessione. Funzionamento:

• La lingua viene rilevata automaticamente per gli assistenti digitali e le competenze configurate con più lingue supportate in modo nativo.
  • Se nell'assistente digitale è presente una sola lingua (supportata in modo nativo), il rilevamento della lingua viene disattivato.
  • Se l'assistente digitale utilizza un servizio di traduzione, il servizio di traduzione gestisce il rilevamento della lingua e non l'assistente digitale.
• La lingua non viene rilevata automaticamente se si accede all'assistente digitale tramite un canale in cui è stata impostata la variabile profile.languageTag o profile.locale.
• La lingua viene rilevata nella prima espressione della conversazione e non viene aggiornata nella sessione, anche se l'utente cambia lingua.
• Per impostazione predefinita, la sessione del canale ha una durata di 7 giorni prima della scadenza.

Di seguito sono riportati i passi iniziali per la configurazione di un assistente digitale non in lingua inglese in modalità Lingua servizio di traduzione.

1. Fare clic su per aprire il menu laterale, selezionare Sviluppo > Assistenti digitali e fare clic su Nuovo assistente digitale.

2. Completare la finestra di dialogo prestando particolare attenzione a questi campi:
   • Versione piattaforma: la versione della piattaforma influisce sul comportamento degli assistenti digitali, ad esempio il modo in cui il motore NLU (Natural Language Understanding) risolve gli intenti e quali lingue sono supportate in maniera nativa.

     Se si sta iniziando con un nuovo assistente digitale, è necessario selezionare la versione più recente disponibile, poiché il supporto per tale versione durerà più a lungo.

     Vedere Versione piattaforma.

   • Lingua principale: questo campo viene visualizzato solo se è stata selezionata la versione della piattaforma 20.12 o successiva.

     In questo campo è necessario selezionare la lingua di destinazione nella sezione Servizio di traduzione dell'elenco a discesa.

     Attenzione:

     Assicurarsi di aver selezionato la voce nella sezione Servizio di traduzione. Se si seleziona la sezione Supportato in modo nativo, l'assistente digitale accetterà solo le competenze che utilizzano la modalità Supportato in modo nativo.

     Se questo campo non viene visualizzato, la lingua dell'assistente digitale viene determinata dalla lingua della prima abilità aggiunta. In questo caso, invece della lingua principale, viene indicata come lingua predominante.

Di seguito sono riportati i passi iniziali per l'impostazione di un assistente digitale multilingue in modalità Lingua servizio di traduzione.

1. Fare clic su per aprire il menu laterale, selezionare Sviluppo > Assistenti digitali e fare clic su Nuovo assistente digitale.

2. Completare la finestra di dialogo prestando particolare attenzione a questi campi:
   • Versione piattaforma: la versione della piattaforma influisce sul comportamento degli assistenti digitali, ad esempio il modo in cui il motore NLU (Natural Language Understanding) risolve gli intenti e quali lingue sono supportate in maniera nativa.

     Se si sta iniziando con un nuovo assistente digitale, è necessario selezionare la versione più recente disponibile, poiché il supporto per tale versione durerà più a lungo.

     Vedere Versione piattaforma.

   • Lingua principale: questo campo viene visualizzato solo se è stata selezionata la versione della piattaforma 20.12 o successiva.

     In questo campo è necessario selezionare Inglese nella sezione Servizio di traduzione dell'elenco a discesa.

     Attenzione:

     Assicurarsi di aver selezionato la voce nella sezione Servizio di traduzione. Se si seleziona la sezione Supportato in modo nativo, l'assistente digitale accetterà solo le competenze che utilizzano la modalità Supportato in modo nativo.

     Se questo campo non viene visualizzato, la lingua dell'assistente digitale viene determinata dalla lingua della prima abilità aggiunta. In questo caso, invece della lingua principale, viene indicata come lingua predominante.

1. Se non lo si è già fatto, configurare un servizio di traduzione per l'istanza di Digital Assistant effettuando le operazioni riportate di seguito.
   1. Fare clic su per aprire il menu laterale e selezionare Impostazioni > Servizio di traduzione.
   2. Fare clic su + Service.
   3. Immettere l'URL e il token di autorizzazione per il servizio Microsoft Translator o l'API di traduzione Google nella finestra di dialogo Servizi di traduzione.
   Fare riferimento alla documentazione per Microsoft Translator e Google Translation API per scoprire come ottenere l'URL e il token di accesso.

   Nota
   
   Per utilizzare l'API di traduzione Google, è necessario generare la chiave API. È possibile creare questa chiave dalla console GCP (API e servizi > Credenziali). Per ulteriori informazioni, consulta la documentazione di Google Cloud Platform.
2. Impostare il servizio di traduzione nell'assistente digitale effettuando le operazioni riportate di seguito.
   1. Fare clic su per aprire il menu laterale, selezionare Sviluppo > Assistenti digitali e selezionare l'assistente digitale.
   2. Nella barra di navigazione sinistra dell'assistente digitale, fare clic sull'icona Impostazioni() e selezionare la scheda Generale.
   3. Passare all'elenco a discesa Servizio di traduzione e selezionare il servizio di traduzione.

Per impostazione predefinita, se un assistente digitale è configurato con un servizio di traduzione, l'assistente digitale rileverà la lingua dell'utente nello stesso modo in cui viene rilevata da una competenza con il componente Rileva lingua.

Tuttavia, è necessario anche assicurarsi che le competenze nell'assistente digitale utilizzino il linguaggio rilevato dall'assistente digitale. Quando un'abilità fa parte di un assistente digitale, l'assistente digitale traduce l'input dell'utente in inglese e passa il testo inglese tradotto all'abilità. Pertanto, per impostazione predefinita, il componente Rileva lingua dello skill rileva l'inglese come lingua e imposta la variabile profile.LanguageTag su Inglese, anche se l'utente ha immesso testo non inglese.

Per evitare di tornare all'inglese in una competenza con un flusso di dialogo sviluppato in modalità Visual, è necessario impostare la proprietà Tag lingua profilo esistente del componente Rileva lingua su True in ogni competenza.

Ciò garantisce che lo skill rispetti il valore della variabile profile.LanguageTag impostata dall'assistente digitale.

Per evitare che il passaggio all'inglese venga eseguito in una competenza basata su YAML, è necessario aggiungere la proprietà seguente al componente System.DetectLanguage di ogni skill:

      useExistingProfileLanguageTag: true

Di seguito è riportato un esempio di componente System.DetectLanguage di una competenza basata su YAML con il set useExistingProfileLanguageTag.

  detectLang:
    component: "System.DetectLanguage"
    properties:
      useExistingProfileLanguageTag: true
    transitions:
      ...

Per il testo visibile all'utente in un assistente digitale che utilizza un servizio di traduzione, è possibile utilizzare uno dei seguenti approcci:

• Utilizzare il servizio di traduzione configurato per l'assistente digitale.

  Se usi questo approccio, devi solo avere i tuoi messaggi di output in inglese. Non è necessaria un'altra configurazione. Il servizio di traduzione configurato tradurrà automaticamente tutti i messaggi di output nella lingua dell'utente.

• Utilizzare un bundle di risorse per tradurre manualmente i messaggi di output.
  Nota
  
  Per i messaggi di output che non hanno un riferimento a una chiave del bundle di risorse, il servizio di traduzione verrà utilizzato automaticamente per tradurre i messaggi.

Negli assistenti digitali che utilizzano un servizio di traduzione, l'invocazione esplicita delle competenze viene riconosciuta dall'assistente digitale sia nella lingua rilevata che in inglese.

È possibile trovare le stringhe traducibili nelle due posizioni seguenti:

• Nella pagina Skill () dell'assistente digitale.

  Qui troverai le stringhe utilizzate principalmente per le schede della Guida visualizzate quando un utente chiede aiuto nell'assistente digitale e quando l'assistente digitale saluta per la prima volta l'utente.

  Per ogni abilità, puoi tradurre

  • I campi Descrizione di una frase, Descrizione e Richiama.
  • Utteranze di esempio.
• Nella pagina Impostazioni (), all'interno della scheda Configurazioni, nella sezione Parametri conversazione. A partire dalla versione 21.04 della piattaforma, le voci del bundle di risorse vengono create automaticamente per queste impostazioni.

Le chiavi bundle di risorse vengono utilizzate per identificare il testo di output che deve essere tradotto e fornire valori in una o più lingue. Per gli assistenti digitali che utilizzano la versione 21.04 o successiva della piattaforma, le chiavi vengono generate automaticamente per le impostazioni di configurazione dell'assistente digitale. Per altre stringhe (e per le impostazioni di configurazione negli assistenti digitali che si trovano nella versione 21.02 o precedente della piattaforma), è necessario creare le chiavi manualmente.

Quando un assistente digitale accoglie l'utente o presenta informazioni della Guida per gli skill in esso contenuti, utilizza i valori della pagina Skill nell'assistente digitale per popolare le schede di benvenuto e di assistenza. È possibile tradurre le informazioni visualizzate in queste schede della Guida modificando alcuni campi della pagina Skill.

1. Nella navigazione a sinistra dell'assistente digitale, fare clic su
2. Selezionare uno skill.
3. Aggiornare i campi Descrizione di una sola frase, Descrizione e Richiesta con riferimenti ai bundle di risorse nel form:

   ${rb.BundleKeyName}

   Ad esempio, è possibile utilizzare quanto segue per un riferimento a una chiave per la descrizione a riga singola di un'abilità pizza.

   ${rb.PizzaSkillShortDescription}

4. Nella sezione Esempi della pagina, passare il puntatore del mouse su un esempio, fare clic sulla relativa icona Modifica e sostituire il testo con un riferimento a una chiave bundle di risorse come descritto sopra.
5. Ripetere il passo precedente per le altre espressioni di esempio dell'abilità.
6. Ripetere i quattro passi precedenti per ogni abilità.

Gli assistenti digitali dispongono di numerose proprietà di configurazione utilizzate per visualizzare vari prompt e messaggi.

Per impostare l'output per una proprietà di configurazione, si fa riferimento alla variabile del bundle di risorse e alla chiave del messaggio. Ad esempio: ${rb('WhatType')}. È inoltre possibile utilizzare la notazione punto, ad esempio: ${rb.WhatType}

1. Nella barra di navigazione sinistra dell'assistente digitale, fare clic sull'icona Impostazioni () e selezionare la scheda Configurazioni.

2. Per le proprietà all'interno della sezione Parametri conversazione della pagina, immettere i riferimenti alle chiavi del bundle di risorse definite per ciascuna di esse.

   Ad esempio, se nel bundle di risorse è presente una chiave denominata daAcknowledgementResponse per la proprietà Risposta conferma, nel campo Risposta conferma immettere quanto segue:

   ${rb('daAcknowledgementResponse')}

È inoltre possibile utilizzare i parametri nei valori per le chiavi bundle, che consentono di utilizzare le variabili di sistema nell'output. Ad esempio, il valore predefinito della proprietà Conferma flusso di uscita è:

Exited ${system.routingFromIntent} in ${system.routingFromSkill}.

È possibile conservare i riferimenti alle variabili di sistema (in questo caso, system.routingFromIntent e system.routingFromSkill) nelle risposte tradotte effettuando le operazioni riportate di seguito.

1. Nel valore della chiave bundle di risorse corrispondente, inserire {0}, {1} e così via come codici di sostituzione per ogni variabile di sistema. Ad esempio, nella voce inglese (o predefinita) creata per la proprietà Conferma flusso di uscita, è possibile utilizzare il testo seguente:

   Exited {0} in {1}.

2. Quindi, nel valore della proprietà, immettere il riferimento alla chiave bundle nel seguente formato:

   ${rb('bundleKey', '${systemVariableForParam0}', '${systemVariableForParam1}')}

   Ad esempio, questo è l'aspetto della proprietà Conferma flusso di uscita (dove daExitFlowConfirmation è la chiave bundle corrispondente):

   ${rb('daExitFlowConfirmation', '${system.routingFromIntent}', '${system.routingFromSkill}')}

È possibile esportare e importare bundle di risorse sotto forma di file CSV, che consente di utilizzare i bundle offline.

Il file CSV deve contenere le colonne riportate di seguito.

• languageTag
• key
• message
• annotation

Per esportare un file CSV con il bundle di risorse esistente:

• Nella pagina Bundle risorse per la competenza o l'assistente digitale, fare clic su per esportare un file CSV con il bundle di risorse esistente.

  Anche se non sono state ancora aggiunte chiavi al bundle delle risorse, verrà esportato un file con il formato CSV richiesto.

Per importare un file bundle di risorse:

• Nella pagina Bundle risorse per lo skill o l'assistente digitale, fare clic su .

A partire dalla versione 21.04 della piattaforma, le voci del bundle di risorse vengono create automaticamente per le impostazioni di configurazione dell'assistente digitale. Se l'assistente digitale è basato sulla piattaforma versione 21.02 o precedente, è possibile eseguire l'aggiornamento alla versione 21.04 o successiva per generare automaticamente queste voci.

Di seguito è riportato un elenco di tutte le voci del bundle di risorse di sistema per gli assistenti digitali insieme ai relativi valori predefiniti.

Se si desidera utilizzare le voci del bundle di risorse per le impostazioni di configurazione senza aggiornare la versione della piattaforma dell'assistente digitale alla versione 21.04 o successiva, di seguito è riportato un elenco delle proprietà di personalizzazione che è possibile tradurre insieme ai nomi suggeriti per le chiavi del bundle e le espressioni che si desidera utilizzare per fare riferimento a tali chiavi del bundle dai campi per le proprietà.