🤖 Hedera Agent Kit V4 공개 — 정책 기반 AI 에이전트 제어·모듈형 SDK·플러그인 시스템 대규모 업데이트

 

Hedera Agent Kit V4가 공식 공개되었습니다. 이번 V4 업데이트의 핵심은 모듈화(Modularity), 제어(Control) 입니다. 기존처럼 하나의 거대한 SDK 패키지를 모두 설치하는 방식이 아니라, 개발자가 필요한 기능만 선택적으로 설치할 수 있는 구조로 변경되었으며, 동시에 AI 에이전트 행동을 세밀하게 통제할 수 있는 정책(policy) 후크(hook) 시스템이 새롭게 추가되었습니다.

특히 이번 업데이트는 결제(payments), 감사 추적(audit trails), 컴플라이언스(compliance), AI 오작동 방지와 같은 실제 운영 환경에서 필요한 “AI agent 행동을 의도된 방식으로 제한하는 결정론적 제어(deterministic control)” 구조를 제공하는 데 초점을 맞추고 있습니다.

⚙️ 완전히 새로워진 Tool 구조

기존 Agent Kit v3에서는 tool이 단순 object literal 기반 구조였습니다. 즉, 하나의 execute 함수, 제한적인 구조만 존재했기 때문에 실행 전 검증, 파라미터 검사, 실행 후 로깅, 정책 적용같은 세밀한 제어가 어려웠습니다.

V4에서는 이를 BaseTool 추상 클래스 구조로 완전히 변경했습니다.

이제 Tool은:

• Pre-execution
• Parameter normalization
• Core action
• Post-execution

등 명확한 lifecycle 단계로 나뉘며, 개발자는 각 단계마다 원하는 정책과 로직을 삽입할 수 있게 되었습니다.

기존 v3 방식도 호환은 유지되지만 Hooks & Policies(후크와 정책) 시스템 적용은 불가능하다고 설명합니다.

🔐 Hooks & Policies — AI Agent Guardrails

이번 V4의 가장 핵심적인 변화 중 하나는 AI 에이전트 행동 제어(guardrails) 시스템입니다.

Hedera는:

• HBAR 전송
• NFT minting
• Consensus 메시지 작성

등 실제 온체인 행동이 가능한 AI 에이전트 환경을 제공하기 때문에 “에이전트가 무엇을 할 수 있는가”를 엄격하게 통제하는 구조가 중요해졌습니다.

V4는 이를 위해 4단계 lifecycle hook 구조를 제공합니다:

• 1️ Pre-Tool Execution: Tool 실행 전 단계→ 시간대, 사용자 권한, agent role 등에 따라 행동 차단 가능

• 2️ Post-Parameter Normalization: 파라미터 정규화 이후 단계→ 전송 금액 제한, allowlist 주소 검사 가능

• 3️ Post-Core Action: 트랜잭션 생성 이후·제출 전 단계→ 실제 온체인 제출 직전 최종 검증 수행

• 4️ Post-Tool Execution: 실행 완료 이후 단계→ 감사 로그, spend tracking, downstream notification 가능

정책은 단순 설정 파일이 아닌 TypeScript 기반 composable object 형태로 제공되며, version control, code review, 테스트가 가능한 실제 application logic으로 관리됩니다.

🧩 Explicit Plugin 구조

V4에서는 plugin 시스템도 완전히 명시적(explicit) 구조로 변경되었습니다.

기존 v3에서는 plugins array가 비어 있어도 기본 tool이 자동 로드되었지만, v4에서는 empty plugins = zero tools입니다.

즉, 필요한 기능만 직접 import, 최소 권한 원칙(minimum permissions) 적용구조로 변경되었습니다.

예: 잔액 조회 agent → minting tool 불필요 → 명시적으로 제외 가능

🌐 Third-Party Plugin 생태계 확대

V4에서는 외부 plugin 생태계도 빠르게 확대되고 있습니다.

예:

• CoinCap → USD/HBAR 환율
• Chainlink → 가격 피드
• Pyth → 오라클 데이터
• Terminal 3 → 신원 인증 및 selective disclosure

등이 plugin 형태로 제공됩니다.

📦 Modular npm Package 구조

기존 v3는 단일 monolithic package형태였습니다.

V4에서는 @hashgraph/* scoped modular package 구조로 변경되었습니다.

예:

• @hashgraph/hedera-agent-kit → core package

• @hashgraph/hedera-agent-kit-langchain → LangChain toolkit

• @hashgraph/hedera-agent-kit-ai-sdk → Vercel AI SDK integration

• @hashgraph/hedera-agent-kit-elizaos → ElizaOS integration

• @hashgraph/hedera-agent-kit-mcp → standalone MCP server

🔄 Hiero SDK 전환

이번 업데이트에서는 SDK namespace도 변경되었습니다:

• 기존: @hashgraph/sdk

• 새 구조: @hiero-ledger/sdk

이는 Hedera JS SDK가 Hiero 오픈소스 구조로 공식 이전되었기 때문입니다.

🤖 Google ADK 지원 추가

V4에서는 Google Agent Development Kit (ADK)지원도 추가되었습니다.

이를 통해 개발자는 Gemini model, Google ADK framework기반으로 Hedera-powered AI agent를 구축할 수 있습니다.

또한, native ADK Web GUI, plugin tool-calling example, CLI runner등도 함께 제공됩니다.

💳 Hedera x402 Facilitator

마지막으로 Hedera exact payment scheme도 x402 표준에 공식 채택되었습니다.

이번 reference implementation은 HBAR, HTS fungible token (예: USDC) 기반 pay-per-request HTTP authorization 구조를 제공합니다.

특히 facilitator는:

• partially-signed transaction 검증
• balance 및 token association preflight check
• fee sponsorship
• transaction broadcasting

를 수행하며 실패 케이스까지 deterministic하게 처리할 수 있도록 설계되었습니다.

🧠 핵심 의미

이번 Hedera Agent Kit V4는 단순 SDK 업데이트를 넘어:

• AI agent 제어(control)
• 정책 기반 실행(policy-driven execution)
• 엔터프라이즈 컴플라이언스
• 모듈형 AI 인프라
• 프로그래머블 가드레일(programmable guardrails)

방향으로 Hedera AI agent 스택이 본격적으로 진화하고 있음을 보여주는 사례입니다.

특히 “AI agent가 실제 자산과 결제를 다루는 시대”를 전제로:

• 예측 가능하고 검증 가능한 동작 구조(deterministic behavior)
• 감사 가능성(auditability)
• 정책 기반 실행 제어(policy enforcement)
• 권한 기반 접근 통제(permission control)

기능을 SDK 레벨에서 제공하기 시작했다는 점이 핵심 변화로 평가됩니다.

🔗 https://hedera.com/blog/hedera-agent-kit-v4-policies-modular-packages-and-plugin-updates/

📚 지금 헤데라 커뮤니티에 참여하시고 최신 뉴스부터 실사용 가이드까지, 직접 소통하며 경험해보세요!

🟡 카카오 (PIN: 0916): https://open.kakao.com/o/gmfIGP0

📲 Telegram (KR): https://t.me/HashgraphKorea

💬 X: https://x.com/HederaKimchi

📺 https://www.youtube.com/@HederaKimchi