Die überwiegende Mehrheit der Vorlagen in der Kategorie Benutzermeldungen basiert auf der Komponente "Gemeinsame Antwort". Mit dieser Komponente können Sie Komponenteneigenschaften und Metadaten verwenden, um eine spezielle Benutzeroberfläche zu erstellen, die Text, Aktionsschaltflächen, Bilder und Karten enthalten kann.

In vielen Fällen, z.B. in den Vorlagen in der Unterkategorie Multimedia-Nachrichten anzeigen, liegen die Hauptunterschiede in der Eigenschaft Metadaten für die Komponente "Gemeinsame Antwort".

In anderen Fällen, z.B. in der Unterkategorie Tabellen und Formulare anzeigen, besteht die Vorlage aus einer Komponente "Gemeinsame Antwort", der eine Komponente "Variable festlegen" vorangestellt ist.

In der Unterkategorie Kanalspezifische Features finden Sie Beispiele für die Verwendung von Erweiterungen, die für Slack- und Microsoft Teams-Kanäle verfügbar sind.

Mit der Komponente "Benutzerfeedback" können Sie Feedbackdaten für Insights erfassen, indem Sie Benutzern eine Bewertungsskala nach Abschluss eines Transaktionsablaufs anzeigen. Benutzer können ihre Bewertung nicht ändern, weil die Benutzerfeedbackkomponente keine Out-of-Order-Eingabe zulässt. Wenn Sie das SDK 21.10 oder höher verwenden, gibt diese Komponente ein horizontales Sternenbewertungssystem aus.

Während Sie das Verhalten dieser Komponente mit den Komponenteneigenschaften ändern können, können Sie ihr Look-and-Feel ändern, wenn Sie das SDK (Version 21.10 oder höher) verwenden. Beispiel: Sie können die Standardsternsymbole für die Feedbackschaltflächen durch ein anderes Symbol ersetzen.

Diese Komponente kann folgende Aktionen zurückgeben:

Sie können die folgenden Systemvariablen für die Nachrichten verwenden, die von den Übergangszuständen ausgegeben werden:

• system.userFeedbackRating - Gibt die Bewertung des Benutzers zurück.
• system.userFeedbackText: Wenn enableTextFeedback auf true gesetzt ist, kann Ihr Skill zur Eingabe von Feedback auffordern, wenn die Bewertungen den Wert threshold unterschreiten. system.userFeedbackText gibt die Benutzereingabe (${system.userFeedbackText.value}) zurück.

Der Standardanzeigetext der Komponente wird in Resource-Bundle-Einträgen gespeichert. Diese Bundle-Einträge haben Standardtext, die Sie jedoch anpassen können. Hier sind die Einträge für diese Komponente:

Kopiert Werte aus einer Variablen in eine andere.

Die Definitionen dieser Eigenschaften müssen sich nicht spiegeln. Sie können zwar sowohl Ziel- als auch Quellvariablen als Variablenlisten definieren, Sie können aber auch die Quellvariable mit einer einzelnen Variablen und das Ziel als Liste definieren. Wenn Sie eine zusätzliche Zielvariable festlegen, erbt sie den Variablenwert des angegebenen fortlaufenden Quellwerts.

Diese Komponente setzt die Werte der angegebenen Variablen auf Null zurück.

Die Komponente "Variable festlegen" legt den Wert einer vordefinierten Variablen fest.

Die Komponente "Sprache erkennen" verwendet den Übersetzungsservice, um die Sprache des Benutzers aus der Benutzereingabe zu ermitteln.

Diese Komponente legt eine Variable mit dem Namen profile.languageTag mit der Gebietsschemazeichenfolge fest. Sie können Variablen mit der aktuellen Sprache festlegen, wenn Sie diese Variable in einem Wertausdruck (${profile.languageTag}) verwenden.

Diese Komponente sendet den angegebenen Text an den Übersetzungsservice des Skills und speichert dann die englische Übersetzung. Dieser Skill basiert auf dem Skill, der mit einem Übersetzungsservice konfiguriert wird. Er erkennt die Sprache aus der Eingabe des Benutzers und übersetzt sie in Englisch. Diese Komponente funktioniert nicht mit Skills, die den Sprachmodus "Nativ unterstützt" verwenden.

