Im Folgenden finden Sie die ersten Schritte zum Einrichten eines digitalen Assistenten im nativ unterstützten Sprachmodus:

1. Klicken Sie auf , um das Seitenmenü zu öffnen, wählen Sie Entwicklung > Digitale Assistenten aus, und klicken Sie auf Neuer digitaler Assistent.

2. Füllen Sie das Dialogfeld aus, und achten Sie dabei besonders auf folgende Felder:
   • Plattformversion: Die Plattformversion wirkt sich auf das Verhalten Ihrer digitalen Assistenten aus, z.B. die Art und Weise, wie die Natural Language Understanding-(NLU-)Engine Intents auflöst, und welche Sprachen nativ unterstützt werden.

     Für den nativ unterstützten Sprachmodus müssen Sie diese Version auf 20.12 oder höher setzen.

     Siehe Plattformversion.

   • Primäre Sprache: Damit wird sowohl die Standardsprache für den digitalen Assistenten als auch die Frage bestimmt, ob der digitale Assistent native Unterstützung für diese Sprache oder einen Übersetzungsservice verwendet.

     In diesem Feld müssen Sie eine der Sprachen im Abschnitt Nativ unterstützt der Dropdown-Liste auswählen.

3. Wenn Sie dem digitalen Assistenten zusätzliche Sprachen hinzufügen müssen:
   1. Klicken Sie in der linken Navigationsleiste des neu erstellten digitalen Assistenten auf .
   2. Klicken Sie auf Sprache hinzufügen, und wählen Sie die gewünschte Sprache aus.

Bei digitalen Assistenten, die auf der nativen Sprachunterstützung von Oracle Digital Assistant basieren, müssen die Sprachen, die Sie für den digitalen Assistenten konfigurieren, mit den Sprachen übereinstimmen, die für die Skills konfiguriert sind.

Um zu überwachen, ob die konfigurierten Sprachen für die Skills mit denen des digitalen Assistenten übereinstimmen, wird immer dann eine Prüfung ausgeführt, wenn Sie dem digitalen Assistenten eine Sprache oder einen Skill hinzufügen. Dabei wird jede Sprache als Abgeschlossen oder In Bearbeitung markiert:

• Abgeschlossene Sprachen sind Sprachen, für die jeder Skill des digitalen Assistenten konfiguriert ist.
• In Bearbeitung befindliche Sprachen sind Sprachen, für die mindestens ein Skill nicht konfiguriert ist.

Die Liste der abgeschlossenen und in Bearbeitung befindlichen Sprachen finden Sie auf der Registerkarte Allgemein der Seite Einstellungen des digitalen Assistenten ().

Wenn Sie die native Sprachunterstützung von Oracle Digital Assistant in einem digitalen Assistenten nutzen möchten, der bereits für die Verwendung eines Übersetzungsservice konfiguriert wurde, gehen Sie wie folgt vor:

1. Erstellen Sie für alle Skills im digitalen Assistenten Versionen, die die native Sprachunterstützung verwenden.

   Siehe Skill mit nativ unterstützten Sprachen erstellen.

   Die Liste der nativ unterstützten Sprachen finden Sie unter Nativ unterstützte Sprachen. (Wenn eine der gewünschten Sprachen nicht in dieser Liste enthalten ist, müssen Sie den Übersetzungsservicemodus weiterhin verwenden.)

2. Erstellen Sie eine neue Version oder einen Klon des digitalen Assistenten.

   1. Klicken Sie auf , um das Seitenmenü zu öffnen, und wählen Sie Entwicklung > Digitale Assistenten aus.

   2. Klicken Sie in der Kachel für den digitalen Assistenten, den Sie versionieren oder klonen möchten, auf , und wählen Sie Version oder Klonen aus.

   3. Füllen Sie die Pflichtfelder aus, und klicken Sie auf Erstellen.

3. Entfernen Sie alle Skills aus der neu erstellten Version oder dem Klon.

   Das ist erforderlich, da Sie den digitalen Assistenten nicht zur Verwendung der nativen Sprachunterstützung überführen können, wenn er Skills enthält, die den Übersetzungsservicemodus nutzen.

