---
title: Los agentes IA
description: "--- ## 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.…"
url: "https://www.kafinea.com/es/documentacion/configuracion/los-agentes-ia/"
updated: "2026-04-13"
category: Configuración
---

# Los agentes IA

---

## 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.

---

## Referencias asociadas

- [El chat de IA](/205_intelligence-artificielle/020_le-chat-ia.md)
- [El asistente de texto de IA](/205_intelligence-artificielle/010_lassistant-de-texte-ia.md)
- [Los flujos de trabajo de IA](/205_intelligence-artificielle/030_les-workflows-ia.md)
- [Conectar una IA externa (MCP)](/205_intelligence-artificielle/040_connecter-une-ia-externe-mcp.md)
- [El OCR de facturas asistido por IA](/205_intelligence-artificielle/050_locr-de-factures-assiste-par-ia.md)
- [El servidor MCP](https://www.kafinea.com/es/documentation/configuracion/el-servidor-mcp/)