Skip to main content
Glama

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). 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

응답은 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

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.


보안

  • 논스(nonce) 재전송 방지 기능이 포함된 Ed25519 서명 인증

  • 입력 검증 — 인젝션 탐지, PII 스캔

  • 에이전트 일시 중지 — 손상된 에이전트는 즉시 차단

  • 감사 추적 — SHA-256 해시 체인 로그, IPFS에 고정


문서

문서

설명

API 참조

예제가 포함된 전체 SDK 메서드 참조

고객 통합

제어된 작업 흐름, 비밀 정보, 오류 및 규정 준수 증거

통합

프레임워크별 설정 가이드

웹훅 경고

푸시 알림 설정

프로토콜 사양

와이어 형식 및 인증

보안 컨텍스트

에이전트 신뢰가 중요한 이유 — 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 참조.

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
<1hResponse time
5dRelease cycle
9Releases (12mo)

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