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: یک راهنمای عملی و سرتاسری برای ساختن عوامل هوش مصنوعی

اگر نام "AgentKit" را شنیده‌اید و از خود پرسیده‌اید که چگونه واقعاً می‌توانید آن را به کار بگیرید، جای درستی آمده‌اید. نکته اینجاست: AgentKit یک محصول واحد نیست. این نام توسط چندین اکوسیستم استفاده می‌شود—به ویژه AgentKit کوین‌بیس برای اقدامات زنجیره‌ای/Web3، AgentKit اینگست برای سازماندهی شبکه‌های عامل، و آموزش‌های مختلف با استفاده از OpenAI Agents SDK در کنار کیت کوین‌بیس. این راهنما توضیح می‌دهد که هر AgentKit چیست، چرا یکی را بر دیگری انتخاب می‌کنید، و چگونه آن را گام به گام راه‌اندازی کنید، با نکات حرفه‌ای و الگوهای دنیای واقعی که می‌توانید دوباره از آن‌ها استفاده کنید.

ما یک رویکرد عملی و راه‌حل‌محور اتخاذ خواهیم کرد: مقایسه‌های سریع، تنظیمات واضح، مثال‌های قابل اجرا و مواردی که باید از آن‌ها اجتناب کرد.

درباره کدام "AgentKit" صحبت می‌کنید؟

Coinbase AgentKit (CDP/Onchain): به عوامل هوش مصنوعی اجازه می‌دهد کیف پول‌ها را مدیریت کنند، تراکنش‌های زنجیره‌ای ارسال کنند، توکن‌ها را مستقر کنند و موارد دیگر را در سراسر شبکه‌های پشتیبانی‌شده انجام دهند. ایده‌آل برای ساختن عوامل Web3-بومی (به عنوان مثال، ربات‌های انعام‌دهی، مستقرکننده‌های توکن، توزیع‌کننده‌های NFT). راهنماهای شروع سریع و کارگاه‌ها به طور گسترده در دسترس هستند.

Inngest AgentKit: یک چارچوب برای تعریف عوامل، ابزارها و اجرای آن‌ها در داخل یک شبکه، با تمرکز بر اجرای مقیاس‌پذیر و رویدادمحور.

کیت‌های Safe/Protocol (متن): اگر عامل شما نیاز به کنترل حساب هوشمند (چند امضایی، خط‌مشی، فراخوانی‌های دسته‌ای) دارد، کیت پروتکل Safe اغلب با عوامل زنجیره‌ای برای اجرای امن جفت می‌شود.

اگر هدف شما ساختن سریع یک عامل هوش مصنوعی زنجیره‌ای است، با Coinbase AgentKit شروع کنید. اگر به یک معماری قوی و چندعاملی و زمان‌بندی نیاز دارید، Inngest AgentKit یک انتخاب قوی است. بسیاری از تیم‌ها هر دو را با هم ترکیب می‌کنند: OpenAI Agents برای استدلال + Coinbase AgentKit برای اقدامات زنجیره‌ای + Inngest برای سازماندهی.

: راهنمای تصمیم‌گیری سریع

شما یک عامل Web3 می‌خواهید که بتواند وجوه را انتقال دهد، توکن‌ها را مستقر کند یا با dapps تعامل داشته باشد ← از Coinbase AgentKit استفاده کنید.

شما به یک سیستم پایدار و رویدادمحور نیاز دارید که چندین عامل/ابزار را با تلاش مجدد و وضعیت سازماندهی کند ← از Inngest AgentKit استفاده کنید.

شما به امنیت کیف پول درجه سازمانی یا حاکمیت چند امضایی برای عامل خود نیاز دارید ← کیت پروتکل Safe را در کنار عامل خود ادغام کنید.

بخش 1: نحوه استفاده از Coinbase AgentKit (عوامل زنجیره‌ای)

چرا Coinbase AgentKit

ساخته شده برای وظایف زنجیره‌ای خارج از جعبه (عملیات کیف پول، نقل و انتقالات، مدیریت توکن)

تجربه توسعه‌دهنده تمیز و ابزارهای شروع سریع

ایده‌آل برای ربات‌ها/عواملی که با کاربران در شبکه‌های اجتماعی (به عنوان مثال، X) ارتباط برقرار می‌کنند و اقدامات را در زنجیره تسویه می‌کنند

بررسی اجمالی تنظیمات