4. Erstellen Sie eine neue Version oder einen Klon dieses geänderten digitalen Assistenten, wählen Sie Plattformversion 20.12 oder höher aus, und wählen Sie den Sprachmodus Nativ unterstützt aus.

   Mit diesem Schritt können Sie die Konfiguration für den digitalen Assistenten beibehalten, obwohl Sie die Skills separat verarbeiten müssen.

5. Fügen Sie die Skillversionen mit nativer Sprachunterstützung zum digitalen Assistenten hinzu.

Bei digitalen Assistenten (oder Standalone-Skills), die mehrere nativ unterstützte Sprachen verwenden, kann der digitale Assistent die Benutzersprache zu Beginn der Session automatisch erkennen. Funktionsweise:

• Die Sprache wird automatisch für digitale Assistenten und Skills erkannt, die mit mehreren nativ unterstützten Sprachen konfiguriert sind.
  • Wenn nur eine (nativ unterstützte) Sprache im digitalen Assistenten vorhanden ist, wird die Spracherkennung deaktiviert.
  • Wenn der digitale Assistent einen Übersetzungsservice verwendet, verarbeitet der Übersetzungsservice die Spracherkennung und nicht der digitale Assistent.
• Die Sprache wird nicht automatisch erkannt, wenn auf den digitalen Assistenten über einen Kanal zugegriffen wird, in dem die Variable profile.languageTag oder profile.locale festgelegt wurde.
• Die Sprache wird in der ersten Äußerung der Unterhaltung erkannt und nicht während der Session aktualisiert, selbst wenn der Benutzer die Sprache wechselt.
• Standardmäßig dauert die Kanalsession sieben Tage, bevor sie abläuft.

Im Folgenden finden Sie die ersten Schritte zum Einrichten eines einsprachigen digitalen Assistenten mit einer anderen Sprache als Englisch im Sprachmodus "Übersetzungsservice":

1. Klicken Sie auf , um das Seitenmenü zu öffnen, wählen Sie Entwicklung > Digitale Assistenten aus, und klicken Sie auf Neuer digitaler Assistent.

2. Füllen Sie das Dialogfeld aus, und achten Sie dabei besonders auf folgende Felder:
   • Plattformversion: Die Plattformversion wirkt sich auf das Verhalten Ihrer digitalen Assistenten aus, z.B. die Art und Weise, wie die Natural Language Understanding-(NLU-)Engine Intents auflöst, und welche Sprachen nativ unterstützt werden.

     Wenn Sie mit einem neuen digitalen Assistenten beginnen, wählen Sie die neueste verfügbare Version aus, da die Unterstützung für diese Version am längsten währt.

     Siehe Plattformversion.

   • Primäre Sprache: Dieses Feld wird nur angezeigt, wenn Sie die Plattformversion 20.12 oder höher ausgewählt haben.

     In diesem Feld müssen Sie die Zielsprache im Abschnitt Übersetzungsservice der Dropdown-Liste auswählen.

     Achtung:

     Stellen Sie sicher, dass Sie eine Option im Abschnitt Übersetzungsservice ausgewählt haben. Wenn Sie eine Option im Abschnitt Nativ unterstützt auswählen, akzeptiert der digitale Assistent nur Skills, die den Modus Nativ unterstützt verwenden.

     Wenn dieses Feld nicht angezeigt wird, wird die Sprache des digitalen Assistenten durch die Sprache des ersten Skills bestimmt, den Sie hinzufügen. In diesem Fall wird diese Sprache als vorherrschende Sprache und nicht als primäre Sprache bezeichnet.

Im Folgenden finden Sie die ersten Schritte zum Einrichten eines mehrsprachigen digitalen Assistenten im Sprachmodus "Übersetzungsservice":

1. Klicken Sie auf , um das Seitenmenü zu öffnen, wählen Sie Entwicklung > Digitale Assistenten aus, und klicken Sie auf Neuer digitaler Assistent.

