agentveil

SDK de Python para Agent Veil Protocol — cumplimiento de confianza para agentes autónomos.

PyPI: agentveil | API: agentveil.dev | Explorador: Panel en vivo

Por qué es importante la infraestructura de confianza de agentes — CVE verificados, datos de mercado y el problema estructural que aborda AVP.

from agentveil import AVPAgent

agent = AVPAgent.load("https://agentveil.dev", "my-agent")

# Should I trust this agent with my task?
decision = agent.can_trust("did:key:z6Mk...", min_tier="trusted")
if decision["allowed"]:
    delegate_task()
# → {"allowed": true, "tier": "trusted", "risk_level": "low", "reason": "..."}

Instalación

pip install agentveil

Related MCP server: Agent Receipts

Inicio rápido

Decisión de confianza — una sola llamada

from agentveil import AVPAgent

agent = AVPAgent.load("https://agentveil.dev", "my-agent")
decision = agent.can_trust("did:key:z6Mk...", min_tier="trusted")
print(decision["allowed"], decision["reason"])

Seguimiento automático con decorador

from agentveil import avp_tracked

@avp_tracked("https://agentveil.dev", name="reviewer", to_did="did:key:z6Mk...")
def review_code(pr_url: str) -> str:
    return analysis

# Success → positive attestation | Exception → negative attestation
# First call → auto-registers agent + publishes card

Probar sin servidor

agent = AVPAgent.create(mock=True, name="test_agent")
agent.register(display_name="Test Agent")
rep = agent.get_reputation()
print(rep)  # Works offline — real crypto, mocked HTTP

Características

• Verificación de confianza — can_trust() — decisión de confianza consultiva en una sola llamada: puntuación + nivel + riesgo + explicación

• Credenciales offline — Credenciales de reputación firmadas con Ed25519. Verifique la confianza sin llamadas a la API

• Decorador de una línea — @avp_tracked() — registro automático, atestación automática, protección automática

• Identidad DID — W3C did:key (Ed25519). Identidad de agente portátil

• Reputación — Puntuación atestada por pares con confianza bayesiana. Resistente a ataques Sybil

• Atestaciones — Calificaciones entre pares firmadas. Las calificaciones negativas requieren evidencia SHA-256. La puntuación se actualiza inmediatamente

• Protección contra disputas — Impugne calificaciones injustas. Árbitro asignado automáticamente desde un grupo verificado

• Descubrimiento de agentes — Publique capacidades, encuentre agentes por habilidad y reputación

• Alertas de Webhook — Notificaciones push sobre caídas de puntuación (guía de configuración)

• Resistencia a ataques Sybil — El análisis de grafos multicapa bloquea redes de agentes falsos

• Puerta de confianza — Limitación de tasa basada en reputación (recién llegado → básico → confiable → élite)

Integraciones

Guías de integración completas: docs/INTEGRATIONS.md

Seguridad

• Autenticación de firma Ed25519 con anti-repetición nonce

• Validación de entrada — detección de inyección, escaneo de PII

• Suspensión de agentes — agentes comprometidos bloqueados instantáneamente

• Registro de auditoría — registro encadenado con hash SHA-256, anclado a IPFS

Documentación

Ejemplos

Ejemplos de frameworks: CrewAI · LangGraph · AutoGen · OpenAI · Claude MCP · Paperclip

Licencia

MIT — ver LICENSE.