Descripción general de los intents (Dialogflow)

Los intents son objetos de mensajería que describen cómo realizar una acción. Puedes usar los intents de las siguientes dos maneras:

  • Cuando proporcionas la entrega de un intent,
  • Solicitando la entrega de un intent por parte del Asistente de Google

El proceso mediante el cual proporcionas la entrega para un intent es diferente para los desarrolladores que compilan con Dialogflow y para los que compilan con el SDK de Actions. Sin embargo, en ambos casos, proporcionas el nombre del intent y la URL de tu webhook de entrega. Esto le indica a Actions on Google que puedes admitir consultas de usuarios que coinciden con el intent.

Para solicitar la entrega de un intent, debes especificar el intent en el objeto possibleIntents cuando le respondas al Asistente. En la solicitud posterior a tu entrega, Asistente te muestra el resultado del intent procesado. Para obtener más información, consulta la descripción general del uso de los asistentes.

Intents comunes

En la siguiente tabla, se describen los intents que el Asistente solicita para que entregues.

Nombre del intent Uso Evento de Dialogflow
actions.intent.MAIN Obligatorio: Cada paquete de acciones declara solo un intent como punto de entrada para que los usuarios inicien conversaciones. WELCOME o GOOGLE_ASSISTANT_WELCOME
actions.intent.TEXT Obtén la representación de texto sin procesar de una solicitud del usuario. Usas esto la mayor parte del tiempo cuando interactúas con una conversación con los usuarios.
actions.intent.CANCEL Recibirás este intent cuando habilites la recepción de intents de cancelación en tu paquete de acciones. Cuando los usuarios dicen un comando de cancelación global, como "quit", recibes este intent en la siguiente solicitud a tu entrega, de modo que puedes responder con un mensaje final y hacer cualquier limpieza en la lógica de entrega. actions_intent_CANCEL
actions.intent.NO_INPUT Recibirás este intent cuando habilites la recepción de intents sin entrada en tu paquete de acciones. Cuando los usuarios no respondan a un mensaje, recibirás este intent en la próxima solicitud a tu entrega. actions_intent_NO_INPUT

Ayudas

En la siguiente tabla, se describen los colaboradores compatibles que puedes pedirle al Asistente que complete.

Nombre del intent Uso Evento de Dialogflow
actions.intent.PERMISSION Obtén el nombre completo, la ubicación aproximada o la ubicación precisa del usuario, o todas las 3. actions_intent_PERMISSION
actions.intent.OPTION Recibe el elemento seleccionado de una IU de lista o carrusel. O bien, si el usuario no selecciona una opción de la IU de la lista o del carrusel, recibe una entrada de voz o texto que coincida con la clave en la IU de la lista o del carrusel. actions_intent_OPTION
actions.intent.DATETIME Obtén una entrada de fecha y hora del usuario. actions_intent_DATETIME
actions.intent.SIGN_IN Solicita un flujo de vinculación de cuentas para vincular la cuenta de un usuario. actions_intent_SIGN_IN
actions.intent.PLACE Obtén una dirección o una ubicación guardada del usuario. actions_intent_PLACE
actions.intent.CONFIRMATION Obtener una confirmación del usuario (por ejemplo, una respuesta a una pregunta de sí o no) actions_intent_CONFIRMATION
actions.intent.NEW_SURFACE Solicita permiso al usuario para transferirlo a otra plataforma de Asistente. actions_intent_NEW_SURFACE

Intents integrados

Los intents integrados modelan algunas de las formas comunes en que los usuarios expresan las tareas que intentan realizar o la información que buscan, como pedir una comida, reservar un viaje o consultar el saldo de una cuenta. Consulta la referencia de intents integrados para obtener más información.

Intents adicionales

La mayoría de las acciones de conversación se compilan con una combinación de intents, asistentes y respuestas comunes. Sin embargo, las Acciones que incorporan funciones adicionales, como las transacciones o las actualizaciones diarias, tienen acceso a intents específicos de esas funciones.

Asistentes de transacciones

En la siguiente tabla, se describen los asistentes relacionados con el manejo de las compras que puedes solicitar a Asistente para que complete. Puedes encontrar más información para implementar estos y otros intents relacionados en la documentación de la función de transacciones.

Nombre del intent Uso Evento de Dialogflow
actions.intent.DELIVERY_ADDRESS Obtén una entrada de la dirección de entrega del usuario. actions_intent_DELIVERY_ADDRESS
actions.intent.TRANSACTION_REQUIREMENTS_CHECK Verifica si se cumplen todos los requisitos de una transacción. actions_intent_TRANSACTION_REQUIREMENTS_CHECK
actions.intent.TRANSACTION_DECISION Le pregunta al usuario si se debe realizar la transacción. actions_intent_TRANSACTION_DECISION
actions.intent.DIGITAL_PURCHASE_CHECK Valida la configuración de transacciones del usuario. Se usa para evitar ofrecer artículos digitales a los usuarios cuya transacción fallará. actions_intent_DIGITAL_PURCHASE_CHECK
actions.intent.COMPLETE_PURCHASE Inicia una solicitud de compra. Genera un resultado de compra que describe si la transacción se realizó correctamente o no, y de qué manera. actions_intent_COMPLETE_PURCHASE

Intents de participación del usuario

En la siguiente tabla, se describen los intents relacionados con las funciones de participación del usuario. Puedes encontrar más información para implementar estos y otros intents relacionados en la documentación de la función de participación del usuario.

Nombre del intent Proporcionar entrega Solicitar entrega Uso Evento de Dialogflow
actions.intent.REGISTER_UPDATE X Le pide al usuario que se registre para recibir actualizaciones. actions_intent_REGISTER_UPDATE
actions.intent.CONFIGURE_UPDATES X Recibirás este intent cuando el usuario intente registrarse para recibir actualizaciones (es decir, se debe enviar un intent REGISTER_UPDATE). actions_intent_CONFIGURE_UPDATES

Intents personalizados

Puedes crear tus propios intents para definir atajos a la conversación y ayudar a los usuarios a realizar tareas de manera más eficiente. Estos intents residen en tu propio espacio de nombres; tú defines cómo los usuarios activan los intents, y tu paquete de acciones es el único que puede admitirlos.

Si deseas obtener más información, lee sobre cómo definir acciones en Dialogflow o con el SDK de Actions. Puedes encontrar más información sobre los paquetes de acción en la documentación de referencia de paquetes de acciones.

Intents de casa inteligente

Si estás compilando una Acción de casa inteligente, defines la compatibilidad para intents de una manera un poco diferente. Consulta la documentación de intents de casa inteligente para obtener más información.