Alcuni prodotti e funzionalità sono in fase di ridenominazione. Anche le funzionalità di playbook generativo e flusso vengono migrate in un'unica console consolidata.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Componente predefinito per la raccolta di indirizzi

Il componente predefinito per la raccolta degli indirizzi raccoglie un indirizzo da un cliente e lo convalida utilizzando l'API Address Validation di Google.

Limitazioni

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

Supporta solo gli indirizzi dei paesi elencati nei dettagli sulla copertura dell'API Address Validation.

Funzionalità aggiuntive

Questo componente predefinito offre le seguenti funzionalità aggiuntive:

Finestre di dialogo di esempio

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

Convalida dell'indirizzo completo

L'utente fornisce un indirizzo completo e il componente di raccolta degli indirizzi lo verifica.

Input utente	Risposta dell'agente
	Per iniziare, indicami 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, l'area amministrativa è CA, il codice postale è 94043, il paese è USA. È corretto? Rispondi "Sì" o "No".
sì
	Fantastico, ho l'indirizzo.

Indirizzo parzialmente valido con elementi dedotti

L'utente fornisce un indirizzo parziale.
L'agente indovina la parte mancante e la verifica dopo la conferma da parte dell'utente.

Input utente	Risposta dell'agente
	Per iniziare, indicami il tuo indirizzo completo.
1600 Amphitheatre Parkway
	Ho indovinato una 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, la via è Amphitheatre Parkway, la città è Mountain View, l'area amministrativa è CA, il codice postale è 94043, il paese è USA. È corretto? Rispondi "Sì" o "No".
Sì
	Fantastico, ho l'indirizzo.

Indirizzo parziale valido con elementi forniti dall'utente

L'utente fornisce un indirizzo parziale.
L'utente rifiuta la parte indovinata e fornisce il proprio input.
L'agente accetta l'input fornito dall'utente e richiede nuovamente la conferma.
L'utente accetta l'indirizzo finale.

Input utente	Risposta dell'agente
	Per iniziare, indicami il tuo indirizzo completo.
1600 Amphitheatre Parkway
	Ho indovinato una 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, la via è Amphitheatre Parkway, la città è Mountain View, l'area amministrativa è CA, il codice postale è 94043, il paese è USA. È corretto? Rispondi "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'è 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, l'area amministrativa è CA, il codice postale è 94043, il paese è USA. È corretto? Rispondi "Sì" o "No".
sì
	Fantastico, ho l'indirizzo.

Input non riconosciuto

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

Input utente	Risposta dell'agente
	Per iniziare, indicami il tuo indirizzo completo.
Va bene
	Non ho capito. Per iniziare, indicami il tuo indirizzo completo.
nice
	Mi dispiace, continuo a non capire. Per iniziare, indicami 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 fornisce un indirizzo non supportato dall'API Address Validation.

Input utente	Risposta dell'agente
	Per iniziare, indicami il tuo indirizzo completo.
India
	Mi dispiace, ma non posso convalidare gli indirizzi in questa regione.

Address Validation

Per saperne di più su come il componente di raccolta degli indirizzi convalida gli indirizzi, consulta la panoramica dell'API Address Validation.

Il componente di raccolta degli indirizzi acquisisce l'input utente dell'utente 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.

L'API Address Validation restituisce i seguenti elementi dell'indirizzo, che puoi utilizzare per raccogliere e convalidare un indirizzo completo:

administrative_area_level_1
archipelago
country
locality
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
Intent specifico del componente	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 configurano determinati comportamenti del componente. Una o più condizioni all'interno del flusso utilizzano i parametri per determinare il comportamento del componente. L'utente deve impostare i parametri con ambito flusso nella pagina iniziale del componente, come descritto nella tabella seguente. L'utente può impostare i parametri con ambito sessione tramite un flusso di chiamata o nella pagina iniziale di questo componente.

L'utente può 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 dell'indirizzo del codice postale è obbligatorio, impostalo su `true`; altrimenti, impostalo su `false`.	boolean
$flow.city	Se l'elemento dell'indirizzo della città è obbligatorio, impostalo su `true`; in caso contrario, impostalo su `false`.	boolean
$flow.admin_area	Se l'elemento dell'indirizzo dell'area amministrativa è obbligatorio, impostalo su `true`; in caso contrario, impostalo su `false`.	boolean
$flow.street_number	Se l'elemento dell'indirizzo relativo al numero civico è obbligatorio, impostalo su `true`; in caso contrario, impostalo su `false`.	boolean
$flow.route	Se l'elemento dell'indirizzo del percorso è obbligatorio, impostalo su `true`; in caso contrario, impostalo su `false`.	boolean
$flow.country	Se l'elemento dell'indirizzo del paese è obbligatorio, impostalo su `true`; in caso contrario, impostalo su `false`.	boolean
$flow.island	Se l'elemento dell'indirizzo dell'isola è obbligatorio, impostalo su `true`; in caso contrario, impostalo 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 l'agente.
Seleziona la scheda Build.
Fai clic sul componente importato nella sezione Flussi.
Fai clic sulla pagina iniziale nella sezione Pagine.
Fai clic sulla route true nella pagina iniziale.
Nella finestra Route (Percorso), modifica i valori di Parameter Presets (Preset dei parametri) in base alle tue esigenze.
Fai clic su Salva.

Parametri di output

I parametri di output sono parametri di sessione che rimangono attivi dopo che l'utente esce dal componente. Questi parametri contengono informazioni importanti raccolte dal componente.

Il componente predefinito fornisce i seguenti parametri di output:

Nome parametro	Descrizione	Formato di output
address_collection_address	Questo parametro restituisce l'oggetto Address 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, 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 non è stato raccolto perché l'API Address Validation non supporta la regione. `NO_USER_CONFIRMATION`: l'indirizzo non è stato confermato perché l'utente 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 di Google Maps. Per saperne di più, consulta Configurazione del webhook.

Configurazione del webhook

Per convalidare gli indirizzi con l'API Address Validation, configura il webhook flessibile fornito con le credenziali corrette.

Webhook di convalida dell'indirizzo

Questo webhook esegue le seguenti azioni:

Elabora i parametri Dialogflow CX acquisiti, forma la richiesta e verifica l'indirizzo utilizzando l'API Address Validation.
Estrae gli elementi dell'indirizzo confermati, non confermati, mancanti e dedotti dalla risposta dell'API Address Validation.

Aggiorna le impostazioni del webhook con la chiave API di Google Maps corretta per configurare il webhook per questo componente.

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

Per configurare il webhook:

Vai alla console Dialogflow CX.
Scegli il tuo progetto Google Cloud .
Seleziona l'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 che include la chiave API di Google Maps: https://addressvalidation.googleapis.com/v1:validateAddress?key=<var>MAPS_API_KEY</var>.
Nelle impostazioni di autenticazione, configura il nome utente come key e imposta la password per la chiave API di Google Maps.
Fai clic su Salva.

Completa

Il componente predefinito e il relativo webhook sono ora 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.