Vordefinierte Komponente für die Adresssammlung

Die vordefinierte Komponente der Adresserfassung erfasst eine Adresse vom Endnutzer und validiert sie mit 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 vorgefertigte Komponente bietet folgende Zusatzfunktionen:

Beispieldialoge

Die folgenden Beispieldialoge veranschaulichen allgemeine Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialogfelder veranschaulichen das Verhalten, wenn die Komponente über Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.

Vollständige gültige Adresse

Der Endnutzer stellt eine vollständige Adresse bereit und wird von der Komponente zur Adresserfassung erfolgreich bestätigt.

Nutzereingabe Agent-Antwort
Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
Ich habe die endgültige Adresse ermittelt. Die Hausnummer lautet 1600, die Route ist Amphitheatre Parkway, die Stadt ist Mountain View, der Verwaltungsbezirk ist CA, die Postleitzahl 94043 und das Land USA. Ist das richtig? Sag einfach Ja oder Nein.
yes
Fantastisch, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit abgeleiteten Elementen

Der Endnutzer stellt eine unvollständige Adresse bereit. Der Kundenservicemitarbeiter errät den fehlenden Teil und überprüft ihn nach der Bestätigung durch den Endnutzer.

Nutzereingabe Agent-Antwort
Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
1600 Amphitheatre Parkway,
Ich vermute, dass die Stadt Mountain View, Postleitzahl 94043, Verwaltungsgebiet ist CA, Land ist USA.

Ich habe die endgültige Adresse erhalten: 1600, die Straße ist „Amphitheatre Parkway“, die Stadt ist Mountain View, CA, die Postleitzahl 94043, das Land „USA“. Ist das richtig? Sag einfach Ja oder Nein.
Ja
Fantastisch, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit von Nutzern bereitgestellten Elementen

Der Endnutzer stellt eine unvollständige Adresse bereit. Der Agent errät den fehlenden Teil, gibt aber seine eigene Eingabe ein, nachdem er „Nein“ gesagt hat, und der Agent akzeptiert die Adresse erfolgreich.

Nutzereingabe Agent-Antwort
Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
1600 Amphitheatre Parkway,
Ich vermute, dass die Stadt Mountain View, Postleitzahl 94043, Verwaltungsgebiet ist CA, Land ist USA.

Ich habe die endgültige Adresse erhalten: 1600, die Straße ist „Amphitheatre Parkway“, die Stadt ist Mountain View, CA, die Postleitzahl 94043, das Land „USA“. Ist das richtig? Sag einfach 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 habe diese Aktualisierung abgeschlossen. Gibt es noch etwas zu ändern? Sag einfach Ja oder Nein.
no
Nach der Überprüfung habe ich die Postleitzahl durch 94043 ersetzt.

Ich habe die finale Adresse erfasst. Die Hausnummer lautet 1600, die Route ist Amphitheatre Parkway, die Stadt ist Mountain View, der Verwaltungsbezirk ist CA, die Postleitzahl 94043, das Land „USA“. Ist das richtig? Sag einfach Ja oder Nein.
yes
Fantastisch, ich habe die Adresse erfasst.

Unbekannte Eingabe

Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe bereitgestellt hat.

Nutzereingabe Agent-Antwort
Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
Kein Problem
Das habe ich nicht verstanden. Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
nett
Hmm, ich habe das immer noch nicht verstanden. Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
sehr gut
Tut mir leid, ich kann deine Antwort nicht verstehen.

Nicht unterstützte Adresse

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

Nutzereingabe Agent-Antwort
Bitte nennen Sie mir Ihre vollständige Adresse, damit ich anfangen kann.
Indien
Tut mir leid, aber ich kann derzeit keine Adressen in dieser Region validieren.

Adressüberprüfung

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

Die Adresserfassungskomponente erfasst Endnutzereingaben 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 folgenden Adresselemente werden von der Address Validation API zurückgegeben und von der Komponente verwendet, um eine vollständige Adresse zu erfassen und zu validieren:

  • administrative_area_level_1
  • Archipel
  • Land
  • Ort
  • postal_code
  • route
  • street_number

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

Namenskonventionen

Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:

Funktion Format Beispiel
Fluss [Komponentenname] Sammlung von Adressen
Komponentenspezifischer Intent prebuilt_components_[component_name]_[intent_name] prebuilt_components_address_collection_locality
Parameter [Parametername] user_provided_address
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_address_collection:address_validation

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. Parameter auf Ablaufebene müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Sitzungsbezogene Parameter können entweder über einen aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.

Sie können konfigurieren, welche Adresselemente von dieser Komponente benötigt werden. Ändern Sie dazu die Parametervoreinstellungen auf der Startseite des Ablaufs.

Diese vordefinierte Komponente unterstützt die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$flow.zip_code Wenn das Postleitzahl-Adresselement erforderlich ist, legen Sie true oder false fest. boolean
$flow.city Wenn das Element für die Stadtadresse erforderlich ist, legen Sie es auf true fest, andernfalls false. boolean
$flow.admin_area Wenn das Element für die Adresse des Verwaltungsgebiets erforderlich ist, legen Sie es auf true fest, ansonsten auf false. boolean
$flow.street_number Wenn das Adresselement für die Hausnummer erforderlich ist, legen Sie dieses auf true fest, andernfalls false. boolean
$flow.route Wenn das Routenelement erforderlich ist, legen Sie es auf true fest, andernfalls false. boolean
$flow.country Wenn das Element für die Länderadresse erforderlich ist, legen Sie es auf true fest, ansonsten auf false. boolean
$flow.island Wenn das Element der Inseladresse erforderlich ist, legen Sie es auf true fest, andernfalls false. boolean
$flow.retry_num Maximale Wiederholungsbeschränkung für Webhook-Aufrufe der Maps Address Validation API festlegen integer

Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende Anleitung.

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

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die auch nach Beenden der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente stellt Werte für die folgenden Ausgabeparameter bereit:

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 Werte:

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

INVALID_ADDRESS: Die Adresse wurde vom Endnutzer bestätigt, aber mindestens ein Element wurde von der Address Validation API nicht validiert oder als UNconfirmED_BUT_PLAUSIBLE markiert.

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

COUNTRY_NOT_SUPPORTED: Die Adresse wurde nicht bestätigt, weil die Address Validation API nicht bestätigt wurde.NO_USER_CONFIRMATION Die Adresse wurde nicht bestätigt, weil die Address Validation API nicht bestätigt wurde.NO_USER_CONFIRMATION

 

string

Grundlegende Einstellungen

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 (siehe Webhook-Einrichtung unten).

Webhook-Einrichtung

Wenn Sie die Address Validation API zum Prüfen von Adressen verwenden möchten, müssen Sie den bereitgestellten flexiblen Webhook mit den richtigen Anmeldedaten konfigurieren.

Webhook für die Adressüberprüfung

Dieser Webhook führt die folgenden Aktionen aus:

  1. Erfasste Dialogflow-Parameter und Formularanfragen werden verarbeitet und die Adresse mit der Address Validation API geprüft.
  2. Extrahiert bestätigte, unbestätigte, fehlende und abgeleitete Adresselemente aus der Google Address Validation API-Antwort.

Zum Konfigurieren des Webhooks für diese Komponente müssen Sie die Webhook-Einstellungen mit Ihrem Maps API-Schlüssel aktualisieren.

  1. So rufen Sie den API-Schlüssel ab: Rufen Sie Google Cloud Platform Console > APIs und Dienste > Anmeldedaten auf, wählen Sie Ihren Maps API-Schlüssel aus und kopieren Sie das Feld für den API-Schlüssel.

So konfigurieren Sie den Webhook:

  1. Öffnen Sie die Dialogflow CX Console.
  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 in Dialogflow durch die URL einschließlich Ihres Maps API-Schlüssels: https://addressvalidation.googleapis.com/v1:validAddress?key=MAPS_API_KEY
  8. Konfigurieren Sie in den Einstellungen für die Authentifizierung den Nutzernamen als key und legen Sie das Passwort auf Ihren Maps API-Schlüssel fest.
  9. Klicken Sie auf Speichern.

Fertig

Der Agent und der zugehörige Webhook sollten jetzt eingerichtet und zum Testen bereit sein.

Zurück
Kontobericht
Weiter
Alphanumerische Sammlung