Intents

Un intent clasifica la intención de un usuario final para un turno de conversación. En comparación con los intents de ES, los intents de CX se simplificaron para que sean un recurso más reutilizable.

Un intent contiene los siguientes datos:

Término Definición
Frases de entrenamiento Las frases de entrenamiento son frases de ejemplo de algo que podrían decir o escribir los usuarios finales, conocidas como entradas del usuario final. Cuando la entrada del usuario final se parece a una de estas frases, Dialogflow hace una coincidencia con el intent. No es necesario que definas todos los ejemplos posibles, ya que el aprendizaje automático integrado de Dialogflow expande la lista con otras frases similares.
Parámetros Define las frases de entrenamiento a fin de usar parámetros para extraer valores de partes específicas de la entrada del usuario final.

Coincidencia de intents

Cuando un usuario final escribe o dice algo, lo que se denomina como entrada del usuario final, Dialogflow compara la entrada con las frases de entrenamiento de intent para encontrar la mejor coincidencia. Este proceso se llama coincidencia de intent. La coincidencia de intent solo puede ocurrir en los intents asociados con una ruta de intent (un controlador de estado con un requisito de intent) dentro del alcance.

Cuando se busca un intent coincidente, Dialogflow puntúa las posibles coincidencias con una confianza de detección de intent, también conocida como puntuación de confianza. Estos valores van desde 0.0 (completamente incierto) hasta 1.0 (completamente cierto). Una vez que se puntúen los intents, hay dos resultados posibles:

  • Si el intent con la puntuación más alta tiene una puntuación de confianza mayor o igual que la configuración del umbral de clasificación, se muestra como una coincidencia.
  • Si ningún intent alcanza el umbral, se invocará un evento de no coincidencia.

Frases de entrenamiento

Las frases de entrenamiento son frases de ejemplo de algo que los usuarios finales podrían escribir o decir, lo que se denomina entrada del usuario final. Debes crear muchas frases de entrenamiento por cada intent. Cuando una entrada del usuario final se parece a una de estas frases, Dialogflow hace una coincidencia con el intent.

Por ejemplo, la frase de entrenamiento “Quiero pizza” entrena a tu agente para que reconozca las entradas del usuario final que son similares a esa frase, como “Obtener una pizza” o “Pedir pizza”.

No tienes que definir todos los ejemplos posibles, porque el aprendizaje automático integrado de Dialogflow expande tu lista con otras frases similares. Debes crear al menos de 10 a 20 frases de entrenamiento (según la complejidad del intent) para que el agente pueda reconocer una variedad de entradas del usuario final. Por ejemplo, si deseas que tu intent reconozca una entrada de un usuario final acerca de su color favorito, puedes definir las siguientes frases de entrenamiento:

  • “Me gusta el rojo”
  • "Mi color favorito es el amarillo"
  • "negro"
  • “El azul es mi color favorito”

Anota las frases de entrenamiento

Para controlar cómo se extraen los datos del usuario final, mediante la anotación de las partes de tus frases de entrenamiento y la configuración de los parámetros asociados.

Por ejemplo, considera una frase de entrenamiento como “¿Cuál es el pronóstico para mañana en Tokio?” Debes anotar “mañana” con un parámetro date y “Tokio” con un parámetro location. Cuando anotas fragmentos de una frase de entrenamiento, Dialogflow reconoce que estos fragmentos son solo ejemplos de valores reales que proporcionarán los usuarios finales en el entorno de ejecución. En una entrada del usuario final como “¿Cuál es el pronóstico para el viernes en Sídney?”, Dialogflow extraería el parámetro date de “Viernes” y el parámetro location de “Sídney”.

Si compilas un agente con la consola, la mayoría de las anotaciones se crean de forma automática cuando agregas frases de entrenamiento que contienen fragmentos que pueden coincidir con un tipo de entidad existente. Estos fragmentos están resaltados en la consola. Puedes editar estas anotaciones y parámetros si lo necesitas.

Para anotar una frase de entrenamiento con la consola de forma manual, haz lo siguiente:

  1. Selecciona el fragmento de la frase de entrenamiento que deseas anotar.
  2. Selecciona el tipo de entidad deseado de la lista.
  3. Se crea un parámetro para ti en la tabla de parámetros a continuación.

Cuando compilas un agente con la API, debes anotar las partes de la frase de entrenamiento de forma manual. Consulta el tipo TrainingPhrase que usa el tipo Intent.

Selecciona un protocolo y una versión para la Referencia de intent:

Protocolo V3 V3beta1
REST Recurso de intent Recurso de intent
RPC Interfaz de intent Interfaz de intent
C# No disponible No disponible
Go No disponible No disponible
Java IntentsClient IntentsClient
Node.js IntentsClient IntentsClient
PHP No disponible No disponible
Python IntentsClient IntentsClient
Ruby No disponible No disponible

