Invocación implícita (Dialogflow)

La invocación implícita es un flujo de interacción que se produce cuando un usuario solicita realizar una tarea sin invocar una acción por su nombre. El 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, le presenta recomendaciones.

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 descubran tu acción mediante el Asistente.

Cómo funciona

A fin de encontrar acciones que coincidan, Google usa indicadores, como 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 adecuada.

Esta interacción se produce de la siguiente manera:

  1. Un usuario le pide al 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 le notifica a la acción 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 Actions on Google a fin de encontrar acciones adecuadas para la solicitud del usuario>
Asistente Por supuesto. En ese caso, es posible que te guste Personal Chef. ¿Quieres probarlo?

Si las frases de invocación de tu acción no se pueden asignar a una variedad de consultas de usuario 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 se recomiende tu acción mediante una invocación implícita.

Cómo agregar frases de invocación

En esta sección, se describe cómo agregar frases de invocación para invocaciones implícitas si usas el SDK de Dialogflow o Actions a fin de compilar la 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 directas y vínculos directos a la acción mediante 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 Define acciones para obtener más información.

Cómo analizar y ver invocaciones implícitas

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

Estadísticas de descubrimiento

La sección Analytics > Discovery de la Consola de Actions proporciona información útil sobre qué frases le solicitaron al Asistente que recomiende tu acción y cuáles de tus intents coincidieron 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 la separación de espacios entre palabras.

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

Si una entidad no está separada del espacio del texto, Actions on Google leerá la frase completa como una string sin sustitución de valor de 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:

  • Mantén tus frases de invocación específicas para los casos de uso de tu acción

    Tu acción debe entregar un propósito específico, por lo que debes asegurarte de que las frases de invocación realmente describan lo que hace. Por ejemplo, si tu acción se usa para reservar vuelos, no uses "How do I get from $location to $location?". Una mejor alternativa es "Reservar 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 de verbos y objetos para que sea lingüísticamente natural. Por ejemplo, "Receta fácil". No sería una buena frase de invocación, ya que la invocación completa sería "Ok Google, receta sencilla". Una mejor alternativa podría ser "¿Cómo preparar una receta fácil?", que se puede invocar mediante "Ok 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

  • La frase carece de un verbo: "The number five".
  • La frase es demasiado general: "Viaje a Nueva York".

Frases de invocación adecuadas

  • La frase tiene un verbo y un objeto claros: "Escuchar el chiste de un padre".
  • La frase proporciona solicitudes específicas:

    • "¿Qué ropa debería usar hoy?".
    • “Quiero jugar un juego de preguntas y respuestas”.
    • "Quiero algunos nombres de bebé para las niñas".

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