AgentVeil Protocol
agentveil
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 agentveilRelated 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응답은 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()— 단일 호출 자문 신뢰 결정: 점수 + 등급 + 위험도 + 설명W3C VC v2.0 자격 증명 — 신뢰 자격 증명은 W3C Verifiable Credentials 표준(
eddsa-jcs-2022데이터 무결성 증명)을 준수합니다. 표준 VC 라이브러리를 사용하여 오프라인에서 검증 가능하며, AVP SDK가 필요하지 않습니다.한 줄 데코레이터 —
@avp_tracked()— 자동 등록, 자동 증명, 자동 보호DID 신원 — W3C
did:key(Ed25519). 휴대 가능한 에이전트 신원평판 — 베이지안 신뢰도를 갖춘 피어 증명 점수. 시빌 공격 방지
증명 — 서명된 피어 투 피어 평가. 부정적인 평가는 SHA-256 증거가 필요합니다. 점수는 즉시 업데이트됩니다.
분쟁 보호 — 불공정한 평가에 이의 제기. 검증된 풀에서 자동으로 중재자 할당
에이전트 검색 — 기능 게시, 기술 및 평판별 에이전트 검색
웹훅 경고 — 점수 하락 시 푸시 알림 (설정 가이드)
시빌 공격 방지 — 다층 그래프 분석을 통해 가짜 에이전트 그룹 차단
신뢰 게이트 — 평판 기반 속도 제한 (신규 사용자 → 기본 → 신뢰됨 → 엘리트)
통합
프레임워크 | 설치 | 빠른 시작 |
Any Python |
|
|
CrewAI |
|
|
LangGraph |
|
|
AutoGen |
|
|
OpenAI |
|
|
Claude |
|
|
Hermes |
|
|
Paperclip |
|
|
AWS Bedrock |
| AVP 신뢰 도구를 사용한 Converse API |
AgentMesh (MS AGT) |
|
|
전체 통합 가이드: 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.
보안
논스(nonce) 재전송 방지 기능이 포함된 Ed25519 서명 인증
입력 검증 — 인젝션 탐지, PII 스캔
에이전트 일시 중지 — 손상된 에이전트는 즉시 차단
감사 추적 — SHA-256 해시 체인 로그, IPFS에 고정
문서
문서 | 설명 |
예제가 포함된 전체 SDK 메서드 참조 | |
제어된 작업 흐름, 비밀 정보, 오류 및 규정 준수 증거 | |
프레임워크별 설정 가이드 | |
푸시 알림 설정 | |
와이어 형식 및 인증 | |
에이전트 신뢰가 중요한 이유 — CVE 및 시장 데이터 | |
버전 기록 |
예제
예제 | 설명 |
엔드투엔드 가이드 — 신뢰 확인 → 위임 → 신호 변경 → 경고 → 오프라인 검증 가능 증명. 로컬 백엔드 필요. | |
서버 불필요 — 모의 모드를 포함한 전체 SDK 데모 | |
등록, 카드 게시, 평판 확인 | |
증명을 포함한 전체 A2A 상호작용 | |
오프라인 자격 증명 검증 (SDK 불필요) |
프레임워크 예제: CrewAI · LangGraph · AutoGen · OpenAI · Claude MCP · Paperclip
라이선스
MIT — LICENSE 참조.
Maintenance
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/agentveil-protocol/avp-sdk'
If you have feedback or need assistance with the MCP directory API, please join our Discord server