CLI و SDK را نصب کنید (طبق شروع سریع) و متغیرهای محیطی را برای شبکه، کلیدها و نقاط پایانی RPC پیکربندی کنید.

یک پروژه را مقداردهی اولیه کنید و قابلیت‌های زنجیره‌ای مورد نیاز خود را انتخاب کنید.

ابزارها (به عنوان مثال، عملیات کیف پول، استقرار توکن) را به عامل خود متصل کنید.

عامل را به یک مدل استدلال (OpenAI یا مشابه) متصل کنید تا تصمیم بگیرد چه زمانی ابزارها را فراخوانی کند.

شروع سریع رسمی را دنبال کنید تا در عرض چند دقیقه اجرا شود. برای یک آموزش عملی در مورد ساختن یک عامل هوش مصنوعی Web3 که کیف پول‌ها را مدیریت می‌کند و در Twitter/X تعامل می‌کند، به راهنمای QuickNode و یک نسخه نمایشی ویدیویی در مورد ایجاد یک ربات AgentKit Twitter مراجعه کنید.

معماری نمونه

لایه استدلال: LLM با فراخوانی تابع/ابزار

لایه عمل: ابزارهای Coinbase AgentKit (انتقال، استقرار توکن)

ماندگاری: حافظه/اهداف عامل را در یک پایگاه داده ذخیره کنید

فرانت‌اند: رابط کاربری چت یا ربات اجتماعی (X) برای درخواست‌های کاربر

بهترین شیوه‌ها

اصل کمترین امتیاز: کلیدهای عامل را به دامنه‌های لازم و ترازهای کوچک محدود کنید

پیام‌های خط‌مشی: قوانین صریح را در مورد زمان مجاز بودن اقدامات زنجیره‌ای تعریف کنید

حفاظت‌ها: پیش‌نمایش/تأیید تراکنش، محدودیت‌ها در هر بازه زمانی را پیاده‌سازی کنید

قابلیت مشاهده: فراخوانی‌های ابزار، تراکنش‌ها و خروجی‌های مدل را برای قابلیت ممیزی ثبت کنید

موانع رایج

مدیریت کلید سهل‌انگارانه: هرگز اسرار را هاردکد نکنید؛ از یک خزانه استفاده کنید

اقدامات نامحدود: برای نقل و انتقالات با ارزش بالا، تأییدیه لازم است

محدودیت‌های نرخ از دست رفته: از نقاط پایانی RPC و APIهای اجتماعی محافظت کنید

بخش 2: نحوه استفاده از Inngest AgentKit (شبکه‌های عامل و سازماندهی)

چرا Inngest AgentKit

عوامل به عنوان کارگران درجه یک و بدون وضعیت با اهداف و مجموعه‌های ابزار

شبکه‌ها برای هماهنگی چندین عامل برای گردش کار پیچیده

طراحی رویدادمحور با تلاش مجدد و اجرای بادوام

با شروع سریع شروع کنید تا اولین عامل خود را بچرخانید و آن را در داخل یک شبکه اجرا کنید. قبل از سیم‌کشی منطق کسب‌وکار، مفاهیم اصلی—عوامل، ابزارها، شبکه‌ها—را بخوانید.

مراحل تنظیم

هدف عامل و ابزارهای موجود خود را تعریف کنید (APIها، خدمات داخلی، کیت‌های زنجیره‌ای).

یک شبکه ایجاد کنید و عوامل را ثبت کنید.

رویدادها را برای راه‌اندازی عوامل ارسال کنید؛ از تلاش مجدد و بازگشت برای انعطاف‌پذیری استفاده کنید.

قابلیت مشاهده را اضافه کنید: گزارش‌ها، ردیابی‌ها، نتایج.

الگوهای سازماندهی

ناظر-کارگر: یک عامل برنامه‌ریز وظایف را به عوامل متخصص واگذار می‌کند

منبع‌یابی رویداد: تغییرات وضعیت باعث می‌شود عوامل واکنش نشان دهند (به عنوان مثال، payment_received → fulfillment_agent)

انسان در حلقه: تأییدیه‌ها برای اقدامات پرخطر، با مکث/ادامه

نکات

عوامل را بدون وضعیت نگه دارید؛ زمینه را از طریق رویدادها/فروشگاه‌های وضعیت منتقل کنید

ابزارها و پیام‌ها را برای ردیابی عملکرد در طول زمان نسخه‌بندی کنید

حالت‌های خرابی را شبیه‌سازی کنید؛ یکسان بودن را برای فراخوانی‌های خارجی تأیید کنید

