agentveil

Python-SDK für das Agent Veil Protocol — Vertrauensdurchsetzung für autonome Agenten.

PyPI: agentveil | API: agentveil.dev | Explorer: Live Dashboard

Warum Infrastruktur für Agenten-Vertrauen wichtig ist — verifizierte CVEs, Marktdaten und das strukturelle Problem, das AVP adressiert.

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": "..."}

Installation

pip install agentveil

Related MCP server: Agent Receipts

Schnellstart

Vertrauensentscheidung — ein Aufruf

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"])

Automatische Nachverfolgung mit Decorator

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

Ohne Server ausprobieren

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

Funktionen

• Vertrauensprüfung — can_trust() — beratende Vertrauensentscheidung mit einem Aufruf: Score + Stufe + Risiko + Erklärung

• Offline-Anmeldeinformationen — Ed25519-signierte Reputationsnachweise. Vertrauen ohne API-Aufrufe verifizieren

• Einzeiliger Decorator — @avp_tracked() — automatische Registrierung, automatische Attestierung, automatischer Schutz

• DID-Identität — W3C did:key (Ed25519). Portierbare Agentenidentität

• Reputation — Peer-attestiertes Scoring mit Bayes'schem Vertrauensintervall. Sybil-resistent

• Attestierungen — Signierte Peer-to-Peer-Bewertungen. Negative Bewertungen erfordern SHA-256-Beweise. Score-Aktualisierung erfolgt sofort

• Streitschutz — Unfaire Bewertungen anfechten. Automatisch zugewiesener Schiedsrichter aus einem verifizierten Pool

• Agenten-Entdeckung — Fähigkeiten veröffentlichen, Agenten nach Qualifikation und Reputation finden

• Webhook-Benachrichtigungen — Push-Benachrichtigungen bei Score-Abfällen (Einrichtungsanleitung)

• Sybil-Resistenz — Mehrschichtige Graphenanalyse blockiert gefälschte Agenten-Netzwerke

• Vertrauens-Gate — Reputationsbasiertes Ratenlimit (Neuling → Basis → Vertrauenswürdig → Elite)

Integrationen

Vollständige Integrationsanleitungen: docs/INTEGRATIONS.md

Sicherheit

• Ed25519-Signatur-Authentifizierung mit Nonce-Anti-Replay

• Eingabevalidierung — Injektionserkennung, PII-Scan

• Agenten-Suspendierung — kompromittierte Agenten werden sofort blockiert

• Audit-Trail — SHA-256-Hash-verkettetes Protokoll, verankert in IPFS

Dokumentation

Beispiele

Framework-Beispiele: CrewAI · LangGraph · AutoGen · OpenAI · Claude MCP · Paperclip

Lizenz

MIT — siehe LICENSE.