agentveil

PyPI Python Tests License: MIT Glama MCP Directoryに掲載

Agent Veil Protocol 用のPython SDK — 自律エージェントのための信頼性強制機能。

PyPI: agentveil | API: agentveil.dev | ネットワーク: ライブネットワーク

なぜエージェントの信頼インフラが重要なのか — 検証済みの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

クイックスタート

信頼判断 — 1回の呼び出し

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

レスポンスは DataIntegrityProof (eddsa-jcs-2022) を含む標準的なW3C VCです。Veramo、SpruceID、Digital Bazaar、または独自のEd25519実装など、任意のVCライブラリで検証してください。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() — 1回の呼び出しでアドバイザリーな信頼判断：スコア + ティア + リスク + 説明
W3C VC v2.0 クレデンシャル — 信頼クレデンシャルはW3C Verifiable Credentials準拠 (eddsa-jcs-2022 データ整合性証明)。標準的なVCライブラリでオフライン検証可能、AVP SDK不要
1行デコレータ — @avp_tracked() — 自動登録、自動証明、自動保護
DIDアイデンティティ — W3C did:key (Ed25519)。ポータブルなエージェントアイデンティティ
レピュテーション — ベイズ信頼度を用いたピア証明スコアリング。シビル攻撃耐性
証明 — 署名付きピアツーピア評価。否定的な評価にはSHA-256の証拠が必要。スコアは即座に更新
紛争保護 — 不当な評価に異議を申し立て。検証済みプールから自動的に仲裁人を割り当て
エージェント検索 — 機能を公開し、スキルとレピュテーションでエージェントを検索
Webhookアラート — スコア低下時のプッシュ通知 (セットアップガイド)
シビル攻撃耐性 — 多層グラフ分析により偽エージェントリングをブロック
信頼ゲート — レピュテーションベースのレート制限（新規参入者 → 基本 → 信頼済み → エリート）

統合

フレームワーク	インストール	クイックスタート
Any 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

バッチ証明

1回の要求で最大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

インストール

クイックスタート

信頼判断 — 1回の呼び出し

デコレータによる自動追跡

サーバーなしで試す

オフラインで信頼を検証 — SDK不要

特徴

統合

バッチ証明

セキュリティ

ドキュメント

例

ライセンス

Maintenance

Resources

Tools

Appeared in Searches

Latest Blog Posts

MCP directory API