Acciones y parámetros

En esta página, se describe la configuración de acciones y parámetros para intents, y cómo se utilizan cuando los intents coinciden en el tiempo de ejecución.

Cuando compilas un agente con la consola (común), puedes acceder a esta configuración desde los datos del intent. Si compilas un agente con la API (poco común), consulta la referencia de intents.

Captura de pantalla de campos de acción y parámetros

Acciones

El campo de acción es un campo de conveniencia sencillo que ayuda a ejecutar la lógica en tu servicio.

Cuando compilas un agente, puedes configurar este campo con cualquier texto que te resulte útil.

Cuando un intent coincide en el tiempo de ejecución, Dialogflow proporciona el valor de acción a tu solicitud de webhook de entregas o la respuesta de interacción de la API. Se puede utilizar para activar lógica específica en tu servicio.

Parámetros

Cuando un intent coincide en el tiempo de ejecución, Dialogflow proporciona los valores extraídos de la declaración de usuario final como parámetros. A diferencia de la entrada sin procesar del usuario final, los parámetros son datos estructurados que se pueden usar fácilmente para realizar alguna lógica o generar respuestas.

Cuando compilas un agente, puedes controlar cómo se extraen los datos mediante anotaciones de texto en tus frases de entrenamiento y la configuración de los parámetros asociados.

En la siguiente lista, se muestran los campos de una configuración de parámetros. Se incluyen ejemplos de la frase de entrenamiento "reservar una habitación el martes", en la que se anota "martes".

  • Obligatorio (Required): Marca esta casilla si se requiere el parámetro para completar el intent. Consulta la sección Rellena ranuras con parámetros obligatorios a continuación.
  • Nombre del parámetro (Parameter Name): Nombre que identifica el parámetro. Ejemplo: date.
  • Entidad (Entity): Tipo de entidad asociado con el parámetro. Ejemplo: @sys.date.
  • Valor (Value): El valor del parámetro es un identificador que se usa para hacer referencia a los valores extraídos establecidos en el tiempo de ejecución. Consulta la sección Usa valores de parámetros en respuestas a continuación. Ejemplo: $date.
  • Es lista (Is List): Marca esta casilla si los valores extraídos deben mostrarse como una lista. Consulta la sección Lista de parámetros a continuación.
  • Mensajes (Prompts): Preguntas que el agente formulará al usuario final si no se proporcionó este parámetro. Este campo solo se usa si el campo Obligatorio (Required) está marcado. Consulta la sección Rellena ranuras con parámetros obligatorios a continuación.
  • Valor predeterminado: Valor por defecto del parámetro cuando el usuario final no proporciona un valor. Para cambiar el valor predeterminado con la consola, debes desplazarte sobre la fila de parámetros y hacer clic en el menú de la derecha.

Si compilas un agente con la consola, los parámetros se crean automáticamente cuando agregas frases de entrenamiento que contienen texto que puede coincidir con una entidad existente. Puedes editar estos parámetros creados automáticamente según sea necesario.

Cuando compilas un agente con la API, debes anotar las frases de entrenamiento y configurar los parámetros de forma manual. Consulta los tipos TrainingPhrase y Parameter en la referencia de intents. El campo Part.alias asocia anotaciones de frases de entrenamiento con parámetros particulares.

Cuando un intent coincide en el tiempo de ejecución, Dialogflow proporciona datos de parámetros a tu solicitud de webhook de entregas o la respuesta de interacción de la API. Estos se proporcionan como una asignación de nombres de parámetros a los valores extraídos determinados por los tipos de entidad asociados.

Cuando compilas un agente, tus respuestas pueden incluir valores extraídos. Consulta Usa valores de parámetros en respuestas a continuación.

Lista de parámetros

Cuando compilas un agente con la consola, si marcas la opción Es lista (Is List), el parámetro se configura como una lista. Las listas pueden contener varios elementos. Por ejemplo, un agente de pedido de productos agrícolas puede esperar las siguientes declaraciones de un usuario final:

  • "Quiero manzanas".
  • "Quiero manzanas y naranjas".
  • "Quiero manzanas, naranjas y bananas".

Usa valores de parámetros en respuestas

El campo de valor de parámetro es un identificador que hace referencia a los valores extraídos de una declaración en tiempo de ejecución. Es similar a un nombre de variable.

Cuando se compila un agente, el valor del parámetro se puede usar para hacer referencia a los valores extraídos en las respuestas. Esto es útil para resumir la información proporcionada por el usuario final. Por ejemplo, la respuesta de tu intent podría ser: "De acuerdo, reservé una habitación para ti el $date".

