Modelos de Acción

Un bot de ConvoKraft puede configurarse para realizar acciones mientras conversa con el usuario. Una acción de un bot se caracteriza por sus oraciones de ejemplo, parámetros y bot logic. Las acciones configuradas para responder con una respuesta directa se definen con sus oraciones de ejemplo relevantes. Por otro lado, las acciones que ejecutan bot logic pueden requerir entradas del usuario para realizar ciertas operaciones, lo que requiere que configures parámetros para las acciones junto con las oraciones de ejemplo.

Oraciones de ejemplo

Las oraciones de ejemplo son las invocaciones de ejemplo que los usuarios finales dirían para invocar una acción particular en su lenguaje conversacional. Estas oraciones de ejemplo ayudan a mejorar la inteligencia de ConvoKraft para comprender mejor la entrada del usuario.

A continuación se enumeran algunas oraciones de ejemplo típicas que pueden configurarse para crear un evento:

• “Create an event”
• “Schedule a meeting”

En la práctica, los usuarios mencionarán datos como parte de las instrucciones de invocación, por lo que las oraciones de ejemplo también pueden incluir ciertos valores de parámetros. Como en los ejemplos a continuación, un usuario puede mencionar el título del evento, la hora de inicio y la hora de finalización como parte de su oración de invocación inicial al intentar programar un evento.

• “Create an event from 5 PM to 6 PM to discuss about the Zylker deal.”
• “Schedule a meeting with John at 5 PM.”

Si la oración de invocación no contiene todos los parámetros requeridos, el bot solicitará al usuario esos valores de parámetros requeridos.

Las oraciones de ejemplo definen la intención de una acción particular, y los parámetros definen las entidades que serían necesarias para cumplir esa acción. Así, el modelo de datos de cualquier acción de ConvoKraft se obtiene usando la combinación de oraciones de ejemplo y parámetros.

Para aprender más sobre las oraciones de ejemplo y su importancia en la configuración de acciones, consulta esta página.

Params

Los parámetros son los datos de entrada necesarios para cumplir o ejecutar una acción. Por ejemplo, los parámetros de una acción configurada para crear un evento en tu calendario serían típicamente el título del evento, la hora de inicio, la hora de finalización, el lugar del evento, y más.

Para aprender más sobre los parámetros y sus tipos, consulta aquí.

Bot logic

El flujo conversacional y la ejecución de una acción depende de la lógica de negocio (o bot logic) definida para ella. ConvoKraft soporta las siguientes plataformas de desarrollo para definir el bot logic de una acción:

• Catalyst Functions
• Deluge Functions
• Webhooks

Todos los parámetros declarados de una acción se pasan a la lógica de negocio para ejecutar la acción. Además de los parámetros declarados, otros datos del entorno (como detalles sobre el usuario o la aplicación cliente) que serían necesarios para ejecutar la lógica de negocio también se pasarán como argumentos de entrada a estas funciones.

1. Catalyst Functions

Las Catalyst Functions son estructuras de código personalizadas que contienen la lógica de negocio compleja de tu aplicación de Catalyst. Las Catalyst Integration Functions te permiten codificar y usar una función de Catalyst como backend de otros servicios de Catalyst o Zoho y establecer una integración con ellos. Cuando invocas la acción en ConvoKraft, esta invocará automáticamente la Integration Function configurada a través de una llamada HTTP.

Al usar Catalyst Functions, tu lógica de negocio puede definirse en los siguientes entornos de programación:

• Java
• Node.js
• Python

Puedes crear una Catalyst Function navegando al servicio Serverless en tu consola o incluso usar el Catalyst CLI para crear y codificar tus funciones desde el entorno local.

Las Catalyst Functions son altamente escalables y eficientes. La infraestructura del servidor en la que se alojan las funciones es manejada completamente por Catalyst, eliminando la necesidad de que gestiones el backend y permitiéndote solo trabajar en el desarrollo de la lógica de negocio. Además de proporcionar backends potentes para tus aplicaciones, las Catalyst Functions son robustas y confiables por naturaleza, proporcionando una integración fluida con ConvoKraft.

Para aprender más sobre el uso de Catalyst Functions para definir la lógica de negocio de tus acciones de ConvoKraft, consulta aquí.

2. Deluge Functions

Deluge es el lenguaje de scripting en línea nativo del entorno en la nube de Zoho. Tiene una sintaxis amigable que permite una integración fluida entre dos servicios de Zoho, o con un servicio de terceros.

La lógica de negocio de las acciones de ConvoKraft debe escribirse en Deluge a través de las siguientes plantillas de funciones predefinidas:

• Execution (obligatoria): Esta es la función principal involucrada en la ejecución de todas las acciones de un bot de ConvoKraft.

• Context Handler (opcional): Esta función se invoca para cada entrada del usuario durante una acción. Puede usarse para cambiar el orden de los parámetros en el flujo conversacional, omitirlos si es necesario, o incluso realizar validaciones personalizadas.

• Button Click (opcional): Esta función puede usarse para definir la lógica de negocio de una tarjeta de botón. Es parte del tipo de función de ejecución que se enfoca en la implementación de botones personalizados.

Estas funciones se alojan en la nube de Zoho y se ejecutarán en sus respectivos puntos de invocación durante la ejecución de una acción. Similar a las Catalyst Functions, las funciones de Deluge también son altamente eficientes, y su alojamiento y mantenimiento son manejados completamente por Zoho. Puedes aprender más sobre el uso de funciones de Deluge para definir la lógica de negocio de tus acciones de ConvoKraft aquí.

3. Webhooks

En el caso de los webhooks, puedes codificar la lógica backend en una plataforma externa e invocarla a través de los webhooks configurados dentro de ConvoKraft. La lógica de negocio de las acciones debe construirse, gestionarse y alojarse externamente en un servidor público que sea accesible para ConvoKraft. Se te requerirá usar APIs REST para acceder a la lógica desde los bots que construyas. La URL del Webhook configurada será invocada por ConvoKraft en los puntos de invocación apropiados durante la ejecución de la acción.

Al usar webhooks, tu lógica de negocio puede definirse en cualquier lenguaje de programación conveniente de tu elección. Pero, a diferencia de Deluge y Catalyst Functions, al usar webhooks tendrás que gestionar la configuración y setup de la infraestructura completamente por tu cuenta. Aprende más sobre el uso de webhooks para definir la lógica de negocio de tus acciones de ConvoKraft en esta página.