agentveil

Listado en el directorio Glama MCP

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

PyPI: agentveil | API: agentveil.dev | Red: Red en vivo

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

Contribución de código abierto fusionada en Microsoft Agent Governance Toolkit — AVPProvider añadido como una implementación de TrustProvider (PR #1010, fusionado en la rama principal).

Documento: Boiko, O. (2026). Por qué la reputación de los agentes de IA necesita tanto análisis de enlaces como control basado en flujo. Zenodo.

Tutorial completo de extremo a extremo: examples/proof_pack/ — ejemplo anotado del arco completo: verificación de confianza → delegación → cambio de señal → alerta → prueba verificable fuera de línea. Requiere un backend de AVP local.

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

Verificar confianza fuera de línea — no requiere SDK

# Get a W3C Verifiable Credential (VC v2.0)
curl https://agentveil.dev/v1/reputation/{agent_did}/credential?format=w3c

La respuesta es una VC (Credencial Verificable) estándar de W3C con una DataIntegrityProof (eddsa-jcs-2022). Verifíquela con cualquier biblioteca de VC — Veramo, SpruceID, Digital Bazaar o su propia implementación de Ed25519. No se necesita el SDK de AVP.

# Or verify with the SDK:
cred = agent.get_reputation_credential(format="w3c")
assert AVPAgent.verify_w3c_credential(cred)  # offline, no API call

Características

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

• Credenciales W3C VC v2.0 — Las credenciales de confianza cumplen con las Credenciales Verificables de W3C (prueba de integridad de datos eddsa-jcs-2022). Verifique fuera de línea con cualquier biblioteca de VC estándar, no se requiere SDK de AVP

• Decorador de una línea — @avp_tracked() — autorregistro, autoatestación, autoprotección

• 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 Sybil — El análisis de grafos multicapa bloquea anillos 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

Atestaciones por lotes

Envíe hasta 50 atestaciones en una sola solicitud. Cada una se valida de forma independiente — es posible el éxito parcial.

results = agent.attest_batch([
    {"to_did": "did:key:z6MkAgent1...", "outcome": "positive", "weight": 0.9, "context": "code_review"},
    {"to_did": "did:key:z6MkAgent2...", "outcome": "negative", "weight": 0.7, "evidence_hash": "sha256hex..."},
    {"to_did": "did:key:z6MkAgent3...", "outcome": "positive"},
])
print(results["succeeded"], results["failed"])  # 3, 0

Cada atestación está firmada individualmente con Ed25519. Campos opcionales: context, evidence_hash, is_private, interaction_id.

Seguridad

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

• 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 por hash SHA-256, anclado a IPFS

Documentación

Ejemplos

Ejemplos de marcos de trabajo: CrewAI · LangGraph · AutoGen · OpenAI · Claude MCP · Paperclip

Licencia

MIT — ver LICENSE.