Descripción general

Los agentes de IA en SurveyAnalytica son servicios autónomos e implementables que pueden ejecutar lógica personalizada, conectarse a APIs externas, procesar datos e integrarse en flujos de trabajo. Puede crear agentes desde cero usando instrucciones en lenguaje natural, implementarlos como endpoints de API en vivo y conectarlos a sus campañas, encuestas y flujos de trabajo de automatización. Los agentes se gestionan a través del Catálogo de Agentes y pueden crearse mediante el Generador de Agentes con IA.

Navegación a Agentes

En la barra lateral de navegación principal, haga clic en Agents para abrir el Catálogo de Agentes. El catálogo tiene dos pestañas:

• My Agents: Agentes que ha creado o a los que tiene acceso en su espacio de trabajo.
• Templates: Plantillas de agentes prediseñadas que puede usar como punto de partida.

Catálogo de Agentes

El Catálogo de Agentes muestra todos sus agentes con su estado, descripción e información de implementación. Puede:

• Buscar: Filtrar agentes por nombre o descripción.
• Filtrar por estado: Ver todos los agentes, solo los agentes implementados o solo los borradores.
• Crear nuevo agente: Abre el Generador de Agentes.
• Editar: Modificar el código, la configuración o los ajustes de un agente existente.
• Eliminar: Quitar un agente. El sistema verifica si existen flujos de trabajo dependientes antes de la eliminación y le advierte sobre dependencias activas.

Creación de un agente

El Generador de Agentes ofrece un entorno de desarrollo asistido por IA para crear agentes.

Configuración del agente

Al crear un agente, configura:

• Nombre: Un nombre descriptivo para el agente.
• Descripción: Qué hace el agente, utilizada para su descubrimiento y documentación.
• Código: El código de la aplicación del agente. El asistente de IA puede generarlo a partir de descripciones en lenguaje natural.
• Variables de entorno: Pares clave-valor para secretos y configuración (claves de API, endpoints, etc.). Los nombres se convierten automáticamente a mayúsculas y se sanitizan.
• Esquema de entrada/salida: Definiciones de JSON Schema para los formatos de solicitud y respuesta de la API del agente, validadas en tiempo de ejecución.

Generación de código con IA

Describa lo que su agente debe hacer en lenguaje natural, y el asistente de IA genera el código completo de la aplicación. El código generado incluye:

• Configuración del servidor y enrutamiento
• Controladores de endpoints de API
• Validación de entradas
• Integraciones con APIs externas
• Manejo de errores

Base de conocimiento (RAG)

Los agentes pueden mejorarse con una base de conocimiento para Retrieval-Augmented Generation (RAG):

• Extracción de URL: Proporcione URLs y el sistema extrae el contenido de texto, luego lo segmenta en fragmentos optimizados para la recuperación.
• Carga de PDF: Cargue documentos PDF (hasta 10 MB) que se analizan y fragmentan para la recuperación de conocimiento.
• Fragmentación de texto: El contenido se divide automáticamente en segmentos optimizados para el rendimiento de recuperación.

Detección de variables de entorno faltantes

El sistema escanea automáticamente el código del agente en busca de referencias a variables de entorno y le advierte sobre cualquier variable referenciada en el código pero no definida en la configuración. Las variables proporcionadas por la plataforma quedan excluidas de esta verificación.

Implementación de un agente

La implementación crea un endpoint de API en vivo y accesible para su agente:

1. El sistema empaqueta el código y la configuración de su agente.
2. Se compila e implementa un servicio en contenedor en la nube.
3. Las variables de entorno se inyectan de forma segura en el entorno de ejecución.
4. El agente recibe una URL de endpoint única para las llamadas a la API.

Prueba de un agente

Antes o después de la implementación, puede probar los agentes realizando llamadas a la API a través de la interfaz del Catálogo de Agentes. Envíe solicitudes de muestra que coincidan con el esquema de entrada y verifique que las respuestas coincidan con el esquema de salida esperado.

Plantillas de agentes

La plataforma ofrece plantillas de agentes prediseñadas para casos de uso comunes. Las plantillas sirven como puntos de partida que puede personalizar:

• Explore las plantillas disponibles en la pestaña Templates.
• Haga clic en una plantilla para obtener una vista previa de su configuración y código.
• Use una plantilla como punto de partida para un nuevo agente, lo que copia la configuración de la plantilla en el Generador de Agentes para su personalización.

Agentes respaldados por modelos

Los modelos de ML entrenados pueden implementarse automáticamente como agentes. Cuando implementa un modelo como agente (desde la interfaz de Modelos de ML), el sistema:

1. Verifica que el modelo tenga una versión activa válida.
2. Crea un envoltorio de agente alrededor del modelo entrenado para inferencia en tiempo real.
3. Implementa el agente como un endpoint de API en vivo.
4. Vincula el agente de nuevo al registro del modelo para facilitar su gestión.

Agentes en flujos de trabajo

Los agentes se integran en los flujos de trabajo de SurveyAnalytica a través del motor de automatización de flujos de trabajo. Puede:

• Agregar un agente como paso en un flujo de trabajo de campaña
• Activar agentes en función de respuestas de encuestas o eventos de datos
• Encadenar varios agentes en secuencia
• Usar las salidas de un agente como entradas para los pasos posteriores del flujo de trabajo

Gestión del ciclo de vida del agente

• Actualizar: Modificar el código del agente y volver a implementarlo.
• Retirar implementación: Poner el agente fuera de línea mientras se conserva la configuración.
• Eliminar: Eliminar el agente de forma permanente. El sistema advierte sobre cualquier flujo de trabajo dependiente antes de permitir la eliminación.
• Supervisar: Ver los registros de invocación del agente y las métricas de rendimiento.