Cómo construir un agente de IA reactivo en Jitterbit Harmony
Introducción
Esta guía muestra cómo construir un agente de IA básico en Jitterbit Harmony usando Studio. Este agente responde a consultas de usuarios utilizando un modelo de lenguaje grande (LLM) sin memoria o herramientas avanzadas.
Consejo
Para propósitos de aprendizaje, consulta el Agente Reactivo proporcionado a través de Jitterbit Marketplace para una implementación de esta guía.
Construir un agente de IA reactivo
-
Crea un nuevo proyecto de Studio:
- Inicia sesión en el portal de Harmony y selecciona Studio > Proyectos.
- Haz clic en Nuevo Proyecto. Se abre un diálogo Crear Nuevo Proyecto.
- En el diálogo, ingresa un Nombre del proyecto como
AI Agent - Basic, selecciona un entorno existente y luego haz clic en Comenzar a Diseñar. Se abre el diseñador de proyectos.
-
Crea el flujo de trabajo de entrada principal y la API personalizada de Jitterbit. Este flujo de trabajo está diseñado para recibir consultas de usuarios de Slack u otra interfaz a través de la API. Para crear el flujo de trabajo de entrada principal y la API:
-
En el diseñador de proyectos, haz doble clic en el nombre del flujo de trabajo predeterminado y renómbralo a
Main Entry - API Request Handler. -
En la pestaña Puntos finales y conectores del proyecto de la paleta de componentes de diseño, bajo la categoría Puntos finales disponibles, haz clic en API para mostrar los tipos de actividades que se pueden crear. Luego haz clic y arrastra el tipo de actividad Solicitud a la zona de colocación en el lienzo de diseño.
-
Haz doble clic en el nombre de operación predeterminado y renómbralo apropiadamente, por ejemplo como
Slack Bot Request. -
Coloca el cursor a la derecha de la actividad API Request, haz clic en la zona de colocación y selecciona Nueva Transformación. Se abre una pantalla de configuración.
-
Crea esquemas de origen y destino según corresponda y asigna campos dentro de la transformación de acuerdo con tus datos y caso de uso. Consulta el Agente Reactivo proporcionado a través de Jitterbit Marketplace para ver ejemplos de transformación de datos.
-
Haz clic en el menú acciones de la operación y selecciona Desplegar > Desplegar.
-
Crea una API personalizada de Jitterbit para aceptar y analizar cargas de consultas de usuarios:
- Haz clic en el menú acciones de la operación y selecciona Publicar como API o selecciona Publicar como API usando IA.
- Mantén la configuración predeterminada excepto por lo siguiente:
- Método:
POST - Tipo de Respuesta:
Variable del Sistema
- Método:
- Conserva la URL del servicio de la API publicada.
-
Crea operaciones adicionales para responsabilidades del manejador de solicitudes (preprocesamiento específico de la interfaz).
Para puntos de entrada basados en interfaz de usuario como Slack, el manejador de solicitudes es responsable de realizar todas las validaciones específicas de la interfaz antes de invocar la lógica principal de IA. Por ejemplo, el manejador de Slack debe detectar y procesar tipos de eventos específicos de Slack:
-
Verificación de URL: Cuando Slack envía una solicitud de
challengepara la verificación de URL de la API de Eventos, el manejador debe validar el token y devolver la respuesta del desafío. Esta operación no representa una consulta de usuario y, por lo tanto, no debe invocar el flujo de trabajo de IA. -
Filtrado de mensajes de bot: Si el evento entrante se origina desde el bot de Slack mismo, el manejador debe ignorar la solicitud y terminar el procesamiento para prevenir bucles recursivos.
-
Enrutamiento de consulta de usuario: Solo cuando la solicitud represente un mensaje de usuario válido, el manejador debe transformar la carga útil de Slack al formato de solicitud estandarizado interno y reenviarlo a la lógica principal de IA.
-
Al asegurar que todas las verificaciones específicas de la plataforma ocurran dentro del manejador de interfaz de usuario, la lógica principal de IA permanece completamente desacoplada de Slack y otras interfaces, permitiendo que interfaces alternas (Microsoft Teams, API REST, aplicación web, etc.) sigan el mismo contrato estandarizado sin modificar flujos de trabajo de IA principales.
-
-
Crea el flujo de trabajo principal de la lógica de IA. El propósito de este flujo de trabajo es manejar llamadas a LLM y devolver respuestas. Para crear el flujo de trabajo principal de la lógica de IA:
-
Haz clic en Agregar nuevo flujo de trabajo en la parte superior del lienzo de diseño para crear un nuevo flujo de trabajo.
-
Haz doble clic en el nombre predeterminado del flujo de trabajo y cámbialo a
Main - AI Agent Tools Logic. -
Usa un conector LLM nativo para crear un punto final que se conecte al servicio LLM que estés utilizando. En la pestaña Puntos finales y conectores del proyecto de la paleta de componentes de diseño, bajo la categoría Puntos finales disponibles, haz clic en el punto final para mostrar sus tipos de actividad, luego arrastra una actividad a la zona de colocación en el lienzo de diseño y haz doble clic en ella para configurarla.
-
Crea transformaciones de solicitud y respuesta pasando el cursor junto a la actividad recién creada en cualquiera de los lados, haciendo clic en la zona de colocación y seleccionando Nueva transformación. En la pantalla de configuración que se abre, asigna las entradas de solicitud para la actividad en la transformación del lado izquierdo, y asigna la respuesta de LLM a una salida estructurada en la transformación del lado derecho. Consulta el Agente Reactivo para ver un ejemplo.
-
Envía la respuesta de LLM de vuelta a la API de Slack o a cualquier otra interfaz que inició la llamada al flujo de trabajo
Main Entry - API Request Handler.
-
-
Conecta los dos flujos de trabajo para que el flujo de trabajo de la lógica de IA principal reciba la consulta del usuario desde el flujo de trabajo de entrada principal:
-
Vuelve al flujo de trabajo
Main Entry - API Request Handler. -
Agrega un script para llamar al flujo de trabajo de lógica de IA:
- Haz clic en una zona de colocación de operación y selecciona Nuevo script.
- Configura el script para ejecutar la operación en el flujo de trabajo
Main - AI Agent Tools Logicusando la funciónRunOperation. Para ver un ejemplo, consulta el scriptCall AI Workflowen el Agente Reactivo.
-
-
Haz clic en el menú acciones del proyecto y selecciona Implementar proyecto.
Próximos pasos
Para ampliar el agente de IA básico, consulta Crear un agente de IA contextual.
