Saltar a contenido

Roadmap público — Ciel Agent Framework

Documentación oficial de mana-ciel (import ciel). Este roadmap describe las capacidades que llegarán a los usuarios y las versiones previstas. Es orientativo: el orden y las fechas pueden ajustarse según aprendizajes de uso. Para el diario técnico de ingeniería, consulta los canales internos del equipo.

Visión

Un framework enterprise para construir agentes autónomos y sistemas multi-agente, model-agnostic y deploy-agnostic, con multitenancy y trazabilidad nativas (k8s/VPS). Principio rector: harness-first, ejecutable sobre planificación extendida, y — a largo plazo — agentes que crean, verifican, refinan y enseñan sus propios skills (autonomía auto-incremental) llevada a nivel enterprise.

Leyenda de estado

  • ✅ Disponible
  • 🟡 En desarrollo
  • 📋 Planificado

Hitos por versión

v0.4 — ✅ Disponible

Base sólida y usable en producción:

  • Orquestación best-of-breed: grafos estilo LangGraph, flows estilo CrewAI, group-chat estilo AutoGen, root-agent estilo ADK, y session state persistente por tenant.
  • Agencia autónoma: bucle durable con reintentos exponenciales y reanudación tras reinicio (ciel loop run / ciel loop resume).
  • Enterprise: RBAC/OIDC, auditoría inmutable (hash-chain), governance de costos, secretos (Vault/K8s/env) y rate-limiting por tenant.
  • Deploy: Helm (HA: PDB, HPA, anti-affinity), OTel/metrics, adapters (Teams/Discord/Web UI), Human-in-the-loop en grafos.
  • Developer Experience: fachada ergonómica, ciel init offline-safe, guías y cookbooks, API reference pública.

v0.5 — ✅ Disponible (Developer Experience II)

Bajar la curva de adopción para nuevos usuarios:

  • Creación de agentes en una línea: model="gpt-4o" elige el provider automáticamente (auto-provider desde la cadena del modelo).
  • Streaming de respuestas (astream) y loop ReAct multi-turno integrados.
  • @ciel.tool con inferencia de schema, validación Pydantic V2 y errores DX claros.
  • Objetivo: un agente funcional con tres líneas, offline-safe.

v0.6 — ✅ Disponible (Autonomía I: Skill Library)

Nota: la Autonomía I (Skill Library) estaba originalmente planeada para la v0.12 del roadmap (cuando las fases se numeraban como v1.x). Se adelantó y se entregó en la v0.6.0, por lo que todo el resto de hitos se renumera +1 (ver abajo).

Primer nivel de autonía: el agente crea, verifica, versiona y enseña sus propios skills, todo offline-safe (sin red ni API keys):

  • Skill Library dinámica (ciel.runtime.skills_lib): store en memoria escribible sobre el registry pasivo; SkillLibrary.create_from_code, register, get, list_skills, history, update (con bump semántico) y remove, con aislamiento por tenant_id.
  • Auto-verificación offline (SkillVerifier): validación de sintaxis + ejecución de casos de prueba ({"call": {...}, "expect": valor}) antes de confiar en un skill.
  • Versioning + changelog (ciel.runtime.skill_versioning): set_changelog / changelog y la semilla del Skill Evolution Tree (evolution_tree) que registra el parent de cada versión.
  • Composition engine (ciel.runtime.skill_composition): fusiona N skills en uno nuevo con combinadores sequence / parallel / selector.
  • Doc auto-generation (ciel.runtime.skill_doc): generate_doc y to_markdown extraen nombre, docstring y firma desde el código fuente (AST).
  • Integración con ciel.Agent (ciel.runtime.skill_agent_integration): decorador @ciel.skill, la librería singleton global_skill_library, Agent(skills=[...]), el método agent.teach(skill) / ciel.teach(agent, skill) (registra un skill verificado como tool ejecutable) y agent.load_skills(...).
  • Skill metrics por tenant (ciel.runtime.skill_metrics): SkillMetrics registra llamadas, éxitos/fallos, tasa de éxito y latencia promedio aisladas por tenant_id.
  • CLI ciel skills (offline): list, create --name --description --code-file, verify --name --test-cases, remove --name.

v0.7 — ✅ Disponible (Ciel Studio — Web UI + observabilidad visual)

Dashboard mínimo operativo y observabilidad visual:

  • Web UI y dashboard mínimo: sesiones, board, loops y estado.
  • Visualización de trazas y replay de session (time-travel); cost dashboard.

v0.8 — ✅ Disponible (Escala y HA real)

(Reordenado desde la v0.6 original del roadmap.)

  • Backend de estado/checkpoint compartido (StateBackend: Postgres para prod, SQLite para dev/local) para supervivencia multi-réplica sin pérdida de sesión, con upsert idempotente por (tenant_id, session_id, key).
  • Ejecución de N réplicas con health reales (/healthz liveness, /readyz readiness) y reanudación de checkpoint compartido con lease anti-doble-ejecución.
  • Runbooks operativos completos (despliegue, incidente, rollback, backup, HPA) y BackupJob (CronJob) en el chart Helm.