Verwenden Sie diese Komponente, wenn Sie den Roheingabetext vor der Übersetzung verarbeiten müssen. Beispiel: Sie möchten einige personenbezogene Daten aus der Benutzereingabe entfernen, bevor Sie sie an den Übersetzungsservice senden.

Da diese Komponente den Übersetzungsservice nutzt, der bereits die Sprache des Benutzers erkennt, muss diese Komponente keine Zustände befolgen, die die Sprache erkennen oder festlegen.

Mit der Komponente "Ausgabe übersetzen" können Sie angegebenen Text in die Sprache des Benutzers übersetzen. Die Komponente übernimmt den für die Eigenschaft Ausdruck definierten Wert. Mit dem Übersetzungsservice des Skills wird der Text in die Sprache übersetzt, die von der Komponente "Sprache ermitteln" oder von der Variable profile.locale ermittelt wurde, und speichert ihn dann in der Variablen, die mit der Eigenschaft Variable angegeben wird.

Diese Komponente funktioniert nicht mit Skills, die den Sprachmodus "Nativ unterstützt" verwenden.

Die Komponente "Entity abgleichen" ruft die Intent Engine auf, um Entityinformationen aus dem in der Eigenschaft Quellvariable gespeicherten Text zu extrahieren. Wenn für den Entitytyp der Variable eine Übereinstimmung vorhanden ist, wird die von der Eigenschaft Variable angegebene Variable mit diesem Entitywert festgelegt.

Diese Komponente hat außerdem zwei vordefinierte Übergänge: match und nomatch.

Verwenden Sie diese Komponente, um den Autorisierungscode für Services zu erhalten, die durch den Autorisierungscode-Berechtigungsablauf gesichert werden, wie LinkedIn, Twitter, Google oder Microsoft. Die benutzerdefinierten Komponenten des Skills können den Autorisierungscode für ein Zugriffstoken austauschen, mit dem sie dann den Endservice aufrufen.

Die Komponente leitet den Benutzer zunächst zur Anmeldeseite des Identitätsproviders weiter. Nach erfolgreicher Anmeldung gibt die Komponente den Autorisierungscode in einer Variablen zurück, mit der Sie den Autorisierungscode an die benutzerdefinierte Komponente übergeben. Die benutzerdefinierte Komponenten-API muss den Autorisierungscode, die Client-ID und das Client Secret gegen ein OAuth-Benutzerzugriffstoken austauschen.

Für jeden Status, der eine Autorisierung erfordert, bevor er aufgerufen werden kann, setzen Sie die Einstellung Autorisierung erforderlich auf True. Die Schritte zum Einrichten dieser Berechtigung finden Sie unter Benutzerautorisierung.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Diese Komponente kann folgende Aktionen zurückgeben:

Der Standardanzeigetext der Komponente wird in Resource-Bundle-Einträgen gespeichert. Diese Bundle-Einträge haben Standardtext, die Sie jedoch anpassen können. Hier sind die Einträge für diese Komponente:

Die Schritte zum Ändern der Standardnachricht für einen Resource Bundle-Eintrag finden Sie unter Resource Bundle-Eintrag ändern.

Wenn die Dialog-Engine diese Komponente aufruft, bietet der Skillbot dem Benutzer zwei Links an: Anmelden und Abbrechen.

Beschreibung der Abbildung fb-oauth.png

Es gibt mehrere Möglichkeiten für den Übergang von dieser Komponente aus:

• Der Benutzer klickt auf die Schaltfläche "Abbrechen", und die Komponente geht in den Status über, der von der Aktion fail benannt wird.

• Der Benutzer klickt nicht auf eine der Schaltflächen, sondern gibt stattdessen Text ein. Die Komponente geht in den Status über, der von der Aktion textReceived benannt wird.

