Agentes IA
Agentes IA
El ecosistema CreaRackSL tiene 5 tipos distintos de agentes IA, cada uno con su sitio, su modo de invocación y su modelo. Esta página describe qué son los agentes IA y cómo encajan los 5 tipos.
Actualizado en la auditoría s185 (02-07-2026): los “agentes” del workspace (
agents/) son plantillas de rol para el connector claude.ai, distintas de las fichas técnicas de dominio que Claude Code consulta de verdad. Se auditó el uso real y se podó el conjunto (ver §Auditoría abajo).
📖 Esta página es la introducción.
- Para la arquitectura interna detallada: [[workspace—producto—workspace-agentes]]
- Para los 8 agentes técnicos de dominio de CreaRack-Pro (los que se usan de verdad): [[crearack-tech—agents-overview]]
- Para las routines remotas Anthropic: [[workspace—agentes-remotos-anthropic]]
- Para los procesos automáticos del Bibliotecario: [[ia-tech—automatismos—metodo—bibliotecario-procesos]]
- Para los agentes IA dentro del producto (Gemma para Auto-Plan, CNS, etc.): [[ia-tech—roles—producto-crearack-pro]]
Que es un agente IA
Un agente IA es un programa que entiende instrucciones en lenguaje natural, tiene herramientas (tools) para ejecutar acciones reales, tiene un rol definido que limita su ámbito, y puede colaborar con otros agentes y con el equipo. No son chatbots genéricos — son especialistas con acceso a los sistemas reales de CreaRack.
Los 5 tipos de agentes en CreaRackSL
| Tipo | Qué es | Dónde corre | Cómo se dispara | Salud (s185) |
|---|---|---|---|---|
| 1 · Plantillas de rol del connector (BIZ/DEV/SUPPORT/OPS) | Prompts-descripción de rol en workspace/agents/ | claude.ai / referencia | Mensaje del usuario | ⚠️ Podado s185 — cero uso medido; ver §Auditoría |
2 · Fichas técnicas de dominio (8, context/agents/) | Referencia que Claude Code CLI lee antes de tocar un módulo | PC del dev (Edu/Dani/Txell) | Carga bajo demanda | 🟢 Vivas y mantenidas (mayo-jun) |
| 3 · Agentes Claude Code reales (design-collaborator, vigia) | Agentes de trabajo del harness | Claude Code (subagentes) | Invocación en sesión | 🟢 Uso real intenso |
| 4 · Procesos Bibliotecario (crons) | Mantenimiento del grafo/wiki | Hetzner STAGE (Super-Cron) | Schedule | 🟢 Operativo |
| 5 · Agentes IA del producto (Gemma + Claude Haiku) | IA integrada del SaaS (Auto-Plan, CNS, Help) | App / Local Agent | Lógica de negocio | 🟢 Operativo |
Total ecosistema IA: <$50/mes (Plan Max del equipo + APIs externas).
Auditoría del equipo de agentes (s185)
Se midió el uso real de cada rol/agente (menciones en sesiones registradas, WORKLOG + LOG) y la veracidad de su definición contra el código actual. Resultado: los agentes de trabajo reales son las 8 fichas de dominio (Tipo 2) + design-collaborator y vigia (Tipo 3). Las plantillas de rol del connector (agents/) tenían cero invocaciones medidas en 3 meses.
Podados a agents/_archive/ (8, con su porqué en el README de esa carpeta):
- 6
dev-*(dev-backend/-devops/-frontend/-mcp/-qa/-vision) — copia rancia de las fichas decontext/agents/, que sí se mantienen. Citaban ramadevelop, DeepSeek, “43 tools” (hoy ~100+). Fuente dev única =context/agents/. support-l2— peligroso: instruía sobre Celery/NAPALM/Nginx, las tres inexistentes en el stack real (Huey/scrapli/Traefik).admin-billing— superado porbiz-accounting(Holded MCP real).
Plantillas de rol que quedan (agents/, correctas pero sin uso — material de referencia del connector, no agentes activos): biz-accounting, biz-crm, legal-contracts, legal-rgpd, marketing-content, sales-outbound, sales-demo, support-l1, ops-infra, ops-workspace.
- Candidatas a convertir en skill (su dominio ya lo cubren skills del harness):
marketing-content/sales-outbound/sales-demo↔/roast,/storm,cro-methodology,one-page-marketing,storybrand-messaging.
Fichas técnicas de dominio (Tipo 2 — las que Claude Code usa)
En CreaRack-Pro/context/agents/, apuntadas desde context/STACK.md con la consigna “consultar ANTES de trabajar en un módulo”. Hub: [[crearack-tech—agents-overview]].
| Ficha | Módulo | Estado |
|---|---|---|
dev-core | core/ auth/usuarios/permisos | 🟢 fresca |
dev-auto-provision | Auto-Provision / network | 🟢 fresca |
dev-cns | CNS / Edge Intelligence / ITSM | 🟢 |
dev-map-editor | Map Editor / Auto-Plan | 🟢 |
dev-terminal | Terminal Hub / Local Agent | 🟢 |
dev-rack-editor | Rack Editor / Konva | 🟢 |
dev-observatory | Network Observatory / VictoriaMetrics | 🟡 a refrescar (abr) |
dev-signage | Digital Signage CMS | 🟡 a refrescar (pre-EPIC F5/F6) |
Agentes Claude Code reales (Tipo 3)
| Agente | Para qué | Uso |
|---|---|---|
design-collaborator (Opus + skills design-*) | UI, decks, prototipos, audits de frontend | 🟢 alto (modal tareas, live_panel…) |
| vigia | Vigilancia de CI/CD tras un push (solo lectura) | 🟢 infra de fondo (Regla 14) |
Protocolo MCP
Los agentes hablan con Workspace vía MCP (Model Context Protocol): expone ~100+ herramientas (bib_*, wiki_*, holded_*, create_task, get_servers_status…) y resources (estado de servidores, tareas, alertas, métricas). Cada rol usa solo las tools de su ámbito.
La Biblioteca
El grafo de conocimiento que conecta código con documentación. Los agentes lo consultan antes de trabajar (bib_ask, bib_context_query) para saber qué existe en cada app, qué documentos se relacionan con un archivo y qué impacto tiene un cambio. Es la memoria colectiva del proyecto.
Interactuar con agentes
Los 3 del staff (Edu, Dani, Txell) trabajan con Claude Code (CLI o desktop), cada uno con su token MCP. Algunos procesos corren por cron (informes, backups); otros reaccionan a eventos (deploy, alerta, commit).
Seguridad
- Cada agente accede solo a las tools que necesita para su rol.
- Las credenciales de servicios externos se gestionan como tokens seguros (ver [[crearack-tech—guides—inventario-de-secretos]]).
- Las acciones quedan en el Activity Log.
- Los agentes nunca ejecutan acciones destructivas sin confirmación humana.
Véase también
- [[workspace—producto—workspace-agentes]] — arquitectura interna del equipo de agentes
- [[crearack-tech—agents-overview]] — hub de las 8 fichas técnicas de dominio (Tipo 2)
- [[workspace—agentes-remotos-anthropic]] — routines remotas Anthropic (Tipo 3)
- [[ia-tech—automatismos—metodo—bibliotecario-procesos]] — procesos del Bibliotecario (Tipo 4)
- [[ia-tech—roles—producto-crearack-pro]] — agentes IA dentro del producto (Tipo 5)
- [[workspace—que-es-workspace]] — qué es Workspace
- [[workspace-tech—tecnico—workspace-technical]] — stack técnico Workspace