Vordefinierte Komponente für die Adresssammlung

Mit der vorgefertigten Komponente für die Adressenerfassung wird eine Adresse vom Endnutzer erfasst und die Google Address Validation API verwendet, um Adressen zu validieren.

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 die folgenden zusätzlichen Funktionen:

Beispieldialoge

Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vordefinierten Komponente abgedeckt werden. Die Beispiel-Dialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dies löst den Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung aus.

Vollständige gültige Adresse

Der Endnutzer gibt eine vollständige Adresse an und die Komponente zur Adressenerfassung bestätigt sie erfolgreich.

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

Teilweise gültige Adresse mit abgeleiteten Elementen

Der Endnutzer gibt eine unvollständige Adresse an. Der Kundenservicemitarbeiter errät den fehlenden Teil und bestätigt ihn nach der Bestätigung durch den Endnutzer.

Nutzereingabe Antwort des KI-Agenten
Bitte gib mir zuerst deine vollständige Adresse an.
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 die 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 die USA. Ist das richtig? Bitte antworte mit Ja oder Nein.
Ja
Fantastisch, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit vom Nutzer angegebenen Elementen

Der Endnutzer gibt eine unvollständige Adresse an. Der Agent errät den fehlenden Teil, aber der Endnutzer gibt nach „Nein“ seine eigene Eingabe an und der Agent akzeptiert die Adresse.

Nutzereingabe Antwort des KI-Agenten
Bitte gib mir zuerst deine vollständige Adresse an.
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 die 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 die USA. Ist das richtig? Bitte antworte mit Ja oder Nein.
Nein
Okay. Bitte sag mir, welcher Teil der Adresse geändert werden muss.
Postleitzahl
Können Sie uns die Postleitzahl mitteilen?
94044
Ich bin mit diesem Update fertig. Muss 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 ermittelt: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, der Bundesstaat ist CA, die Postleitzahl ist 94043 und das Land ist die USA. Ist das richtig? Bitte antworte mit Ja oder Nein.
Ja
Fantastisch, ich habe die Adresse erfasst.

Nicht erkannte Eingabe

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

Nutzereingabe Antwort des KI-Agenten
Bitte gib mir zuerst deine vollständige Adresse an.
Alles in Ordnung
Das habe ich nicht verstanden. Bitte gib mir zuerst deine vollständige Adresse an.
schön
Hm, das habe ich immer noch nicht verstanden. Bitte gib mir zuerst deine vollständige Adresse an.
sehr gut
Tut mir leid, ich habe Schwierigkeiten, deine Antwort zu verstehen.

Nicht unterstützte Adresse

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

Nutzereingabe Antwort des KI-Agenten
Bitte gib mir zuerst deine vollständige Adresse an.
Indien
Leider kann ich Adressen in dieser Region derzeit nicht validieren.

Adressbestätigung

Informationen dazu, wie die Komponente zum Erheben von Adressen Adressen validiert, finden Sie in der Übersicht zur Address Validation API.

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

Die folgenden Adressenelemente 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
  • country
  • Ort
  • postal_code
  • route
  • street_number

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

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Erhebung von Adressen
Komponentenspezifische Intention 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

Eingabeparameter werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf 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 mit Sitzungsbereich können entweder durch einen aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.

Sie können konfigurieren, welche Adressenelemente für diese Komponente erforderlich sind, indem Sie Parameter-Voreinstellungen auf der Startseite des Ablaufs ändern.

Diese vorgefertigte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$flow.zip_code Wenn das Adressenelement „Postleitzahl“ erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.city Wenn das Adressenelement „Stadt“ erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.admin_area Wenn das Adressenelement für den Verwaltungsbezirk erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.street_number Wenn das Adressenelement „Hausnummer“ erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.route Wenn das Adressenelement für die Route erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.country Wenn das Adressenelement „Land“ erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.island Wenn das Adressenelement der Insel erforderlich ist, legen Sie es auf true fest, andernfalls auf false. boolean
$flow.retry_num Legt das maximale Limit für Wiederholungsversuche 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 Abschnitt, um die Anleitung 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 Bereich Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die richtige Route.
  8. Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
  9. 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 werden. Diese vordefinierte Komponente liefert Werte für 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 Endnutzer bestätigt, aber ein oder mehrere Elemente wurden von der Address Validation API nicht validiert oder als UNCONFIRMED_BUT_PLAUSIBLE gekennzeichnet.

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

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

NO_USER_CONFIRMATION: Die Adresse wurde nicht bestätigt, da der Endnutzer keine Adresse bestätigt hat.		 
string

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

  1. Vordefinierte Komponente importieren
  2. Aktivieren Sie die Address Validation API.
  3. Konfigurieren Sie den bereitgestellten flexiblen Webhook mit Ihrem Maps API-Schlüssel (siehe „Webhook einrichten“ unten).

Webhook-Einrichtung

Wenn Sie die Address Validation API zum Validieren von Adressen verwenden 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 und Formularanfragen und überprüft die Adresse mit der Address Validation API.
  2. Extrahiert bestätigte, nicht bestätigte, fehlende und abgeleitete Adressenelemente aus der Antwort der Google Address Validation API.

Um den Webhook für diese Komponente zu konfigurieren, müssen Sie die Webhook-Einstellungen mit Ihrem Maps API-Schlüssel aktualisieren.

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

So konfigurieren Sie den Webhook:

  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 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 Maps API-Schlüssel: https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
  8. Konfigurieren Sie in den Authentifizierungseinstellungen den Nutzernamen als key und legen Sie das Passwort auf Ihren Maps API-Schlüssel fest.
  9. Klicken Sie auf Speichern.

Abgeschlossen

Ihr KI-Agent und sein Webhook sollten jetzt eingerichtet sein und können getestet werden.

Zurück
Kontobericht
Weiter
Alphanumerische Sammlung