Definir Parámetros

Los datos de entrada recibidos de un usuario durante una conversación con un bot se describen como parámetros de una acción. Si consideramos la ejecución de una acción como algo análogo a completar un formulario, entonces los campos del formulario pueden considerarse como los parámetros de la acción.

Por ejemplo, los parámetros para una acción de crear un evento serían típicamente:

• Título del evento
• Hora de inicio del evento
• Hora de finalización del evento

Los usuarios pueden proporcionar valor a cada uno de estos parámetros de forma conversacional en su lenguaje natural. Según los parámetros configurados para una acción, ConvoKraft comprenderá automáticamente la intención del mensaje y extraerá el valor apropiado de los parámetros.

ConvoKraft usa su capacidad NLP para establecer una coincidencia entre las configuraciones realizadas a la acción y la entrada del usuario en tiempo de ejecución. Convertirá la entrada del usuario en un valor computacional según el tipo de datos declarado del parámetro específico. Discutiremos más sobre los tipos de datos soportados de un parámetro más adelante en esta página. Estos parámetros a su vez se utilizarán en la lógica de negocio para realizar las operaciones requeridas del bot.

Puedes aprender más sobre la implementación y uso de parámetros al crear una acción.

Atributos de un parámetro

En esta sección, discutiremos los diversos atributos de un parámetro en detalle:

1. Nombre del parámetro

   Un nombre válido para el parámetro debe cumplir con los siguientes puntos:

• Comenzar con minúscula
• Solo se permiten números y letras
• Contener un máximo de 50 caracteres
• Debe ser único para cada acción
• Los siguientes nombres no pueden usarse como parámetro, ya que son palabras reservadas en ConvoKraft como userInput, previousParam, additionalParams, sessionData, broadcast, previousUserMsgs, cache, org y user

2. Tipo de parámetro

Puedes elegir el tipo de datos requerido para tu parámetro de la lista de tipos soportados en ConvoKraft:

Para el parámetro de archivo, puedes definir los tipos de archivo soportados de la siguiente manera:

Lista de Selección Única y Múltiple

Para los parámetros de lista de selección única y múltiple, necesitas ingresar la siguiente información adicional:

1. Opciones: Estas son la lista de opciones disponibles de las cuales el usuario puede seleccionar una o múltiples opciones.

   Puedes configurar las opciones de forma estática sin usar código. Se recomienda dar a cada opción un valor distinto que pueda ser entendido por el usuario. Cada opción tiene un ID, que se usa para identificar de forma única una opción programáticamente. Puedes ingresar el ID para cada opción manualmente o usar el ID generado automáticamente mientras escribes las opciones. Un nombre e ID válidos para las opciones de la lista de selección deben cumplir con los siguientes puntos:

   • El ID solo soporta caracteres alfanuméricos, guiones y guiones bajos
   • El nombre de la opción puede tener un máximo de 150 caracteres
   • Un parámetro de lista de selección puede tener hasta 50 opciones

2. Botones: Los botones representan las acciones que se ejecutarán sobre las opciones de la lista de selección elegidas. La acción predeterminada es enviar las opciones de la lista de selección seleccionadas, si no se configuran botones personalizados.

   Las propiedades de un botón incluyen las siguientes:

• Label - El texto que se muestra en el botón.

• ID - Un identificador para que la lógica de negocio identifique de forma única qué botón se eligió durante la conversación.

• Theme - El esquema de colores que refleja la apariencia del botón en la conversación. Se soportan los siguientes tres temas.

  1. Positive
  2. Negative
  3. Neutral

  Un nombre e ID válidos para los botones deben cumplir con los siguientes puntos:

• El nombre y el ID de un botón pueden incluir todos los caracteres alfanuméricos y símbolos especiales.

• Pueden contener un máximo de 150 caracteres.

• Un parámetro de lista de selección puede tener hasta tres botones.

3. Permitir valores distintos a estas opciones: Esta opción permite al usuario enviar sus propios valores en lugar de seleccionar de la lista de opciones que definiste. Si esta opción está habilitada, los IDs de dichos valores se establecerán como null.

4. Modo de entrada: Esto especifica la forma en que un usuario puede proporcionar un valor al parámetro. Puede ser Textual o Visual. Si se elige Textual, el usuario podrá escribir el valor preferido que desea asignar al parámetro. En el caso de Visual, el usuario debe seleccionar su entrada de las opciones visuales disponibles. Las opciones se mostrarán como un botón de radio (en caso de selección única), casilla de verificación (en caso de selección múltiple) o un selector de fecha/hora (en caso de rango de fecha/hora).

5. Mensaje de solicitud: La pregunta que el bot le haría al usuario para obtener la entrada del parámetro como parte de una conversación del bot con el usuario. Por ejemplo, para obtener el valor de la hora de inicio de un evento en la acción de crear evento, el mensaje de solicitud podría ser “What time does the event start at?” o “When is the event?”. Este campo no puede dejarse vacío y debe cumplir con los siguientes puntos:

   • Puede incluir todos los caracteres alfanuméricos y símbolos especiales excepto #, /, , &, *, +, = y ().
   • Puede contener un máximo de 255 caracteres.

   Para parámetros que involucran un rango, el campo de mensaje de solicitud se divide en:

   • Start of the Range: Mensaje de solicitud para obtener el valor de inicio del rango.
   • End of the Range: Mensaje de solicitud para obtener el valor final del rango.

6. Mensaje de solicitud en caso de fallo de validación: El mensaje personalizado que se mostrará al usuario cuando la entrada del usuario sea inválida para el parámetro solicitado. Este campo es opcional.

7. Permitir omitir: Permite al usuario omitir la respuesta de un parámetro mientras conversa con un bot.

Definir un parámetro

En esta sección, discutiremos algunos escenarios de ejemplo para explicar el uso de parámetros en una acción de ConvoKraft:

• Consideremos un escenario donde el usuario necesita iniciar una solicitud de devolución para un pedido en línea. El usuario diría algo como esto:

“I would like to return my order”

“Return my order”

“Return this product and request refund”

Puedes crear un parámetro order id para obtener los detalles del usuario al iniciar una solicitud de devolución y asociar el parámetro con cualquier frase en tus invocaciones de ejemplo. De modo que cuando el usuario consulte sobre la devolución, el bot solicitará inmediatamente el número de pedido.

• Discutamos otro escenario para programar una reunión en el calendario.

El usuario escribiría algo como esto:

“Schedule a meeting in my calendar at 5pm tomorrow”

“Add a meeting for tomorrow”

En este caso, puedes crear parámetros como eventname(String), eventtype(Single selection list), eventdays(Multi-selection list), eventtime(Date/Time Range).

Para aprender sobre la configuración de un parámetro al crear una acción para tu bot de ConvoKraft, consulta crear una acción.