Compila modelos de invocación

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 en tu modelo de conversación. Puedes definir invocaciones de las siguientes maneras:

  • Invocación principal: Esta es la única invocación obligatoria para tu proyecto de acciones. Los usuarios dicen una frase similar a "Hey Google, habla con <nombre visible>" para coincidir con este intent. Para ello, se suele saludar 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 crear vínculos directos a una parte específica de la conversación. Los usuarios pueden decir una frase similar a "Hey Google, habla con <nombre visible> para <frase de vínculo directo>" para que coincida con estos tipos de intents (por ejemplo, "Hey Google, habla con Datos sobre Google 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. Cuando declaran 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 "Ok Google, jugar un juego" y Asistente de Google puede presentar tu acción como opción de invocación.

Figura 1: Un modelo de invocación consta de todos los intents que son aptos para iniciar conversaciones con tus Acciones.

Crea la invocación principal

Todos los proyectos de acciones tienen una invocación principal predeterminada que actúa como punto de entrada predeterminado en tu proyecto de acciones.El modelo de lenguaje de esta invocación está asociado con el nombre visible de tu proyecto, por lo que los usuarios solo deben decir una frase similar a “Hey Google, habla con <nombre visible>” para usar esta invocación. Cuando los usuarios invocan tus acciones de esta manera, el tiempo de ejecución de Asistente coincide con el intent del sistema actions.intent.MAIN.

Para crear la invocación principal, haz lo siguiente:

Para compilar 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>").

Crea invocaciones implícitas

La invocación implícita permite que los usuarios invoquen tu Acción sin usar el nombre visible del proyecto. Para encontrar Acciones coincidentes, Google usa indicadores, como los usuarios que le dicen al Asistente que realice una acción similar a una frase de invocación para uno de tus intents configurados, o cuando el usuario se encuentra en un contexto en el que tus Acciones serían apropiadas.

Controla eventos de invocación

Cuando Asistente establece una coincidencia 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 tu controlador (puedes elegir una o cualquier combinación de las tres).

Activa un webhook

Tu controlador de intents puede delegar a un servicio web mediante la activación de un evento de webhook. Para activar un webhook y hacer que un servicio web controle la invocación, sigue estos pasos:

Mensajes

Tu controlador de intents puede responder con un mensaje estático. Por lo general, las solicitudes de intents de invocación le dan la bienvenida al usuario, lo orientan sobre el uso de la Acción o responden con la información que el usuario necesita de inmediato (acciones únicas).

Para controlar una coincidencia de intent de invocación con un mensaje, haz lo siguiente:

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 hacer la transición a una escena, haz lo siguiente: