What is AgentKit, and which one should I use?

AgentKit commonly refers to Coinbase AgentKit for onchain actions and Inngest AgentKit for orchestrating agents. Choose Coinbase for Web3 tasks (wallets, tokens) and Inngest for multi-agent, event-driven workflows.

How do I safely let an AI agent move funds onchain?

Use small balances, strict tool schemas, and confirmation prompts for risky actions. For production, integrate Safe smart accounts and require multisig or policy approvals.

Can I combine OpenAI Agents with Coinbase AgentKit?

Yes. Connect your reasoning layer (OpenAI Agents/function calling) to Coinbase AgentKit tools. Many devs also add Inngest for orchestration and retries.

What are common pitfalls when using AgentKit?

Hardcoding keys, skipping testnets, and allowing unbounded actions are the big ones. Add rate limits, spend caps, and robust observability to stay safe.

Where can I find a quickstart to build a Web3 AI agent?

Start with Coinbase’s AgentKit quickstart for setup and examples, plus tutorials from QuickNode and workshop videos for end-to-end guidance.

AgentKitን እንዴት መጠቀም እንደሚቻል፡ AI ወኪሎችን ለመስራት ተግባራዊ፣ ከጫፍ እስከ ጫፍ መመሪያ

ስለ “AgentKit” ወሬ ሰምተው ከሆነ እና እንዴት በተግባር ላይ ማዋል እንደሚችሉ እያሰቡ ከሆነ፣ በትክክለኛው ቦታ ላይ ነዎት። እዚህ ላይ ያለው ቁም ነገር፡ AgentKit አንድ ነጠላ ምርት አይደለም። ስሙ በብዙ ሥነ-ምህዳሮች ጥቅም ላይ ይውላል—በተለይም የ Coinbase's AgentKit ለኦንቼይን/Web3 ድርጊቶች፣ የ Inngest's AgentKit የወኪል ኔትወርኮችን ለማስተባበር፣ እና የ OpenAI Agents SDKን ከCoinbase ኪት ጋር በመጠቀም የተለያዩ ትምህርቶች። ይህ መመሪያ እያንዳንዱ AgentKit ምን እንደሆነ፣ አንዱን ከሌላው ለምን እንደሚመርጡ እና እንዴት ደረጃ በደረጃ እንደሚያዘጋጁት፣ የባለሙያ ምክሮችን እና እንደገና ጥቅም ላይ ሊውሉ የሚችሉ የእውነተኛ ዓለም አብነቶችን ይገልጻል።

ተግባራዊ እና መፍትሄ ተኮር አካሄድን እንወስዳለን፡ ፈጣን ንጽጽሮች፣ ግልጽ ማዋቀር፣ ማስኬድ የሚችሉ ምሳሌዎች እና መወገድ ያለባቸው አደጋዎች።

ስለ የትኛው “AgentKit” ነው እያወሩ ያሉት?

Coinbase AgentKit (CDP/Onchain)፡ የ AI ወኪሎች የኪስ ቦርሳዎችን እንዲያስተዳድሩ፣ ኦንቼይን ግብይቶችን እንዲልኩ፣ ቶከኖችን እንዲያሰማሩ እና በተደገፉ ኔትወርኮች ላይ ተጨማሪ እንዲያደርጉ ያስችላቸዋል። ለWeb3-ቤተኛ ወኪሎች ለመገንባት ተስማሚ ነው (ለምሳሌ፣ የጥቆማ ቦቶች፣ ቶከን ማሰማሪያዎች፣ NFT አከፋፋዮች)። ፈጣን መነሻ መመሪያዎች እና አውደ ጥናቶች በስፋት ይገኛሉ።

Inngest AgentKit፡ ወኪሎችን፣ መሳሪያዎችን ለመግለጽ እና በኔትወርክ ውስጥ ለማስኬድ የሚያስችል ማዕቀፍ ሲሆን፣ በሚለካ፣ በክስተት ላይ በተመሰረተ አፈጻጸም ላይ ያተኩራል። ብዙ ወኪሎችን፣ እንደገና መሞከር አመክንዮን እና የጀርባ የስራ ፍሰቶችን ለማስተባበር በጣም ጥሩ ነው።

Safe/Protocol Kits (ዐውደ-ጽሑፍ)፡ ወኪልዎ ስማርት አካውንት ቁጥጥር (ባለብዙ ፊርማ፣ ፖሊሲ፣ በባች የተደረጉ ጥሪዎች) የሚያስፈልገው ከሆነ፣ የSafe's Protocol Kit ብዙ ጊዜ ለደህንነቱ የተጠበቀ አፈጻጸም ከኦንቼይን ወኪሎች ጋር ይጣመራል።

ግብዎ ኦንቼይን AI ወኪልን በፍጥነት መገንባት ከሆነ፣ በ Coinbase AgentKit ይጀምሩ። ጠንካራ፣ ባለብዙ ወኪል አርክቴክቸር እና መርሐግብር የሚያስፈልግዎ ከሆነ፣ Inngest AgentKit ጠንካራ አማራጭ ነው። ብዙ ቡድኖች ሁለቱንም ይቀላቅላሉ፡ OpenAI Agents ለምክንያታዊነት + Coinbase AgentKit ለኦንቼይን ድርጊቶች + Inngest ለማስተባበር።

፡ ፈጣን የውሳኔ መመሪያ

Web3 ወኪል ገንዘብ ማንቀሳቀስ፣ ቶከኖችን ማሰማራት ወይም ከ dapps ጋር መገናኘት እንዲችል ይፈልጋሉ → Coinbase AgentKitን ይጠቀሙ።

ብዙ ወኪሎችን/መሳሪያዎችን እንደገና በመሞከር እና በስቴት በማስተባበር የሚችል ዘላቂ፣ በክስተት ላይ የተመሠረተ ስርዓት ያስፈልግዎታል → Inngest AgentKitን ይጠቀሙ።

ለወኪልዎ የድርጅት ደረጃ የኪስ ቦርሳ ደህንነት ወይም ባለብዙ ፊርማ አስተዳደር ያስፈልግዎታል → የSafe's Protocol Kitን ከወኪልዎ ጎን ያዋህዱ።

ክፍል 1፡ Coinbase AgentKitን እንዴት መጠቀም እንደሚቻል (ኦንቼይን ወኪሎች)

Coinbase AgentKit ለምን?

ለኦንቼይን ተግባራት ከአገልግሎት መስጫ ውጭ የተሰራ (የኪስ ቦርሳ ስራዎች፣ ዝውውሮች፣ ቶከን አስተዳደር)

ንጹህ የገንቢ ልምድ እና ፈጣን የመነሻ መሳሪያ

በማህበራዊ ሚዲያ (ለምሳሌ X) ላይ ከሚገኙ ተጠቃሚዎች ጋር ለመገናኘት እና ድርጊቶችን በኦንቼይን ላይ ለማስቀመጥ ለሚችሉ ቦቶች/ወኪሎች ተስማሚ

የማዋቀር አጠቃላይ እይታ

CLI እና SDK (በፈጣን ጅምር መሰረት) ይጫኑ እና ለአውታረ መረብ፣ ቁልፎች እና RPC የመጨረሻ ነጥቦች የአካባቢ ተለዋዋጮችን ያዋቅሩ።

ፕሮጀክት ያስጀምሩ እና የሚፈልጉትን ኦንቼይን ችሎታዎች ይምረጡ።

መሳሪያዎችን (ለምሳሌ፣ የኪስ ቦርሳ ስራዎች፣ ቶከን ማሰማራት) ከወኪልዎ ጋር ያገናኙ።

መሳሪያዎችን መቼ እንደሚደውሉ ለመወሰን ወኪሉን ከምክንያታዊነት ሞዴል (OpenAI ወይም ተመሳሳይ) ያገናኙ።

በደቂቃዎች ውስጥ ለመጀመር ኦፊሴላዊውን ፈጣን ጅምር ይከተሉ። የኪስ ቦርሳዎችን የሚያስተዳድር እና በTwitter/X ላይ የሚገናኝ Web3 AI ወኪልን ስለመስራት ተግባራዊ ትምህርት ለማግኘት፣ የ QuickNode አጠቃላይ እይታን እና AgentKit Twitter bot ስለመፍጠር የቪዲዮ ማሳያን ይመልከቱ።

