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.