Un modelo de invocación especifica cómo los usuarios invocan las acciones en tu proyecto. Cuando los usuarios invocan una acción, comienzan una conversación con ella, que se define mediante tu modelo de conversación. Puedes definir invocaciones de las siguientes maneras:
Invocación principal: Esta es la única invocación obligatoria para el proyecto de Acciones. Los usuarios dicen una frase similar a "Ok Google, habla con <nombre visible>" para que coincida con este intent, que generalmente usas cuando saludas al usuario con un mensaje de bienvenida.
Invocaciones de vínculos directos: Estas son invocaciones opcionales que te permiten definir frases de entrenamiento en un intent personalizado para que los usuarios puedan establecer vínculos directos a una parte específica de tu conversación. Los usuarios pueden decir una frase similar a "Hey Google, habla con <nombre visible>" para <frase de vínculo directo>" que coincida con estos tipos de intents (por ejemplo, "Hey Google, habla con Google sobre datos para obtener datos de la empresa").
Intents integrados: Estas son invocaciones opcionales que te permiten aprovechar los modelos de invocación definidos por el sistema. Si declaras la compatibilidad con un intent integrado, los usuarios pueden descubrir e invocar tu proyecto de acciones sin tener que especificar tu nombre visible. Por ejemplo, los usuarios pueden decir "Hey Google, jugar un juego", y Asistente de Google puede presentar tu acción como una opción para la invocación.
Crea la invocación principal
Cada proyecto de Actions tiene una invocación principal predeterminada que actúa como punto de entrada predeterminado en tu proyecto de Actions.El modelo de lenguaje para esta invocación está asociado con el nombre visible de tu proyecto, por lo que los usuarios solo deben decir una frase similar a "Ok Google, habla con <nombre visible>" para usar esta invocación. Cuando los usuarios invocan tus Acciones de esta manera, el entorno de ejecución de Asistente coincide con el intent del sistema actions.intent.MAIN.
Para crear la invocación principal, haz lo siguiente:
Crea invocaciones de vínculos directos
A fin de crear invocaciones de vínculos directos, debes crear intents de usuario globales con frases de entrenamiento que definan la entrada del usuario que deseas establecer para el vínculo directo. Los usuarios dicen tu nombre visible en combinación con la frase de vínculo directo para realizar una invocación de vínculo directo (por ejemplo, "Ok Google, habla con <nombre visible> para <frase de vínculo directo>").
Cómo crear invocaciones implícitas
La invocación implícita permite a los usuarios invocar tu acción sin usar el nombre visible de tu proyecto. A fin de encontrar acciones que coincidan, Google usa indicadores, como usuarios que le indican a Asistente que realice una acción similar a una frase de invocación para uno de tus intents configurados, o cuando el usuario se encuentre en un contexto en el que tus acciones sean apropiadas.
Cómo controlar eventos de invocación
Cuando Asistente coincide con uno de tus intents globales, activa un evento que puedes procesar con un controlador. En las siguientes secciones, se describe lo que puede hacer el controlador (puedes elegir una o cualquiera de las tres combinaciones).
Activa un webhook
Tu controlador de intents puede delegar un servicio web activando un evento de webhook. Para activar un webhook y que un servicio web controle la invocación, haz lo siguiente:
Mensajes
El controlador del intent puede responder con un mensaje estático. Por lo general, los mensajes de intents de invocación agradecen al usuario, los guían en el uso de la acción o responden de inmediato con la información que el usuario necesita (acciones únicas).
Para controlar la coincidencia de un intent de invocación con un mensaje, haz lo siguiente:
Cómo hacer la transición a una escena
Tu controlador de intents puede pasar a una escena para procesar el intent de invocación coincidente. Esto te brinda la mayor flexibilidad para llevar a cabo la lógica. Para hacerlo, sigue estos pasos: