Vordefinierte Komponente für die Adresserfassung

Adresserfassung vordefinierte Komponente vom Endnutzer erfasst und die Google Address Validation API um Adressen zu validieren.

Beschränkungen

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

Zusätzliche Funktionen

Die folgenden zusätzlichen Funktionen werden von dieser vordefinierten Komponente bereitgestellt:

Beispieldialoge

Die folgenden Beispieldialogfelder veranschaulichen häufige Szenarien, die von diesem vordefinierte Komponente. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung ausgelöst.

Vollständige gültige Adresse

Der Endnutzer gibt eine vollständige Adresse an, die von der Komponente zur Adresserfassung erfolgreich bestätigt wird.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte nennen Sie mir zuerst Ihre vollständige Adresse.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
Ich habe die endgültige Adresse erfasst. die Hausnummer lautet 1600, die Route ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043, das Land ist USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Ja
Fantastisch, ich habe die Adresse gefunden.

Teilweise gültige Adresse mit abgeleiteten Elementen

Der Endnutzer gibt eine teilweise Adresse an. Der Kundenservicemitarbeiter schätzt den fehlenden Teil und bestätigt ihn nach Bestätigung durch den Endnutzer.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte nennen Sie mir zuerst Ihre vollständige Adresse.
1600 Amphitheatre Parkway
Ich habe einen Teil der Adresse vermutet: Die Stadt ist Mountain View, die Postleitzahl lautet 94043, das Verwaltungsgebiet ist CA, das Land ist USA.

Ich habe die endgültige Adresse erfasst. die Hausnummer lautet 1600, die Route ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043, das Land ist USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Ja
Fantastisch, ich habe die Adresse gefunden.

Teilweise gültige Adresse mit vom Nutzer bereitgestellten Elementen

Der Endnutzer gibt eine unvollständige Adresse an. Der Kundenservicemitarbeiter errät den fehlenden Teil, aber der Endnutzer gibt seine eigene Eingabe ein, nachdem er „Nein“ sagt, und er akzeptiert die Adresse erfolgreich.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte nennen Sie mir zuerst Ihre vollständige Adresse.
1600 Amphitheatre Parkway
Ich habe einen Teil der Adresse vermutet: Die Stadt ist Mountain View, die Postleitzahl lautet 94043, das Verwaltungsgebiet ist CA, das Land ist USA.

Ich habe die endgültige Adresse erfasst. die Hausnummer lautet 1600, die Route ist Amphitheatre Parkway, die Stadt ist Mountain View, das Verwaltungsgebiet ist CA, die Postleitzahl ist 94043, das Land ist USA. Ist das richtig? Bitte sagen Sie 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
Dieses Update ist abgeschlossen. Muss noch etwas geändert werden? Bitte sagen Sie Ja oder Nein.
no
Nach der Überprüfung habe ich die Postleitzahl in 94043 geändert.

Ich habe die endgültige Adresse erfasst: Die Hausnummer lautet 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, der Verwaltungsbezirk ist CA, die Postleitzahl ist 94043 und das Land ist USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Ja
Fantastisch, ich habe die Adresse gefunden.

Unbekannte Eingabe

Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine unbekannte Eingabe vorgenommen hat.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte nennen Sie mir zuerst Ihre vollständige Adresse.
In Ordnung
Das habe ich nicht verstanden. Bitte nennen Sie mir zuerst Ihre vollständige Adresse.
nett
Hm, das habe ich immer noch nicht verstanden. Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
sehr gut
Tut mir leid, ich habe Schwierigkeiten, deine Antwort zu verstehen.

Nicht unterstützte Adresse

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

Nutzereingabe Antwort des Kundenservicemitarbeiters
Bitte nennen Sie mir zuerst Ihre vollständige Adresse.
Indien
Tut mir leid, aber ich kann derzeit keine Adressen in dieser Region bestätigen.

Adressvalidierung

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

Die Komponente zur Adresserfassung erfasst Endnutzereingaben mithilfe der Funktion @sys.address Systementität 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 werden von der Komponente verwendet, um eine vollständige Adresse zu erfassen und zu validieren:

  • administrative_area_level_1
  • Archipel
  • country
  • Ort
  • postal_code
  • Route
  • street_number

Sie können die Demo zur Google Address Validation mit einer beliebigen Adresse von einem unterstützte Region.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Feature Format Beispiel
Flow [Komponentenname] Adresssammlung
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. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente wie unten beschrieben festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf oder auf der Startseite dieser Komponente festgelegt werden.

Sie können konfigurieren, welche Adresselemente für diese Komponente erforderlich sind, indem Sie Parametervoreinstellungen in der Startseite von Flow.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$flow.zip_code Wenn das Adresselement für die Postleitzahl erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.city Wenn das Element für die Stadtadresse erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.admin_area Wenn das Adresselement des Verwaltungsgebiets erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.street_number Wenn das Adresselement für die Hausnummer erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.route Wenn das Routenadresselement erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.country Wenn das Element für die Länderadresse erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.island Wenn das Inseladresselement erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.retry_num Legt das maximale Limit für Wiederholungen für Webhook-Aufrufe der Maps Address Validation API fest integer

Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

  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 Abschnitt Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Parametervoreinstellungen nach Bedarf.
  9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die vom Komponente. Diese vordefinierte Komponente stellt Werte für die folgende Ausgabe bereit Parameter:

Parametername Beschreibung Ausgabeformat
address_collection_address Dieser Parameter gibt das Adressobjekt zurück, wenn von der Komponente eine Adresse 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 Endnutzer bestätigt, aber mindestens ein Element wurde von der Address Validation API nicht bestätigt oder als UNCONFIRMED_BUT_PLAUSIBLE markiert.

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

COUNTRY_NOT_SUPPORTED: „address wurde nicht bestätigt, weil die Address Validation API keine Region unterstützt.NO_USER_CONFIRMATION

 
string

Grundlegende Einstellungen

So richten Sie diese vordefinierte Komponente ein:

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

Webhook-Einrichtung

Damit Sie die Address Validation API zum Validieren von Adressen verwenden können, müssen Sie um den bereitgestellten flexiblen Webhook mit den richtigen Anmeldedaten zu konfigurieren.

Address Validation-Webhook

Dieser Webhook führt die folgenden Aktionen aus:

  1. Erfasste Dialogflow-Parameter, Formularanfragen und Verifizierung der Address Validation API an.
  2. Extrahiert bestätigte, unbestätigte, fehlende und abgeleitete Adresselemente aus Antwort der Google Address Validation API

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

  1. So rufen Sie Ihren API-Schlüssel ab: Rufen Sie die Google Cloud Platform Console > APIs und Dienste > Anmeldedaten, wählen Sie Ihren Google Maps API-Schlüssel aus und kopieren Sie das Feld 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 (Webhook-URL) in Dialogflow durch die URL. einschließlich Ihres Google 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 als Passwort Ihren Maps API-Schlüssel fest.
  9. Klicken Sie auf Speichern.

Abgeschlossen

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

Zurück
Kontobericht
Weiter
Alphanumerische Sammlung