Componente predefinito per la raccolta di indirizzi

Il componente predefinito di raccolta di indirizzi raccoglie un indirizzo dall'utente finale e utilizza l'API Google Address Validation per convalidare gli indirizzi.

Limitazioni

Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:

Funzionalità aggiuntive

Le seguenti funzionalità aggiuntive sono fornite da questo componente predefinito:

Finestre di dialogo di esempio

Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Le finestre di dialogo di esempio mostrano il comportamento quando il componente viene chiamato tramite telefonia, il che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.

Indirizzo completo valido

L'utente finale fornisce un indirizzo completo e il componente per la raccolta degli indirizzi lo verifica correttamente.

Input utente Risposta dell'agente
Per iniziare, dimmi il tuo indirizzo completo.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
Ho raccolto l'indirizzo finale; il numero civico è 1600, il percorso è Amphitheatre Parkway, la città è Mountain View, l'area amministrativa è CA, il codice postale è 94043, il paese è USA. È corretto? Di' sì o no.
sì
Fantastico, ho recuperato l'indirizzo.

Indirizzo parzialmente valido con elementi dedotti

L'utente finale fornisce un indirizzo parziale; l'agente indovina la parte mancante e la verifica correttamente dopo la conferma dell'utente finale.

Input utente Risposta dell'agente
Per iniziare, dimmi il tuo indirizzo completo.
1600 Amphitheatre Parkway
In qualche parte dell'indirizzo, la città è Mountain View, il codice postale è 94043, l'area amministrativa è CA, il paese è USA.

Ho raccolto l'indirizzo finale: il numero civico è 1600, il percorso è Amphitheatre Parkway, la città è Mountain View, l'area amministrativa è CA, il codice postale è 94043, il paese è gli Stati Uniti. È corretto? Di' sì o no.
Sì
Fantastico, ho recuperato l'indirizzo.

Indirizzo parzialmente valido con elementi forniti dall'utente

L'utente finale fornisce un indirizzo parziale; l'agente indovina la parte mancante, ma l'utente finale fornisce il proprio input dopo aver detto "no" e l'agente accetta correttamente l'indirizzo.

Input utente Risposta dell'agente
Per iniziare, dimmi il tuo indirizzo completo.
1600 Amphitheatre Parkway
In qualche parte dell'indirizzo, la città è Mountain View, il codice postale è 94043, l'area amministrativa è CA, il paese è USA.

Ho raccolto l'indirizzo finale: il numero civico è 1600, il percorso è Amphitheatre Parkway, la città è Mountain View, l'area amministrativa è CA, il codice postale è 94043, il paese è gli Stati Uniti. È corretto? Di' sì o no.
No
Ok, dimmi quale parte dell'indirizzo deve essere modificata.
Codice postale
Puoi condividere il codice postale?
94044
Ho finito con questo aggiornamento. C'è qualcos'altro da modificare? Di' sì o no.
no
Dopo la convalida, ho sostituito il codice postale con 94043.

Ho raccolto l'indirizzo finale: il numero civico è 1600, il percorso è Amphitheatre Parkway, la città è Mountain View, l'area amministrativa è CA, il codice postale è 94043, il paese è gli Stati Uniti. È corretto? Di' sì o no.
sì
Fantastico, ho recuperato l'indirizzo.

Input non riconosciuto

Il componente esce dal flusso dopo che l'utente finale fornisce un input non riconosciuto per tre volte.

Input utente Risposta dell'agente
Per iniziare, dimmi il tuo indirizzo completo.
Va bene
Non ho capito. Per iniziare, dimmi il tuo indirizzo completo.
un senso di benessere
Continuo a non capire. Per iniziare, dimmi il tuo indirizzo completo.
moltissimo
Mi dispiace, non riesco a capire la tua risposta.

Indirizzo non supportato

Il componente esce dal flusso dopo che l'utente finale ha fornito un indirizzo attualmente non supportato dall'API Address Validation.

Input utente Risposta dell'agente
Per iniziare, dimmi il tuo indirizzo completo.
India
Mi dispiace, ma al momento non sono in grado di convalidare gli indirizzi in quella regione.

Convalida degli indirizzi

Per capire in che modo il componente della raccolta degli indirizzi convalida gli indirizzi, consulta la panoramica dell'API Address Validation.

Il componente per la raccolta degli indirizzi acquisisce l'input utente dell'utente finale utilizzando l'entità di sistema@sys.address e invia l'indirizzo acquisito all'API Address Validation per estrarre gli elementi dell'indirizzo per un'ulteriore elaborazione.

I seguenti elementi indirizzo vengono restituiti dall'API Address Validation e utilizzati dal componente per raccogliere e convalidare un indirizzo completo:

  • livello_area_amministrativa_1
  • arcipelago
  • country
  • località
  • postal_code [codice_postale]
  • percorso
  • numero_via

Puoi provare la demo di convalida degli indirizzi Google con qualsiasi indirizzo di un'area geografica supportata.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità Formato Esempio
Flow [Nome componente] Raccolta indirizzi
Intent specifico del componente componenti_predefiniti_[component_name]_[intent_name] località_raccolta_componenti_predefiniti
Parametro [nome_param] indirizzo_fornito dall'utente
Webhook predefiniti_components_[component_name]:[webhook_action] predefiniti_components_address_collection:address_validation