የምሳሌ አርክቴክቸር

የምክንያታዊነት ንብርብር፡ LLM ከ ተግባር/መሳሪያ ጥሪ ጋር

የድርጊት ንብርብር፡ Coinbase AgentKit መሳሪያዎች (ዝውውር፣ ቶከን ማሰማራት)

ጽናት፡ የወኪል ማህደረ ትውስታ/ግቦችን በመረጃ ቋት ውስጥ ያስቀምጡ

የፊት ለፊት፡ የውይይት UI ወይም ለማህበራዊ ቦት (X) ለተጠቃሚ ጥያቄዎች

ምርጥ ልምዶች

የትንሹ መብት መርህ፡ የወኪል ቁልፎችን ወደ አስፈላጊው ወሰን እና አነስተኛ ቀሪ ሂሳብ ይገድቡ

የፖሊሲ ጥያቄዎች፡ ኦንቼይን ድርጊቶች መቼ እንደሚፈቀዱ ግልጽ ደንቦችን ይግለጹ

የጥበቃ መንገዶች፡ የግብይት ቅድመ እይታ/ማረጋገጫን ይተግብሩ፣ በየጊዜው የገደብ መስኮት

ክትትል፡ ለኦዲት የሚደረጉ የመሳሪያ ጥሪዎችን፣ ግብይቶችን እና የሞዴል ውጤቶችን ይግቡ

የተለመዱ አደጋዎች

የላላ ቁልፍ አስተዳደር፡ በጭራሽ ሚስጥሮችን በኮድ ውስጥ አያስቀምጡ፤ ቮልት ይጠቀሙ

ያልተገደበ ድርጊቶች፡ ለትልቅ ዋጋ ዝውውሮች ማረጋገጫዎችን ይጠይቁ

የጎደሉ የፍጥነት ገደቦች፡ RPC የመጨረሻ ነጥቦችን እና ማህበራዊ ኤፒአይዎችን ይጠብቁ

ክፍል 2፡ Inngest AgentKitን እንዴት መጠቀም እንደሚቻል (የወኪል ኔትወርኮች እና ኦርኬስትራ)

Inngest AgentKit ለምን?

ወኪሎች እንደ መጀመሪያ ደረጃ፣ ግብ የሌላቸው ሰራተኞች ግቦች እና የመሳሪያ ስብስቦች

ብዙ ወኪሎችን ለተወሳሰቡ የስራ ፍሰቶች ለማስተባበር ኔትወርኮች

ክስተት ላይ የተመሰረተ ንድፍ ከእንደገና ሙከራዎች እና ዘላቂ አፈፃፀም ጋር

የመጀመሪያ ወኪልዎን ለማሽከርከር እና በኔትወርክ ውስጥ ለማስኬድ በፈጣን ጅምር ይጀምሩ። የንግድ ሥራ አመክንዮ ከመፍጠርዎ በፊት ዋና ጽንሰ-ሐሳቦችን - ወኪሎች, መሳሪያዎች, ኔትወርኮች - ያንብቡ.

የማዋቀር ደረጃዎች

የወኪልዎን ግብ እና የሚገኙ መሳሪያዎችን ይግለጹ (ኤፒአይዎች፣ የውስጥ አገልግሎቶች፣ ኦንቼይን ኪቶች)።

ኔትወርክ ይፍጠሩ እና ወኪሎችን ይመዝግቡ።

ወኪሎችን ለማስነሳት ክስተቶችን ያውጡ፤ ለጽናት እንደገና መሞከር እና ማፈግፈግ ይጠቀሙ።

ክትትልን ያክሉ፡ ምዝግቦች፣ ዱካዎች፣ ውጤቶች።

የኦርኬስትራ አብነቶች

ተቆጣጣሪ-ሰራተኛ፡ የእቅድ አውጪ ወኪል ተግባሮችን ለልዩ ወኪሎች ያስተላልፋል

ክስተት-ምንጭ፡ የስቴት ለውጦች ወኪሎች ምላሽ እንዲሰጡ ያደርጋል (ለምሳሌ፣ payment_received → fulfillment_agent)

