Agents · BLANK Intranet

¿Qué es esto?

BLANK se construye con una plantilla pequeña de personas y una flota de agentes. Esta carpeta contiene esos agentes: 7 especialistas, cada uno con su rol y sus herramientas.

Cada agente opera a un nivel de autonomía entre 0 (solo sugiere) y 3 (actúa y notifica). El salto entre niveles lo decide el CEO desde /agents en esta intranet.

El runtime usa LangGraph para orquestar pasos, guardrails para filtrar acciones, y un audit log para que todo sea revisable.

Stack técnico

Python 3.12
LangGraph (workflows de estado)
LangChain (primitivas)
FastAPI (management API)
Anthropic Claude + OpenAI (LLMs)
Redis (memoria corta)
Postgres (audit log)

Estructura de carpetas

agents/
├── api/                 management API en :8001
├── runtime/
│   ├── engine.py        loop principal de cada agente
│   ├── ladder.py        niveles de autonomía 0-3
│   ├── guardrails.py    filtros de acciones
│   └── audit.py         registro de todo
├── specialists/
│   ├── marketing/
│   ├── webmaster/
│   ├── security/
│   ├── customer_support/
│   ├── finance/
│   ├── devops/
│   └── sales/
└── workflows/           grafos LangGraph por tarea

Archivos clave

Archivo	Qué hace	Prioridad
runtime/engine.py	Bucle que hace tick a cada agente.	Alta
runtime/ladder.py	Gate entre niveles 0-3 de autonomía.	Alta
runtime/guardrails.py	Bloquea acciones fuera del permiso.	Alta
api/main.py	Endpoints que consume la intranet.	Media
specialists/customer_support/agent.py	Agente que responde tickets.	Media
specialists/marketing/agent.py	Agente que redacta y publica.	Media
specialists/finance/agent.py	Agente que concilia y emite alertas.	Baja

Cómo ejecutarlo

Arrancar el management API

cd agents && uvicorn api.main:app --reload --port 8001

Ejecutar un solo tick de un agente en local

cd agents && python -m specialists.marketing.agent --tick

Ver el audit log

cd agents && python -m runtime.audit --tail 50

Qué falta

0 de 11 completados

Alta Media Baja

Dependencias con otros módulos

Depende del backend: los agentes llaman a los microservicios con API keys.
La UI de gestión vive en la intranet en /agents.
Necesita claves de OpenAI y Anthropic en .env.