نظرة عامة على الوكلاء
يوفر Asset Core محولات جاهزة للإنتاج لتكامل وكلاء الذكاء الاصطناعي، مما يمكّن النماذج من التلاعب بالحالة من خلال مجموعة عمليات محدودة وقابلة للتدقيق. الهدف هو السماح للأتمتة بالعمل بأمان دون توسيع سطح الهجوم أو كسر إعادة التشغيل الحتمية.
لمن هذا
مهندسون يبنون وكلاء ذكاء اصطناعي يحتاجون للتفاعل مع حالة Asset Core من خلال واجهة موحدة قائمة على الأدوات. إذا كنت تتكامل مع MCP أو OpenAI أو Gemini، فإن هذه الصفحة هي نقطة البداية المفاهيمية.
ما ستتعلمه
- لماذا مجموعة العمليات الثابتة لـ Asset Core مثالية للوكلاء
- كيف تتوافق واجهة الأدوات القياسية مع HTTP
- أين يمكن العثور على التعريفات الكاملة للأدوات والمخططات
حزمة إحاطة LLM
هل تحتاج إلى ملف مفصل واحد يمكنك تحميله في نموذج اللغة الخاص بك؟ تغطي حزمة الإحاطة الخاصة بـ Asset Core LLM النموذج الذهني الكامل، ومنطق التخطيط، والضمانات، وإرشادات الملاءمة. هي باللغة الإنجليزية فقط (تتعامل معظم نماذج اللغة مع الإنجليزية بشكل جيد) وتجريبية؛ المصدر الرسمي للحقيقة هو الموقع الإلكتروني. استخدمها كدليل، وليس كمصدر سجل. الهدف هو الاستكشاف الذاتي: قم بتحميلها، وصف مجالك، ودع النموذج يربط Asset Core بحالة الاستخدام الخاصة بك. يمكنك أيضًا إعطاء وكيل عناوين URL الرسمية: https://assetcore.io/ أو https://assetcore.io/docs (CSP صارم، لا تتبع)، لكن ليس كل صفحة مضمونة الزيارة، لذا تحتفظ هذه الحزمة بالرياضيات الأساسية، والقيود، وإرشادات القرار في مكان واحد.
- فتح: حزمة إحاطة Asset Core LLM (17.5 كيلوبايت، باللغة الإنجليزية فقط)
- تحميل: Asset Core LLM حزمة الإحاطة (.md) (17.5 كيلوبايت، باللغة الإنجليزية فقط)
متى تستخدم هذا
استخدم Asset Core كخلفية حالة لوكيلك عندما تحتاج إلى:
- قابلية التدقيق: يتم تسجيل كل تغيير في الحالة
- السلامة: العمليات المحدودة تمنع الطفرات الخطيرة
- الحتمية: سلوك قابل للتكرار للاختبار وتصحيح الأخطاء
الهيكل عالي المستوى
المشكلة مع واجهات برمجة التطبيقات المفتوحة
يمكن لوكلاء الذكاء الاصطناعي تنفيذ إجراءات عشوائية، مما يخلق مخاطر. بدون مجموعة عمليات محدودة، تصبح عملية التدقيق والتراجع تخمينًا.
- يمكن أن تؤدي الطفرات غير المحدودة إلى فساد الحالة
- لا يوجد سجل تدقيق لما تم تغييره
- من الصعب اختبار والتحقق من السلوك
- من الصعب تقييد الأذونات
المعاملات كسطح آمن
تحل Asset Core هذه المشكلة من خلال كشف 24 عملية بالضبط. تجعل المفردات الثابتة الوصول الآلي قابلاً للمراجعة والتنفيذ.
| المجال | العمليات |
|---|---|
| الحاوية | CreateContainer, RemoveContainer |
| الرصيد | AddFungible, RemoveFungible, MoveFungible, TransferFungible, TransferMany, Distribute, MoveMany, MergeStacks, ConsolidateStacks |
| النسخة | AddInstance, MoveInstance, RemoveInstance, BurnInstance, Attach, Detach |
| الفتحة | PlaceInSlot, RemoveFromSlot, SwapSlots |
| المخطط | RegisterClass, RegisterClassShape, RegisterClassContinuousShape1d, RegisterClassContinuousShape2d |
هذا المفردات الثابتة:
- يحدد نطاق الانفجار: يمكن للوكلاء القيام بهذه الأشياء فقط
- تمكين التدقيق: كل إجراء ممكن معروف
- يدعم الأذونات: تصفية العمليات حسب العلامة
- تبسيط الاختبار: فضاء الحالة المحدود
محولات البروتوكول
يوفر 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 | التحقق من حداثة العرض |
assetcore_read_stream | بث الالتزامات باستخدام مؤشرات SSE |
assetcore_list_containers | قائمة الحاويات مع الفلاتر |
assetcore_get_container_contents | استعلام موحد لمحتويات الحاوية |
assetcore_docs_search | البحث في وثائق Asset Core الثابتة |
tools/list | نقطة اكتشاف أدوات MCP |
أداة الالتزام تقبل نفس هيكل العمليات كما في واجهة برمجة التطبيقات 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"]]
هذا يتيح لك بناء وكلاء بمستويات إذن مختلفة دون تغيير النظام الأساسي.
الخطوات التالية
- دليل الأدوات - تعريفات الأدوات القياسية
- Tooling Manifest - بيانات التعريف الخاصة بالأدوات القابلة للقراءة آليًا
- مرجع الإجراء - مرجع العملية الكامل