agentveil

PyPI Python Tests License: MIT 在 Glama MCP 目录中列出

Agent Veil Protocol 的 Python SDK — 为自主智能体提供信任强制执行。

PyPI: agentveil | API: agentveil.dev | 网络: 实时网络

为什么智能体信任基础设施很重要 — 已验证的 CVE、市场数据以及 AVP 解决的结构性问题。

开源贡献已合并至 Microsoft Agent Governance Toolkit — AVPProvider 已添加为 TrustProvider 实现（PR #1010，已合并至上游）。

论文: Boiko, O. (2026). 为什么 AI 智能体信誉需要链路分析和基于流的门控. 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 实现）即可验证。无需 AVP SDK。

# 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 可验证凭证标准（eddsa-jcs-2022 数据完整性证明）。使用任何标准 VC 库即可离线验证，无需 AVP SDK
单行装饰器 — @avp_tracked() — 自动注册、自动证明、自动保护
DID 身份 — W3C did:key (Ed25519)。可移植的智能体身份
信誉 — 具有贝叶斯置信度的对等证明评分。抗女巫攻击
证明 — 签名的对等评分。负面评分需要 SHA-256 证据。评分即时更新
争议保护 — 对不公平的评分提出异议。从已验证池中自动分配仲裁员
智能体发现 — 发布能力，按技能和信誉查找智能体
Webhook 警报 — 评分下降时的推送通知（设置指南）
抗女巫攻击 — 多层图分析可阻止虚假智能体环
信任门控 — 基于信誉的速率限制（新手 → 基础 → 受信任 → 精英）

集成

框架	安装	快速入门
任意 Python	`pip install agentveil`	`@avp_tracked()` 或直接使用 `AVPAgent`
CrewAI	`pip install agentveil crewai`	`tools=[AVPReputationTool(), AVPDelegationTool()]`
LangGraph	`pip install agentveil langgraph`	`ToolNode([avp_check_reputation, avp_should_delegate])`
AutoGen	`pip install agentveil autogen-core`	`tools=avp_reputation_tools()`
OpenAI	`pip install agentveil openai`	`tools=avp_tool_definitions()`
Claude	`pip install 'agentveil[mcp]'`	`agentveil-mcp` — MCP 服务器，文档
Hermes	`pip install 'agentveil[mcp]'`	`agentveil-mcp` + agentskills.io 技能
Paperclip	`pip install agentveil`	`avp_should_delegate()` + `avp_evaluate_team()`
AWS Bedrock	`pip install agentveil boto3`	使用 AVP 信任工具的 Converse API
AgentMesh (MS AGT)	`pip install agentmesh-avp`	`TrustEngine(external_providers=[AVPProvider()])`

完整集成指南：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 签名认证
输入验证 — 注入检测、PII 扫描
智能体暂停 — 被入侵的智能体会被立即封禁
审计追踪 — SHA-256 哈希链日志，锚定到 IPFS

文档

文档	描述
API 参考	包含示例的完整 SDK 方法参考
客户集成	受控操作流程、密钥、错误和合规性证据
集成	框架特定的设置指南
Webhook 警报	推送通知设置
协议规范	有线格式和认证
安全上下文	为什么智能体信任很重要 — CVE 和市场数据
更新日志	版本历史

示例

示例	描述
`proof_pack/`	端到端演练 — 信任检查 → 委托 → 信号变更 → 警报 → 可离线验证的证明。需要本地后端。
`standalone_demo.py`	无需服务器 — 带有模拟模式的完整 SDK 演示
`quickstart.py`	注册、发布卡片、检查信誉
`two_agents.py`	带有证明的完整 A2A 交互
`verify_credential_standalone.py`	离线凭证验证（无需 SDK）

框架示例：CrewAI · LangGraph · AutoGen · OpenAI · Claude MCP · Paperclip

许可证

MIT — 参见 LICENSE。

AgentVeil Protocol

agentveil

安装

快速入门

信任决策 — 单次调用

使用装饰器自动跟踪

无需服务器即可尝试

离线验证信任 — 无需 SDK

特性

集成

批量证明

安全性

文档

示例

许可证

Maintenance

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API