AgentShield
Core Engine

Infrastructure: The Hidden Engine

Detrás de los routers y agentes, existe una capa de infraestructura resiliente. Conoce los componentes que mantienen el sistema vivo: desde la validación estricta de configuración hasta la economía de tokens en tiempo real.

Configuration Hardening

AgentShield no arranca si no es seguro. Utilizamos Pydantic Settings para validar el entorno en tiempo de arranque, previniendo configuraciones inseguras en producción.

Strict Validators

Impide el uso de claves por defecto (`dev-secret-key`) en entornos de Producción.

Connection Integrity

Valida que `SUPABASE_URL` y `REDIS_URL` usen protocolos seguros (`https://`, `rediss://`).

app/config.py environment check
# Validating environment...
✔ SUPABASE_URL: https://... [OK]
✔ REDIS_URL: rediss://... [OK]
✖ SECRET_KEY: 'dev-secret-key-change-me'
ValueError: ❌ FATAL: Cannot use default SECRET_KEY in production!
Process exited with code 1.
FinOps Intelligence

Multimodal Cost Estimator

El corazón económico de AgentShield. `cost_estimator.py` no solo mira precios estáticos; aprende de la realidad. Utiliza medias móviles exponenciales (EMA) para predecir el coste de salida de modelos complejos como GPT-4o y DeepSeek-R1.

Dynamic Ratios
Currency Hardening

Fallback Ratios (2026)

GPT-4o
Dense & Concise
1.45x
Claude-3.5
Detailed Explanations
1.70x
DeepSeek-R1
Chain of Thought
8.00x
Creative
Generative Burst
4.50x

Core Utilities

Patrones de diseño resilientes implementados como decoradores Python para mantener el código de negocio limpio y seguro.

@retry_with_backoff
Reintenta llamadas a LLM con espera exponencial (1s, 2s, 4s) ante fallos de red.
@audit_action
Registra automáticamente operaciones críticas en `audit_logs` sin bloquear la respuesta.
@semantic_cache (Fail-Open)
Si Redis cae, el decorador captura la excepción y ejecuta la función original. El servicio nunca se detiene.

Health & Connections

El módulo `db.py` ahora expone un health check unificado y gestiona pools de conexiones explícitos.

GET /health200 OK
{
"status": "ok",
"ready": true,
"infra": "connected"
}
Entrypoints
Root /API Info & Docs Link
HealthUnified DB + Redis Check
Redis Production Pool
Max Connections50
Timeout5.0s
Rate Limiting Enabled
ENABLE_RATE_LIMITING

Background Workers

Procesos asíncronos que mantienen la salud del sistema mientras duermes.

Trust Healer

workers/trust_healer.py

Ejecuta el ciclo de "Fairness". Si un empleado con bajo Trust Score no comete infracciones en 24h, el sistema le amnistía automáticamente (+5 puntos).

Mode: [DRY_RUN]Status: HEALTHY
> Scanning damaged users...
> User u_9182: Clean sheet detected.
> [DRY_RUN] Would heal +5pts.

Data Integrity & Webhooks

models.py
webhooks.py

Cierre del círculo de seguridad. Validadores estrictos en pydantic y webhooks firmados criptográficamente.

HMAC SignatureX-AgentShield-Signature
Context Traceabilitylatency_ms & response_id
Authorize ValidatorStrict Currency (EUR/USD)
"Reliability is the feature that makes all other features possible."
Volver a Services
Volver AtrásApp Core
Continuar TourServices Inventory