كيفية استخدام AgentKit: دليل عملي وشامل لبناء وكلاء الذكاء الاصطناعي

إذا سمعت عن مصطلح "AgentKit" وتساءلت عن كيفية استخدامه فعليًا، فأنت في المكان الصحيح. إليك الأمر: AgentKit ليس منتجًا واحدًا. يتم استخدام الاسم من قبل العديد من الأنظمة البيئية - وأبرزها AgentKit الخاص بـ Coinbase للإجراءات المتسلسلة/Web3، و AgentKit الخاص بـ Inngest لتنسيق شبكات الوكلاء، والعديد من البرامج التعليمية التي تستخدم OpenAI Agents SDK جنبًا إلى جنب مع مجموعة Coinbase. يشرح هذا الدليل ماهية كل AgentKit، ولماذا تختار واحدًا على الآخر، وكيفية إعداده خطوة بخطوة، مع نصائح احترافية وأنماط واقعية يمكنك إعادة استخدامها.

سنتخذ نهجًا عمليًا وموجهًا نحو الحلول: مقارنات سريعة وإعداد واضح وأمثلة قابلة للتشغيل وأخطاء يجب تجنبها.

عن أي "AgentKit" تتحدث؟

Coinbase AgentKit (CDP/Onchain): يتيح لوكلاء الذكاء الاصطناعي إدارة المحافظ وإرسال معاملات متسلسلة ونشر الرموز والمزيد عبر الشبكات المدعومة. مثالي لبناء وكلاء Web3 أصليين (مثل روبوتات الإكراميات وناشري الرموز وموزعي NFT). تتوفر على نطاق واسع أدلة البدء السريع وورش العمل.

Inngest AgentKit: إطار عمل لتحديد الوكلاء والأدوات وتشغيلها داخل الشبكة، مع التركيز على التنفيذ القابل للتطوير والقائم على الأحداث. رائع لتنسيق العديد من الوكلاء ومنطق إعادة المحاولة وسير العمل في الخلفية.

Safe/Protocol Kits (السياق): إذا كان وكيلك بحاجة إلى تحكم في حساب ذكي (توقيع متعدد، سياسة، مكالمات مجمعة)، فغالبًا ما يتم إقران Safe’s Protocol Kit بوكلاء متسلسلين لتنفيذ آمن.

إذا كان هدفك هو بناء وكيل ذكاء اصطناعي متسلسل بسرعة، فابدأ بـ Coinbase AgentKit. إذا كنت بحاجة إلى بنية قوية ومتعددة الوكلاء وجدولة، فإن Inngest AgentKit هو خيار قوي. تخلط العديد من الفرق بين الاثنين: OpenAI Agents للاستدلال + Coinbase AgentKit للإجراءات المتسلسلة + Inngest للتنسيق.

: دليل اتخاذ قرار سريع

تريد وكيل Web3 يمكنه تحويل الأموال أو نشر الرموز أو التفاعل مع التطبيقات اللامركزية ← استخدم Coinbase AgentKit.

أنت بحاجة إلى نظام دائم وقائم على الأحداث لتنسيق العديد من الوكلاء/الأدوات مع إعادة المحاولات والحالة ← استخدم Inngest AgentKit.

أنت تتطلب أمانًا للمحفظة على مستوى المؤسسات أو حوكمة متعددة التوقيعات لوكيلك ← قم بدمج Safe’s Protocol Kit جنبًا إلى جنب مع وكيلك.

الجزء الأول: كيفية استخدام Coinbase AgentKit (الوكلاء المتسلسلون)

لماذا Coinbase AgentKit

تم تصميمه للمهام المتسلسلة خارج الصندوق (عمليات المحفظة والتحويلات وإدارة الرموز)

تجربة مطور نظيفة وأدوات بدء سريعة

مثالي للروبوتات/الوكلاء الذين يتفاعلون مع المستخدمين على وسائل التواصل الاجتماعي (مثل X) وتسوية الإجراءات المتسلسلة

نظرة عامة على الإعداد

قم بتثبيت CLI و SDK (وفقًا للبدء السريع) وقم بتكوين متغيرات البيئة للشبكة والمفاتيح ونقاط نهاية RPC.

قم بتهيئة مشروع واختر الإمكانات المتسلسلة التي تحتاجها.

اربط الأدوات (مثل عمليات المحفظة ونشر الرموز) بوكيلك.

قم بتوصيل الوكيل بنموذج استدلال (OpenAI أو ما شابه) لتحديد متى يتم استدعاء الأدوات.

اتبع البدء السريع الرسمي لتشغيله في دقائق. للحصول على برنامج تعليمي عملي حول بناء وكيل ذكاء اصطناعي Web3 يدير المحافظ ويتفاعل على Twitter/X، راجع QuickNode walkthrough وعرض فيديو حول إنشاء روبوت AgentKit Twitter.

