ํค๋ฐ๋ผ ์ด๋ฐดํธ (์งํ์ค)!
๐ค ํค๋ฐ๋ผ ์์ด์ ํธ ํคํธ ์ฌ์ธต ํ๊ตฌ: ํ๋ฌ๊ทธ์ธ, ๋๊ตฌ, ๊ทธ๋ฆฌ๊ณ ์ค์ฉ์ ์ํฌํ๋ก์ฐ
- ๊ณต์ ๋งํฌ ๋ง๋ค๊ธฐ
- X
- ์ด๋ฉ์ผ
- ๊ธฐํ ์ฑ
ํค๋ฐ๋ผ ์์ด์ ํธ ํคํธ(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):
- ์๋ก์ด ํ ํฝ์ ์์ฑํ๋ค.
- ํด๋น ํ ํฝ์ "hello" ๋ฉ์์ง๋ฅผ ์ ์ถํ๋ค.
- ๊ทธ ํ ํฝ์์ ๋ชจ๋ ๋ฉ์์ง๋ฅผ ์กฐํํ๋ค.
- "hello" ๋ฉ์์ง์ ์ํ์ค ID๋ฅผ ๊ฐ์ ธ์จ๋ค.
- "hi"๋ผ๋ ์๋ก์ด ๋ฉ์์ง๋ฅผ ์ ์ถํ๋ค.
- ์ํ์ค ๋ฒํธ๊ฐ 2 ์ด์์ธ ๋ฉ์์ง๋ง ํํฐ๋งํ๋ค.
๐ฐ B. ํ ํฐ ๊ด๋ฆฌ (Token Management)
ํค๋ฐ๋ผ ์์ด์ ํธ ํคํธ๋ ํ ํฐ ์์ฑ ๋ฐ ์ ์ก ๊ณผ์ ์ ๋ํํ ํ๋ฆ์ ํตํด ๋จ์ํํฉ๋๋ค.
์์ ์ฑํ
ํ๋ฆ (Chat Flow):
- "Chips
(CHI)"๋ผ๋ ํ ํฐ์ ์์ฑํ๋ค. (๊ณต๊ธ๋ 1000, ์ ํ ๊ณต๊ธ, ์์์ 1์๋ฆฌ, ์ฌ๋ฌด(treasury)๋ ์ด์์ ๊ณ์ ์ผ๋ก ์ค์ )
- ์ ํ ํฐ์ ์ธ๋ถ์ฌํญ์ ์กฐํํ๋ค.
- “Supply Key๋ ๋ฌด์์ด๊ณ , ์ ์ค์ ๋์ง ์์๋๊ฐ?” ์ ๊ฐ์ ์ง๋ฌธ์ ํ ์ ์๋ค. (์ถ๊ฐ ์ค๋ช
์์ฒญ ๊ฐ๋ฅ)
- ์ด์์ ๊ณ์ (์ฌ๋ฌด ๊ณ์ )์ Chips ํ ํฐ ์์ก์ ์กฐํํ๋ค.
- ์ด์์ ๊ณ์ ์์ ๊ณ์ 0.0.6883658๋ก Chips ํ ํฐ 1๊ฐ๋ฅผ ์ ์กํ๋ค.
- ๊ณ์ 0.0.6883658์ Chips ํ ํฐ ์์ก์ ์กฐํํ๋ค.
๐ค C. ๊ณ์ ๊ด๋ฆฌ (Account Management)
์์ด์ ํธ๋ ๊ณ์ ์์ฑ๊ณผ ์์ก ์ถ์ ์ ๊ฐ์ํํ๋ ๋ฐ ๋์์ ์ค๋๋ค.
์์ ์ฑํ
ํ๋ฆ (Chat Flow):
- ์๋ก์ด ๊ณ์ ์ ์์ฑํ๋ค. (๋ฉ๋ชจ: "operator account", ์ด๊ธฐ ์์ก = 10 HBAR, ์๋ ์ฐ๊ด ์ต๋๊ฐ = 1)
- ๊ณ์ 0.0.6888420์ ์๋ ์ฐ๊ด ์ต๋๊ฐ์ ๋ฌด์ ํ์ผ๋ก ์
๋ฐ์ดํธํ๋ค.
- ๊ณ์ 0.0.6888420์์ ์ด์์ ๊ณ์ ์ผ๋ก 1 HBAR๋ฅผ ์ ์กํ๋ค.
- ๋ ๊ณ์ ์ ์์ก์ ์กฐํํ์ฌ ์ ์ก์ ํ์ธํ๋ค.
Hedera Agent Kit์ AI ๊ธฐ๋ฐ ์ํฌํ๋ก์ฐ๋ฅผ ํค๋ฐ๋ผ ๋คํธ์ํฌ์ ์์ฝ๊ฒ ๋์
ํ ์ ์๋๋ก ๋์ต๋๋ค.
- ์ฌ๋์ด ์น์ธํ๋ Human-in-the-loop ๋ชจ๋
- ์์ ์๋ํ๋ Autonomous ๋ชจ๋
๋ ๊ฐ์ง ๋ชจ๋ ์ง์ํ๋ฉฐ, ํ๋ฌ๊ทธ์ธ ์ํคํ
์ฒ๋ฅผ ํตํด ๊ฐ๋ ฅํ๊ณ ๋๋ฉ์ธ ํนํ๋ ์ ํ๋ฆฌ์ผ์ด์
์ ์ ์ํ ์ ์์ต๋๋ค.
๋ฆฌ์์ค:
- ๐ป
Hedera Agent Kit on GitHub: https://github.com/hashgraph/hedera-agent-kit-js
- ๐งฉ
Plugins & Tools Documentation: https://github.com/hashgraph/hedera-agent-kit-js/blob/main/docs/PLUGINS.md
- ๐ค
Hedera AI Studio Documentation: https://docs.hedera.com/hedera/open-source-solutions/ai-studio-on-hedera/hedera-ai-agent-kit
์ถ์ฒ: 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
- ๊ณต์ ๋งํฌ ๋ง๋ค๊ธฐ
- X
- ์ด๋ฉ์ผ
- ๊ธฐํ ์ฑ




๋๊ธ
๋๊ธ ์ฐ๊ธฐ