Vordefinierte Komponente für die Adresssammlung

Die vordefinierte Komponente zur Adresserfassung erfasst eine Adresse von einem Kunden und validiert sie mithilfe der Google Address Validation API.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:

Zusätzliche Funktionen

Diese vordefinierte Komponente bietet die folgenden zusätzlichen Funktionen:

Beispieldialoge verfassen

Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Sie zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des KI-Agenten zu Beginn der Unterhaltung ausgelöst.

Vollständige Adressvalidierung

Der Nutzer gibt eine vollständige Adresse ein und die Komponente zur Adresserfassung überprüft sie.

Nutzereingabe Antwort des KI-Agenten
Bitte nenne mir zuerst deine vollständige Adresse.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
Ich habe die endgültige Adresse erfasst: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043 und das Land ist USA. Ist das richtig? Bitte antworte mit „Ja“ oder „Nein“.
Ja
Fantastisch, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit abgeleiteten Elementen

  1. Der Nutzer gibt eine unvollständige Adresse ein.
  2. Der Agent rät den fehlenden Teil und überprüft ihn nach Bestätigung durch den Nutzer.
Nutzereingabe Antwort des KI-Agenten
Bitte nenne mir zuerst deine vollständige Adresse.
1600 Amphitheatre Parkway
Ich habe einen Teil der Adresse erraten: Die Stadt ist Mountain View, die Postleitzahl ist 94043, das Verwaltungsgebiet ist CA und das Land ist USA.

Ich habe die endgültige Adresse ermittelt: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043 und das Land ist USA. Ist das richtig? Bitte antworte mit „Ja“ oder „Nein“.
Ja
Fantastisch, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit vom Nutzer bereitgestellten Elementen

  1. Der Nutzer gibt eine unvollständige Adresse ein.
  2. Der Nutzer lehnt den erratenen Teil ab und gibt eigene Eingaben ein.
  3. Der KI-Agent akzeptiert die Eingabe des Nutzers und fordert ihn noch einmal zur Bestätigung auf.
  4. Der Nutzer akzeptiert die endgültige Adresse.
Nutzereingabe Antwort des KI-Agenten
Bitte nenne mir zuerst deine vollständige Adresse.
1600 Amphitheatre Parkway
Ich habe einen Teil der Adresse erraten: Die Stadt ist Mountain View, die Postleitzahl ist 94043, das Verwaltungsgebiet ist CA und das Land ist USA.

Ich habe die endgültige Adresse ermittelt: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043 und das Land ist USA. Ist das richtig? Bitte antworte mit „Ja“ oder „Nein“.
Nein
Okay. Bitte teilen Sie mir mit, welcher Teil der Adresse geändert werden muss.
Postleitzahl
Können Sie mir bitte die Postleitzahl nennen?
94044
Ich bin mit diesem Update fertig. Muss sonst noch etwas geändert werden? Bitte antworte mit „Ja“ oder „Nein“.
no
Nach der Validierung habe ich die Postleitzahl durch 94043 ersetzt.

Ich habe die endgültige Adresse erfasst: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043 und das Land ist USA. Ist das richtig? Bitte antworte mit „Ja“ oder „Nein“.
Ja
Fantastisch, ich habe die Adresse erfasst.

Nicht erkannte Eingabe

Die Komponente verlässt den Ablauf, nachdem der Nutzer dreimal eine nicht erkannte Eingabe gemacht hat.

Nutzereingabe Antwort des KI-Agenten
Bitte nenne mir zuerst deine vollständige Adresse.
Alles in Ordnung
Das habe ich nicht verstanden. Bitte nenne mir zuerst deine vollständige Adresse.
nice
Hm, ich habe das immer noch nicht verstanden. Bitte nenne mir zuerst deine vollständige Adresse.
sehr gut
Ich habe leider Probleme, deine Antwort zu verstehen.

Nicht unterstützte Adresse

Die Komponente wird beendet, nachdem der Nutzer eine Adresse angegeben hat, die von der Address Validation API nicht unterstützt wird.

Nutzereingabe Antwort des KI-Agenten
Bitte nenne mir zuerst deine vollständige Adresse.
Indien
Tut mir leid, aber ich kann keine Adressen in dieser Region validieren.

Address Validation

Weitere Informationen dazu, wie die Komponente zur Adresserfassung Adressen validiert, finden Sie unter Address Validation API – Übersicht.

Die Komponente zur Adresserfassung erfasst Nutzereingaben mithilfe der Systementität @sys.address und sendet die erfasste Adresse an die Address Validation API, um Adresselemente für die weitere Verarbeitung zu extrahieren.

Die Address Validation API gibt die folgenden Adresselemente zurück, mit denen Sie eine vollständige Adresse erfassen und validieren können:

  • administrative_area_level_1
  • archipelago
  • country
  • locality
  • postal_code
  • route
  • street_number

Sie können die Google Address Validation Demo mit einer beliebigen Adresse aus einer unterstützten Region ausprobieren.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Adressenerfassung
Komponentenspezifischer Intent prebuilt_components_[component_name]_[intent_name] prebuilt_components_address_collection_locality
Parameter [param_name] user_provided_address
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_address_collection:address_validation

