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 della piattaforma: la versione della piattaforma influisce sul comportamento degli assistenti digitali, ad esempio sul modo in cui il motore NLU (Natural Language Understanding) risolve gli intenti e quali lingue sono supportate in modo nativo.

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

     Vedere Versione piattaforma.

   • Lingua principale: determina sia la lingua predefinita per l'assistente digitale sia 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 Supportato 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 controllare se le lingue configurate per le competenze e l'assistente digitale sono allineate, viene eseguito un controllo ogni volta che si aggiunge una lingua o una competenza all'assistente digitale e ogni lingua è contrassegnata come Completa o In corso:

• Le lingue complete sono quelle in cui ciascuna delle competenze dell'assistente digitale è configurata per quella lingua.
• Le lingue in corso sono quelle per le quali non sono configurate una o più competenze.

L'elenco delle lingue complete e in corso è disponibile 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 dell'assistente digitale, crea 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 delle lingue che si desidera supportare non è inclusa nell'elenco, è necessario continuare a utilizzare la modalità di 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 tutte le competenze dalla nuova versione o dalla copia appena creata.

   Ciò è necessario, perché non è possibile creare un 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 dell'assistente digitale modificato, selezionare Versione piattaforma 20.12 o successiva e selezionare la modalità lingua Supportata in modo nativo.

   Con questo passaggio, puoi preservare la configurazione che hai fatto per l'assistente digitale, anche se devi gestire le competenze separatamente.

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

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

• 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 è disattivato.
  • Se l'assistente digitale utilizza un servizio di traduzione, il servizio di traduzione gestisce il rilevamento della lingua, 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 voce della conversazione e non aggiornata nella sessione, anche se l'utente cambia lingua.
• Per impostazione predefinita, la sessione del canale dura 7 giorni prima della scadenza.

Di seguito sono riportati i passaggi iniziali per l'impostazione di un assistente digitale in lingua singola non inglese in modalità Lingua servizio 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 della piattaforma: la versione della piattaforma influisce sul comportamento degli assistenti digitali, ad esempio sul modo in cui il motore NLU (Natural Language Understanding) risolve gli intenti e quali lingue sono supportate in modo nativo.

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

     Vedere Versione piattaforma.

   • Lingua principale: questo campo viene visualizzato solo se è stata selezionata la versione 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 effettuato la selezione dalla sezione Servizio di traduzione. Se si seleziona la sezione Supportato in modo nativo, l'assistente digitale accetterà solo skill che utilizzano la modalità Supportato in modo nativo.

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

Di seguito sono riportati i passaggi iniziali per l'impostazione di un assistente digitale multilingue in modalità Lingua servizio 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 della piattaforma: la versione della piattaforma influisce sul comportamento degli assistenti digitali, ad esempio sul modo in cui il motore NLU (Natural Language Understanding) risolve gli intenti e quali lingue sono supportate in modo nativo.

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

     Vedere Versione piattaforma.

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

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

     Attenzione

     Assicurarsi di aver effettuato la selezione dalla sezione Servizio di traduzione. Se si seleziona la sezione Supportato in modo nativo, l'assistente digitale accetterà solo skill che utilizzano la modalità Supportato in modo nativo.

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

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 + Servizio.
   3. Selezionare il servizio e immettere le informazioni di configurazione necessarie.

      Se si seleziona OCI (per il servizio OCI Language) non si immettono informazioni direttamente in questa finestra di dialogo, ma è necessario impostare i criteri OCI per utilizzare il servizio.

      Vedere Servizi di traduzione supportati per informazioni sulle operazioni da eseguire per configurare ciascun servizio.

   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 di 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. Imposta il servizio di traduzione nel tuo assistente digitale:
   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 è impostato con un servizio di traduzione, l'assistente digitale rileverà la lingua dell'utente nello stesso modo in cui fa un'abilità con il componente Rileva lingua.

Tuttavia, devi anche assicurarti che le competenze dell'assistente digitale utilizzino la lingua rilevata 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 tradotto in inglese all'abilità. Pertanto, per impostazione predefinita, il componente Rileva lingua dell'abilità rileva l'inglese come lingua e imposta la variabile profile.LanguageTag sull'inglese, anche se l'utente ha immesso testo non in inglese.

Per evitare che questo passaggio ritorni all'inglese in uno skill con un flusso di finestre di dialogo sviluppato in modalità Visual, è necessario impostare la proprietà Tag lingua profilo esistente del componente Rileva lingua su True in ogni skill.

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

Per evitare che questo passaggio alla lingua inglese venga eseguito in uno skill basato su YAML, è necessario aggiungere la proprietà seguente al componente System.DetectLanguage in ogni skill:

      useExistingProfileLanguageTag: true

Di seguito è riportato un esempio di componente System.DetectLanguage di uno skill basato 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 si utilizza questo approccio, è sufficiente avere i messaggi di output in inglese. Non sono necessarie altre configurazioni. Il servizio di traduzione configurato tradurrà automaticamente tutti i messaggi di output nella lingua dell'utente.

• Utilizzare un bundle di risorse per tradurre i messaggi di output manualmente.
  Nota
  
  Per qualsiasi messaggio di output che non contiene un riferimento a una chiave 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 seguenti due posizioni:

• Nella pagina Skill () dell'assistente digitale.

  Qui troverai le stringhe utilizzate principalmente per le schede di aiuto che vengono 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 frase singola, Descrizione e Richiamo.
  • 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 del bundle delle 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 piattaforma versione 21.04 o successiva, 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 sulla piattaforma versione 21.02 o precedente), è necessario creare le chiavi manualmente.

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

1. Nella navigazione a sinistra per l'assistente digitale, fare clic
2. Selezionare uno skill.
3. Aggiornare i campi Descrizione frase singola, Descrizione e Richiamo con riferimenti ai bundle di risorse nel formato seguente:

   ${rb.BundleKeyName}

   Ad esempio, è possibile utilizzare quanto segue per un riferimento a una chiave per la descrizione di una linea 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 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 una serie di proprietà di configurazione utilizzate per visualizzare vari prompt e messaggi.

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

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

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

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

   ${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 delle 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 i bundle di risorse sotto forma di file CSV, che consente di utilizzare i bundle non in linea.

Il file CSV deve avere le colonne riportate di seguito.

• languageTag
• key
• message
• annotation

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

• Nella pagina Bundle di risorse per lo skill 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 delle 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, ecco un elenco delle proprietà di personalizzazione che è possibile tradurre insieme ai nomi suggeriti per le chiavi bundle e le espressioni utilizzate per fare riferimento a tali chiavi bundle dai campi per le proprietà.