Lingue aggiuntive

Lo sviluppo dell'assistente digitale riguarda la persona che hai progettato per questo. Il personaggio definisce il linguaggio, il tono di voce e l'atteggiamento di un assistente digitale.

Per assicurarti che il tuo assistente digitale assuma la persona che hai progettato, devi mantenere il controllo dei messaggi in uscita del bot per ogni lingua che supporti. I bundle di risorse rappresentano un unico luogo in cui gestire i messaggi dei bot, il che semplifica la coerenza del tono vocale. Per la creazione di assistenti digitali che supportano una seconda lingua, non esiste un'alternativa realistica ai bundle di risorse per la visualizzazione dei messaggi bot.

Le stringhe di bundle di risorse vengono create in modo dichiarativo nelle competenze e negli assistenti digitali di Oracle Digital Assistant. È possibile fare riferimento alle conversazioni, alle entità e alle impostazioni di configurazione delle competenze utilizzando le espressioni FreeMarker di Apache. Per fare riferimento a una stringa di messaggio, utilizzare un'espressione simile alla seguente:

${rb('message_key')}

rb fa riferimento alla definizione del bundle di risorse e cerca un identificativo di messaggio con il nome specificato. Nell'esempio precedente, viene cercata una chiave messaggio con il nome message_key.

Se per la lingua dell'utente non esiste un nome di chiave del bundle di risorse, verrà utilizzata la stringa definita per la lingua predefinita (la lingua di base). Se per la lingua predefinita manca una stringa di messaggio, durante il test di runtime viene restituita un'eccezione.

Se è necessario passare i dati a un messaggio stampato tramite un bundle di risorse, è possibile eseguire questa operazione mediante parametri posizionali e denominati.

Parametro posizionale: Hello {0}, {1}

Parametro denominato: Hello {name}, {greeting}

Per passare i valori letti dalle variabili aggiunte a una conversazione, utilizzare un'espressione simile a quella mostrata di seguito.

Per i parametri posizionali: ${rb('message_key',firstname.value, greetingMessage.value)}

Per i parametri denominati: ${rb('message_key','name,greeting',firstname.value, greetingMessage.value)}

Sebbene i parametri posizionali sembrino più semplici da utilizzare, è consigliabile utilizzare i parametri denominati quando possibile, poiché forniscono il contesto per il tipo di dati aggiunto a un messaggio. Conoscere il contesto rende più facile la vita di un traduttore.

L'uso completo dei bundle di risorse nella tua abilità significa riferirti a loro dalle entità, dal flusso di finestre di dialogo e dalle impostazioni di abilità e assistente digitale. Per semplificare la ricerca dei riferimenti delle stringhe dei bundle di risorse nelle competenze e nell'assistente digitale, è consigliabile aggiungere il contesto ai nomi delle chiavi dei bundle di risorse implementando una convenzione di denominazione.

Ad esempio, è possibile utilizzare i seguenti nomi per un messaggio di errore, un messaggio di disambiguazione e prompt in un'entità elenco di valori:

• list.<entity_name>.errorMessage

• list.<entity_name>.disambiguationMessage

• list.<entity_name>.prompt1

• list.<entity_name>.prompt2

Per un'entità sacchetto composito, è possibile utilizzare una struttura di denominazione simile, ma aggiungere il nome dell'elemento sacchetto ad esso:

• cbe.<entity_name>.<bag_item_name>.errorMessage

• cbe.<entity_name>.<bag_item_name>.disambiguationMessage

• cbe.<entity_name>.<bag_item_name>.prompt1

• cbe.<entity_name>.<bag_item_name>.prompt2

Se si fa riferimento a una stringa di bundle di risorse dal prompt di uno stato del flusso di una finestra di dialogo o se uno stato del flusso di una finestra di dialogo stampa solo un messaggio utente, è possibile utilizzare:

• <dialog_flow_state_name>.prompt

• <dialog_flow_state_name>.message

Per gli elementi globali, ad esempio i pulsanti di impaginazione o Guida in un componente Risposta comune, è possibile utilizzare una convenzione di denominazione che non contenga il nome di uno specifico stato di flusso della finestra di dialogo.

• button.next

• button.previous

• button.cancel

• button.help

Non esiste una regola rigorosa per stabilire se utilizzare la notazione a punti come negli esempi precedenti, i caratteri di sottolineatura o qualcosa di tuo.

Il componente Risposta comune consente di definire le parole chiave per gli elementi azione in modo che l'utente possa "virtualmente premerli" inviando la parola chiave come messaggio. Le parole chiave sono particolarmente importanti se l'interfaccia utente non consente all'utente di premere un pulsante (ad esempio quando si utilizzano canali di solo testo o voce).

Come promemoria gentile ma ovvio, "submit" non è chiamato "submit" in tedesco, portoghese, francese, arabo e tutte le altre lingue che supporti con il tuo bot. È pertanto opportuno sapere che la proprietà keyword degli elementi azione nel componente Risposta comune può essere letta da una chiave bundle di risorse. Il messaggio relativo al bundle di risorse è un elenco separato da virgole di parole chiave che si desidera utilizzare.

Questo esempio di messaggio del bundle di risorse prevede che l'argomento region venga passato quando si fa riferimento al nome della chiave del bundle di risorse. Nell'esempio, i valori da gestire in modo diverso sono definiti come region1 e region2. È possibile impostare i valori desiderati, ad esempio un codice paese.

{region, select,
  region1 {message for region 1}
  region2 {message for region 2}
  other {message for all other regions}
}

Per fare riferimento al messaggio nel bundle di risorse per una delle aree, utilizzare l'espressione seguente nella configurazione del flusso di finestre di dialogo, dell'entità o dello skill:

${rb('the_key_name','region','<VARIABLE_CONTAINING_REGION_VALUE>.value')}

<VARIABLE_CONTAINING_REGION_VALUE> deve essere sostituito da un nome di variabile nello skill che contiene il valore per il quale è stato definito un messaggio diverso.