Eingabeparameter

Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Eine oder mehrere Bedingungen im Ablauf verwenden die Parameter, um zu bestimmen, wie sich die Komponente verhalten soll. Der Nutzer muss auf der Startseite der Komponente Parameter mit Ablaufbereich festlegen, wie in der folgenden Tabelle beschrieben. Der Nutzer kann Parameter auf Sitzungsebene entweder über einen aufrufenden Ablauf oder auf der Startseite dieser Komponente festlegen.

Der Nutzer kann konfigurieren, welche Adresselemente für diese Komponente erforderlich sind, indem er die Parametervoreinstellungen auf der Startseite des Ablaufs ändert.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$flow.zip_code Wenn das Adresselement für die Postleitzahl erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.city Wenn das Adressenelement für die Stadt erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.admin_area Wenn das Adresselement „Verwaltungsgebiet“ erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.street_number Wenn das Adresselement „Hausnummer“ erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.route Wenn das Element für die Routenadresse erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.country Wenn das Adressenelement für das Land erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.island Wenn das Adresselement für die Insel erforderlich ist, legen Sie es auf true fest. Andernfalls legen Sie es auf false fest. boolean
$flow.retry_num Legt die maximale Anzahl von Wiederholungsversuchen für Webhook-Aufrufe der Maps Address Validation API fest. integer

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.

  1. Öffnen Sie die Dialogflow CX-Konsole.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Erstellen aus.
  5. Klicken Sie im Bereich Abläufe auf die importierte Komponente.
  6. Klicken Sie im Abschnitt Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen nach Bedarf.
  9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die aktiv bleiben, nachdem der Nutzer die Komponente verlassen hat. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden.

Die vordefinierte Komponente bietet die folgenden Ausgabeparameter:

Parametername Beschreibung Ausgabeformat
address_collection_address Dieser Parameter gibt das Adressobjekt zurück, wenn eine Adresse von der Komponente erfasst wurde. 
{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}
address_collection_status Dieser Parameter gibt den Status der erfassten Adresse zurück. Der zurückgegebene Wert ist einer der folgenden:

VALID_ADDRESS: Die Adresse wurde von der Address Validation API erfasst und validiert.

INVALID_ADDRESS: Die Adresse wurde vom Nutzer bestätigt, aber ein oder mehrere Elemente wurden von der Address Validation API nicht validiert oder als UNCONFIRMED_BUT_PLAUSIBLE markiert.

MAPS_API_ERROR: Die Adresse wurde aufgrund eines Fehlers der Address Validation API nicht erfasst.

COUNTRY_NOT_SUPPORTED: Die Adresse wurde nicht erfasst, weil die Address Validation API diese Region nicht unterstützt.

NO_USER_CONFIRMATION: Die Adresse wurde nicht bestätigt, weil der Nutzer keine Adresse bestätigt hat.		 
string

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

  1. Importieren Sie die vordefinierte Komponente.
  2. Aktivieren Sie die Address Validation API.
  3. Konfigurieren Sie den bereitgestellten flexiblen Webhook mit Ihrem Google Maps-API-Schlüssel. Weitere Informationen finden Sie unter Webhook einrichten.

Webhook-Einrichtung

Wenn Sie Adressen mit der Address Validation API validieren möchten, müssen Sie den bereitgestellten flexiblen Webhook mit den richtigen Anmeldedaten konfigurieren.

Address Validation-Webhook

Dieser Webhook führt die folgenden Aktionen aus:

  1. Verarbeitet erfasste Dialogflow CX-Parameter, formuliert die Anfrage und überprüft die Adresse mithilfe der Address Validation API.
  2. Extrahiert bestätigte, unbestätigte, fehlende und abgeleitete Adresselemente aus der Antwort der Address Validation API.

Aktualisieren Sie die Webhook-Einstellungen mit dem richtigen Google Maps-API-Schlüssel, um den Webhook für diese Komponente zu konfigurieren.

Um Ihren API-Schlüssel abzurufen, rufen Sie die Google Cloud Console > APIs und Dienste > Anmeldedaten auf, wählen Sie Ihren Google Maps-API-Schlüssel aus und kopieren Sie das Feld „API-Schlüssel“.

So konfigurieren Sie den Webhook:

  1. Rufen Sie die Dialogflow CX-Konsole auf.
  2. Wählen Sie Ihr Google Cloud Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook prebuilt_components_address_collection:address_validation aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch die URL mit Ihrem Google Maps-API-Schlüssel: https://addressvalidation.googleapis.com/v1:validateAddress?key=<var>MAPS_API_KEY</var>.
  8. Konfigurieren Sie in den Authentifizierungseinstellungen den Nutzernamen als key und legen Sie das Passwort für Ihren Google Maps-API-Schlüssel fest.
  9. Klicken Sie auf Speichern.

Abgeschlossen

Die vordefinierte Komponente und ihr Webhook sind jetzt eingerichtet und können getestet werden.

Zurück
Kontobericht
Weiter
Alphanumerische Sammlung