Introducción #
El Explorador de Agentes IA es la interfaz de administración que permite supervisar la actividad de los agentes IA en Kafinea. Ofrece una vista consolidada de las ejecuciones (runs), las estadísticas de uso y los costes asociados.
Esta página está reservada para los administradores y los administradores restringidos.
1. Acceso #
Acceda al explorador a través de Parámetros > Extensiones > Explorador de Agentes IA.
2. Panel de estadísticas #
La parte superior de la página muestra un panel de control sintético con:
- Número total de runs: número de ejecuciones de agentes IA
- Coste estimado: coste total estimado en función de los tokens consumidos
- Tokens utilizados: desglose entre tokens de prompt (entrada) y tokens de completado (salida)
- Estadísticas por periodo: desglose mensual o semanal
3. Lista de ejecuciones #
La lista paginada muestra cada ejecución de agente IA con la siguiente información:
| Columna | Descripción |
|---|---|
| Run ID | Identificador único de la ejecución |
| Agente | Nombre del agente que ha realizado la ejecución |
| Modelo | Modelo de IA utilizado (ej.: gpt-4, claude-3, etc.) |
| Usuario | El usuario de Kafinea que ha activado la ejecución |
| Estado | Estado de la ejecución: running, completed, failed |
| Tokens | Número de tokens de prompt / completado / total |
| Coste | Coste estimado de la ejecución |
| Duración | Tiempo de ejecución |
| Fecha | Fecha y hora de inicio |
4. Filtros #
Puede filtrar la lista de ejecuciones por:
- Estado: running, completed, failed
- Agente: nombre del agente
- Modelo: modelo de IA utilizado
- Usuario: usuario que ha activado la ejecución
5. Detalle de una ejecución #
Al hacer clic en una ejecución, accederá al detalle que incluye:
- El resumen de la entrada (prompt enviado)
- La lista de eventos (pasos intermedios del agente)
- La respuesta generada
- Las métricas detalladas (tokens, coste, duración)
6. Herramientas disponibles para los agentes #
Los agentes IA disponen de un conjunto de herramientas que les permiten interactuar con los datos de Kafinea:
- Búsqueda: buscar registros en los módulos
- Lectura: consultar el detalle de un registro
- Navegación: recorrer las relaciones entre registros
- Análisis: calcular agregados o estadísticas
- Creación: crear nuevos registros (requiere el interruptor Beta)
- Modificación: actualizar registros existentes (requiere el interruptor Beta)
- Eliminación: eliminar registros (requiere el interruptor Beta)
Nota: Los agentes respetan los derechos de acceso del usuario que activa la ejecución. Las herramientas de creación, modificación y eliminación solo están disponibles si la opción (Beta) Autorizar al Agente IA a modificar los datos está activada en Parámetros > Funcionalidades.
7. Configuración #
La configuración de los agentes IA se gestiona en los archivos de configuración de Kafinea:
- Clave API: configurada en los parámetros de la pasarela IA
- Feature flags: activación/desactivación de las funcionalidades de IA
- Modelos disponibles: lista de modelos de IA utilizables
Importante: La modificación de estos parámetros requiere acceso al servidor.
FAQ #
¿Cómo ver cuánto cuesta el uso de la IA?
El panel del explorador muestra el coste estimado por ejecución y el coste total. Estas estimaciones se basan en el número de tokens consumidos.
¿Puede un agente modificar datos?
Los agentes de tipo flujo de trabajo (VTMdsPromptAITask) pueden actualizar los campos configurados en el mapeo. El chat de IA puede crear, modificar y eliminar registros únicamente si la opción (Beta) Autorizar al Agente IA a modificar los datos está activada en Parámetros > Funcionalidades. Cuando esta opción está desactivada, el chat de IA funciona en modo de solo lectura.