Zusätzliche Sprachen

Bei der Entwicklung digitaler Assistenten dreht sich alles um die Persona, die Sie dafür entwickelt haben. Die Persona definiert die Sprache, den Tonfall und die Einstellung eines digitalen Assistenten.

Um sicherzustellen, dass Ihr digitaler Assistent die von Ihnen entworfene Persona übernimmt, müssen Sie die Kontrolle über die ausgehenden Nachrichten des Bots für jede unterstützte Sprache behalten. Resource Bundles stellen einen zentralen Ort dar, an dem Sie Botnachrichten verwalten. So können Sie ganz einfach Konsistenz im Tonfall gewährleisten. Für die Erstellung digitaler Assistenten, die eine zweite Sprache unterstützen, gibt es keine realistische Alternative zu Resource Bundles zur Anzeige von Botnachrichten.

Resource Bundle-Zeichenfolgen werden deklarativ in Oracle Digital Assistant-Skills und digitalen Assistenten erstellt. Sie referenzieren sie aus Unterhaltungen, in Entitys und in Skillkonfigurationseinstellungen mit Apache FreeMarker-Ausdrücken. Um eine Meldungszeichenfolge zu referenzieren, verwenden Sie einen Ausdruck wie den folgenden:

${rb('message_key')}

rb referenziert die Resource Bundle-Definition und sucht nach einer Nachrichten-ID mit dem angegebenen Namen. Im obigen Beispiel wird nach einem Nachrichtenschlüssel mit dem Namen message_key gesucht.

Wenn kein Resource Bundle-Schlüsselname für die Sprache des Benutzers vorhanden ist, wird die für die Standardsprache (Basissprache) definierte Zeichenfolge verwendet. Wenn eine Meldungszeichenfolge für die Standardsprache fehlt, wird während des Laufzeittests eine Ausnahme ausgelöst.

Wenn Sie Daten an eine Nachricht übergeben müssen, die über ein Resource Bundle gedruckt wird, können Sie dies über positionale und benannte Parameter tun.

Positionsparameter: Hello {0}, {1}

Benannter Parameter: Hello {name}, {greeting}

Um Werte zu übergeben, die Sie aus Variablen lesen, die einer Unterhaltung hinzugefügt wurden, verwenden Sie einen Ausdruck wie den unten gezeigten.

Für Positionsparameter: ${rb('message_key',firstname.value, greetingMessage.value)}

Für benannte Parameter: ${rb('message_key','name,greeting',firstname.value, greetingMessage.value)}

Obwohl positionale Parameter einfacher zu verwenden scheinen, empfehlen wir, benannte Parameter zu verwenden, wenn möglich, da sie den Kontext für den Datentyp bereitstellen, der einer Nachricht hinzugefügt wird. Die Kenntnis des Kontextes erleichtert dem Übersetzer das Leben.

Umfassende Verwendung von Resource Bundles in Ihrem Skill bedeutet, dass sie aus Entitys, dem Dialogablauf sowie aus den Einstellungen für Skills und digitale Assistenten referenziert werden. Um die Suche nach Zeichenfolgenreferenzen in Resource Bundles in Ihrem Skill und digitalen Assistenten zu erleichtern, wird empfohlen, den Schlüsselnamen des Resource Bundles Kontext hinzuzufügen, indem eine Benennungskonvention implementiert wird.

Beispiel: Sie können die folgenden Namen für eine Fehlermeldung, eine Zweideutigkeitsmeldung und Prompts in einer Wertelistenentity verwenden:

• list.<entity_name>.errorMessage

• list.<entity_name>.disambiguationMessage

• list.<entity_name>.prompt1

• list.<entity_name>.prompt2

Bei einer Mischentity können Sie eine ähnliche Benennungsstruktur verwenden, aber den Namen des Mischentityelements hinzufügen:

• 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

Wenn Sie eine Resource Bundle-Zeichenfolge aus der Eingabeaufforderung eines Dialogablaufstatus referenzieren oder wenn ein Dialogablaufstatus nur eine Benutzernachricht ausgibt, können Sie Folgendes verwenden:

• <dialog_flow_state_name>.prompt

• <dialog_flow_state_name>.message

Bei globalen Elementen wie Paginierung oder Hilfeschaltflächen in einer Komponente "Allgemeine Antwort" können Sie eine Benennungskonvention verwenden, die nicht den Namen eines bestimmten Dialogablaufstatus enthält:

• button.next

• button.previous

• button.cancel

• button.help

Es gibt keine strenge Regel, ob Sie die Punktnotation wie in den obigen Beispielen, Unterstrichen oder etwas Eigenes verwenden.

Mit der Komponente "Allgemeine Antwort" können Sie Schlüsselwörter für Aktionselemente definieren, damit der Benutzer sie "virtuell drücken" kann, indem er das Schlüsselwort als Nachricht sendet. Schlüsselwörter sind besonders wichtig, wenn die Benutzeroberfläche es dem Benutzer nicht erlaubt, eine Taste zu drücken (z. B. bei der Verwendung von Nur-Text-Kanälen oder Sprache).

Als sanfte, aber offensichtliche Erinnerung wird "Submit" nicht auf Deutsch, Portugiesisch, Französisch, Arabisch und allen anderen Sprachen, die Sie mit Ihrem Bot unterstützen, als "Submit" bezeichnet. Es ist daher gut zu wissen, dass die Eigenschaft keyword von Aktionspunkten in der Komponente "Gemeinsame Antwort" aus einem Resource Bundle-Schlüssel gelesen werden kann. Die Resource Bundle-Nachricht ist eine durch Komma getrennte Liste der Schlüsselwörter, die Sie verwenden möchten.

Dieses Resource Bundle-Nachrichtenbeispiel erwartet, dass das Argument region beim Referenzieren des Resource Bundle-Schlüsselnamens übergeben wird. Im Beispiel werden die Werte, die unterschiedlich behandelt werden sollen, als region1 und region2 definiert. Sie können diese Werte beliebig einstellen, z.B. auf einen Ländercode.

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

Um die Nachricht im Resource Bundle für eine der Regionen zu referenzieren, verwenden Sie den folgenden Ausdruck in der Dialogablauf-, Entity- oder Skillkonfiguration:

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

<VARIABLE_CONTAINING_REGION_VALUE> muss durch einen Variablennamen in Ihrem Skill ersetzt werden, der den Wert enthält, für den Sie eine andere Nachricht definiert haben.