Los intents representan una tarea que el Asistente necesita para que realice tu acción, como una entrada del usuario que necesita procesamiento o un evento del sistema que debes controlar. Usa intents para crear tu invocación y modelos de conversación. Cuando se producen estos eventos, el entorno de ejecución de Asistente lo hace coincidir con el intent correspondiente y lo envía a la acción que debe procesar. Hay dos tipos principales de intents, que se describen en la siguiente lista:
Los intents del usuario te permiten extender la capacidad de Asistente para comprender las solicitudes del usuario que son específicas de tu marca y servicios. Debes definir frases de entrenamiento personalizadas dentro de un intent, lo que, a su vez, genera el modelo de lenguaje de un intent. Ese modelo de lenguaje aumenta la CLN del Asistente, lo que aumenta su capacidad de entender aún más.
Los intents del sistema tienen datos de entrenamiento, o bien otros indicadores de entrada no conversacionales definidos por Asistente. Esto significa que no necesitas definir frases de entrenamiento para estos intents. Asistente vincula estos intents de forma estándar durante eventos del sistema conocidos, como la invocación principal, o cuando los usuarios no proporcionan ninguna entrada.
Intents del usuario
Cuando creas acciones, creas intents de usuario que contienen frases de entrenamiento, lo que extiende la capacidad de Asistente para comprender aún más. Asistente usa tus frases de entrenamiento para aumentar su CLN cuando delega las solicitudes de los usuarios a tus acciones.
Cuando esto ocurre, Asistente asigna la comunicación entre el usuario y tus acciones, y asigna la entrada del usuario a un intent que tiene un modelo de lenguaje coincidente. Luego, Asistente notificará a tus acciones del intent coincidente, para que puedas procesarlo en una escena.
Cuando compilas intents de usuario, debes especificar los siguientes elementos:
Una designación de intents globales define si el entorno de ejecución de Asistente puede coincidir o no con el intent del usuario especificado en el momento de la invocación y durante una conversación. De forma predeterminada, Asistente puede hacer coincidir los intents de usuario solo durante una conversación. Solo los intents que marcas como globales son aptos para la invocación de vínculos directos.
Las frases de entrenamiento son ejemplos de lo que podría decir un usuario para que coincida con el intent. El motor de comprensión del lenguaje natural (CLN) de Asistente natural expande estas frases de entrenamiento para incluir otras similares. Proporcionar un conjunto grande de ejemplos de alta calidad aumenta la calidad del intent y la exactitud de la coincidencia.
Los parámetros son datos escritos que deseas extraer de la entrada del usuario. Para crear un parámetro, anota las frases de entrenamiento con tipos para notificar al motor de CLN que deseas extraer partes de la entrada del usuario. Puedes usar tipos de sistema o crear tus propios tipos personalizados para los parámetros.
Cuando el motor de CLN detecta una coincidencia de parámetros en la entrada del usuario, extrae el valor como un parámetro escrito para que puedas realizar la lógica con una escena. Si un parámetro de intent tiene el mismo nombre que un espacio de escena, el entorno de ejecución del Asistente llena automáticamente el espacio de escena con el valor del parámetro de intent. Consulta la documentación sobre la asignación de valores de ranura para obtener más información.
Los parámetros de intent también admiten coincidencias "parciales". Por ejemplo, si especificas un tipo de DateTime y el usuario solo proporciona una fecha, la CLN seguirá extrayendo el valor parcial como parámetro.
Te recomendamos que uses tu propia CLN para controlar todas las entradas del usuario de una acción. Por ejemplo, es posible que quieras que tu acción responda a todas las situaciones sin coincidencias durante una conversación. Para asegurarte de captar todas las entradas del usuario, crea un intent con el Tipo de texto de formato libre. Sin embargo, debes evitar usar intents personalizados para anular de forma global el comportamiento predeterminado sin coincidencias de Asistente, ya que puede afectar negativamente la capacidad de los usuarios de moverse entre Acciones.
Cuando creas un intent personalizado en la Consola de Actions, Action Builder sugiere intents del sistema que pueden cumplir la misma función que el intent del usuario. Para obtener más información sobre los intents del sistema, consulta la siguiente sección.
Intents del sistema
Asistente vincula los intents del sistema en función de los eventos estándar del sistema. Estos eventos pueden tener un modelo de lenguaje definido por el sistema, como los usuarios que dicen "pause" para pausar el reproductor multimedia, o puede que no tengan un modelo de idioma, como que los usuarios no proporcionan ninguna entrada. Debido a que Asistente proporciona estos intents, no tienes que preocuparte por la coincidencia, sino solo por cómo controlarlos cuando se detecta una coincidencia.
Los intents del sistema también reemplazan la necesidad de crear intents de usuario para acciones que suelen requerirse, como YES y NO. Los intents del sistema se entrenan para todas las configuraciones regionales, lo que te permite implementar con mayor facilidad una experiencia coherente para tus usuarios en varios idiomas.
Los intents del sistema también se pueden configurar como intents globales.
Los intents del sistema tienen control de versiones. Puedes usar una versión específica de un intent del sistema siempre que el Asistente admita esa versión. Si una acción usa una versión no compatible de un intent del sistema, ese intent se actualiza automáticamente a una versión compatible.
Lista de intents
| Intent | Descripción |
|---|---|
actions.intent.MAIN
|
Cada proyecto de acciones debe contener esta invocación principal predeterminada, que está vinculada a tu nombre visible. Los usuarios dicen frases como "Hey Google, habla con <nombre visible>" para invocar la acción. |
|
|
Estos intents coinciden cuando el usuario dice algo que no puede coincidir con un intent en tu acción. Puedes configurar mensajes individuales individuales y un mensaje de salida en el intent final. |
|
|
Estos intents coinciden cuando el usuario no recibe entradas después de 8 segundos. Puedes configurar solicitudes individuales para cada intent y un mensaje de salida en el intent final. |
actions.intent.CANCEL
|
Este intent coincide cuando el usuario quiere salir de tus acciones durante una conversación, como cuando un usuario dice "Quiero salir". |
actions.intent.MEDIA_STATUS_FINISHED
|
Este intent coincide y se envía a tu acción cuando un usuario completa la reproducción de contenido multimedia o pasa a la siguiente pieza de contenido multimedia. |
actions.intent.MEDIA_STATUS_PAUSED
|
Este intent coincide y se envía a tu acción cuando un usuario pausa la reproducción de contenido multimedia en una respuesta. |
actions.intent.MEDIA_STATUS_STOPPED
|
Este intent coincide y se envía a tu acción cuando un usuario detiene o sale de la reproducción de contenido multimedia desde una respuesta multimedia. |
actions.intent.MEDIA_STATUS_FAILED
|
Este intent coincide y se envía a tu acción cuando el reproductor de una respuesta multimedia no se puede reproducir. |
actions.intent.YES
|
Este intent coincide cuando un usuario proporciona una respuesta afirmativa a tu acción. |
actions.intent.NO
|
Este intent coincide cuando un usuario proporciona una respuesta negativa a tu acción. |
actions.intent.REPEAT
|
Este intent coincide cuando un usuario le pide a la acción que repita la última respuesta. Asistente controla automáticamente las solicitudes de repetición si el intent del sistema no está habilitado en el agente. Si habilitas este intent del sistema, podrás modificar cómo se manejan las solicitudes repetidas y las respuestas. |
actions.intent.PLAY_GAME
|
Este intent coincide cuando un usuario solicita jugar a un juego. Este intent te permite optar por una invocación implícita (invocación sin usar tu nombre visible) proporcionada por Actions on Google. |
Cómo agregar compatibilidad con otros idiomas
Algunos intents del sistema, como YES, NO y NO_MATCH, solo se admiten en inglés.Para agregar compatibilidad con otros lenguajes, debes crear intents de usuario que coincidan con esos intents del sistema. Tus intents nuevos deben manejarse en tu código de la misma manera que los intents del sistema que implementaste.
Por ejemplo, supongamos que desarrollas una acción nueva y que implementaste el intent del sistema YES. El intent del sistema YES solo se admite en inglés, pero también quieres que tu app admita interacciones en alemán y japonés.
A fin de admitir los idiomas adicionales, debes crear un intent que incluya frases de entrenamiento para alemán y japonés y, luego, implementar el control que usaste para el intent del sistema YES.
Obtén más información para crear intents de usuario.
Obtén más información para localizar los intents de tu usuario.
Rendimiento sin coincidencias
Cuando la respuesta de un usuario no coincide con uno de tus intents, Asistente intenta controlar la entrada. Este comportamiento facilita que los usuarios cambien las acciones en el medio de una conversación. Por ejemplo, un usuario pregunta: "¿Qué películas hay para ver esta semana?" y, luego, cambia el contexto durante la conversación: "¿Cómo estará el clima mañana?". En este ejemplo, porque "¿Cómo estará el clima mañana?" no es una respuesta válida a la conversación activada por el mensaje inicial. Asistente intenta controlar automáticamente la coincidencia y mover al usuario a una conversación adecuada.
Si Asistente no puede encontrar una acción apropiada que coincida con la entrada del usuario, este continuará dentro del contexto de tu acción.
Dado que Asistente puede interrumpir tu acción para responder a una situación sin coincidencia válida, no uses el intent del sistema NO_MATCH para completar las búsquedas de los usuarios. Solo debes usar el intent NO_MATCH para volver a preguntarle al usuario.