نظرة عامة على الوكلاء
يوفر Asset Core محولات جاهزة للإنتاج لتكامل وكيل الذكاء الاصطناعي، مما يمكّن النماذج من التلاعب بالحالة من خلال مجموعة عمليات محدودة وقابلة للتدقيق.
لمن هذا
مهندسون يقومون ببناء وكلاء ذكاء اصطناعي يحتاجون إلى التفاعل مع حالة Asset Core، سواء من خلال MCP أو استدعاء وظائف OpenAI أو أدوات Gemini.
ما ستتعلمه
- لماذا مجموعة العمليات الثابتة لـ Asset Core مثالية للوكلاء
- كيف تقوم محولات البروتوكول بترجمة استدعاءات الأدوات إلى HTTP
- أي محول تختار لحالة الاستخدام الخاصة بك
متى تستخدم هذا
استخدم Asset Core كخلفية حالة لوكيلك عندما تحتاج إلى:
- قابلية التدقيق: يتم تسجيل كل تغيير في الحالة
- السلامة: العمليات المحدودة تمنع الطفرات الخطيرة
- الحتمية: سلوك قابل للتكرار للاختبار وتصحيح الأخطاء
الهيكل العام
المشكلة مع واجهات برمجة التطبيقات المفتوحة
يمكن لوكلاء الذكاء الاصطناعي تنفيذ إجراءات عشوائية، مما يخلق مخاطر:
- يمكن أن تؤدي الطفرات غير المحدودة إلى فساد الحالة
- لا يوجد سجل تدقيق لما تم تغييره
- من الصعب اختبار والتحقق من السلوك
- من الصعب تقييد الأذونات
المعاملات كسطح آمن
تحل Asset Core هذه المشكلة من خلال الكشف عن 16 عملية بالضبط:
| المجال | العمليات |
|---|---|
| الحاوية | CreateContainer, RemoveContainer |
| الرصيد | AddFungible, RemoveFungible, TransferFungible, MergeStacks, ConsolidateStacks |
| النسخة | MintInstance, BurnInstance, Attach, Detach |
| الفتحة | PlaceInSlot, RemoveFromSlot, SwapSlots |
| المخطط | RegisterClass, RegisterClassShape |
هذا المفردات الثابتة:
- يحدد نطاق الانفجار: يمكن للوكلاء القيام بهذه الأشياء فقط
- تمكين التدقيق: كل إجراء ممكن معروف
- يدعم الأذونات: تصفية العمليات حسب العلامة
- تبسيط الاختبار: فضاء الحالة المحدود
محولات البروتوكول
يوفر Asset Core محولات تترجم بين بروتوكولات الذكاء الاصطناعي وHTTP:
Agent → Adapter → HTTP API → Daemon
المهايئات المتاحة:
| البروتوكول | الوصف | النقل |
|---|---|---|
| MCP | بروتوكول سياق النموذج | STDIO, SSE |
| OpenAI | استدعاء الدوال | HTTP |
| Gemini | إعلانات الدوال | HTTP |
جميع المحولات تعرض نفس واجهة الأدوات، لذا فإن تغيير البروتوكولات لا يتطلب تغيير تكامل Asset Core الخاص بك.
بنية المحول
يوفر كل محول:
- تعريفات الأدوات المطابقة لمخطط البروتوكول
- المنفذ الذي يربط استدعاءات الأدوات بطلبات HTTP
- عميل HTTP للتواصل مع daemon
- معالجة الأخطاء مع استجابات مناسبة للبروتوكول
تعيش المحولات في assetcore-adapters وتشارك بنية تحتية مشتركة.
جرد الأدوات
أدوات قياسية عبر جميع المحولات:
| الأداة | الوصف |
|---|---|
assetcore_commit | تقديم المعاملات إلى عملية الكتابة |
assetcore_write_health | التحقق من صحة عملية الكتابة |
assetcore_read_health | التحقق من صحة عملية القراءة |
assetcore_read_freshness | التحقق من حداثة العرض |
أداة الالتزام تقبل نفس هيكل العمليات كما في واجهة برمجة التطبيقات HTTP، لذا يمكن للوكلاء تكوين معاملات معقدة.
التصفية حسب العلامات
تحتوي العمليات على علامات (مجال، إجراء، نطاق، قابلية العكس) التي تمكن من التصفية:
# Allow only read operations
allowed = [op for op in operations if op.action != "destroy"]
# Restrict to specific domains
allowed = [op for op in operations if op.domain in ["balance", "container"]]
هذا يتيح لك بناء وكلاء بمستويات إذن مختلفة دون تغيير النظام الأساسي.
الخطوات التالية
- MCP Integration - إعداد خادم MCP
- OpenAI Tools - دمج استدعاء الوظائف
- Gemini - استخدام محول Gemini
- العمليات حسب المجال - مرجع العمليات الكامل