مثال على البنية

طبقة الاستدلال: LLM مع استدعاء الوظائف/الأدوات

طبقة الإجراء: أدوات Coinbase AgentKit (التحويل، نشر الرمز)

الثبات: قم بتخزين ذاكرة/أهداف الوكيل في قاعدة بيانات

الواجهة الأمامية: واجهة مستخدم للدردشة أو روبوت اجتماعي (X) لمطالبات المستخدم

أفضل الممارسات

مبدأ الامتياز الأقل: قصر مفاتيح الوكيل على النطاقات الضرورية والأرصدة الصغيرة

مطالبات السياسة: حدد قواعد صريحة حول متى يُسمح بالإجراءات المتسلسلة

الحواجز الوقائية: قم بتنفيذ معاينة/تأكيد المعاملة، وحدود لكل نافذة زمنية

إمكانية المراقبة: سجل استدعاءات الأدوات والمعاملات ومخرجات النموذج لإمكانية التدقيق

المزالق الشائعة

إدارة المفاتيح المتراخية: لا تقم أبدًا بترميز الأسرار بشكل ثابت؛ استخدم مخزنًا

إجراءات غير محدودة: تتطلب تأكيدات للتحويلات ذات القيمة الكبيرة

حدود المعدل المفقودة: حماية نقاط نهاية RPC وواجهات برمجة التطبيقات الاجتماعية

الجزء الثاني: كيفية استخدام Inngest AgentKit (شبكات الوكلاء والتنسيق)

لماذا Inngest AgentKit

الوكلاء كعاملين من الدرجة الأولى وغير مرتبطين بالحالة مع الأهداف ومجموعات الأدوات

شبكات لتنسيق العديد من الوكلاء لسير العمل المعقد

تصميم قائم على الأحداث مع إعادة المحاولات والتنفيذ الدائم

ابدأ بالبدء السريع لتدوير وكيلك الأول وتشغيله داخل الشبكة. اقرأ المفاهيم الأساسية - الوكلاء والأدوات والشبكات - قبل توصيل منطق الأعمال.

خطوات الإعداد

حدد هدف وكيلك والأدوات المتاحة (واجهات برمجة التطبيقات والخدمات الداخلية والمجموعات المتسلسلة).

إنشاء شبكة وتسجيل الوكلاء.

إرسال الأحداث لتشغيل الوكلاء؛ استخدم عمليات إعادة المحاولة والتراجع لتحقيق المرونة.

أضف إمكانية المراقبة: السجلات والتتبعات والنتائج.

أنماط التنسيق

المشرف-العامل: يقوم وكيل التخطيط بتفويض المهام إلى وكلاء متخصصين

تحديد مصادر الأحداث: تؤدي تغييرات الحالة إلى تشغيل الوكلاء للتفاعل (مثل payment_received → fulfillment_agent)

الإنسان في الحلقة: الموافقات على الإجراءات الخطرة، مع الإيقاف المؤقت/الاستئناف

نصائح

حافظ على الوكلاء غير مرتبطين بالحالة؛ قم بتمرير السياق عبر الأحداث/مخازن الحالة

أدوات الإصدار والمطالبات لتتبع الأداء بمرور الوقت

محاكاة أوضاع الفشل؛ تحقق من عدم تغيير المعرفات للمكالمات الخارجية

الجزء الثالث: التنفيذ الآمن مع Safe (اختياري ولكن موصى به)

إذا كان وكيلك يدير الأموال أو ينفذ عمليات المسؤول، فقم بدمج الحسابات الذكية مع الحوكمة. يوفر Safe’s Protocol Kit الإنشاء والتكوين والتنفيذ للحسابات الذكية وتدفقات التوقيع المتعدد.

حالة الاستخدام: يقدم وكيل متسلسل المعاملات، بينما يوقع المالكون (البشر أو وكلاء المشرف) بشكل مشترك

الفائدة: ضوابط السياسة وحدود الإنفاق والاسترداد الآمن

النمط: يقترح الوكيل المعاملات؛ تقوم محرك السياسة (أو الإنسان) بالتوقيع والتنفيذ

خطوة بخطوة: بناء وكيل متسلسل بسيط

فيما يلي تدفق مفاهيمي يمكنك تكييفه (مستقل عن اللغة، نمط التعليمات البرمجية الزائفة). راجع Coinbase quickstart للحصول على رمز العمل وأوامر CLI.

تهيئة المشروع وتثبيت التبعيات

أنشئ دليل مشروع وقم بتثبيت AgentKit SDK وعميل LLM الخاص بك

تعيين متغيرات البيئة: عنوان URL لـ RPC والمفتاح الخاص أو المحفظة المدارة والشبكة

