Introducción
El Explorador de agentes de IA es la interfaz de administración que permite supervisar la actividad de los agentes de IA en Kafinea. Ofrece una vista consolidada de las ejecuciones, las estadísticas de uso y los costes asociados.
Esta página está reservada a los administradores y a los administradores con acceso restringido.
1. Acceso #
Accede al explorador a través de Ajustes > Extensiones > Explorador de agentes de IA.
2. Panel de estadísticas #
En la parte superior de la página aparece un panel de control con:
- Número total de ejecuciones: número de ejecuciones de los agentes de IA
- Coste estimado: coste total estimado en función de los tokens consumidos
- Tokens utilizados: distribución entre tokens de solicitud (entrada) y tokens de finalización (salida)
- Estadísticas por período: desglose mensual o semanal
3. Lista de ejecuciones #
La lista paginada muestra cada ejecución del agente de IA con la siguiente información:
| Columna | Descripción |
|---|---|
| N.º de carrera | Identificador único de la ejecución |
| Agente | Nombre del agente que llevó a cabo la ejecución |
| Modelo | Modelo de IA utilizado (p. ej., GPT-4, Claude-3, etc.) |
| Usuario | El usuario Kafinea ha iniciado la ejecución |
| Estatuto | Estado de la ejecución: en curso, completada, fallida |
| Fichas | Número de tokens de prompt / autocompletado / total |
| Coste | Coste estimado de la ejecución |
| Duración | Tiempo de ejecución |
| Fecha | Fecha y hora de lanzamiento |
4. Filtros #
Puedes filtrar la lista de ejecuciones por:
- Estado: en curso, completado, fallido
- Agente: nombre del agente
- Modelo: modelo de IA utilizado
- Usuario: usuario que ha iniciado la ejecución
5. Detalle de una ejecución #
Al hacer clic en una ejecución, accederás a los detalles, que incluyen:
- Resumen de la entrada (mensaje 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 de 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 los detalles de un registro
- Navegación: explorar 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 inicia la ejecución. Las herramientas de creación, modificación y eliminación solo están disponibles si la opción (Beta) «Permitir que el agente de IA modifique los datos» está activada en Configuración > Funcionalidades.
7. Configuración #
La configuración de los agentes de IA se gestiona en los archivos de configuración de Kafinea:
- Clave API: configurada en los ajustes de la pasarela de IA
- Indicadores de funciones: activación/desactivación de las funciones de IA
- Modelos disponibles: lista de modelos de IA que se pueden utilizar
Importante: Para modificar estos parámetros es necesario tener acceso al servidor.
Preguntas frecuentes n. º
¿Cómo puedo saber cuánto cuesta utilizar la IA?
El panel de control 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 la asignación. El chat de IA puede crear, modificar y eliminar registros únicamente si la opción (Beta) «Permitir que el agente de IA modifique los datos» está activada en «Configuración» > «Funcionalidades». Cuando esta opción está desactivada, el chat de IA funciona en modo de solo lectura.