🐍 헤데라 Agent Kit를 위한 Python SDK를 소개합니다.

🚀 AI × 블록체인 개발자를 위한 확장된 프로그래머빌리티

Hedera Agent Kit를 위한 Python SDK를 소개합니다. 이번 SDK는 AI와 블록체인의 교차점을 탐구하고자 하는 더 폭넓은 개발자 커뮤니티를 위해 확장된 프로그래머빌리티를 제공합니다.

🔧 JavaScript SDK 이후의 다음 단계

Python SDK는 기존의 JavaScript SDK에 이은 후속 버전으로, 개발자가 LangChain, Vercel, MCP 중 원하는 AI 프레임워크를 선택하여 Hedera Testnet과 상호작용하는 에이전트를 구축할 수 있도록 지원합니다.

이 SDK를 통해 개발자는 암호화폐 결제를 실행할 수 있는 AI 에이전트를 만들 수 있으며, 이는 블록체인 없이 AI 에이전트가 구현하기 어려운 무허가(permissionless) 거래 및 마이크로 트랜잭션을 가능하게 합니다.

Python은 AI 및 머신러닝을 위한 풍부한 라이브러리와 통합 환경을 갖춘 대표적인 언어이기 때문에, Python SDK는 AI Studio 도구 세트의 자연스러운 다음 단계입니다.

🧠 LangChain v1.0 통합 지원

Python SDK는 LangChain v1.0과 통합되어 있으며, LangChain과 LangGraph를 하나의 간결한 SDK로 통합합니다. 이를 통해 Hedera 위에서 AI 에이전트를 구축하는 Python 개발자들에게 미래 호환성과 일관된 개발 경험을 제공합니다.

✨ 새로운 SDK로 무엇이 달라졌을까요?

이제 새롭게 출시된 SDK에서 어떤 기능들이 추가되었는지 살펴보겠습니다.

🤖 Hedera Agent Kit란 무엇인가?

Hedera Agent Kit는 AI 에이전트가 Hedera 네트워크와 직접 상호작용할 수 있도록 설계된 오픈소스 프레임워크입니다.

이 프레임워크는 다음과 같은 Hedera 기능을 손쉽게 사용할 수 있도록 하는 플러그인 세트를 제공합니다:

계정 생성 및 트랜잭션 처리와 같은 기본 계정 작업
토큰 생성 및 관리(HTS)
합의 서비스(HCS) 를 통한 불변(immutable) 메시지 게시
스마트 컨트랙트 실행(EVM)

개발자는 이러한 도구를 활용해, Hedera의 고유한 기능을 최대한 활용하는 AI 에이전트를 구축할 수 있습니다.

🧩 Python SDK의 핵심 기능

🏗️ 플러그인 기반 아키텍처

Python SDK는 모듈화되고 확장 가능한 플러그인 아키텍처를 중심으로 설계되었습니다. 각 플러그인은 관련 도구들을 하나로 묶어 제공하며, 필요한 기능만 선택하거나 특정 사용 사례에 맞는 커스텀 플러그인을 제작할 수 있습니다.

🔌 제공되는 플러그인 목록

🔑 Core Account Plugin

HBAR 전송
계정 생성, 업데이트, 삭제
Allowance 승인 및 삭제

🧬 Core Token Plugin (HTS)

대체 가능 / 대체 불가능 토큰 생성
토큰 민팅, 연결(associate), 해제(dissociate)
대체 가능 토큰 에어드랍
Allowance를 통한 토큰 전송

🧾 Core Consensus Plugin (HCS)

토픽 생성, 업데이트, 삭제
토픽에 메시지 제출

📜 Core EVM Plugin

ERC-20 토큰 생성 및 전송
ERC-721 토큰 생성 및 전송

🔍 Core Query Plugins

계정 정보 및 HBAR 잔액 조회
토큰 정보 및 잔액 조회
토픽 정보 조회
트랜잭션 기록 조회
환율 정보 조회

🤝 AI 제공자 선택의 유연성

이 SDK는 다양한 AI 제공자와 함께 작동합니다. 개발자는 필요와 예산에 맞는 옵션을 선택할 수 있습니다.

Ollama: 로컬 실행, API 키 불필요
Groq: 관대한 무료 티어 제공
OpenAI, Claude: 프로덕션 환경용

⚙️ 실행 모드 (Execution Modes)

🤖 Autonomous Mode

에이전트가 설정된 운영자(operator) 계정을 사용해 트랜잭션을 직접 실행합니다.

🧾 Return Bytes Mode (출시 예정)

원시 트랜잭션 바이트(raw transaction bytes)를 반환하여, 사용자가 직접 검토·서명·제출할 수 있습니다. 이는 추가 승인 단계나 외부 서명 워크플로우가 필요한 애플리케이션에 유용합니다.

🛠️ 무엇을 만들 수 있을까?

Hedera Agent Kit는 다양한 AI 기반 애플리케이션 가능성을 열어줍니다.

💰 재무 및 결제 에이전트: 잔액을 모니터링하고, HBAR 전송을 실행하며, 사전 정의된 규칙 또는 자연어 명령에 따라 토큰 분배를 관리하는 에이전트
🤖 토큰 관리 봇: 대체 가능 또는 NFT 토큰의 생성·민팅·분배 자동화, 에어드랍 처리, Allowance 관리, 신규 자산 발행 요청 대응 등
🧵 온체인 메시징 시스템: 합의 서비스 플러그인을 사용해 토픽에 업데이트 게시, 이벤트 기록, 시스템 간 조정 수행
📦 스마트 컨트랙트 인터페이스: ERC-20 또는 ERC-721 컨트랙트를 배포하고, 에이전트가 전송·조회·상호작용을 처리하도록 구성
📊 모니터링 및 리포팅 도구: 계정 잔액, 토큰 보유량, 트랜잭션 이력을 조회하고 이를 실시간으로 요약하거나 자동 실행