Invocación explícita (Dialogflow)

La invocación explícita se produce cuando un usuario le dice al Asistente de Google que use tu acción por su nombre. De manera opcional, el usuario puede incluir una frase de invocación al final de la invocación que lo llevará directamente a la función que solicita.

Nota: Los usuarios pueden descubrir tu acción a través del directorio de Asistente, que es como una tienda web de Actions on el Asistente de Google. El directorio es una fuente importante para el descubrimiento de tu acción, así que asegúrate de dedicarle tiempo de desarrollo a la creación de una buena ficha.

Componentes de invocación explícitos

En el siguiente ejemplo, se muestran los diferentes componentes posibles de un comando de invocación explícito:

Frase del activador

Estas frases inician una invocación explícita y las define Actions on Google:

• "Ok Google, hablar con..."
• "Ok Google, hablar con..."
• "Hey Google, quiero hablar con..."
• "Hey Google, preguntar..."

Puedes obtener más información sobre las frases de activación para cada idioma en Idiomas y configuraciones regionales.

Nota: En los dispositivos Android, las frases de activación invocan tu Acción, a menos que la frase se superponga con un intent integrado de Acciones en apps. En estos casos, si está instalada, Asistente inicia la app, en lugar de la acción.

Por ejemplo, si un usuario dice algo como "Hey Google, registra que comí un burrito en SeguimientodeEjemplo", Asistente iniciará la app de SeguimientodeEjemplo, si implementó el intent integrado actions.intent.RECORD_FOOD_OBSERVATION, sobre cualquier acción de ExampleTracker que entregue un intent similar.

Nombre de invocación

Este es el nombre de tu Acción, como "Cocinero personal". Los usuarios combinan esto con frases de activación para invocar acciones de forma explícita por nombre, como: "Hey Google, déjame hablar con Personal Chef".

Nota: Es importante tener en mente la invocación cuando decidas qué nombre asignarle a tu acción. Si tienes un nombre de Acción inteligente, pero Asistente tiene problemas para reconocerlo, es posible que los usuarios tengan dificultades para invocarla. Consulta nuestras políticas de nombres y la lista de tareas para la invocación a fin de obtener más detalles.

Frase de invocación (opcional)

Las frases de invocación son un mecanismo valioso para aumentar la visibilidad de tu Acción y proporcionan a los usuarios una forma de establecer un vínculo directo con tu conversación, ya que proporcionan una tarea específica para realizar. Estas frases ilustran varias formas en que los usuarios pueden solicitar las funciones de tu Acción, de modo que Asistente de Google pueda comprender mejor las capacidades de tu Acción y relacionarlas con las solicitudes de los usuarios.

• "busca recetas"
• "recomendar un vino"
• "reservar un viaje"
• "jugar un juego"
• "quiero meditar"

Los usuarios combinan tu nombre de invocación con frases de invocación para invocar de manera explícita intents específicos, como: "Hey Google, habla con Personal Chef para buscarme recetas".

Nota: Asegúrate de que las frases de invocación sean específicas de tu Acción y describan casos de uso reales. Un error común es definir frases de invocación que son demasiado generales para ser específicas para el propósito de tu Acción, lo que hace que las frases sean menos útiles y dañan el descubrimiento de tu Acción. Consulta la invocación implícita y la lista de tareas de invocación para obtener más detalles.

Intent de invocación explícito

Si tu Acción se invoca de forma explícita sin ninguna frase de invocación y por nombre ("Hey Google, habla con Personal Chef"), se activa el intent actions.intent.MAIN en tu Acción. Tu proyecto de acciones solo debe contener un intent principal para la invocación explícita por nombre.

Si tu Acción se invoca de forma explícita con una frase de invocación y por nombre (“Hey Google, habla con Personal Chef para conocer la receta de sopa de hoy”), se invoca el intent correspondiente a esa frase de invocación.

Para obtener más información, consulta nuestra documentación sobre intents.