Die vordefinierte Komponente für das Guthaben prüft die Authentifizierungsstufe eines Kunden und stellt einem authentifizierten Kunden dann Informationen zum Guthaben bereit. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das spezifische Konto, für das der Kunde das Guthaben abrufen möchte. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge verfassen
Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des Agents zu Beginn der Unterhaltung ausgelöst.
Einzelnes Konto
Der Endnutzer hat ein einzelnes Konto und erhält das Guthaben.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Der Agent authentifiziert den Nutzer mithilfe der vordefinierten Komponente Authentifizierung. | |
| Vielen Dank, Sie wurden authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Der Kontostand des Kontos, das auf 4567 endet, beträgt 50,00 $. |
Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Kundenservicemitarbeiter erfragt die letzten vier Ziffern der Kontonummer, bestätigt sie und gibt das Guthaben für dieses Konto an.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Der Agent authentifiziert den Nutzer mithilfe der vordefinierten Komponente Authentifizierung. | |
| Vielen Dank, Sie wurden authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind. Können Sie uns bitte die letzten vier Ziffern des Kontos nennen, auf das Sie sich beziehen? |
|
| 2002 | |
| Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, sind 2002. Ist das richtig? | |
| Ja | |
| Der Kontostand des Kontos mit der Nummer, die auf 2002 endet, beträgt 5.000 $. |
Mehrere Konten mit Kontext
Der Endnutzer hat mehrere Konten. Die Kontonummer, auf die sich die Anfrage bezieht, wird aus der vorherigen Intent-Anfrage übernommen und der Kontostand wird angegeben.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass mit Ihrer Nummer drei Konten verknüpft sind. Suchen Sie nach der Kontonummer, die auf 4567 endet? |
|
| Ja | |
| Der Kontostand des Kontos mit der Nummer, die auf 4567 endet, beträgt 50 $. |
Namenskonventionen
Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Guthaben |
| Komponentenspezifischer Intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_balance:get_account_balance |
Eingabeparameter
Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen der Komponente konfiguriert werden. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Ablaufbezogene Parameter müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder von einem aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.
Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.auth_level | (Optional) Gibt die Authentifizierungsebene des Aufrufers an. | integer |
| $session.params.auth_level_req | Gibt die Authentifizierungsebene an, die erforderlich ist, bevor ein Nutzer auf sein Guthaben zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1. |
integer |
| $session.params.account_auth_enabled | Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true. |
boolean |
| $session.params.card_auth_enabled | Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert wird in den Parametervoreinstellungen des Fulfillments für den Seiteneinstieg auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false. |
boolean |
| $session.params.phone_number | (Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. | String |
| $session.params.account_count | (Optional) Anzahl der Konten, die mit dem authentifizierten Nutzer verknüpft sind. | integer |
| $session.params.last_four_digit_of_account_number | (Optional) Die letzten vier Ziffern der Kundenkontonummer, für die das Guthaben angegeben werden muss. Wenn der Kunde ein einzelnes Konto hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Konten hat, wird die spezifische Kontonummer vom Kunden erfasst. | String |
| $flow.max_retry_acc_number | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die letzten vier Ziffern der Kontonummer des Endnutzers erfasst werden. Der Standardwert ist 3. |
integer |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Erstellen aus.
- Klicken Sie im Bereich Abläufe auf die importierte Komponente.
- Klicken Sie im Abschnitt Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| auth_level | Gibt die Authentifizierungsebene des Aufrufers an. | integer |
| phone_number | Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. | String |
| account_count | Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat. | integer |
| last_four_digit_of_account_number | Wenn ein Nutzer ein einzelnes Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehr als ein Konto hat, sind die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt hat, um Informationen zum Guthaben zu erhalten, der Wert dieses Parameters. | String |
| transfer_reason | Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, wenn er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden:agent: Der Endnutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat sich geweigert, die von der Komponente angeforderten Informationen weiterzugeben.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Eingabe.max_no_match: Die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Übereinstimmung wurde erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse für „Keine Übereinstimmung“.webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Integriertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe Integriertes Ereignis „webhook.error.not-found“. |
String |
Grundlegende Einrichtung
So richten Sie diese vordefinierte Komponente ein:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten im Abschnitt „Webhook-Einrichtung“.
Webhook-Einrichtung
Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.
Authentifizierung
Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie sie konfigurieren, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Eine ausführliche Anleitung finden Sie unter Authentifizierungs-Webhook einrichten.
Konto bestätigen
Der Webhook prebuilt_components_account_services:validate_account wird von der Komponente verwendet, um anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer zu prüfen, ob ein Konto vorhanden ist.
Der Webhook gibt auch das Guthaben zurück, falls ein Konto vorhanden ist.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.phone_number | Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. | String |
| $session.params.last_four_digit_of_account_number | Die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt und bestätigt hat, um Informationen zum Guthaben zu erhalten. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| account_found | Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den angegebenen letzten vier Ziffern vorhanden ist. | boolean |
| Kontostand | Der aktuelle Kontostand, falls vorhanden. | Zahl |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Konto validieren“ für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_account_services:validate_account“ aus.
- Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.