Agentes IA dentro del producto CreaRack-Pro
Lista de call sites de IA integrados en el producto SaaS CreaRack-Pro. No son agentes Claude conversacionales del equipo — son llamadas a APIs de modelos IA que se ejecutan dentro de la app o del Local Agent del cliente.
📖 Para los agentes del equipo (claude.ai connector, sub-agents Claude Code, routines remotas), ver [[workspace—agentes-ia]] y [[workspace—producto—workspace-agentes]]. Para la política de modelos (qué modelo Gemini usa cada cosa), ver [[decision—20260401—gemini-3-flash-preview]].
Categoría A · Análisis estructurado / visión / extracción JSON crítica
Modelo: gemini-3-flash-preview (FIJO) — Razón: prompt y parámetros (temp 0.1, JSON output, max tokens) están calibrados para este modelo. Cualquier cambio invalida la calibración silenciosamente.
| Agente / Call site | Archivo | Función | Activación |
|---|---|---|---|
| Auto-Plan AI | blueprints/services/autoplan.py | Digitaliza planos de infraestructura. Recibe JPEG (máx 2048px), devuelve JSON con posiciones, tipos de elementos y conexiones. | Map Editor → “Auto-Plan” |
| CNS Explain (Gemini) | monitoring/services/ai_providers/gemini.py | Diagnóstico de anomalías Network Sentinel. Genera summary, likely_cause, risk_level, comandos sugeridos con rollback. | Cuando Local Agent reporta anomalía SNMP/ping/HTTP |
| CNS Tutor | monitoring/services/tutor_service.py | Asistente CCNA-to-CCIE con guardrails de tema. Conversación con histórico + contexto de dispositivo. | Tab “Tutor” del CNS |
| MIB Assistant | network/services/mib_assistant.py | Clasifica OIDs SNMP de MIBs subidas, identifica útiles para deep discovery. | Auto-Provision wizard al subir MIB |
| AI Operations router | core/services/ai_operations.py + core/services/ai_providers/router.py | Multi-provider router para operaciones IA generales. DEFAULT_GEMINI_MODEL apunta a la categoría A. | Endpoints /api/ai/* |
| FinOps Report | core/management/commands/finops_report.py | Genera informe mensual de costes con análisis IA del consumo Hetzner / APIs / etc. | Cron mensual + endpoint /reports/finops |
| Perf Review | core/management/commands/perf_review.py | Performance Review con datos reales de VictoriaMetrics + análisis IA. | Cron mensual + endpoint /reports/perf |
Categoría B · Síntesis de texto / traducción
Modelo: gemini-2.5-flash (estable, no preview) — Razón: estabilidad de comportamiento prima sobre features experimentales. Estos casos son RAG y traducción de prosa, no requieren capacidades de un preview.
| Agente / Call site | Repo | Archivo | Función |
|---|---|---|---|
| Archivo Maestro síntesis | workspace | functions/api/mcp/handlers/archivo-core.ts | RAG sobre toda la wiki Supercontexto: recibe pregunta + chunks rankeados (embeddings bge-m3), sintetiza respuesta con fuentes. Es el motor del MCP tool bib_ask. |
| Wiki traducción ES→EN (live) | workspace | functions/api/wiki/translate.ts | Traducción on-demand de pages al inglés cuando un usuario abre la wiki en EN. |
| Wiki traducción ES→EN (batch) | workspace | scripts/translate-wiki.mjs | Traducción pre-build de todo el corpus, ejecutada en CF Pages Deploy. |
Categoría C · Edge Intelligence (Local Agent)
Vive en el binario CreaRackAgent.exe v2.0.19 que cada cliente instala en su red. Modelos invocados sobre datos locales antes de mandar al SaaS.
| Componente | Archivo | Función |
|---|---|---|
| AnomalyDetector | terminal/agent/sentinel/anomaly_detector.py | Detección por umbrales (no IA): packet loss > 10%, latency > 200ms, CRC errors > 100/min, client drop > 30%, interface down. Dispara InsightReporter cuando hay match. |
| InsightReporter | terminal/agent/sentinel/insight_reporter.py | Queue async + JWT POST al SaaS. Lleva metadata de anomalía + datos crudos. El SaaS los recibe en /sentinel/insights/ y allí Gemini hace el explain. |
| AI Remediation | terminal/agent/network/ai_remediate.py | Ejecuta comandos AI-recommended via Scrapli (Cisco/Arista/Juniper) cuando operador pulsa “Apply” en CNS. Usa whitelist por vendor. |
Categoría D · Alternativos (Anthropic Claude)
Modelo: claude-haiku-4-5-20251001 — alternativo a Gemini para Edge Intelligence. Activable por env var.
| Componente | Archivo | Cuándo se usa |
|---|---|---|
| CNS Explain (Claude) | monitoring/services/ai_providers/claude.py | Cuando EDGE_AI_PROVIDER=claude en settings. Mismo contrato que provider Gemini. Útil si Gemini falla o se compara calidad. |
Modelos prohibidos (drift = bug)
gemini-2.0-flash: deprecated por Google, devuelve 404. Cualquier referencia es bug latente.gemini-latestu otros alias dinámicos: contraviene política de pin de versiones (Regla 9 patrones de despliegue + Regla 8 modelos IA en CLAUDE.md).
Cualquier cambio de modelo en cualquier call site requiere actualizar en el mismo commit:
- La tabla canónica de modelos en [[decision—20260401—gemini-3-flash-preview]].
- La nota expandida de la Regla 8 en
CreaRack-Pro/CLAUDE.md. - Esta página si afecta a un call site listado.
Política de fallback y multi-provider
core/services/ai_providers/router.py implementa router con prioridad:
Auto-Plan / CNS Explain / Tutor → Gemma 4 (gemma-4-26b-a4b-it, Google AI Studio) — primario único (Regla 8)
→ Claude Haiku 4.5 (fallback deliberado, chain ai_fallback)
→ Static rules (último recurso, sin IA)Diagnosis Validator (sensor computacional, [[crearack-tech—method—harness-guide]] § Apéndice) corre tras cada respuesta IA en CNS antes de persistir AIInsight. 7 checks pre-persistencia.
CNS Feedback Loop (Huey cada 6h) extrae patrones aprendidos de conversaciones humano→IA y los inyecta en StaticRulesProvider ANTES de las reglas hardcoded. Aprendizaje continuo sin reentrenamiento.
Comparación con otros agentes del ecosistema
| Tipo | Dónde corre | Modelo | Activación | Coste |
|---|---|---|---|---|
| Agente IA del producto (esta page) | App CreaRack-Pro o Local Agent del cliente | Gemini 3 Flash Preview / Gemini 2.5 Flash / Claude Haiku | Lógica de negocio del SaaS | API por llamada (variable) |
| Cron Bibliotecario | GitHub Actions workspace | Haiku / Sonnet | Schedule | API por run · ver [[ia-tech—automatismos—metodo—bibliotecario-procesos]] |
| Routine remota Anthropic | Cloud Anthropic | Sonnet / Haiku | Cron remoto | API por run · ver [[workspace—agentes-remotos-anthropic]] |
| Sub-agent Claude Code | PC del dev | Opus / Sonnet | Tool Agent interactivo | Plan Max |
| Agente claude.ai connector | claude.ai | Haiku / Sonnet / Opus | Mensaje del usuario | Plan Max |
Coste estimado mensual (a 27-04-2026)
| Categoría | Coste mensual aprox |
|---|---|
| Categoría A · Gemini 3 Flash Preview (Auto-Plan + CNS + tutor + reports) | ~$15-25/mes |
| Categoría B · Gemini 2.5 Flash (Archivo Maestro + wiki translate) | ~$5/mes |
| Categoría C · Edge Intelligence Local Agent | $0 (lógica local sin IA, solo umbrales) |
| Categoría D · Claude Haiku alternativo | $0 (no activado por defecto) |
| Total ecosistema producto | ~$20-30/mes |
Sumado al coste del workspace (Bibliotecario ~$2-5/mes + routines ~$0.70/mes) y operaciones del equipo (Plan Max), el coste IA total CreaRackSL es <$50/mes.
Histórico
- 18-02-2026 (v1.0.0) · primera release con Auto-Plan AI (Gemini 2.0 Flash inicialmente).
- 10-03-2026 (v1.0.34) · CNS Phase 5 con Claude Haiku como provider alternativo.
- 21-04-2026 · ADR multi-modelo
decision--20260401--gemini-3-flash-previewformaliza categorías A y B. - 26-04-2026 (sesión 30) · drift de Regla 8 cerrado. Tabla canónica con 8 call sites en Cat A + 3 en Cat B.
- 27-04-2026 (sesión 32) · esta página creada para hacer visible los agentes del producto en el grafo wiki, además del ADR y CLAUDE.md.
Véase también
- [[decision—20260401—gemini-3-flash-preview]] — ADR canónico de modelos Gemini por función
- [[workspace—agentes-ia]] — agentes claude.ai connector (categoría distinta)
- [[workspace—producto—workspace-agentes]] — arquitectura del equipo de agentes (vista interna)
- [[workspace—agentes-remotos-anthropic]] — routines remotas (categoría distinta)
- [[ia-tech—automatismos—metodo—bibliotecario-procesos]] — procesos automáticos del Bibliotecario (categoría distinta)
- [[crearack-tech—agents—dev-cns]] — agente técnico CNS (documentación dev)
- [[crearack-tech—agents—dev-map-editor]] — agente técnico Map Editor (donde vive Auto-Plan AI)
- [[crearack-tech—method—harness-guide]] — § Apéndice describe el Diagnosis Validator y CNS Feedback Loop