Parametri di input

I parametri di input sono parametri utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno del flusso per determinare il comportamento del componente. I parametri con ambito a flusso devono essere impostati nella pagina iniziale del componente, come descritto di seguito. I parametri basati sulle sessioni possono essere impostati da un flusso di chiamata o nella pagina iniziale di questo componente.

Puoi configurare gli elementi indirizzo richiesti da questo componente modificando i valori preimpostati di parametri nella pagina iniziale del flusso.

Questo componente predefinito accetta i seguenti parametri di input:

Nome parametro Descrizione Formato di input
$flow.zip_code Se l'elemento indirizzo del codice postale è obbligatorio, impostalo su true, altrimenti false. boolean
$flow.city Se l'elemento indirizzo della città è obbligatorio, viene impostato come true, altrimenti false. boolean
$flow.admin_area Se l'elemento indirizzo dell'area amministrativa è obbligatorio, viene impostato su true, altrimenti false. boolean
$flow.street_number Se l'elemento indirizzo numero civico è obbligatorio, impostalo su true, altrimenti false. boolean
$flow.route Se l'elemento dell'indirizzo di route è obbligatorio, viene impostato come true, altrimenti false. boolean
$flow.country Se l'elemento indirizzo del paese è obbligatorio, viene impostato su true, altrimenti false. boolean
$flow.island Se l'elemento indirizzo dell'isola è obbligatorio, impostalo come true, altrimenti false. boolean
num_$flow.retry Imposta il limite massimo di nuovi tentativi per le chiamate ai webhook all'API Maps Address Validation integer

Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.

  1. Apri la console CX di Dialogflow.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona l'agente.
  4. Seleziona la scheda Crea.
  5. Fai clic sul componente importato nella sezione Flussi.
  6. Fai clic sulla Pagina iniziale nella sezione Pagine.
  7. Fai clic sul percorso true nella pagina iniziale.
  8. Nella finestra Percorso, modifica i valori di Preimpostazioni parametri in base alle necessità.
  9. Fai clic su Salva.

Parametri di output

I parametri di output sono parametri di sessione che rimarranno attivi dopo l'uscita dal componente. Questi parametri contengono importanti informazioni raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:

Nome parametro Descrizione Formato di output
indirizzo_raccolta_indirizzo Questo parametro restituisce l'oggetto indirizzo se il componente ha acquisito un indirizzo. 

{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}
stato_raccolta_indirizzo Questo parametro restituisce lo stato dell'indirizzo raccolto. Il valore restituito è uno dei seguenti:

VALID_ADDRESS: l'indirizzo è stato raccolto e convalidato dall'API Address Validation.

INVALID_ADDRESS: l'indirizzo è stato confermato dall'utente finale, ma uno o più elementi non sono stati convalidati o contrassegnati come UNCONFIRMED_BUT_PLAUSIBLE dall'API Address Validation.

MAPS_API_ERROR: l'indirizzo non è stato raccolto a causa di un errore dell'API Address Validation.

COUNTRY_NOT_SUPPORTED: l'indirizzo conferma non è stato raccolto perché l'API Address Validation non è stata confermata.NO_USER_CONFIRMATION

 

string

Configurazione di base

Per configurare questo componente predefinito:

  1. Importa il componente predefinito.
  2. Abilita l'API Address Validation.
  3. Configura il webhook flessibile fornito con la chiave API di Google Maps; consulta la sezione Configurazione webhook di seguito.

Configurazione webhook

Per utilizzare l'API Address Validation per convalidare gli indirizzi, devi configurare il webhook flessibile fornito con le credenziali corrette.

Webhook di convalida degli indirizzi

Questo webhook esegue le seguenti azioni:

  1. I processi hanno acquisito i parametri Dialogflow, richiedono moduli e verificano l'indirizzo utilizzando l'API Address Validation.
  2. Estrae elementi indirizzo confermati, non confermati, mancanti e dedotti dalla risposta dell'API Google Address Validation.

Per configurare il webhook per questo componente, devi aggiornare le impostazioni del webhook con la tua chiave API di Maps.

  1. Per recuperare la chiave API: vai alla console di Google Cloud Platform > API e servizi > Credenziali, seleziona la chiave API di Maps e copia il campo Chiave API.

Per configurare il webhook:

  1. Apri la console CX di Dialogflow.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona l'agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Webhook.
  6. Seleziona il webhook predefinito_components_address_collection:address_validation.
  7. Sostituisci l'URL nel campo URL webhook di Dialogflow con l'URL che include la chiave API di Maps: https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
  8. Nelle impostazioni di Autenticazione, configura il nome utente su key e imposta la password sulla chiave dell'API di Google Maps.
  9. Fai clic su Salva.

Completata

L'agente e il relativo webhook dovrebbero essere configurati e pronti per il test.

Indietro
Estratto conto
Avanti
Raccolta alfanumerica