🤖 헤데라 에이전트 키트 심층 탐구: 플러그인, 도구, 그리고 실용적 워크플로우


헤데라 에이전트 키트(Hedera Agent Kit) 지능형 에이전트 워크플로우를 헤데라 네트워크에 도입하는 오픈소스 툴킷입니다.

이는 개발자가 헤데라 합의 서비스(HCS), 토큰 서비스(HTS), 계정 관리 기능을 에이전트 기반 애플리케이션에 통합할 있도록 설계되었습니다. 에이전트는 단순히 정보를 처리하는 것을 넘어 토큰 전송, 계정 관리, 워크플로우 조정까지 퍼블릭 원장에서 직접 수행할 있습니다.

블로그에서는 에이전트 키트의 아키텍처를 설명하고, 플러그인 시스템을 강조하며, 실제로 에이전트가 헤데라 서비스와 상호작용하는 사례를 보여주어 탈중앙 네트워크에서 AI 기반 애플리케이션의 새로운 가능성을 열어갑니다.

1. 헤데라 에이전트 키트란?

헤데라 에이전트 키트는 AI 기반 에이전트(: LangChain, LLM 기반 어시스턴트) 헤데라 서비스 사이의 간극을 메웁니다.

구성 요소:

A. 플러그인 (Plugins)

  • 헤데라 플러그인: 헤데라 팀이 공식적으로 유지하는 핵심 플러그인
  • 서드파티 플러그인: 커뮤니티가 제작한 확장 기능 (: 오라클, 브릿지, 디파이 )

B. 도구 (Tools)

  • HCS 메시징, 토큰 작업, 계정 관리 등을 위한 Hedera SDK 래퍼

C. 운영 모드

  • Human-in-the-loop (HITL): 트랜잭션 실행 전에 사용자가 서명해야 보안과 투명성이 중요한 사용자 앱에 적합
  • Autonomous (자율형): 에이전트가 인간 승인 없이 명령을 실행 반복 작업(: HCS 모니터링, 토큰 재분배) 적합

🧩 2. 플러그인과 도구 개요 (Plugins and Tools Overview)

헤데라 에이전트 키트의 핵심에는 모듈형 플러그인 시스템에 있습니다. 플러그인은 에이전트에게 특정 헤데라 서비스에 접근할 있도록 하는 구성 블록(building blocks) 역할을 하며, 또한 쿼리 플러그인은 원장 데이터에 대한 읽기 전용 접근을 제공하여, 보안성과 유연성을 모두 갖춘 워크플로우 설계를 가능하게 합니다.

📂 코어 플러그인 상세

아래는 키트에 포함된 핵심 플러그인들의 세부 항목입니다:

👤 A. 계정 플러그인 (Account Plugins)

  • Core Account Plugin: 헤데라 계정을 생성하고 관리하는 도구.
  • Core Account Query Plugin: 계정 관련 데이터를 조회하는 도구 (잔액, 속성, 토큰 연관 관계 ).

📝 B. 합의 서비스(HCS) 플러그인 (Consensus Service Plugins)

  • Core Consensus Plugin: HCS 토픽에 메시지를 게시하거나 관리하는 기능 제공.
  • Core Consensus Query Plugin: HCS 메시지를 검색·필터링하는 기능 제공.

💰 C. 토큰 서비스(HTS) 플러그인 (Token Service Plugins)

  • Core Token Plugin: 대체 가능 토큰(FT) 대체 불가 토큰(NFT) 생성하고 관리하는 도구.
  • Core Token Query Plugin: 토큰 정보, 공급량, 잔액 등을 조회하는 도구.

📜 D. EVM 플러그인 (EVM Plugins)

  • Core EVM Plugin: 헤데라 스마트 컨트랙트(ERC-20, ERC-721) 상호작용하는 도구.
  • Core EVM Query Plugin: 컨트랙트 데이터와 상태를 조회하는 도구.

🔄 E. 트랜잭션 플러그인 (Transaction Plugins)

  • Core Transactions Plugin: 헤데라 트랜잭션 생명주기를 관리하는 도구 (생성, 서명, 제출).

🔧 커뮤니티 확장성

기본 플러그인 외에도 개발자들은 커뮤니티가 기여한 플러그인을 탐색하거나, 직접 자신만의 플러그인을 제작할 있습니다. 플러그인 아키텍처는 확장성(extensibility) 염두에 두고 설계되었기 때문에, 오라클·브릿지·모니터링 도구·특화 자동화 등을 에이전트 워크플로우에 쉽게 통합할 있습니다.

⚙️ 3. 헤데라 에이전트 키트 예제 워크플로우

이제 합의 서비스 (HCS), 토큰 관리, 계정 관리에 대한 실제 워크플로우 예시를 살펴보겠습니다.

각각의 워크플로우는 Next.js 기반 Hedera Agent Chat 예제에서 실행할 있습니다.

📨 A. 합의 메시징 (Consensus Messaging, HCS)

예제 채팅 흐름 (Chat Flow):

  1. 새로운 토픽을 생성한다.
  2. 해당 토픽에 "hello" 메시지를 제출한다.
  3. 토픽에서 모든 메시지를 조회한다.
  4. "hello" 메시지의 시퀀스 ID 가져온다.
  5. "hi"라는 새로운 메시지를 제출한다.
  6. 시퀀스 번호가 2 이상인 메시지만 필터링한다.

💰 B. 토큰 관리 (Token Management)

헤데라 에이전트 키트는 토큰 생성 전송 과정을 대화형 흐름을 통해 단순화합니다.

예제 채팅 흐름 (Chat Flow):

  1. "Chips (CHI)"라는 토큰을 생성한다. (공급량 1000, 유한 공급, 소수점 1자리, 재무(treasury) 운영자 계정으로 설정)
  2. 토큰의 세부사항을 조회한다.
  3. Supply Key 무엇이고, 설정되지 않았는가? 같은 질문을 있다. (추가 설명 요청 가능)
  4. 운영자 계정(재무 계정) Chips 토큰 잔액을 조회한다.
  5. 운영자 계정에서 계정 0.0.6883658 Chips 토큰 1개를 전송한다.
  6. 계정 0.0.6883658 Chips 토큰 잔액을 조회한다.

👤 C. 계정 관리 (Account Management)

에이전트는 계정 생성과 잔액 추적을 간소화하는 도움을 줍니다.

예제 채팅 흐름 (Chat Flow):

  1. 새로운 계정을 생성한다. (메모: "operator account", 초기 잔액 = 10 HBAR, 자동 연관 최대값 = 1)
  2. 계정 0.0.6888420 자동 연관 최대값을 무제한으로 업데이트한다.
  3. 계정 0.0.6888420에서 운영자 계정으로 1 HBAR 전송한다.
  4. 계정의 잔액을 조회하여 전송을 확인한다.

🛠️ 빌드를 시작하세요 (Start Building with the Hedera Agent Kit)

Hedera Agent Kit AI 기반 워크플로우를 헤데라 네트워크에 손쉽게 도입할 있도록 돕습니다.

  • 사람이 승인하는 Human-in-the-loop 모드
  • 완전 자동화된 Autonomous 모드

가지 모두 지원하며, 플러그인 아키텍처를 통해 강력하고 도메인 특화된 애플리케이션을 제작할 있습니다.

리소스:

출처: https://hedera.com/blog/deep-dive-into-the-hedera-agent-kit-plugins-tools-and-practical-workflows

📚 헤데라의 모든 , 한곳에! “헤데라 지식창고 헤데라김치와 함께하세요!

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

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

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

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

댓글