በሰው-በሉፕ፡ ለአደገኛ ድርጊቶች ማፅደቆች፣ ለአፍታ ማቆም/እንደገና ማስጀመር

ጠቃሚ ምክሮች

ወኪሎችን ግብ የለሽ ያድርጉ፤ ሁኔታን በክስተቶች/የስቴት ማከማቻዎች በኩል ያስተላልፉ

ከጊዜ ወደ ጊዜ አፈጻጸምን ለመከታተል የመሳሪያዎችን እና ጥያቄዎችን ስሪት ያድርጉ

የውድቀት ሁነታዎችን ያስመስሉ፤ ለውጫዊ ጥሪዎች idempotencyን ያረጋግጡ

ክፍል 3፡ በ Safe ደህንነቱ የተጠበቀ አፈጻጸም (አማራጭ ግን የሚመከር)

ወኪልዎ ገንዘብን የሚያስተዳድር ወይም የአስተዳደር ስራዎችን የሚያከናውን ከሆነ፣ ስማርት አካውንቶችን ከአስተዳደር ጋር ያዋህዱ። የSafe's Protocol Kit ለስማርት አካውንቶች እና ባለብዙ ፊርማ ፍሰቶች መፍጠር፣ ማዋቀር እና አፈጻጸምን ያቀርባል።

የአጠቃቀም ጉዳይ፡ ኦንቼይን ወኪል ግብይቶችን ያስገባል፣ ባለቤቶቹ (ሰዎች ወይም ተቆጣጣሪ ወኪሎች) በጋራ ይፈርማሉ

ጥቅም፡ የፖሊሲ ቁጥጥሮች፣ የወጪ ገደቦች እና ደህንነቱ የተጠበቀ መልሶ ማግኛ

አብነት፡ ወኪል ግብይቶችን ይጠቁማል፤ የፖሊሲ ሞተር (ወይም ሰው) ይፈርማል እና ያስፈጽማል

ደረጃ በደረጃ፡ አነስተኛውን ኦንቼይን ወኪል መገንባት

ከዚህ በታች ሊያስተካክሉት የሚችሉት ጽንሰ-ሐሳባዊ ፍሰት ነው (ቋንቋ-አግኖስቲክ፣ የውሸት ኮድ-ቅጥ)። የሚሰራ ኮድ እና CLI ትዕዛዞችን ለማግኘት የCoinbase ፈጣን ጅምርን ይመልከቱ።

ፕሮጀክት አስጀምር እና ጥገኞችን ጫን

የፕሮጀክት ማውጫ ይፍጠሩ እና የ AgentKit SDK እና የእርስዎን LLM ደንበኛ ይጫኑ

የአካባቢ ተለዋዋጮችን ያዘጋጁ፡ RPC URL፣ የግል ቁልፍ ወይም የሚተዳደር ቦርሳ፣ አውታረ መረብ

መሳሪያዎችን እና ችሎታዎችን ይግለጹ

ቦርሳ፡ get_balance, transfer(to, amount)

ቶከኖች፡ deploy_erc20(name, symbol, supply)

እንደ አስፈላጊነቱ የውል ጥሪዎችን አንብብ/ጻፍ

የምክንያታዊነት ሞዴልን ያገናኙ

ግቦችን እና ገደቦችን የሚገልጽ የስርዓት ጥያቄ ያቅርቡ

ደህንነቱ የተጠበቀ ተግባር ለመጥራት መሳሪያዎችን በ schema ይመዝግቡ

ደህንነት እና ፖሊሲዎችን ጨምር

ከመነሻው በላይ ለዝውውሮች ማረጋገጫን አስገድድ

ዕለታዊ ወጪን ይገድቡ፣ ለአምራችነት የተቀባይ አድራሻዎችን ይፍቀዱ

መሰረታዊ በይነገጽ ይላኩ

CLI: agent ask "0.01 ETH ወደ 0x... ላክ"

ድር/ውይይት፡ ተግባራትን ለማስገባት እና ደረሰኞችን ለማሳየት አነስተኛ UI

በመጀመሪያ በሙከራ አውታረ መረብ ላይ ይሞክሩ

የFaucet ገንዘብ; የድርጊት ምዝግብ ማስታወሻዎችን እና የግብይት ሃሾችን ያረጋግጡ

