agentveil

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

PyPI: agentveil | API: agentveil.dev | Обозреватель: Live Dashboard

Почему важна инфраструктура доверия к агентам — проверенные CVE, рыночные данные и структурная проблема, которую решает 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

Функции

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

• Офлайн-учетные данные — репутационные учетные данные, подписанные Ed25519. Проверка доверия без вызовов API

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

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

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

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

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

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

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

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

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

Интеграции

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

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

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

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

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

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

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

Примеры

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

Лицензия

MIT — см. LICENSE.