agentveil

В списке каталога Glama MCP

Python SDK для Agent Veil Protocol — обеспечение доверия для автономных агентов.

PyPI: agentveil | API: agentveil.dev | Сеть: Live Network

Почему важна инфраструктура доверия к агентам — проверенные CVE, рыночные данные и структурная проблема, которую решает AVP.

Вклад с открытым исходным кодом, объединенный с Microsoft Agent Governance Toolkit — AVPProvider добавлен как реализация TrustProvider (PR #1010, объединено в основной репозиторий).

Статья: Boiko, O. (2026). Why AI Agent Reputation Needs Both Link Analysis and Flow-Based Gating. Zenodo.

Полное пошаговое руководство: examples/proof_pack/ — аннотированный пример полного цикла: проверка доверия → делегирование → изменение сигнала → оповещение → офлайн-проверяемое доказательство. Требуется локальный бэкенд 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": "..."}

Установка

pip install agentveil

Related MCP server: Agent Receipts

Быстрый старт

Решение о доверии — один вызов

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

Автоматическое отслеживание с помощью декоратора

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

Попробуйте без сервера

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

Проверка доверия офлайн — SDK не требуется

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

Ответ представляет собой стандартный W3C VC с DataIntegrityProof (eddsa-jcs-2022). Проверьте его с помощью любой библиотеки VC — Veramo, SpruceID, Digital Bazaar или вашей собственной реализации Ed25519. SDK AVP не требуется.

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

Функции

• Проверка доверия — can_trust() — консультативное решение о доверии в один вызов: оценка + уровень + риск + пояснение

• Учетные данные W3C VC v2.0 — Учетные данные доверия соответствуют стандарту W3C Verifiable Credentials (доказательство целостности данных eddsa-jcs-2022). Проверяйте офлайн с помощью любой стандартной библиотеки VC, SDK AVP не требуется

• Декоратор в одну строку — @avp_tracked() — автоматическая регистрация, автоматическая аттестация, автоматическая защита

• Идентификация DID — W3C did:key (Ed25519). Портативная идентификация агента

• Репутация — Оценка, подтвержденная участниками, с байесовской достоверностью. Устойчивость к атакам Сивиллы

• Аттестации — Подписанные рейтинги между участниками. Отрицательные рейтинги требуют доказательств SHA-256. Оценка обновляется немедленно

• Защита от споров — Оспаривание несправедливых рейтингов. Автоматически назначенный арбитр из проверенного пула

• Обнаружение агентов — Публикация возможностей, поиск агентов по навыкам и репутации

• Webhook-оповещения — Push-уведомления при падении рейтинга (руководство по настройке)

• Устойчивость к атакам Сивиллы — Многоуровневый графовый анализ блокирует сети поддельных агентов

• Шлюз доверия — Ограничение скорости на основе репутации (новичок → базовый → доверенный → элитный)

Интеграции

Полные руководства по интеграции: docs/INTEGRATIONS.md

Пакетные аттестации

Отправляйте до 50 аттестаций в одном запросе. Каждая проверяется независимо — возможен частичный успех.

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

Каждая аттестация индивидуально подписана Ed25519. Дополнительные поля: context, evidence_hash, is_private, interaction_id.

Безопасность

• Аутентификация подписи Ed25519 с защитой от повторного воспроизведения (nonce)

• Валидация входных данных — обнаружение инъекций, сканирование PII

• Приостановка работы агентов — скомпрометированные агенты мгновенно блокируются

• Аудиторский след — лог с цепочкой хешей SHA-256, закрепленный в IPFS

Документация

Примеры

Примеры для фреймворков: CrewAI · LangGraph · AutoGen · OpenAI · Claude MCP · Paperclip

Лицензия

MIT — см. LICENSE.