በክትትል ወደ ምርት ይሂዱ

ቴሌሜትሪን ያንሱ፣ ያልተሳኩ ግብይቶች ላይ ማንቂያዎች እና በሞዴል ባህሪ ውስጥ መንሸራተት

በምርት ውስጥ የሚሰሩ አብነቶች

እቅድ-ከዚያ-ተግባር፡ መሣሪያዎችን ከመጥራትዎ በፊት እርምጃዎችን ለመዘርዘር ሞዴሉን ይጠቀሙ

ደረቅ-ሩጫ ሁነታ፡ ግብይቶችን አስቀድመው ይመልከቱ እና ማፅደቅን ይጠይቁ

የበጀት ኤንቨሎፖች፡ ለእያንዳንዱ ተግባር የወጪ ጣሪያ እና የመሳሪያ ጊዜ ማብቂያዎችን ይስጡ

ሰው ሰራሽ ክትትል፡ የታቀዱ ተግባራት የወኪሉን ጤንነት እና RPC ግንኙነት ያረጋግጣሉ

የእውነተኛ ዓለም ምሳሌ ሁኔታዎች

የማህበረሰብ የጥቆማ ቦት፡ ተጠቃሚዎች ቦቱን በ X ላይ ይጠቅሳሉ; ወኪሉ የተረጋገጡ ቦርሳዎችን በኦንቼይን ላይ ይጠቁማል

የደንበኛ ሽልማቶች፡ ወኪል ኦንቼይን እርምጃዎችን ይከታተላል እና በየሳምንቱ የሽልማት ቶከኖችን ይልካል

DAO ስራዎች፡ ወኪል ለፕሮፖዛል የSafe ግብይቶችን ያዘጋጃል; ባለብዙ ፊርማ ከግምገማ በኋላ ይፈርማል

የገበያ ቦታ ረዳት፡ ወኪል NFTsን ይዘረዝራል እና ለተጠቃሚ ጥያቄዎች ምላሽ ይሰጣል፣ ከማረጋገጫ በኋላ ንግዶችን ያስፈጽማል

በተመራ የWeb3 ወኪል ግንባታ፣ የ QuickNode ትምህርትን እና የCoinbase's አውደ ጥናት በ Agents SDK + AgentKit ውህደት ውስጥ በመሄድ ይመልከቱ።

መላ መፈለጊያ፡ ፈጣን ጥገናዎች

ወኪሌ ግብይቶችን መላክ አይችልም፡ የአውታረ መረብን፣ የጋዝ ቅንጅቶችን እና የቁልፍ ፈቃዶችን ያረጋግጡ; በመጀመሪያ የሙከራ አውታረ መረብን ይሞክሩ

የመሳሪያ ጥሪዎች የተሳሳቱ ናቸው፡ የመሳሪያ schema እና ማረጋገጫን አጥብቁ; የቅድመ-ፍተሻ ጥያቄዎችን ጨምር

ሩጫዎች ደካማ ናቸው፡ እንደገና መሞከርን ከመመለሻ ጋር ጨምር; የ RPC የፍጥነት ገደቦችን እና የሁኔታ ኮዶችን ይቆጣጠሩ

የደህንነት ስጋቶች፡ ቁልፎችን ያሽከርክሩ፣ ገንዘቦችን ለይተው ያውጡ፣ ወደ Safe-based ማጽደቆች ይሂዱ

በነገራችን ላይ፡ የስራ ፍሰትዎን በ Sider.AI ያፋጥኑ

ሊጠቀስ የሚገባው ነገር -ጥያቄዎችን፣ የማጣበቂያ ኮድን እና ሰነዶችን እየደጋገሙ ከሆነ፣ የጎን አጋዥ ሊረዳ ይችላል። በ Sider.AI፣ ምርምርን፣ የኮድ ቁርጥራጮችን እና የሙከራ ምዝግብ ማስታወሻዎችን ከአርታዒዎ ጎን በተደራጀ መልኩ ማስቀመጥ ይችላሉ፣ ይህም ለወኪሎች የግንባታ-መለኪያ-መማር ዑደቶችን ያፋጥናል። እዚህ ያስሱት፡