بخش 3: اجرای امن با Safe (اختیاری اما توصیه می‌شود)

اگر عامل شما وجوه را مدیریت می‌کند یا عملیات مدیریت را اجرا می‌کند، حساب‌های هوشمند را با حاکمیت ادغام کنید. کیت پروتکل Safe ایجاد، پیکربندی و اجرای حساب‌های هوشمند و جریان‌های چند امضایی را فراهم می‌کند.

مورد استفاده: یک عامل زنجیره‌ای تراکنش‌ها را ارسال می‌کند، در حالی که مالکان (انسان‌ها یا عوامل ناظر) به طور مشترک امضا می‌کنند

مزیت: کنترل‌های خط‌مشی، محدودیت‌های هزینه و بازیابی امن

الگو: عامل تراکنش‌ها را پیشنهاد می‌کند؛ یک موتور خط‌مشی (یا انسان) امضا و اجرا می‌کند

گام به گام: ساختن یک عامل زنجیره‌ای حداقلی

در زیر یک جریان مفهومی وجود دارد که می‌توانید آن را تطبیق دهید (زبان آگنوستیک، به سبک شبه‌کد). برای کد کار و دستورات CLI با شروع سریع Coinbase مشورت کنید.

مقداردهی اولیه پروژه و نصب وابستگی‌ها

یک دایرکتوری پروژه ایجاد کنید و AgentKit SDK و مشتری LLM خود را نصب کنید

تنظیم متغیرهای محیطی: آدرس اینترنتی RPC، کلید خصوصی یا کیف پول مدیریت شده، شبکه

تعریف ابزارها و قابلیت‌ها

کیف پول: get_balance، transfer(to, amount)

توکن‌ها: deploy_erc20(name, symbol, supply)

در صورت نیاز فراخوانی‌های قرارداد خواندن/نوشتن

اتصال مدل استدلال

یک پیام سیستم ارائه دهید که اهداف و محدودیت‌ها را تعریف می‌کند

ابزارها را با طرحواره‌ها برای فراخوانی تابع ایمن ثبت کنید

افزودن ایمنی و سیاست‌ها

اعمال تأیید برای نقل و انتقالات بالاتر از آستانه

محدود کردن هزینه روزانه، لیست سفید آدرس‌های گیرنده برای تولید

ارسال یک رابط کاربری اساسی

CLI: agent ask "Send 0.01 ETH to 0x..."

وب/چت: حداقل رابط کاربری برای ارسال وظایف و نمایش رسیدها

ابتدا در یک تست‌نت آزمایش کنید

وجوه شیر آب؛ گزارش‌های عمل و هش‌های تراکنش را تأیید کنید

انتقال به تولید با قابلیت مشاهده

ثبت تله‌متری، هشدارها در مورد تراکنش‌های ناموفق و رانش در رفتار مدل

الگوهایی که در تولید کار می‌کنند

برنامه‌ریزی-سپس-عمل: از مدل برای ترسیم مراحل قبل از فراخوانی ابزارها استفاده کنید

حالت اجرای آزمایشی: پیش‌نمایش تراکنش‌ها و درخواست تأیید

پاکت‌های بودجه: به هر کار یک سقف هزینه و مهلت زمانی ابزار بدهید

نظارت مصنوعی: وظایف برنامه‌ریزی‌شده سلامت عامل و اتصال RPC را تأیید می‌کنند

سناریوهای نمونه دنیای واقعی

ربات انعام‌دهی انجمن: کاربران ربات را در X ذکر می‌کنند؛ عامل به کیف پول‌های تأییدشده در زنجیره انعام می‌دهد

پاداش‌های مشتری: عامل اقدامات زنجیره‌ای را ردیابی می‌کند و توکن‌های پاداش را به صورت هفتگی ارسال می‌کند

عملیات DAO: عامل تراکنش‌های Safe را برای پیشنهادات پیش‌نویس می‌کند؛ چند امضایی پس از بررسی امضا می‌کند

دستیار بازار: عامل NFTها را فهرست می‌کند و به سؤالات کاربران پاسخ می‌دهد و پس از تأیید، معاملات را انجام می‌دهد

برای ساخت یک عامل Web3 هدایت‌شده، به آموزش QuickNode و کارگاه Coinbase که ادغام Agents SDK + AgentKit را بررسی می‌کند، مراجعه کنید.

عیب‌یابی: رفع سریع

