App Core: Más que un Proxy
La carpeta app/ no es un simple pasamanos de peticiones HTTP. Es un Sistema Operativo de Gobernanza completo. Mientras la competencia (Helicone, Kong) actúa como un "logger pasivo", AgentShield toma decisiones milimétricas en tiempo real para bloquear, modificar o enrutar el tráfico.
¿Por qué existe `app/`?
El Problema de los "Dumb Pipes"
Los proxies tradicionales son tuberías tontas. Si un empleado envía una base de datos de clientes a GPT-4, el proxy lo permite y solo lo registra (log) cuando el daño ya está hecho.
La Revolución de la "Defensa Activa"
AgentShield inspecciona el contenido semántico de cada paquete in-flight. Nuestro middleware y proxy.py detienen la petición ANTES de que salga hacia OpenAI.
Zero Data Leak Guarantee
Anatomía de `app/`
Componentes Críticos
proxy.py
El enrutador más complejo (24kb+). Gestiona la comunicación con LLMs, inyecta prompts de sistema dinámicos y maneja el fallback entre proveedores.
ai_act_compliance.py
Clasificador de riesgos según la Ley de IA de la UE. Etiqueta automáticamente cada interacción como "Low", "High" o "Unacceptable" Risk.
Middleware Stack
Layer 1 (`security.py`): Global Rate Limit, Trace ID Injection & Cloudflare Secret check.
Layer 2 (`auth.py`): JWT Validation & Tenant Isolation.