• Der Benutzer klickt auf den Anmeldelink, und der Kanal zeigt die Anmeldeseite des Identitätsproviders oder das zugehörige Authentifizierungsdialogfeld als Webview an, wie im folgenden Beispiel dargestellt. Nach erfolgreicher Autorisierung geht die Komponente in den Status über, der von der Aktion pass benannt wird (oder in den nächsten Status, wenn keine Aktion pass vorhanden ist). Dabei wird normalerweise eine benutzerdefinierte Komponente aufgerufen, die den Autorisierungscode gegen ein Zugriffstoken austauscht.

Beschreibung der Abbildung webview-login.png

Wenn das Testfenster nicht als Webview angezeigt wird, können Sie den Linktext kopieren und in den Browser einfügen.

Verwenden Sie diese Komponente, um ein OAuth2-Benutzerzugriffstoken (Berechtigungstyp Autorisierungscode) für Ressourcen abzurufen, die von OCI IAM, Oracle Access Manager (OAM), Microsoft-Identitätsplattform oder Google OAuth 2.0-Autorisierung gesichert werden. Diese Komponente führt alle Schritte für den dreistufigen OAuth2-Ablauf aus und gibt das OAuth2-Zugriffstoken zurück.

Für jeden Status, der eine Autorisierung erfordert, bevor er aufgerufen werden kann, setzen Sie die Einstellung Autorisierung erforderlich auf True. Die Schritte zum Einrichten dieser Berechtigung finden Sie unter Benutzerautorisierung.

Wenn Sie ein Zugriffstoken des Berechtigungstyps "Clientzugangsdaten" anfordern müssen, finden Sie weitere Informationen unter OAuth 2.0 Client.

Bevor Sie diese Komponente in einem Skill verwenden können, müssen Sie folgende Aufgaben ausführen:

1. Wenn der Client noch nicht registriert wurde, registrieren Sie ihn mit dem Identitätsprovider, wie unter Identitätsproviderregistrierung beschrieben.
2. Fügen Sie einen Authentifizierungsservice für den Identitätsprovider hinzu, wie unter Authentifizierungsservices beschrieben.

Einige Identitätsprovider stellen Aktualisierungstoken aus. Wenn Sie diese Komponente verwenden, speichert Digital Assistant das Aktualisierungstoken für den Aufbewahrungszeitraum, der für den Authentifizierungsservice angegeben ist. Das Backend von Digital Assistant kann das Aktualisierungstoken verwenden, sofern verfügbar, um ein neues Zugriffstoken abzurufen, ohne dass sich der Benutzer erneut anmelden muss.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Diese Komponente kann folgende Aktionen zurückgeben:

Der Standardanzeigetext der Komponente wird in Resource-Bundle-Einträgen gespeichert. Diese Bundle-Einträge haben Standardtext, die Sie jedoch anpassen können. Hier sind die Einträge für diese Komponente:

Die Schritte zum Ändern der Standardnachricht für einen Resource Bundle-Eintrag finden Sie unter Resource Bundle-Eintrag ändern.

Wenn die Dialog-Engine die Komponente ermittelt, fordert der Skillbot den Benutzer mit zwei Links zu einer Handlung auf: Zugriffstoken abrufen und Abbrechen (Sie können den Linktext mit linkLabel und cancelLabel ändern).

Wenn der Benutzer auf den Link zum Abrufen eines Zugriffstokens klickt, wird die Anmeldeseite oder das Authentifizierungsdialogfeld des Identitätsproviders angezeigt, wie vom Authentifizierungsservice angegeben. Nach erfolgreicher Anmeldung wird das Zugriffstoken abgerufen, die Werte für die Variablen accessTokenVariableName und authenticatedUserVariableName werden festlegt, und es wird in den Status übergegangen, der durch die pass-Aktion benannt wird (oder den nächsten Status, wenn keine pass-Aktion vorhanden ist). Wenn der Benutzer den Vorgang abbricht, wird die Postback-Aktion auf fail gesetzt. Wenn der Benutzer Text eingibt, wird die Aktion textReceived zurückgegeben.

Wie bereits erwähnt können Sie requiresAuthorization für einen Status festlegen, um sicherzustellen, dass der Benutzer autorisiert ist, bevor die Komponente des Status aufgerufen wird. Wenn der Benutzer noch keine Berechtigung hat, ruft das Dialogfeld das Ereignis "Benutzer autorisieren" auf.

Mit dieser Komponente können Sie ein OAuth2-Zugriffstoken des Berechtigungstyps "Clientzugangsdaten" abrufen. Sie können damit also ein Zugriffstoken abrufen, das auf den Clientzugangsdaten und nicht auf dem Namen und Kennwort des Benutzers basiert. Mit dieser Komponente können Sie ein Token abrufen, das den Zugriff auf Clientressourcen ermöglicht, die von Oracle Identity Cloud Service oder Oracle Access Manager (OAM) gesichert werden.

Wenn Sie im Namen eines Benutzers auf Ressourcen zugreifen müssen, finden Sie weitere Informationen unter OAuth 2.0 Accountlink und OAuth Accountlink.

Bevor Sie diese Komponente in einem Skill verwenden können, müssen Sie folgende Aufgaben ausführen:

1. Wenn der Client noch nicht registriert wurde, registrieren Sie ihn mit dem Identitätsprovider, wie unter Identitätsproviderregistrierung beschrieben.
2. Fügen Sie einen Clientzugangsdaten-Authentifizierungsservice für den Identitätsprovider hinzu, wie unter Authentifizierungsservices beschrieben.

Diese Komponente hat keine Aktionen. Um mögliche Systemprobleme zu verarbeiten, fügen Sie einen nächsten Übergang hinzu, der zu einem Status führt, der derartige Fehler verarbeiten kann.

Mit dieser Komponente können Sie alle Aktualisierungs- und Benutzerzugriffstoken des angemeldeten Benutzers vom Identitätsprovider entziehen, den der Authentifizierungsservice repräsentiert. Außerdem werden die Aktualisierungstoken aus der Datenbank entfernt. Um diese Komponente verwenden zu können, müssen Sie die URL zum Widerrufen von Aktualisierungstoken des Identitätsproviders in der Authentifizierungsservice-UI angeben.

Der Skill muss einen Status enthalten, der die Komponente OAuth 2.0-Accountlink für denselben Authentifizierungsservice verwendet, und er muss vor dem Status aufgerufen werden, der diese Komponente verwendet.

Diese Komponente kann folgende Aktion zurückgeben:

Mit dieser Komponente können Sie den Status basierend auf einem Variablenwert ändern.

Diese Komponente bestimmt einen Ausführungspfad, indem sie eine Variable oder einen Ausdruck auflöst und dann eine entsprechende Übergangsaktion auslöst, die einem Status im Ablauf zugeordnet ist.

Sie definieren und ordnen die Übergangsaktionen auf der Registerkarte Übergänge des Eigenschaftsinspektors zu.

Mit dieser Komponente rufen Sie einen untergeordneten Fluss aus dem aktuellen Fluss auf und übergeben optional Eingabeparameter. Nach Abschluss des untergeordneten Ablaufs werden eine Aktion und optionale Ausgabeparameter an den übergeordneten Ablauf zurückgegeben.

Die Übergangsaktionen, die festgelegt werden können, hängen von den Aktionen ab, die in der Endflusskomponente des untergeordneten Ablaufs festgelegt werden.

Mit dieser Komponente rufen Sie den Ablauf eines anderen Skills auf und übergeben optional Eingabeparameter. Wenn der aufgerufene Ablauf abgeschlossen ist, gibt er eine Aktion und optionale Ausgabeparameter an den aufrufenden Ablauf zurück.

Bevor Sie diese Komponente verwenden, muss ein öffentlicher Ablauf in dem Skill verfügbar sein, den Sie aufrufen. Siehe Weitere Skills aus einem Ablauf aufrufen.

ParamName: ParamValue

Mit dieser Komponente wird ein Ablauf explizit beendet.

Wenn dieser Status erreicht ist, werden alle Variablen des Ablaufs gelöscht, und die Steuerung wird an den übergeordneten Ablauf zurückgegeben (oder, wenn kein übergeordneter Ablauf vorhanden ist, den Hauptfluss).

Sie benötigen keinen Endablaufstatus für einen Ablauf, wenn Sie keine Parameter oder Aktionen aus dem Ablauf an einen übergeordneten Ablauf oder den Hauptablauf zurückgeben müssen.