عامل من نمی‌تواند تراکنش ارسال کند: شبکه، تنظیمات گاز و مجوزهای کلید را بررسی کنید؛ ابتدا یک تست‌نت را امتحان کنید

فراخوانی‌های ابزار نامنظم هستند: طرحواره‌ها و اعتبارسنجی ابزار را محکم‌تر کنید؛ پیام‌های پیش‌آزمایش را اضافه کنید

اجراها ناپایدار هستند: تلاش مجدد را با بازگشت اضافه کنید؛ محدودیت‌های نرخ RPC و کدهای وضعیت را نظارت کنید

نگرانی‌های امنیتی: کلیدها را بچرخانید، وجوه را قرنطینه کنید، به تأییدیه‌های مبتنی بر Safe بروید

به هر حال: گردش کار خود را با Sider.AI تسریع کنید

ارزش ذکر دارد—اگر روی پیام‌ها، کد چسب و اسناد تکرار می‌کنید، یک یاور می‌تواند کمک کند. با Sider.AI، می‌توانید تحقیقات، قطعه‌های کد و گزارش‌های آزمایشی را در کنار ویرایشگر خود سازماندهی کنید و حلقه‌های ساخت-اندازه‌گیری-یادگیری را برای عوامل سرعت بخشید. آن را اینجا کاوش کنید:

نکات کلیدی

"AgentKit" معمولاً به جعبه ابزار زنجیره‌ای کوین‌بیس و کیت سازماندهی اینگست اشاره دارد—بر اساس نیاز خود به اقدامات زنجیره‌ای در مقابل هماهنگی چندعاملی انتخاب کنید.

کوچک شروع کنید: تست‌نت، حداقل ابزارها، سیاست‌های سختگیرانه؛ قابلیت‌ها را به تدریج اضافه کنید.

برای اختیار مالی یا مدیریتی، Safe را برای حاکمیت و امنیت ادغام کنید.

با عامل مانند نرم‌افزار تولید رفتار کنید: گزارش‌گیری، هشدارها، محدودیت‌ها و تأییدیه انسانی.

مطالعه بیشتر

شروع سریع Coinbase AgentKit و CLI

کارگاه: OpenAI Agents SDK با Coinbase AgentKit

ساخت یک راهنمای عامل هوش مصنوعی Web3 (QuickNode)

شروع سریع و مفاهیم Inngest AgentKit،

کیت پروتکل Safe برای حساب‌های هوشمند امن

سؤالات متداول

Q1: AgentKit چیست و کدام یک را باید استفاده کنم؟ AgentKit معمولاً به Coinbase AgentKit برای اقدامات زنجیره‌ای و Inngest AgentKit برای سازماندهی عوامل اشاره دارد. Coinbase را برای وظایف Web3 (کیف پول، توکن) و Inngest را برای گردش کار چندعاملی و رویدادمحور انتخاب کنید.

Q2: چگونه می‌توانم به طور ایمن به یک عامل هوش مصنوعی اجازه دهم وجوه را در زنجیره انتقال دهد؟ از ترازهای کوچک، طرحواره‌های سختگیرانه ابزار و پیام‌های تأیید برای اقدامات پرخطر استفاده کنید. برای تولید، حساب‌های هوشمند Safe را ادغام کنید و تأییدیه چند امضایی یا خط‌مشی را الزامی کنید.

Q3: آیا می‌توانم OpenAI Agents را با Coinbase AgentKit ترکیب کنم؟ بله. لایه استدلال خود (OpenAI Agents/فراخوانی تابع) را به ابزارهای Coinbase AgentKit متصل کنید. بسیاری از توسعه‌دهندگان نیز Inngest را برای سازماندهی و تلاش مجدد اضافه می‌کنند.

Q4: موانع رایج هنگام استفاده از AgentKit چیست؟ هاردکد کردن کلیدها، رد کردن تست‌نت‌ها و اجازه دادن به اقدامات نامحدود موارد بزرگ هستند. محدودیت‌های نرخ، سقف‌های هزینه و قابلیت مشاهده قوی را برای ایمن ماندن اضافه کنید.

Q5: کجا می‌توانم یک شروع سریع برای ساخت یک عامل هوش مصنوعی Web3 پیدا کنم؟ با شروع سریع Coinbase AgentKit برای تنظیمات و مثال‌ها، به همراه آموزش‌های QuickNode و ویدیوهای کارگاهی برای راهنمایی سرتاسری شروع کنید.