تحديد الأدوات والقدرات

المحفظة: get_balance, transfer(to, amount)

الرموز: deploy_erc20(name, symbol, supply)

قراءة/كتابة استدعاءات العقد حسب الحاجة

توصيل نموذج الاستدلال

توفير مطالبة نظام تحدد الأهداف والقيود

تسجيل الأدوات مع المخططات لاستدعاء الوظائف الآمن

إضافة السلامة والسياسات

فرض التأكيد على التحويلات فوق الحد

تحديد الإنفاق اليومي، والسماح بقائمة عناوين المستلمين للإنتاج

شحن واجهة أساسية

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

Web/Chat: واجهة مستخدم بسيطة لإرسال المهام وعرض الإيصالات

الاختبار على شبكة اختبار أولاً

صنبور الأموال؛ تحقق من سجلات الإجراءات وتجزئة المعاملات

الانتقال إلى الإنتاج مع إمكانية المراقبة

التقاط بيانات القياس عن بعد، والتنبيهات بشأن المعاملات الفاشلة، والانحراف في سلوك النموذج

الأنماط التي تعمل في الإنتاج

التخطيط ثم العمل: استخدم النموذج لتحديد الخطوات قبل استدعاء الأدوات

وضع التشغيل الجاف: معاينة المعاملات وطلب الموافقة

مغلفات الميزانية: امنح كل مهمة حدًا للإنفاق ومهلات للأداة

المراقبة الاصطناعية: تتحقق المهام المجدولة من صحة الوكيل واتصال RPC

سيناريوهات أمثلة واقعية

روبوت إكرامية للمجتمع: يذكر المستخدمون الروبوت على X؛ يقوم الوكيل بإكرامية المحافظ التي تم التحقق منها على السلسلة

مكافآت العملاء: يتتبع الوكيل الإجراءات المتسلسلة ويرسل رموز المكافآت أسبوعيًا

عمليات DAO: يقوم الوكيل بصياغة معاملات Safe للمقترحات؛ توقعات التوقيع المتعدد بعد المراجعة

مساعد السوق: يسرد الوكيل NFTs ويرد على أسئلة المستخدم، وينفذ الصفقات بعد التأكيد

للحصول على بناء وكيل Web3 مُوجَّه، راجع البرنامج التعليمي QuickNode وورشة عمل Coinbase التي تتناول Agents SDK + تكامل AgentKit.

استكشاف الأخطاء وإصلاحها: إصلاحات سريعة

لا يمكن لوكيلي إرسال المعاملات: تحقق من الشبكة وإعدادات الغاز وأذونات المفاتيح؛ جرب شبكة اختبار أولاً

استدعاءات الأدوات غير منتظمة: شدد مخططات الأدوات والتحقق من الصحة؛ إضافة مطالبات فحص مسبق

عمليات التشغيل متقطعة: إضافة عمليات إعادة محاولة مع التراجع؛ مراقبة حدود معدل RPC ورموز الحالة

مخاوف أمنية: تدوير المفاتيح، وعزل الأموال، والانتقال إلى الموافقات المستندة إلى Safe

بالمناسبة: تسريع سير عملك مع Sider.AI

تجدر الإشارة إلى أنه - إذا كنت تكرر المطالبات وكود اللصق والمستندات، فيمكن أن يساعدك مساعد. مع Sider.AI، يمكنك الاحتفاظ بالبحث ومقتطفات التعليمات البرمجية وسجلات التجارب منظمة جنبًا إلى جنب مع محرر التعليمات البرمجية الخاص بك، مما يؤدي إلى تسريع حلقات البناء والقياس والتعلم للوكلاء. استكشفه هنا:

الوجبات الرئيسية

يشير مصطلح "AgentKit" بشكل شائع إلى مجموعة أدوات Coinbase المتسلسلة ومجموعة أدوات Inngest للتنسيق - اختر بناءً على حاجتك إلى الإجراءات المتسلسلة مقابل تنسيق متعدد الوكلاء.

ابدأ صغيرًا: شبكة اختبار، وأدوات قليلة، وسياسات صارمة؛ إضافة قدرات تدريجياً.

للحصول على سلطة مالية أو إدارية، قم بدمج Safe للحوكمة والأمن.

تعامل مع الوكيل مثل برنامج الإنتاج: التسجيل والتنبيهات والحدود والموافقة البشرية.

مزيد من التعلم

Coinbase AgentKit quickstart و CLI

ورشة العمل: OpenAI Agents SDK مع Coinbase AgentKit

بناء Web3 AI agent walkthrough (QuickNode)

Inngest AgentKit quickstart والمفاهيم,

Safe Protocol Kit للحسابات الذكية الآمنة

FAQ

Q1: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.

Q2: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.

Q3: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.

Q4: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.

Q5: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.