Diese Vorlage besteht aus den Komponenten "Agent-Initiierung" und "Agent-Unterhaltung". Mit diesen Komponenten übertragen Sie die Unterhaltung eines Skills zusammen an einen Oracle B2C Service-Agent.

• Die Agent-Initiierungskomponente initiiert den Handshake mit dem Agent-Integrationskanal, der durch die Eigenschaft Agent-Integrationskanal der Komponente angegeben wird.
• Die Agent Conversation-Komponente verwaltet den Austausch zwischen Skill und Live-Agent.

Diese Vorlage ist für Unterhaltungen bestimmt, die aus dem Skill stammen. Verwenden Sie diese Vorlage nicht für Unterhaltungen, die aus einem Oracle B2C Service-Chat stammen, wie in Digital Assistant Agent Framework in Aktion beschrieben.

Mit der Agent-Übertragungskomponente können Sie in digitalen DA-Agents die Unterhaltung zurück an den Chatservice übertragen. Die Unterhaltung wird gemäß den im Chatservice konfigurierten Chatregeln an einen Live-Agent weitergeleitet.

Diese Komponente ist für Unterhaltungen bestimmt, die aus einem Servicechat stammen, wie in Digital Assistant-Agent-Framework in Aktion beschrieben. Verwenden Sie stattdessen die Agent-Kommunikationsvorlage für Unterhaltungen, die aus dem Skill stammen.

Mit der Komponente "Agent-Übertragungsbedingung" können Sie in digitalen Assistenten von DA-as-agent bestimmen, ob Agents verfügbar sind und, falls ja, die erwartete Wartezeit.

Mit den Eigenschaften der Komponente können Sie die Übertragungsbedingungen angeben. Außerdem wird eine Aktion zurückgegeben, die angibt, ob die Bedingungen erfüllt wurden. Außerdem werden die Werte der benannten Zuordnungsvariablen festgelegt.

Im Folgenden finden Sie die Struktur des Werts der Agent-Verfügbarkeitsstatusvariable und der darin gespeicherten Informationen:

queueId (integer, optional): The engagement queue ID,
expectedTotalWaitSeconds (integer, optional): Expected wait time in the queue in seconds
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitSeconds (integer, optional): The number representing the "ss" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitMinutes (integer, optional): The number representing the "mm" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
availableAgentSessions (integer, optional): Total number of sessions available across all agents.,
totalAvailableAgents (integer, optional): Total number of agents whose status is available.,
totalUnavailableAgents (integer, optional): Total number of agents whose status is unavailable.,
totalAgentsRequestingNewEngagement (integer, optional): Total number of agents who are available and have capacity.
outsideOperatingHours (boolean, optional): True if outside operating hours. False if inside operating hours.,
engagementsInQueue (integer, optional): The number of engagements currently in the queue.
sessionId (string, optional): The session ID.,
clientId (integer, optional): The client ID.