ቁልፍ መውሰጃዎች

“AgentKit” በተለምዶ የ Coinbase's ኦንቼይን መሣሪያ ስብስብን እና የ Inngest's ኦርኬስትራ መሣሪያ ስብስብን ያመለክታል—በኦንቼይን ድርጊቶች ወይም ባለብዙ ወኪል ማስተባበር ላይ ባለው ፍላጎትዎ ላይ በመመስረት ይምረጡ።

በትንሹ ጀምር፡ የሙከራ አውታረ መረብ፣ አነስተኛ መሣሪያዎች፣ ጥብቅ ፖሊሲዎች; ችሎታዎችን ቀስ በቀስ ያክሉ።

ለፋይናንሺያል ወይም ለአስተዳደር ባለስልጣን፣ አስተዳደር እና ደህንነት Safeን ያዋህዱ።

ወኪሉን እንደ የምርት ሶፍትዌር ይያዙት፡ ምዝግብ ማስታወሻ፣ ማንቂያዎች፣ ገደቦች እና የሰው ማጽደቅ።

ተጨማሪ ትምህርት

Coinbase AgentKit ፈጣን ጅምር እና CLI

አውደ ጥናት፡ OpenAI Agents SDK ከCoinbase AgentKit ጋር

Web3 AI ወኪል የእግር ጉዞ (QuickNode) ይገንቡ

Inngest AgentKit ፈጣን ጅምር እና ጽንሰ-ሐሳቦች

ደህንነቱ የተጠበቀ ስማርት አካውንቶች የ Safe Protocol Kit

FAQ

Q1:AgentKit ምንድን ነው፣ እና የትኛውን መጠቀም አለብኝ? AgentKit በተለምዶ ለኦንቼይን እርምጃዎች Coinbase AgentKit እና ወኪሎችን ለማስተባበር Inngest AgentKitን ያመለክታል። ለWeb3 ተግባራት (የኪስ ቦርሳዎች፣ ቶከኖች) Coinbaseን እና ለብዙ ወኪል፣ በክስተት ላይ የተመሰረቱ የስራ ፍሰቶች Inngestን ይምረጡ።

Q2:AI ወኪል በኦንቼይን ላይ ገንዘብን በደህና እንዲያንቀሳቅስ እንዴት መፍቀድ እችላለሁ? ትንንሽ ቀሪ ሂሳቦችን፣ ጥብቅ የመሳሪያ schemas እና ለአደገኛ ድርጊቶች የማረጋገጫ ጥያቄዎችን ይጠቀሙ። ለአምራችነት፣ ደህንነቱ የተጠበቀ ስማርት አካውንቶችን ያዋህዱ እና ባለብዙ ፊርማ ወይም የፖሊሲ ማጽደቆችን ይጠይቁ።

Q3:OpenAI Agentsን ከCoinbase AgentKit ጋር ማጣመር እችላለሁ? አዎ። የምክንያታዊነት ንብርብርዎን (OpenAI Agents/function calling) ከCoinbase AgentKit መሳሪያዎች ጋር ያገናኙ። ብዙ ገንቢዎች ለማስተባበር እና እንደገና ለመሞከር Inngestን ይጨምራሉ።

Q4:AgentKitን ሲጠቀሙ የተለመዱ አደጋዎች ምንድን ናቸው? ቁልፎችን በኮድ ውስጥ ማስቀመጥ፣ የሙከራ አውታረ መረቦችን መዝለል እና ያልተገደበ ድርጊቶችን መፍቀድ ትልልቆቹ ናቸው። ደህንነትን ለመጠበቅ የፍጥነት ገደቦችን፣ የወጪ ጣሪያዎችን እና ጠንካራ ክትትልን ያክሉ።

Q5:Web3 AI ወኪልን ለመገንባት የት ፈጣን ጅምር ማግኘት እችላለሁ? ለማዋቀር እና ምሳሌዎች በ Coinbase's AgentKit ፈጣን ጅምር ይጀምሩ፣ በተጨማሪም ከ QuickNode ትምህርቶች እና ለአጠቃላይ መመሪያ የአውደ ጥናት ቪዲዮዎች።