v0.9 — ✅ Disponible (Enterprise reforzado)

  • SSO/OIDC con proveedor real (no solo verificación local de JWT).
  • Vault para secretos dinámicos y rotación.
  • Guardrails + sandbox de ejecución de código del agente (Docker/gVisor).

v0.10 — ✅ Disponible (Providers y multimodal)

Capa de providers ampliada y multimodal nativo:

  • Multimodal nativo: ChatMessage.content acepta str | list[dict] (partes text / image_url / input_audio); nuevo helper ChatMessage.text() degrada multimodal a texto concatenado.
  • LiteLLM como meta-provider (extra opcional litellm): instala con pip install "mana-ciel[litellm]"; LiteLLMProvider expone 100+ modelos vía el contrato ChatProvider, con Router para fallback/balanceo (offline-safe, import diferido).
  • Azure OpenAI: AzureOpenAIProvider (deployment + api-version); prefijo azure/ en auto_provider.
  • Ollama local: prefijo ollama/ → OpenAICompatibleProvider en http://localhost:11434/v1.
  • vLLM/TGI: prefijo vllm/ → OpenAICompatibleProvider en http://localhost:8000/v1 (configurable vía VLLM_BASE_URL).
  • auto_provider reconoce prefijos: gpt-/o1/o3→OpenAI, claude-→Anthropic, gemini-/models/→Gemini, azure/→Azure, ollama/→Ollama, vllm/→vLLM.

v0.11 — ✅ Disponible (Memoria, RAG y conocimiento)

  • Memoria episódica nativa (EpisodicStore, MemoryConfig) inyectada en el agente, aislada por tenant, offline-safe.
  • RAG enterprise (ciel.rag): KnowledgeBase/Retriever/SemanticCache, índice vectorial sin red (InMemoryVectorStore + DeterministicEmbeddingProvider), búsqueda híbrida BM25+vector con fusión RRF y rerank, chunking configurable, loaders MD/HTML/TXT (PDF opt-in) y tools RAG (rag_tools).
  • API pública aditiva: ciel.EpisodicStore, ciel.MemoryConfig, install_agent_memory_support. Extra rag opcional (chromadb, pypdf).

v0.12 — ✅ Disponible (Evaluación y testing)

Capa de evaluación y testing reproducible, offline-safe por defecto:

  • MockProvider determinista (ciel.providers.MockProvider): modos fixed/echo/map, sin red ni API keys; registrado en auto_provider con prefijo mock/.
  • ciel evaluate (CLI Typer): run (KPIs + Rich, exit-code por umbral), regression (gate contra baseline) y redteam (prompt injection / fuga de tenant con assertions de aislamiento).
  • ciel.eval: Evaluator, EvalCase, load_dataset (YAML) y métricas deterministas propias (exact_match, contains, f1_token, faithfulness, context_relevance, answer_relevance).
  • Integración opt-in con DeepEval/RAGAS/TruLens vía extra eval (degrada a métricas propias si no está instalado).
  • CI: nuevo job eval (offline, MockProvider, sin red) para regression en PRs.

v0.13 — 📋 Autonomía II: auto-aprendizaje

  • Self-reflection y learning-from-failure; prompt evolution versionado; introspección y estado cognitivo explicable.

v0.14 — 📋 Autonomía III: curricula y exploración

  • Autonomous goal setting + curriculum; knowledge graph y transfer learning entre dominios.

v0.15 — 📋 Inteligencia colectiva

  • Cross-agent knowledge transfer; composición y marketplace de skills; skill evolution tree y métricas de velocidad de aprendizaje.

v0.16 — 📋 APIs multi-lenguaje y despliegue moderno

  • API REST/gRPC para exponer agentes; SDKs (TS/Go/Java/Rust); IaC y GitOps.

v0.17 — 📋 Observability GA y multi-cloud

  • OTel a collector real con dashboards/alertas; integraciones (LangFuse, W&B, DataDog, PagerDuty); multi-cloud sin vendor lock-in.

v0.18 — 📋 API stability y ecosistema

  • API pública estable (semver + deprecación); ecosistema de plugins, galería de templates, docs bilingüe (es/en), benchmark público.

v1.0 — 📋 GA / Madurez (meta-agente)

v1.0.0 se reserva para la madurez real del framework. No se lanzará la versión 1 hasta completar todas las fases previas (v0.10–v0.18) y considerar que Ciel es un framework maduro y apto para producción a nivel GA. Todas las versiones intermedias son 0.x (pre-1.0).

  • Meta-agentes que eligen estrategia y auto-optimizan su aprendizaje; límites de seguridad autónomos que evolucionan con la experiencia; compliance automático (SOC2/ISO/GDPR) y disaster recovery. API estable, SLA y despliegue multi-cloud.

Cómo seguir el progreso

  • Releases en PyPI: pip install mana-ciel / uv add mana-ciel.
  • CHANGELOG y guías en este mismo sitio.
  • Cada versión menor se acompaña de tag, wheels y notas de upgrade.