2. Füllen Sie das Dialogfeld aus, und achten Sie dabei besonders auf folgende Felder:
   • Plattformversion: Die Plattformversion wirkt sich auf das Verhalten Ihrer digitalen Assistenten aus, z.B. die Art und Weise, wie die Natural Language Understanding-(NLU-)Engine Intents auflöst, und welche Sprachen nativ unterstützt werden.

     Wenn Sie mit einem neuen digitalen Assistenten beginnen, wählen Sie die neueste verfügbare Version aus, da die Unterstützung für diese Version am längsten währt.

     Siehe Plattformversion.

   • Primäre Sprache: Dieses Feld wird nur angezeigt, wenn Sie die Plattformversion 20.12 oder höher ausgewählt haben.

     In diesem Feld müssen Sie im Abschnitt Übersetzungsservice der Dropdown-Liste die Option Englisch auswählen.

     Achtung:

     Stellen Sie sicher, dass Sie eine Option im Abschnitt Übersetzungsservice ausgewählt haben. Wenn Sie eine Option im Abschnitt Nativ unterstützt auswählen, akzeptiert der digitale Assistent nur Skills, die den Modus Nativ unterstützt verwenden.

     Wenn dieses Feld nicht angezeigt wird, wird die Sprache des digitalen Assistenten durch die Sprache des ersten Skills bestimmt, den Sie hinzufügen. In diesem Fall wird diese Sprache als vorherrschende Sprache und nicht als primäre Sprache bezeichnet.

1. Falls noch nicht geschehen, konfigurieren Sie einen Übersetzungsservice für Ihre Digital Assistant-Instanz folgendermaßen:
   1. Klicken Sie auf , um das Seitenmenü zu öffnen, und wählen Sie Einstellungen > Übersetzungsservice aus.
   2. Klicken Sie auf + Service.
   3. Geben Sie im Dialogfeld "Übersetzungsservice" die URL und das Autorisierungstoken für den Microsoft Translator-Dienst oder die Google-Übersetzungs-API ein.
   In der Dokumentation zu Microsoft Translator und zur Google-Übersetzer-API wird beschrieben, wie die URL und das Zugriffstoken abgerufen werden.

   Hinweis
   
   Um die Google-Übersetzer-API verwenden zu können, müssen Sie den API-Schlüssel generieren. Sie erstellen diesen Schlüssel in der GCP-Konsole ( APIs und Services > Zugangsdaten). Weitere Informationen finden Sie in der Google Cloud Platform-Dokumentation.
2. Legen Sie den Übersetzungsservice in Ihrem digitalen Assistenten wie folgt fest:
   1. Klicken Sie auf , um das Seitenmenü zu öffnen, und wählen Sie Entwicklung > Digitale Assistenten und anschließend Ihren digitalen Assistenten aus.
   2. Klicken Sie in der linken Navigationsleiste des digitalen Assistenten auf das Symbol Einstellungen (), und wählen Sie die Registerkarte Allgemein aus.
   3. Navigieren Sie zur Dropdown-Liste Übersetzungsservice, und wählen Sie den Übersetzungsservice aus.

Wenn ein digitaler Assistent mit einem Übersetzungsservice eingerichtet ist, erkennt der digitale Assistent standardmäßig die Sprache des Benutzers auf die gleiche Weise wie ein Skill mit der Komponente "Sprache erkennen".

Sie müssen jedoch auch sicherstellen, dass die Skills im digitalen Assistenten die Sprache verwenden, die vom digitalen Assistenten erkannt wird. Wenn ein Skill Teil eines digitalen Assistenten ist, übersetzt der digitale Assistent Benutzereingaben ins Englische und übergibt diesen übersetzten englischen Text an den Skill. Standardmäßig erkennt daher die Skillkomponente "Sprache erkennen" Englisch als Sprache und setzt die Variable profile.LanguageTag auf Englisch, obwohl der Benutzer nicht-englischen Text eingegeben hat.

Um diesen Wechsel zu Englisch in einem Skill mit einem im visuellen Modus entwickelten Dialogablauf zu verhindern, müssen Sie die Eigenschaft Vorhandenes Profilsprachentag der Komponente "Sprache erkennen" in jedem Skill auf True setzen.

Dadurch wird sichergestellt, dass der Skill den Wert der profile.LanguageTag-Variable berücksichtigt, die vom digitalen Assistenten festgelegt wird.

Um diesen Wechsel zurück zu Englisch in einem YAML-basierten Skill zu verhindern, müssen Sie der Komponente System.DetectLanguage in jedem Skill die folgende Eigenschaft hinzufügen:

      useExistingProfileLanguageTag: true

