iii-observabilidad-agentes

name: iii-observabilidad-agentes description: "iii — Framework de observabilidad y composición de servicios: workers, funciones y triggers para construir sistemas de agentes observables en tiempo real" url: https://github.com/iii-hq/iii category: mcp fecha: 2026-06-02

iii (Triple I)

El modo más fácil de componer, extender y observar cada servicio en tu stack en tiempo real.

¿Qué hace?

iii colapsa la complejidad de integrar queues, cron, HTTP, state, observabilidad, agentes y sandboxes en un solo sistema vivo. Cada backend empieza como un proyecto antes de la primera línea de lógica de negocio. iii convierte todo eso en una superficie de sistema observable.

Tres primitivas son todo el modelo mental:

1. Workers — Procesos que se registran con el motor iii y luego registran triggers y funciones. Un servicio TypeScript, una pipeline Python, un microservicio Rust... cualquier funcionalidad se convierte en worker con pocas líneas.
2. Triggers — Cualquier cosa que cause que una función se ejecute: llamada directa, HTTP, cron, queue, cambio de estado, stream event. Declarativos: el Worker define "esta función corre cuando pasa esto".
3. Functions — Unidades de trabajo con identificador estable (ej: content::classify, orders::validate). Reciben input, hacen trabajo, devuelven output.

Para agentes: cuando una tarea necesita una capacidad que el sistema no tiene, un agente puede añadir un worker, descubrir sus funciones, llamarlas y trazar lo que pasó. Misma interfaz que usa un desarrollador.

Características clave

• SDKs nativos: TypeScript (npm), Python (PyPI), Rust (crates.io)
• Worker catalog vivo: iii worker add <capability> — cada worker se registra y notifica a todos los demás
• Trace en tiempo real: Console para inspeccionar workers, funciones y traces
• Agent skills: Skills legibles por agentes que cubren cada primitiva iii
• Workers published: Catálogo en workers.iii.dev
• Extensión en runtime: Workers pueden crear otros workers en tiempo de ejecución
• Docker: Imagen oficial disponible

Casos de uso

1. Observabilidad de agentes IA — Rastrear qué workers, funciones y triggers usa cada agente
2. Composición de microservicios — Unificar queues, cron, HTTP, state en un sistema
3. Agentes que se auto-extienden — Un agente añade un worker con la capacidad que necesita
4. Debugging de sistemas multi-servicio — Ver todo el flujo de un request en un trace unificado
5. Integración de agentes con infraestructura existente — Los agentes usan el mismo catálogo que los devs

Snippets útiles

# Instalar iii
# macOS/Linux
brew install iii-hq/iii/iii
# o desde binarios: https://iii.dev/docs/quickstart

# Inicializar proyecto
iii project init myapp
cd myapp

# Iniciar el motor
iii

# Añadir workers
iii worker add queue
iii worker add agent
iii worker add sandbox
iii worker add observability

# Instalar skills para agentes
npx skills add iii-hq/iii/skills

# Ver workers registrados
iii workers list

# Ver traces en tiempo real
iii console

// TypeScript SDK
import { iii } from 'iii-sdk';

// Registrar una función
iii.functions.register('content::classify', async (input) => {
  return { category: 'tech', confidence: 0.95 };
});

// Registrar un trigger
iii.triggers.register('http', {
  path: '/api/classify',
  method: 'POST',
  handler: iii.functions.get('content::classify')
});

# Python SDK
from iii_sdk import Worker, Function, Trigger

# Crear worker
worker = Worker("my-pipeline")

# Registrar función
@worker.function("data::process")
def process_data(input):
    return {"processed": True, "rows": len(input)}

# Registrar trigger
@worker.trigger("queue", channel="data-queue")
def on_new_data(data):
    return process_data(data)

Cómo integrarlo

En un proyecto existente

iii project init myapp
cd myapp
iii worker add <your-service>
iii  # start engine

Con agentes IA

Los agentes pueden usar las skills de iii para:

• Descubrir workers disponibles
• Llamar funciones de otros workers
• Trazar el flujo de ejecución
• Auto-extender el sistema añadiendo nuevos workers

En un sistema multi-agente

Cada agente puede ser un worker. Los agentes descubren capacidades de otros agentes a través del catálogo de workers. Un agente puede delegar en otro añadiendo su worker al catálogo.

Comparativa

Pitfalls

• iii engine requiere instalación separada — no es solo un SDK, necesita el motor corriendo
• Los workers se registran en memoria — sin persistencia por defecto, los workers se pierden al reiniciar
• Console es experimental — la interfaz de observación está en desarrollo activo
• SDKs en 3 lenguajes — cada SDK tiene su propia API, no hay abstracción unificada
• Modelo mental de 3 primitivas — requiere re-pensar la arquitectura de servicios

Fecha de descubrimiento

2026-06-02 — Trending semanal en GitHub. 17.5k⭐, Rust/TS/Python. Framework de observabilidad y composición para agentes IA y microservicios.