Die vorgefertigte Komponente „Guthaben“ prüft die Authentifizierungsebene eines Kunden und stellt einem authentifizierten Kunden dann Informationen zum Guthaben zur Verfügung. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das Konto, für das der Kunde das Guthaben abrufen möchte. Diese Komponente verwendet die vorgefertigte Komponente „Authentifizierung“ , um Nutzer zu authentifizieren.
Beschränkungen
Zusätzlich zu den allgemeinen Beschränkungen für vorgefertigte Komponenten, gelten für diese vorgefertigte Komponente die folgenden Beschränkungen:
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge verfassen
Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungsintent und die erste Antwort des Agenten 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 mit der vorgefertigten Komponente „Authentifizierung“ | |
| Vielen Dank, Sie wurden authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Ihr Kontostand für das Konto, das auf 4567 endet, beträgt 50,00 $. |
Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Agent fragt nach den letzten vier Ziffern der Kontonummer und bestätigt sie und gibt das Guthaben für dieses Konto an.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Der Agent authentifiziert den Nutzer mit der vorgefertigten Komponente „Authentifizierung“ | |
| Vielen Dank, Sie wurden authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass Ihrer Nummer zwei Konten zugeordnet sind. Können Sie uns 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 | |
| Ihr Kontostand für das Konto, das auf 2002 endet, beträgt 5.000 $. |
Mehrere Konten mit Kontext
Der Endnutzer hat mehrere Konten. Die angegebene Kontonummer wird aus dem vorherigen Intent beibehalten und das Guthaben wird angegeben.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass Ihrer Nummer drei Konten zugeordnet sind. Suchen Sie nach der Kontonummer, die auf 4567 endet? |
|
| Ja | |
| Ihr Kontostand für das Konto, das auf 4567 endet, beträgt 50 $. |
Namenskonventionen
Diese vorgefertigte Komponente verwendet die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Komponentenname] | Kontostand |
| 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 werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Flow verwendet, um das Verhalten der Komponente zu bestimmen. Parameter mit Flow-Bereich müssen auf der Startseite der Komponente festgelegt werden, wie unten beschrieben. Parameter auf Sitzungsebene können entweder von einem aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.
Diese vorgefertigte Komponente akzeptiert die folgenden Eingabeparameter:
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.auth_level | (Optional) Gibt die Authentifizierungsebene des Anrufers 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 der Seiteneintragserfüllung auf der check auth level Seite konfiguriert. Standardmäßig ist dieser Wert 1. |
integer |
| $session.params.account_auth_enabled | Gibt an, ob der Nutzer als Kontoinhaber authentifiziert werden soll, wie unter Authentifizierungstypen beschrieben. Dieser Wert wird in den Parametervoreinstellungen der Seiteneintragserfüllung auf der check auth level Seite 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 der Seiteneintragserfüllung auf der check auth level Seite konfiguriert. Standardmäßig ist dieser Wert false. |
boolean |
| $session.params.phone_number | (Optional) Registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. | String |
| $session.params.account_count | (Optional) Anzahl der Konten, die dem authentifizierten Nutzer zugeordnet sind. | integer |
| $session.params.last_four_digit_of_account_number | (Optional) Die letzten vier Ziffern der Kontonummer des Kunden, für die der Kontostand 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 Wiederholungsversuche an, die beim Erfassen der letzten vier Ziffern der Kontonummer des Endnutzers zulässig sind. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie diesen Abschnitt, um die Anleitung einzublenden.
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr Google Cloud-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie den Tab Erstellen aus.
- Klicken Sie im Abschnitt 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 unter Parametervoreinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die nach dem Beenden der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst wurden. Diese vorgefertigte Komponente liefert Werte für die folgenden Ausgabeparameter:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| auth_level | Gibt die Authentifizierungsebene des Anrufers an. | integer |
| phone_number | Lokale Telefonnummer des Nutzers ohne Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
| account_count | Anzahl der Konten, die der registrierten Telefonnummer zugeordnet 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, ist der Wert dieses Parameters die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt hat, um Informationen zum Guthaben zu erhalten. | String |
| transfer_reason | Dieser Parameter gibt den Grund für das Beenden des Flows an, wenn er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden:agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die von der Komponente angeforderten Informationen nicht weitergegeben.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Weitere Informationen finden Sie unter Vorgefertigte Ereignisse ohne Eingabe.max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Übereinstimmung erreicht. Weitere Informationen finden Sie unter Vorgefertigte Ereignisse ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Vorgefertigtes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Vorgefertigtes Ereignis „webhook.error.not-found“. |
String |
Grundlegende Einrichtung
So richten Sie diese vorgefertigte Komponente ein:
- Importieren Sie die vorgefertigte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten unter Webhook -Einrichtung.
Webhook-Einrichtung
Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen aus Ihren externen Diensten abzurufen.
Authentifizierung
Wenn Sie zuvor keine externen Dienste konfiguriert haben, die für die Authentifizierung erforderlich sind, müssen Sie sie konfigurieren, um die Authentifizierung von Nutzern für diese Komponente zu aktivieren. Eine ausführliche Anleitung finden Sie unter Webhook für die Authentifizierung 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, wenn 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 | Lokale Telefonnummer des Nutzers ohne Ländervorwahl, 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 und von der Komponente verwendet.
| 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 |
| balance | Der aktuelle Kontostand, falls das Konto vorhanden ist. | Zahl |
Wenn Sie den Webhook „Konto bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie diesen Abschnitt, um die Anleitung einzublenden.
- Öffnen Sie die Dialogflow CX Console.
- 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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt für den Dienst, in den Sie die Komponente einbinden möchten. Wählen Sie im Drop-down-Menü die entsprechende 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 sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Einstellungen unter Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet sein und getestet werden können.