Intent de bienvenida predeterminado

Cuando creas un agente, se crea un intent de bienvenida predeterminado. Para algunos lenguajes, el intent tiene frases de entrenamiento simples como "Hola" o "Hola" que deben coincidir con la entrada inicial del usuario final. Puedes editar este intent como desees.

Cuando usas la API, puedes hacer referencia a este intent con el siguiente ID de intent:

00000000-0000-0000-0000-000000000000

Intent negativo predeterminado

Cuando creas un agente, se crea un intent negativo predeterminado. Puedes agregar frases de entrenamiento a este intent que actúen como ejemplos negativos. Puede haber casos en los que la entrada del usuario final tenga una leve similitud con las frases de entrenamiento en intents normales, pero no deseas que coincidan con ningún intent normal.

Por ejemplo, un agente de reserva de habitaciones puede tener una frase de entrenamiento como “Me gustaría reservar una habitación”. Si el usuario final quisiera alquilar una habitación en una reserva natural, podría decir “Me gustaría alquilar una habitación en una reserva”. Para asegurarte de que la entrada del usuario final no coincida con tu intent, puedes agregar esa frase como ejemplo negativo.

Cuando usas la API, puedes hacer referencia a este intent con el siguiente ID de intent:

00000000-0000-0000-0000-000000000001

Cancelar intents

Durante una conversación, es posible que el usuario final quiera cancelar el tema de la conversación actual. Por ejemplo, es posible que la página que está activa en ese momento solicite una cita para una cita nueva, pero el usuario final decidió no crear una cita nueva. El usuario final puede decir algo como "cancelar" o "No quiero una cita nueva". A fin de manejar esta situación, puedes crear uno o más intents de cancelación para tu agente. Puedes nombrar estos intents de cancelación como desees, pero es habitual incluir "cancel" en el nombre. Debes asociar estos intents de cancelación con rutas de intents que estén dentro del alcance en puntos relevantes de la conversación. Estas rutas de intents deben pasar a una página adecuada para manejar la cancelación.

Las frases de entrenamiento para intents de cancelación deben controlar los intentos genéricos y específicos de cancelar un tema. Por ejemplo:

  • Cancelar
  • Detener
  • Cambié de opinión
  • Mejor no
  • Volver
  • Atrás
  • No quiero una cita nueva
  • Cancelar cita nueva
  • Borrar cita nueva

Crea un intent

Para crear un intent, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Intents.
  6. Haz clic en +Crear.
  7. Ingresa los datos del intent.
  8. Haga clic en Save.

API

Consulta el método create para el tipo Intent.

Selecciona un protocolo y una versión para la Referencia de intent:

Protocolo V3 V3beta1
REST Recurso de intent Recurso de intent
RPC Interfaz de intent Interfaz de intent
C# No disponible No disponible
Go No disponible No disponible
Java IntentsClient IntentsClient
Node.js IntentsClient IntentsClient
PHP No disponible No disponible
Python IntentsClient IntentsClient
Ruby No disponible No disponible

Borra un intent

Para borrar un intent, sigue estos pasos:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Intents.
  6. Coloca el cursor sobre el intent que deseas borrar.
  7. Haz clic en el botón Borrar .

API

Consulta el método delete para el tipo Intent.

Selecciona un protocolo y una versión para la Referencia de intent:

Protocolo V3 V3beta1
REST Recurso de intent Recurso de intent
RPC Interfaz de intent Interfaz de intent
C# No disponible No disponible
Go No disponible No disponible
Java IntentsClient IntentsClient
Node.js IntentsClient IntentsClient
PHP No disponible No disponible
Python IntentsClient IntentsClient
Ruby No disponible No disponible

Accede a los datos del intent

Para acceder a los datos del intent, haz lo siguiente:

Console

  1. Abre la consola de Dialogflow CX.
  2. Elige tu proyecto de GCP.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Intents.
  6. Haz clic en el intent al que deseas acceder.
  7. Visualiza o actualiza los datos del intent
  8. Haz clic en Guardar a fin de guardar los cambios.

API

Consulta los métodos get y patch/update para el tipo Intent.

Selecciona un protocolo y una versión para la Referencia de intent:

Protocolo V3 V3beta1
REST Recurso de intent Recurso de intent
RPC Interfaz de intent Interfaz de intent
C# No disponible No disponible
Go No disponible No disponible
Java IntentsClient IntentsClient
Node.js IntentsClient IntentsClient
PHP No disponible No disponible
Python IntentsClient IntentsClient
Ruby No disponible No disponible