Alcuni prodotti e funzionalità sono in fase di rinominazione. Anche le funzionalità di playbook e flusso generativi sono in fase di migrazione a un'unica console consolidata. Consulta i dettagli.

Questa pagina è stata tradotta dall'API Cloud Translation.

Componente predefinito per la raccolta di indirizzi

Il componente predefinito di raccolta degli 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:

Supporta solo indirizzi dei paesi elencati in Dettagli della copertura dell'API Address Validation.

Funzionalità aggiuntive

Questo componente predefinito fornisce le seguenti funzionalità aggiuntive:

Esempi di dialoghi

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 valido completo

L'utente finale fornisce un indirizzo completo e il componente di raccolta dell'indirizzo 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, la via è Amphitheatre Parkway, la città è Mountain View, la regione è CA, il codice postale è 94043 e il paese è USA. È corretto? Rispondi "Sì" o "No".
sì
	Perfetto, ho raccolto l'indirizzo.

Indirizzo valido parziale 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
	Ho indovinato una parte dell'indirizzo: la città è Mountain View, il codice postale è 94043, la regione è CA e il paese è USA. Ho raccolto l'indirizzo finale: il numero civico è 1600, la via è Amphitheatre Parkway, la città è Mountain View, la regione è CA, il codice postale è 94043 e il paese è USA. È corretto? Rispondi "Sì" o "No".
Sì
	Perfetto, ho raccolto l'indirizzo.

Indirizzo valido parziale 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 risposto "no" e l'agente accetta l'indirizzo.

Input utente	Risposta dell'agente
	Per iniziare, dimmi il tuo indirizzo completo.
1600 Amphitheatre Parkway
	Ho indovinato una parte dell'indirizzo: la città è Mountain View, il codice postale è 94043, la regione è CA e il paese è USA. Ho raccolto l'indirizzo finale: il numero civico è 1600, la via è Amphitheatre Parkway, la città è Mountain View, la regione è CA, il codice postale è 94043 e il paese è USA. È corretto? Rispondi "Sì" o "No".
No
	Ok. Dimmi quale parte dell'indirizzo deve essere modificata.
Codice postale
	Potresti condividere il codice postale?
94044
	Ho finito con questo aggiornamento. C'è qualcos'altro da modificare? Rispondi "Sì" o "No".
no
	Dopo la convalida, ho sostituito il codice postale con 94043. Ho raccolto l'indirizzo finale: il numero civico è 1600, la via è Amphitheatre Parkway, la città è Mountain View, la regione è CA, il codice postale è 94043 e il paese è USA. È corretto? Rispondi "Sì" o "No".
sì
	Perfetto, ho raccolto l'indirizzo.

Valore non riconosciuto

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

Input utente	Risposta dell'agente
	Per iniziare, dimmi il tuo indirizzo completo.
Va bene
	Non ho capito. Per iniziare, dimmi il tuo indirizzo completo.
nice
	Hmm, non sono ancora riuscito a 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 fornisce 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 questa regione.

Convalida dell'indirizzo

Per capire come il componente di raccolta degli indirizzi convalida gli indirizzi, vedi Panoramica dell'API Address Validation.

Il componente di 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 l'ulteriore elaborazione.

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

administrative_area_level_1
arcipelago
country
località
postal_code
route
street_number

Puoi provare la demo di Google Address Validation con qualsiasi indirizzo di una regione supportata.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità	Formato	Esempio
Flow	[Component Name]	Raccolta di indirizzi
Component Specific Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_address_collection_locality
Parametro	[param_name]	user_provided_address
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_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 flusso devono essere impostati nella pagina iniziale del componente come descritto di seguito. I parametri con ambito sessione possono essere impostati da un flusso di chiamata o nella pagina iniziale di questo componente.

Puoi configurare gli elementi dell'indirizzo richiesti da questo componente modificando i preset dei 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 codice postale è obbligatorio, impostalo come `true`, altrimenti `false`.	boolean
$flow.city	Se l'elemento dell'indirizzo della città è obbligatorio, impostalo su `true`, altrimenti su `false`.	boolean
$flow.admin_area	Se l'elemento dell'indirizzo della zona amministrativa è obbligatorio, impostalo su `true`, altrimenti su `false`.	boolean
$flow.street_number	Se l'elemento dell'indirizzo del numero civico è obbligatorio, impostalo su `true`, altrimenti su `false`.	boolean
$flow.route	Se l'elemento dell'indirizzo dell'itinerario è obbligatorio, impostalo su `true`, altrimenti su `false`.	boolean
$flow.country	Se l'elemento dell'indirizzo del paese è obbligatorio, impostalo su `true`, altrimenti su `false`.	boolean
$flow.island	Se l'elemento dell'indirizzo dell'isola è obbligatorio, impostalo su `true`, altrimenti su `false`.	boolean
$flow.retry_num	Imposta il limite massimo di tentativi per le chiamate webhook dell'API Maps Address Validation	integer

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

Apri la console Dialogflow CX.
Scegli il tuo progetto Google Cloud.
Seleziona il tuo agente.
Seleziona la scheda Crea.
Fai clic sul componente importato nella sezione Flussi.
Fai clic su Pagina iniziale nella sezione Pagine.
Fai clic sulla route true nella pagina iniziale.
Nella finestra Route, modifica i valori di Preset parametri in base alle tue esigenze.
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 informazioni importanti raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:

Nome parametro	Descrizione	Formato di output
address_collection_address	Questo parametro restituisce l'oggetto indirizzo se un indirizzo è stato acquisito dal componente	{ "admin-area": string, "city": string, "country": string, "island": string, "route": string, "zip-code": string, "street-number": string }
address_collection_status	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 sono stati 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 non è stato raccolto perché l'API Address Validation non supporta quella regione. `NO_USER_CONFIRMATION`: l'indirizzo non è stato confermato perché l'utente finale non ha confermato un indirizzo.	string

Impostazione di base

Per configurare questo componente predefinito:

Importa il componente predefinito.
Abilita l'API Address Validation.
Configura il webhook flessibile fornito con la tua chiave API Maps. Vedi la configurazione del 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 Address Validation

Questo webhook esegue le seguenti azioni:

Elabora i parametri, la richiesta di moduli e verifica l'indirizzo di Dialogflow CX utilizzando l'API Address Validation.
Estrae gli elementi dell'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 chiave API Maps.

Per recuperare la chiave API, vai a Google Cloud Console > API e servizi > Credenziali, seleziona la chiave API di Maps e copia il campo Chiave API.

Per configurare il webhook:

Apri la console Dialogflow CX.
Scegli il tuo progetto Google Cloud.
Seleziona il tuo agente.
Seleziona la scheda Gestisci.
Fai clic su Webhook.
Seleziona il webhook prebuilt_components_address_collection:address_validation.
Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'URL inclusa la tua chiave API di Maps: https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
Nelle impostazioni di Autenticazione, configura il nome utente come key e imposta la password sulla chiave API di Maps.
Fai clic su Salva.

Completa

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

Indietro

Estratto conto

Avanti

Raccolta alfanumerica

Componente predefinito per la raccolta di indirizzi Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.