Invocación implícita (Dialogflow)

La invocación implícita es un flujo de interacción que ocurre cuando un usuario solicita una tarea sin invocar una acción por su nombre. Asistente de Google intenta hacer coincidir la solicitud del usuario con una entrega adecuada, como una acción, un resultado de la búsqueda o una app para dispositivos móviles, y luego presenta recomendaciones al usuario.

Si implementaste una acción que puede ayudar al usuario con su tarea, la invocación implícita proporciona una forma para que los usuarios la descubran a través de Asistente.

Cómo funciona

Para encontrar acciones coincidentes, Google usa indicadores, como los usuarios que le indican 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 tu acción sería apropiada.

Esta interacción ocurre de la siguiente manera:

  1. Un usuario le pide a Asistente que realice una tarea.
  2. El algoritmo de recomendación determina que tu acción puede completar la tarea del usuario.
  3. Asistente recomienda tu Acción al usuario.

Cuando el usuario selecciona tu acción después de la invocación implícita, Asistente notifica a tu acción sobre la tarea específica que solicitó el usuario.

En el siguiente ejemplo, se muestra cómo un usuario puede activar una invocación implícita solicitando una receta de sopa de pollo sin especificar el nombre de invocación de una Acción.

User Ok Google, necesito una receta de sopa de pollo.
<El Asistente consulta la plataforma de Actions on Google para encontrar acciones adecuadas para la solicitud del usuario>
Asistente Por supuesto. En ese caso, tal vez te interese Personal Chef. ¿Quieres probarlo?

Si las frases de invocación de tu Acción no se pueden asignar a una variedad de consultas de usuarios relacionadas, no se reconocerán como relevantes. Si quieres obtener más detalles, consulta Prácticas recomendadas para escribir frases de invocación útiles.

Debido a la naturaleza cambiante del algoritmo de recomendación, Google no puede garantizar que tu Acción se recomendará mediante invocación implícita.

Agrega frases de invocación

En esta sección, se describe cómo agregar frases de invocación para la invocación implícita si usas Dialogflow o el SDK de Actions a fin de compilar tu Acción.

Dialogflow

Si usas entidades en tus frases de entrenamiento, asegúrate de familiarizarte con los requisitos para las frases con entidades.

En Dialogflow, tus acciones y sus frases de invocación se definen como frases de entrenamiento en intents que especificas para la invocación implícita. Puedes agregar compatibilidad con invocaciones implícitas y vínculos directos a tu acción con un proceso de un solo paso en la consola de Dialogflow, como se describe en la guía de integración de Dialogflow.

SDK de Actions

En el SDK de Actions, tus acciones y sus frases de invocación se definen como patrones de consulta. Consulta Cómo definir acciones para obtener más información.

Analiza y consulta invocaciones implícitas

En esta sección, se describe cómo usar la Consola de Actions para analizar y ver información sobre las invocaciones implícitas que coincidieron con tu Acción.

Estadísticas de descubrimiento

En la sección Analytics > Descubrimiento de la Consola de Actions, se proporciona información útil sobre qué frases pidieron al Asistente que recomendara tu acción y cuál de tus intents coincidió con el mensaje.

Puedes encontrar más información en nuestra documentación sobre estadísticas y estado de la consola.

Ver frases de invocación

En la Consola de Actions, puedes ver tu acción y sus frases de invocación en Build > Actions.

Puedes hacer clic en cualquiera de las acciones enumeradas para ver sus frases de invocación. Si usas Dialogflow, tienes la opción de Agregar más frases, que te vincula directamente a los intents de tu acción en Dialogflow.

Requisitos para las frases con entidades

Si usas Dialogflow, las siguientes reglas se aplican a las entidades. Estas reglas de sintaxis también se aplican a los idiomas (por ejemplo, coreano y tailandés) que, en la práctica, no usan espacios separados entre palabras.

  • Si colocas una entidad en una frase, debe tener un espacio antes y después.
  • No es necesario agregar espacio antes de la entidad si se coloca al principio de una frase.
  • No es necesario que agregues espacio después de la entidad si se coloca al final de una frase.

Si una entidad no está separada por espacios del texto, Actions on Google leerá la frase completa como una cadena sin sustitución de valores para la entidad.

Debes probar frases que contengan entidades y texto en el simulador de Actions para asegurarte de que se conserve el significado deseado.

Para obtener más información, consulta la descripción general de las entidades de Dialogflow.

Prácticas recomendadas para escribir frases de invocación útiles

Las frases de invocación ofrecen una herramienta de invocación y descubrimiento útil para los usuarios, pero debes elegirlas con cuidado. Ten en cuenta las siguientes prácticas recomendadas cuando diseñes las frases de invocación de tu Acción:

  • Conserva las frases de invocación específicas de los casos de uso de tu Acción

    Tu Acción debería tener un propósito específico, así que asegúrate de que las frases de invocación describan lo que hace tu Acción. Por ejemplo, si tu Acción se usa para reservar vuelos, no uses "¿Cómo llego de $location a $location?". Una mejor alternativa es "Reserva un vuelo de $location a $location.".

    • Si tus frases de invocación contienen entidades, asegúrate de que todos los sinónimos de esas entidades sean relevantes para sus frases y el caso de uso de tu Acción en general.
  • Crea frases que incluyan un verbo y un objeto.

    Una invocación consiste en una oración completa, lo que significa que la frase de invocación de tu Acción debe ser un par verbo-objeto para ser lingüísticamente natural. Por ejemplo, "Receta fácil" no sería una buena frase de invocación porque la invocación completa sería "Ok Google, receta fácil". Una alternativa mejor podría ser "¿Cómo preparo una receta fácil?", que se puede invocar con el comando "Hey Google, ¿cómo hago una receta fácil?".

Considera los siguientes ejemplos de frases de invocación incorrectas y buenas:

Frases de invocación incorrectas

  • En la frase, no hay un verbo: "El número cinco".
  • La frase es demasiado general: "Viaje a Nueva York".

Frases de invocación buenas

  • La frase tiene un verbo y un objeto claros: "Escucha un chiste de papá".
  • La frase proporciona solicitudes específicas:

    • "¿Qué ropa uso hoy?"
    • "Quiero jugar a un juego de preguntas y respuestas".
    • "Quiero algunos nombres de bebés para niñas".

Es posible que estas frases de invocación no sean exclusivas de tu Acción. Depende del Asistente determinar qué acciones sugerir a los usuarios.