El conjunto de direcciones componente compilado previamente recopila una dirección del usuario final y usa la API de Google Address Validation para validar direcciones.
Limitaciones
Además de las limitaciones comunes de los componentes precompilados, este componente precompilado tiene las siguientes limitaciones:
- Solo admite direcciones de países que figuran en Detalles de cobertura de la API de Address Validation
Funciones adicionales
Este componente precompilado proporciona las siguientes funciones adicionales:
Diálogos de muestra
En los siguientes diálogos de muestra, se muestran situaciones comunes que controla este componente precompilado. Los diálogos de muestra demuestran el comportamiento cuando el componente se a través de telefonía, lo que activa el Default Welcome Intent y el primer respuesta de agente al comienzo de la conversación.
Dirección válida completa
El usuario final proporciona una dirección completa, y el componente de recopilación de direcciones la verifica correctamente.
Entrada del usuario | Respuesta del agente |
---|---|
Dime tu dirección completa para comenzar. | |
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, EE.UU. | |
Tengo la dirección final: el número de calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. | |
sí | |
Genial, tengo la dirección. |
Dirección parcial válida con elementos inferidos
Si el usuario final proporciona una dirección parcial el agente adivina la parte faltante y la verifica correctamente después de la confirmación del usuario final.
Entrada del usuario | Respuesta del agente |
---|---|
Para comenzar, dime tu dirección completa. | |
1600 Amphitheatre Parkway | |
Supongo que parte de la dirección. La ciudad es Mountain View, el código postal es 94043, el área administrativa es CA y el país es EE.UU. Ya recopilé la dirección final. el número de la calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. |
|
Sí | |
Fantástico, recopilé la dirección. |
Dirección parcial válida con elementos proporcionados por el usuario
Si el usuario final proporciona una dirección parcial El agente adivina la parte faltante, pero el usuario final proporciona su propia entrada después de decir "no", y el agente acepta la dirección con éxito.
Entrada del usuario | Respuesta del agente |
---|---|
Para comenzar, dime tu dirección completa. | |
1600 Amphitheatre Parkway | |
Supongo que parte de la dirección. La ciudad es Mountain View, el código postal es 94043, el área administrativa es CA y el país es EE.UU. Ya recopilé la dirección final. el número de la calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. |
|
No | |
Muy bien. Dime qué parte de la dirección debe cambiar. | |
Código postal | |
¿Puedes indicarme el código postal? | |
94044 | |
Terminé con esta actualización. ¿Hay algo más que deba cambiar? Di sí o no. | |
no | |
Después de la validación, reemplacé el código postal por 94043. Recopilé la dirección final: el número de calle es 1600, la ruta es Amphitheatre Parkway, la ciudad es Mountain View, el área administrativa es CA, el código postal es 94043 y el país es EE.UU. ¿Verdad? Di sí o no. |
|
sí | |
Genial, tengo la dirección. |
Entrada no reconocida
El componente sale del flujo después de que el usuario final proporciona una entrada no reconocida tres veces.
Entrada del usuario | Respuesta del agente |
---|---|
Dime tu dirección completa para comenzar. | |
Está bien | |
Lo siento, no entendí. Dime tu dirección completa para comenzar. | |
Niza | |
Sigo sin entender. Para comenzar, dime tu dirección completa. | |
genial | |
Lo siento, pero no entiendo tu respuesta. |
Dirección no admitida
El componente sale del flujo después de que el usuario final proporciona una dirección que actualmente no es compatible con la API de Address Validation.
Entrada del usuario | Respuesta del agente |
---|---|
Dime tu dirección completa para comenzar. | |
India | |
Lo siento, pero en este momento no puedo validar direcciones de esa región. |
Validación de la dirección
Para comprender cómo el componente de recopilación de direcciones valida las direcciones, consulta Descripción general de la API de Address Validation.
El componente de recopilación de direcciones captura la entrada del usuario final a través del Entidad del sistema@sys.address y envía la dirección capturada a la API de Address Validation para extraer elementos de dirección para su procesamiento posterior.
La API de Address Validation devuelve los siguientes elementos de dirección y el componente las usa para recopilar y validar una dirección completa:
- administrative_area_level_1
- archipiélago
- país
- localidad
- postal_code
- ruta
- street_number
Puedes probar la Demostración de Google Address Validation con cualquier dirección de un región compatible.
Convenciones de nombres
Este componente compilado previamente usa las siguientes convenciones de nomenclatura:
Atributo | Formato | Ejemplo |
---|---|---|
Flujo | [Nombre del componente] | Recopilación de direcciones |
Intent específico del componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_address_collection_locality |
Parámetro | [param_name] | user_provided_address |
Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_address_collection:address_validation |
Parámetros de entrada
Los parámetros de entrada son parámetros que se usan para configurar ciertos comportamientos del componente. Los parámetros se utilizarán en una o más condiciones dentro de la para determinar cómo debe comportarse el componente. Los parámetros con alcance de flujo deben establecerse en la página de inicio del componente como se describe a continuación. Centrado en la sesión los parámetros se pueden configurar mediante un flujo de llamada, o bien de este componente.
Puedes configurar qué elementos de dirección requiere este componente modificando ajustes predeterminados de parámetros la página de inicio del flujo de trabajo.
Este componente compilado previamente acepta los siguientes parámetros de entrada:
Nombre del parámetro | Descripción | Formato de entrada |
---|---|---|
$flow.zip_code | Si se requiere el elemento de dirección de código postal, configúralo como true o, de lo contrario, false . |
booleano |
$flow.city | Si se requiere el elemento de dirección de la ciudad, configúralo como true ; de lo contrario, false . |
booleano |
$flow.admin_area | Si se requiere el elemento de dirección del área administrativa, establece como true o, de lo contrario, false . |
booleano |
$flow.street_number | Si se requiere el elemento de dirección del número de calle, establece como true o de lo contrario, false . |
booleano |
$flow.route | Si el elemento de dirección de la ruta es obligatorio, configúralo como true ; de lo contrario, configúralo como false . |
booleano |
$flow.country | Si se requiere el elemento de dirección del país, configúralo como true o, de lo contrario, false . |
booleano |
$flow.island | Si se requiere el elemento de dirección de la isla, establece como true o, de lo contrario, false . |
booleano |
$flow.retry_num | Establece el límite máximo de reintentos para las llamadas de webhook de la API de Maps Address Validation. | integer |
Si quieres configurar los parámetros de entrada de este componente, expande para obtener instrucciones.
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Build.
- Haz clic en el componente importado en la sección Flujos.
- Haz clic en la página principal en la sección Páginas.
- Haz clic en la ruta true en la página principal.
- En la ventana Ruta, edita los valores de Parámetros predefinidos según sea necesario.
- Haz clic en Guardar.
Los parámetros de resultado
Los parámetros de salida son parámetros de sesión que permanecerán activos después de salir el componente. Estos parámetros contienen información importante que recopila el este componente. Este componente precompilado proporciona valores para los siguientes parámetros de salida:
Nombre del parámetro | Descripción | Formato de salida |
---|---|---|
address_collection_address | Este parámetro muestra el objeto de dirección si el componente capturó una dirección. | { |
address_collection_status | Este parámetro muestra el estado de la dirección recopilada. El valor que se muestra es uno de los siguientes:VALID_ADDRESS : La API de Address Validation recopiló y validó la dirección.INVALID_ADDRESS : El usuario final confirmó la dirección, pero la API de Address Validation no confirmó o marcó uno o más elementos como UNCONFIRMED_BUT_PLAUSIBLE.MAPS_API_ERROR : No se recopiló la dirección debido a un error de la API de Address ValidationCOUNTRY_NOT_SUPPORTED : no confirmó la dirección porque la API de Address Validation no confirmóNO_USER_CONFIRMATION la dirección no confirmó la dirección.COUNTRY_NOT_SUPPORTED : No confirmó la dirección. |
string |
Configuración básica
Para configurar este componente compilado previamente, haz lo siguiente:
- Importa el componente precompilado.
- Habilita la API de Address Validation.
- Configura los webhook flexible con tus la clave de API de Google Maps, consulta Configuración de webhooks a continuación.
Configuración de webhook
Si quieres usar la API de Address Validation para validar direcciones, deberás para configurar el webhook flexible proporcionado con las credenciales correctas.
Webhook de Address Validation
Este webhook realiza las siguientes acciones:
- Processes capturó los parámetros de Dialogflow CX, dio forma a la solicitud y verifica la dirección con la API de Address Validation.
- Extrae de las direcciones confirmadas, no confirmadas, inferidas y faltantes de la respuesta de la API de Google Address Validation.
Para configurar el webhook para este componente, deberá actualizar el webhook los parámetros de configuración con tu clave de la API de Google Maps.
- Para recuperar tu clave de API, ve a la consola de Google Cloud Platform > APIs y Servicios > Credenciales, selecciona tu clave de API de Google Maps y copia el campo Clave de API.
Para configurar el webhook, haz lo siguiente:
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Webhooks.
- Selecciona el webhook precompilado_components_address_collection:address_validation.
- Reemplaza la URL en el campo URL de webhook de Dialogflow CX por la URL. incluida tu clave de la API de Google Maps: https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
- En la configuración de Autenticación, establece el nombre de usuario como
key
y, luego, establece la contraseña en tu clave de API de Google Maps. - Haz clic en Guardar.
Completado
Tu agente y su webhook ya deberían estar configurados y listos para probarlos.