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 definidos por tu modelo de conversación. Puedes definir invocaciones de las siguientes maneras:
Main invocation: Esta es la única invocación obligatoria para tu proyecto de acciones. Los usuarios dicen una frase de manera similar a "Ok Google, talk to <display name>" para buscar coincidencias con este intent, que se suele manejar saludando al usuario con un mensaje de bienvenida.
Invocaciones de vínculos directos - Estas son invocaciones opcionales que te permiten definir frases de entrenamiento en una público basado en intención personalizado, para que los usuarios puedan establecer un vínculo directo a una parte específica de tu conversación. Los usuarios pueden decir una frase similar a "Hey Google, habla con <nombre visible> a <frase de vínculo directo>" para que coincida con estos tipos de (por ejemplo, "Hey Google, habla con Facts about Google para obtener hechos").
Intents integrados: Estos son invocaciones opcionales que te permiten aprovechar de invocación y escalamiento. Cuando se declara la compatibilidad con un intent integrado, los usuarios pueden descubrir e invocar tu proyecto de Actions sin tener que especificar nombre visible. Por ejemplo, los usuarios pueden decir "Hey Google, jugar a un juego" y Asistente de Google puede presentar tu acción como una opción de invocación.
Cómo crear la invocación principal
Todos los proyectos de acciones tienen una invocación principal predeterminada que actúa de forma predeterminada.
punto de entrada a tu proyecto de Acciones.El modelo de lenguaje de esta invocación
se asocia con el nombre visible de tu proyecto, por lo que los usuarios solo tienen que decir un
frase similar a "Hey Google, habla con <nombre visible>" para usar esta
invocación. Cuando los usuarios invocan tus acciones de esta manera, el Asistente
tiempo de ejecución coincida con el intent del sistema actions.intent.MAIN
.
Para crear la invocación principal, haz lo siguiente:
Crea invocaciones de vínculos directos
Para compilar invocaciones de vínculos directos, debes crear intents de usuario globales con entrenamiento frases que definen 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 que debes llevar. una invocación de vínculo directo (por ejemplo, "Hey Google, habla con <display nombre> a <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. Para encontrar Acciones coincidentes, Google utiliza indicadores, como los usuarios decirle a Asistente que haga algo 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 Actions sería adecuado.
Controla los eventos de invocación
Cuando el Asistente detecta una coincidencia con uno de tus intents globales, activa un evento que puede procesar con un controlador. En las siguientes secciones, se describe lo que el controlador puede realizar (puede elegir uno o cualquier combinación de los 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 que un servicio web controle la invocación, haz lo siguiente:
Instrucciones
Tu controlador de intents puede responder con un mensaje estático. Por lo general, solicita los intents de invocación dan la bienvenida al usuario, lo orientan sobre cómo usar la acción o responder de inmediato con la información que el usuario necesita (acciones en un intento).
Para controlar una coincidencia de 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 la invocación coincidente . Esto te brinda la mayor flexibilidad para llevar a cabo la lógica. Para hacer la transición a una escena: