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:
- Unterstützt nur Adressen aus Ländern, die in den Details zur Address Validation API aufgeführt sind.
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.
- Ö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 Build aus.
- Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
- Klicken Sie im Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte unter Parameter Presets (Voreinstellungen für Parameter) nach Bedarf.
- 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. | { |
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:
- Importieren Sie die vordefinierte Komponente.
- Aktivieren Sie die Address Validation API.
- 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:
- Erfasste Dialogflow-Parameter und Formularanfragen werden verarbeitet und die Adresse mit der Address Validation API geprüft.
- 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.
- 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:
- Ö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_address_collection:address_validation“ aus.
- 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
- 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. - Klicken Sie auf Speichern.
Fertig
Der Agent und der zugehörige Webhook sollten jetzt eingerichtet und zum Testen bereit sein.