Beispiel für die System.DetectLanguage-Komponente eines YAML-basierten Skills mit festgelegtem useExistingProfileLanguageTag-Wert:

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

Für den sichtbareren Text in einem digitalen Assistenten, der einen Übersetzungsservice verwendet, können Sie eine der folgenden Übersetzungsansätze verwenden:

• Verwenden Sie den Übersetzungsservice, der für den digitalen Assistenten konfiguriert ist.

  Wenn Sie diesen Ansatz verwenden, müssen nur Ihre Ausgabenachrichten auf Englisch vorliegen. Es ist keine weitere Konfiguration erforderlich. Der von Ihnen konfigurierte Übersetzungsservice übersetzt alle Ausgabenachrichten automatisch in die Sprache des Benutzers.

• Verwenden Sie ein Resource Bundle, um die Ausgabenachrichten selbst zu übersetzen.
  Hinweis
  
  Für Ausgabenachrichten, die keine Referenz auf einen Resource-Bundle-Schlüssel haben, wird automatisch der Übersetzungsservice zum Übersetzen der Nachrichten verwendet.

In digitalen Assistenten, die einen Übersetzungsservice verwenden, wird der explizite Aufruf von Skills vom digitalen Assistenten sowohl in der erkannten Sprache als auch in englischer Sprache erkannt.

Die übersetzbaren Zeichenfolgen finden Sie an den folgenden beiden Stellen:

• Auf der Seite "Skills" () des digitalen Assistenten.

  Hier finden Sie die Zeichenfolgen, die in erster Linie für die Hilfekarten verwendet werden, die angezeigt werden, wenn ein Benutzer im digitalen Assistenten um Hilfe bittet und wenn der digitale Assistent den Benutzer anfangs begrüßt.

  Für jeden Skill können Sie Folgendes übersetzen:

  • Die Felder Ein-Satz-Beschreibung, Beschreibung und Aufruf.
  • Die Beispieläußerungen.
• Auf der Seite Einstellungen () auf der Registerkarte Konfigurationen im Abschnitt Unterhaltungsparameter. Ab Plattformversion 21.04 werden Resource-Bundle-Einträge automatisch für diese Einstellungen erstellt.

Mit Resource-Bundle-Schlüsseln können Sie Ausgabetext identifizieren, der übersetzt werden muss, und Werte in einer oder mehreren Sprachen angeben. Bei digitalen Assistenten mit Plattformversion 21.04 oder höher werden Schlüssel automatisch für die Konfigurationseinstellungen des digitalen Assistenten generiert. Für andere Zeichenfolgen (und für Konfigurationseinstellungen in digitalen Assistenten auf Plattformversion 21.02 oder früher) müssen Sie Schlüssel manuell erstellen.

Wenn ein digitaler Assistent den Benutzer begrüßt oder Hilfeinformationen für die darin enthaltenen Skills anzeigt, verwendet er Werte von der Seite "Skills" im digitalen Assistenten, um die Willkommens- und Hilfekarten aufzufüllen. Sie können die auf diesen Hilfekarten angezeigten Informationen übersetzen, indem Sie einige der Felder auf der Seite "Skills" bearbeiten.

1. Klicken Sie in der linken Navigationsleiste des digitalen Assistenten auf
2. Wählen Sie einen Skill aus.
3. Aktualisieren Sie die Felder Ein-Satz-Beschreibung, Beschreibung und Aufruf mit Referenzen auf Resource Bundles im Formular:

   ${rb.BundleKeyName}

   Beispiel: Sie können Folgendes für eine Referenz auf einen Schlüssel für eine einzeilige Beschreibung eines Pizzaskills verwenden.

   ${rb.PizzaSkillShortDescription}

4. Zeigen Sie im Abschnitt "Beispiele" der Seite mit der Maus auf ein Beispiel, klicken Sie auf das zugehörige Symbol Bearbeiten, und ersetzen Sie den Text wie oben durch eine Referenz auf einen Resource-Bundle-Schlüssel.
5. Wiederholen Sie den vorherigen Schritt für die anderen Beispieläußerungen des Skills.
6. Wiederholen Sie die vorherigen vier Schritte für jeden Skill.

