Oracle Cloud Infrastructure - Dokumentation

Komponenten

Die Status eines Dialogablaufs basieren auf Komponenten, die Aktionen ausführen, wie das Akzeptieren von Benutzereingaben, das Prüfen dieser Eingabe oder das Antworten mit Text.

Es gibt zwei Arten von Komponenten, die Sie in einem Dialogablauf verwenden können: integrierte Komponenten und benutzerdefinierte Komponenten. Wenn die Dialog-Engine in einen Status im Dialogablauf übergeht, wird die Komponente ausgewertet. Wenn eine der integrierten Komponenten ermittelt wird, wird eine der allgemeinen Aufgaben ausgeführt, z.B. eine Nachricht anzeigen oder den Benutzer bitten, Text einzugeben. Wenn die Dialog-Engine eine benutzerdefinierte Komponente erkennt, ruft sie den Service der Komponente auf, der eine oder mehrere benutzerdefinierte Komponenten hostet.

Integrierte Komponenten

Digital Assistant stellt eine Reihe von Komponenten bereit, die eine Reihe von allgemeinen Aktionen unterstützen, die Sie in jedem Skill verwenden können: Sicherheit, Parsing der Benutzereingabe, Weiterleiten des Dialogablaufs basierend auf der Benutzereingabe, und Ausgabe der Skillantworten auf verschiedene Arten. Sofern Sie nicht mit Backends integrieren müssen oder extrem komplexe Logik ausführen, bieten diese Komponenten die Aktionen, die Ihre Status benötigen.

Der Zugriff auf Komponenten hängt davon ab, ob Sie den Dialogablauf mit Visual Flow Designer oder im YAML-Modus entwerfen:

  • Wenn Sie Visual Flow Designer verwenden, fügen Sie einem Ablauf den ersten Status für eine integrierte Komponente hinzu, indem Sie mit der Maus auf die Kachel Start zeigen, auf das Menü Symbol im Menü "Status hinzufügen" klicken, Startstatus hinzufügen auswählen und dann im Dialogfeld Status hinzufügen eine Komponentenvorlage auswählen. Sie können nachfolgende Status hinzufügen, indem Sie im Menü eines Status die Option Status hinzufügen auswählen oder auf das Symbol Status zu diesem Übergang hinzufügen zwischen zwei Status klicken. Siehe Abläufe entwerfen.
  • Wenn Sie Ihren Skill im YAML-Modus entwerfen, fügen Sie dem Dialogablauf einen Status für eine integrierte Komponente hinzu, indem Sie + Komponenten auswählen und dann eine Komponentenvorlage aus dem Menü auswählen.

Bei der Validierung des Dialogablaufs überprüft Digital Assistant die Eigenschaften der Komponente. Er meldet beispielsweise, wenn Sie vergessen haben, eine erforderliche Eigenschaft aufzunehmen.

Details zu den im Visual Flow Designer verfügbaren Komponentenvorlagen finden Sie unter Komponentenvorlagen.

Details zu Komponenten, die im YAML-Modus verfügbar sind, finden Sie unter Integrierte Komponenten: Eigenschaften, Übergänge und Nutzung.

Benutzerdefinierte Komponenten

Die meisten Skills müssen mit Daten aus Remotesystemen integriert werden oder eine Backend-Verarbeitung durchführen. Beispiel: Ihr Skill muss eine Liste mit Produkten abrufen oder Bestellinformationen speichern. Weiteres Beispiel: Ihr Skill muss möglicherweise komplexe Logik ausführen, die Sie mit FreeMarker oder einem Entity-Event-Handler nicht ausführen können. Mit benutzerdefinierten Komponenten können Sie Integrationen mit Backends vornehmen und Aufgaben ausführen, die von den integrierten Komponenten nicht abgedeckt werden.

Weitere Informationen zum Erstellen einer benutzerdefinierten Komponente finden Sie unter Benutzerdefinierte Komponenten implementieren. Weitere Informationen zum Hinzufügen von benutzerdefinierten Komponenten zur Verwendung in Ihrem Skill finden Sie unter Komponentenpackage zu Skills hinzufügen. Um mehr über eine benutzerdefinierte Komponente zu erfahren, die dem Skill hinzugefügt wurde, gehen Sie zur Seite "Komponenten" Symbol "Komponenten" des Skills, blenden Sie den Komponentenservice ein, und wählen Sie die Komponente aus. Name, Eigenschaften und unterstützte Aktionen der Komponente werden angezeigt. Mit diesen Informationen können Sie den Status der Komponente in Ihrem Dialogablauf erstellen.

Tipp:

Weil Komponenten aus verschiedenen Services denselben Namen haben können, können Sie dem Komponentennamen den Servicenamen, gefolgt von einem Doppelpunkt (:), voranstellen, um sicherzustellen, dass Sie jede verwendete benutzerdefinierte Komponente eindeutig referenzieren.

Nachfolgend finden Sie ein Beispiel für einen benutzerdefinierten Komponentenstatus in einem Dialogablauf, der im YAML-Modus entwickelt wird. Die Komponente hello.world stammt aus dem Service custom. 

  start:
    component: "custom:helloWorld"
    properties:
      human: "${human.value}"
    transitions:
      next: "askAge"

Wenn Sie den eingebetteten Komponentenservice zum Hosten Ihrer benutzerdefinierten Komponenten verwenden, können Sie über die Seite "Komponenten" Symbol "Komponenten" auf Logs und Absturzberichte zugreifen. Wählen Sie den Service aus, und klicken Sie auf Diagnose.

Andere Eigenschaften, die für benutzerdefinierte Komponenten im YAML-Modus verfügbar sind

Bei der Entwicklung von Dialogabläufen im YAML-Modus können Sie diese Eigenschaften zusätzlich zu den definierten Eigenschaften der Komponente in den Status der benutzerdefinierten Komponente aufnehmen.

Name Beschreibung Erforderlich?
autoNumberPostbackActions Wenn diese Option auf true gesetzt ist, stellt sie den Schaltflächen und Listenoptionen Zahlen voran. Selbst wenn Sie diese Option nicht auf true gesetzt haben, kann die automatische Nummerierung für Kartenelemente erzwungen werden, wenn die Konfiguration Automatische Nummerierung bei Postback-Aktionen aktivieren des digitalen Assistenten auf true gesetzt ist. Der Standardwert ist false. Nr.
insightsEndConversation Setzen Sie diesen Wert auf true, um die Aufzeichnung der Unterhaltung für Insight-Berichte zu stoppen. Der Standardwert lautet false. Nr.
insightsInclude Gibt an, ob der Status in Insight-Berichte einbezogen werden soll. Der Standardwert ist true. Nr.
translate Mit dieser Eigenschaft können Sie den booleschen Wert außer Kraft setzen, den Sie für die Kontextvariable autotranslate festgelegt haben. Wenn Sie die Variable autotranslate nicht festgelegt oder sie auf false gesetzt haben, können Sie diese Eigenschaft auf true setzen, um die automatische Übersetzung nur für diese Komponente zu aktivieren. Wenn Sie die Variable autotranslation auf true setzen, können Sie diese Eigenschaft auf false setzen, um diese Komponente von der automatischen Übersetzung auszuschließen. Siehe Übersetzungsservices in Skills. Der Standardwert ist der Wert der Kontextvariable autotranslate. Nr.

Diese Eigenschaften sind für Status in Dialogabläufen, die Sie mit Visual Flow Designer entwickeln, nicht verfügbar.