Haz referencia a valores originales extraídos

Cuando el texto coincide con una entidad en particular, a menudo se convierte en texto que es más conveniente para el procesamiento. Por ejemplo, la palabra "manzanas" en una declaración de usuario final se puede extraer como "manzana" para una entidad de fruta.

Para hacer referencia al valor extraído exactamente como lo proporcionó el usuario final, agrega .original al valor del parámetro. Por ejemplo, podrías hacer referencia al valor extraído original del parámetro de fecha como $date.original.

Haz referencia a valores extraídos de entidades compuestas

Las entidades compuestas son entidades que hacen referencia a otras subentidades.

Para hacer referencia al valor extraído de la subentidad de un parámetro, agrega .<sub-entity name> al valor del parámetro. Por ejemplo, si el valor del parámetro es "$move" y el nombre de la subentidad es "direction", puedes hacer referencia al valor extraído como $move.direction.

Haz referencia a valores extraídos de contextos

Los contextos pueden servir como almacenamiento temporal para los valores extraídos de los parámetros. Para hacer referencia a un valor extraído de un contexto activo, proporciona el nombre del contexto y, luego, el nombre del parámetro, de la siguiente manera: #context_name.parameter_name.

Haz referencia a un parámetro de evento

Para hacer referencia a un parámetro de evento, usa el siguiente formato: #event_name.parameter_name.

Rellena ranuras con parámetros obligatorios

Cuando compilas un agente, puedes marcar los parámetros como obligatorios. Un intent no está completo hasta que el usuario final haya suministrado datos para cada uno de estos parámetros obligatorios.

Captura de pantalla de campos de parámetros obligatorios

Cuando un intent coincide en el tiempo de ejecución, el agente de Dialogflow continúa recopilando información del usuario final hasta que el usuario haya proporcionado datos para cada uno de los parámetros obligatorios. Este proceso se llama relleno de ranuras.

Dialogflow no envía una solicitud de webhook de entregas hasta que haya recopilado todos los datos obligatorios del usuario final, a menos que esté habilitado el webhook para el relleno de ranuras.

Dialogflow no envía una respuesta de interacción de la API hasta que haya recopilado todos los datos obligatorios del usuario final.

Cuando compilas un agente, proporcionas mensajes que el agente utilizará para obtener datos de parámetros del usuario final. También puedes proporcionar variaciones de los mensajes, para que el agente no haga siempre la misma pregunta.

Captura de pantalla de mensajes de parámetros

Por ejemplo, considera que tu agente de tienda de ropa tiene un intent con parámetros obligatorios para los siguientes elementos:

  • tipo de ropa
  • cantidad
  • talla
  • color

Completar un intent podría ser algo parecido a lo siguiente:

Usuario: Me gustaría comprar una camiseta.
Agente: ¿Cuántas quieres?
Usuario: Tres.
Agente: ¿Qué color te gustaría?
Usuario: Negro.
Agente: ¿En qué talla?
Usuario: Mediana.
Agente: Entendido, son tres camisetas negras de talla mediana.

Si el usuario final proporciona datos para más de un parámetro en una sola declaración, Dialogflow recopila los datos proporcionados y continúa solicitando los datos faltantes. Por ejemplo, el usuario final puede decir: "Me gustaría comprar tres camisetas negras". Dialogflow le preguntará al usuario acerca de la talla.

Ordena los parámetros

Cuando compilas un agente, puedes ordenar los parámetros, lo que determina el orden en el que el agente solicitará al usuario final los datos que faltan.

Si compilas un agente desde la consola, al desplazarte sobre un parámetro se mostrará un ícono de reordenamiento a la derecha. Puedes arrastrar este ícono para cambiar la posición del parámetro en la lista.

Haz referencia a valores extraídos en mensajes

Cuando compilas un agente, puedes hacer referencia a los valores extraídos en los mensajes, pero solo si estos valores corresponden a los parámetros obligatorios antes del mensaje. Por ejemplo, si el parámetro de "color" está antes que el parámetro de "talla", puedes usar el siguiente mensaje para el parámetro de "talla": How many $color t-shirts would you like to buy?

Cancela el relleno de ranuras

Cuando el usuario final dice una frase de salida como "Cancelar", "Detener", "Suficiente", etc., el agente responde "Bueno, cancelado" y borra los contextos de relleno de ranuras.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Dialogflow
Si necesitas ayuda, visita nuestra página de asistencia.