This might take {minutes, plural,
     =-1 {}
     =0 {}
     =1 {1 minute and }
     other {# minutes and }
}{seconds, plural,
     =-1 {a while}
     =0 {{minutes, plural,
          =0 {a short wait time}
          other {0 seconds}
        }}
     =1 {1 second}
     other {# seconds}
} to connect. Are you willing to wait?

Mit dieser Komponente können Sie eine HTTP-Anforderung an einen REST-Endpunkt senden, den Sie in den API-Serviceeinstellungen konfiguriert haben.

Im Folgenden werden die Komponenteneigenschaften aufgeführt:

Die Komponente gibt folgende Aktionen zurück:

Weitere Informationen finden Sie unter Mit der REST-Servicekomponente auf Backends zugreifen.

Mit dieser Komponente können Sie in Oracle B2C Service Knowledge Foundation oder Oracle Fusion Service Knowledge Management nach Informationen über einen bestimmten Suchbegriff suchen und die Ergebnisse anzeigen.

Bei Oracle B2C Service hängen die Suchergebnisse davon ab, ob die Antworten öffentlich sind und welche Zugriffsebene, welches Produkt und welche Kategorieeinstellungen ausgewählt sind.

Sie müssen einen Knowledge-Suchservice erstellen, bevor Sie diese Komponente verwenden können. Siehe Knowledge-Suchservice hinzufügen.

Hier sind die Eigenschaften der Knowledge-Suchkomponente:

Mit der Vorlage Vorfallerstellung können Sie einen Vorfallsbericht für einen Kundenservice-Standort erstellen. Beachten Sie, dass Sie eine Kundenserviceintegration auf der Seite Einstellungen > Zusätzliche Services > Kundenserviceintegration erstellen müssen, bevor Sie diese Komponente in Ihrer Instanz verwenden können.

Mit dieser Komponente können Sie von einem Skill aus auf ein Oracle Intelligent Advisor-Interview zugreifen.

Sie müssen eine Intelligent Advisor-Serviceintegration erstellen, bevor Sie diese Komponente verwenden können. Siehe Intelligent Advisor-Service hinzufügen. Außerdem muss das Interview im Intelligent Advisor Hub bereitgestellt und im Chatservicekanal aktiviert worden sein. Das Interview muss für anonyme Benutzer gelten. Sie können nicht auf Interviews für Portalbenutzer oder Agent-Benutzer zugreifen.

Mit den Eigenschaften der Komponente können Sie die folgenden Intervieweinstellungen angeben:

• Anzeige der Titel und Erläuterungen
• Die Labels für die Schaltflächen "Ja", "Nein" und "Weiß nicht"
• Die Zeichenfolgen, die der Benutzer zum Zurücksetzen, zum Zurückkehren zur vorherigen Frage (Rückgängig) und zum Beenden des Interviews eingibt
• Der Text, der am Ende des Interviews angezeigt werden soll
• Formulierung der Frage, ob die Erklärung angezeigt werden soll
• Die Zeichenfolge, mit der Benutzer angeben, dass Dateien vollständig hochgeladen wurden
• Die Attributwerte und Connector-Parameter, die an das Interview übergeben werden
• Das zu verwendende Projektgebietsschema

Die Webview-Komponente öffnet eine Webview in Ihrem Skill oder für Skills, die in einem Webkanal ausgeführt werden, auf einer Browserregisterkarte.

Mit dieser Komponente können Sie eine Benachrichtigung an einen Benutzer senden, wenn ein cloudbasiertes Ereignis eines Typs aufgetreten ist, der in Oracle Digital Assistant registriert wurde. Informationen zum Registrieren von Ereignistypen und zum Konfigurieren eines digitalen Assistenten zum Konsumieren des Ereignisses finden Sie unter Externe Ereignisse.

Mit dieser Komponente können Sie ein cloud-basiertes Ereignis eines Typs, der in Oracle Digital Assistant registriert wurde, extern veröffentlichen. Informationen zum Registrieren von Ereignistypen und zum Konfigurieren eines digitalen Assistenten für die Veröffentlichung und Nutzung von Ereignissen finden Sie unter Externe Ereignisse.

Im Folgenden finden Sie ein Beispiel für eine Payload, die als Wert für die Eigenschaft "Data" verwendet werden kann:

{
    "size": "Large",
    "type": "Veggie"
}

        "system.postbackActions": {
          "small": {
            "postback": {
              "variables": {
                "size": "Small"
              },
              "system.botId": "44F2405C-F317-4A3F-8250-617F54F01EA6",
              "action": "Small",
              "system.state": "size"

An dieser Stelle wird die Eigenschaft system.state in der Payload der eingehenden Postback-Aktion vom System mit dem aktuellen Status verglichen. Wenn diese nicht mehr übereinstimmen, führt der Skill einen Übergang durch, der davon abhängt, wie Sie den Dialogablauf konfigurieren. Die Anforderung des Benutzers wird entweder genehmigt oder abgelehnt.

Sie können das standardmäßige Out-of-Order-Nachrichtenhandling ändern, indem Sie das Systemübergangsereignis "Out-of-Order Message" einer Invoke Flow-Komponente zuordnen, die einen Flow aufruft, den Sie für die Verarbeitung von Out-of-Order-Nachrichten angegeben haben.