Digitale Assistenten verfügen über eine Reihe von Konfigurationseigenschaften, mit denen verschiedene Prompts und Nachrichten angezeigt werden.

Um die Ausgabe für eine Konfigurationseigenschaft festzulegen, referenzieren Sie die Resource Bundle-Variable und den Nachrichtenschlüssel. Beispiel: ${rb('WhatType')}. Sie können auch die Punktnotation verwenden, z.B.: ${rb.WhatType}

1. Klicken Sie in der linken Navigationsleiste des digitalen Assistenten auf das Symbol Einstellungen (), und wählen Sie die Registerkarte Konfigurationen aus.

2. Geben Sie für die Eigenschaften im Abschnitt Unterhaltungsparameter der Seite die Referenzen auf Resource-Bundle-Schlüssel ein, die Sie jeweils dafür definiert haben.

   Beispiel: Wenn Sie einen Schlüssel in Ihrem Resource Bundle mit dem Namen daAcknowledgementResponse für die Eigenschaft "Bestätigungsantwort" haben, geben Sie Folgendes in das Feld Bestätigungsantwort ein:

   ${rb('daAcknowledgementResponse')}

Sie können auch Parameter in Werten für Bundle-Schlüssel verwenden. Auf diese Weise können Sie Systemvariablen in der Ausgabe verwenden. Beispiel: Der Standardwert der Eigenschaft "Ablaufbestätigung beenden" lautet:

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

Sie können die Referenzen auf die Systemvariablen (in diesem Fall system.routingFromIntent und system.routingFromSkill) in Ihren übersetzten Antworten beibehalten, indem Sie folgende Aktionen ausführen:

1. Fügen Sie im Wert für den entsprechenden Resource-Bundle-Schlüssel {0}, {1} usw. als Substitutionscodes für jede Systemvariable ein. Beispiel: In dem englischen (oder Standard-)Eintrag, den Sie für die Eigenschaft "Ablaufbestätigung beenden" erstellen, können Sie den folgenden Text verwenden:

   Exited {0} in {1}.

2. Geben Sie dann im Wert der Eigenschaft die Referenz auf den Bundle-Schlüssel im folgenden Format ein:

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

   Beispiel: Die Eigenschaft "Ablaufbestätigung beenden" (wobei daExitFlowConfirmation der entsprechende Bundle-Schlüssel ist) würde folgendermaßen aussehen:

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

Sie können Resource Bundles in Form einer CSV-Datei exportieren und importieren. Dadurch können Sie offline mit den Bundles arbeiten.

Die CSV-Datei muss folgende Spalten enthalten:

• languageTag
• key
• message
• annotation

So exportieren Sie eine CSV-Datei mit dem vorhandenen Resource Bundle:

• Klicken Sie auf der Seite "Resource Bundle" für Ihren Skill oder digitalen Assistenten auf , um eine CSV-Datei mit dem vorhandenen Resource Bundle zu exportieren.

  Selbst wenn Sie dem Resource Bundle noch keine Schlüssel hinzugefügt haben, wird eine Datei mit dem erforderlichen Format der CSV-Datei exportiert.

So importieren Sie eine Resource-Bundle-Datei:

• Klicken Sie auf der Seite "Resource Bundle" für Ihren Skill oder digitalen Assistenten auf .

Ab Plattformversion 21.04 werden Resource Bundle-Einträge automatisch für die Konfigurationseinstellungen des digitalen Assistenten erstellt. Wenn Ihr digitaler Assistent auf Plattformversion 21.02 oder früher basiert, können Sie ein Upgrade auf 21.04 oder höher durchführen, damit diese Einträge für Sie generiert werden.

Im Folgenden finden Sie eine Liste aller Systemressourcen-Bundle-Einträge für digitale Assistenten sowie deren Standardwerte.

Wenn Sie Resource-Bundle-Einträge für Ihre Konfigurationseinstellungen verwenden möchten, ohne die Plattformversion des digitalen Assistenten auf 21.04 oder höher zu aktualisieren, finden Sie hier eine Liste der Anpassungseigenschaften, die Sie übersetzen können, zusammen mit vorgeschlagenen Namen für die Bundle-Schlüssel und den Ausdrücken, mit denen Sie diese Bundle-Schlüssel aus den Feldern für die Eigenschaften referenzieren können.