AgentMug · Dahshan Labs
بناء ونشر وكلاء ذكاء اصطناعي قابلين للنقل باستخدام AgentMug
يمثّل AgentMug العامل بملف .agent، وهو صيغة JSON موثّقة لتعريف المهمة. يمكن للمطوّرين إنشاء التعريف برمجياً والتحقّق منه واختيار بيئة تشغيل مدعومة. قابلية النقل تخص التعريف؛ ويجب التحقّق من الأدوات وبيانات الاعتماد ودعم التنفيذ في كل وجهة.
ابدأ بالصيغة ومصفوفة القدرات
اقرأ مواصفة .agent v1 ومخطط JSON Schema. استخدم مصفوفة القدرات المنشورة لاختيار الأدوات المدعومة في بيئتك. صحة بنية الملف وحدها لا تثبت قدرة العامل على إكمال المهمة بالحسابات والأدوات المتاحة.
أنشئ العامل وتحقّق منه
توفّر حزمة @agentmug/runtime الدوال buildAgentFile() وparseAgentFile() وserializeAgentFile() لإنشاء التعريف والتحقّق منه وتسلسله. احتفظ ببيانات الاعتماد خارج الملف وأعلن الاتصالات المطلوبة. استخدم مهارة التأليف الرسمية عند توليد التعريف بمساعد برمجي.
شغّل محلياً أو استورد إلى السحابة
تستطيع واجهة أوامر AgentMug تشغيل ملفات .agent محلياً بمفاتيح نماذجك. استخدم agentmug check <file> لفحص المتطلبات قبل التشغيل. للنقل إلى السحابة، استخدم الاستيراد في الويب أو واجهة الاستيراد الموثّقة بالمصادقة، وراجع المعاينة وعالج العوائق قبل التنفيذ.
اختر بيئة التشغيل المناسبة
يناسب تطبيق سطح المكتب العمل المحلي، وتناسب واجهة الأوامر مهام الطرفية، وتوفّر سحابة AgentMug تشغيلًا مُداراً. لا تصبح الأداة السحابية محلية بمجرد تصدير الملف. راجع مصفوفة القدرات ومتطلبات الاتصال عند الانتقال بين البيئات.
اربط عبر MCP عند الحاجة
يتيح جسر AgentMug MCP لعميل MCP استدعاء العمّال عبر سحابة AgentMug، ويتطلب الإعداد وبيانات الاعتماد. إنه اتصال بالخدمة السحابية، وليس بديلاً لمحرك يعمل دون اتصال. راجع التوثيق لتعليمات الإعداد الحالية.
تحقّق من النتائج إلى جانب الملف
شغّل مهمة صغيرة ببيانات ممثّلة، وراجع نتائج الأدوات والمخرجات، وتحقّق من التغييرات الخارجية في النظام المستهدف. احتفظ بإصدارات تعريف .agent في مستودعك وكرّر الفحص عند تغيير الأدوات أو النماذج أو المتطلبات.
أسئلة شائعة
- هل صيغة .agent مفتوحة؟
- المواصفة ومخطط JSON Schema متاحان علناً، وحزمة @agentmug/runtime منشورة بترخيص Apache-2.0. راجع ترخيص كل حزمة أو خدمة منفصلة قبل الاستخدام.
- هل يعمل كل عامل في كل بيئة؟
- لا. الملف قابل للنقل لكن دعم الأدوات وبيانات الاعتماد يختلف. راجع مصفوفة القدرات وفحوص جاهزية الوجهة وعالج القدرات الناقصة قبل الاعتماد على العامل.
- هل يستطيع مساعد برمجي إنشاء عامل؟
- نعم. زوّده بمهارة التأليف الرسمية والمواصفة ومصفوفة القدرات. تحقّق من ملف .agent الناتج وراجع معاينة الاستيراد قبل التشغيل.
- من أين أبدأ؟
- استخدم التوثيق للإعداد والأمثلة، والمواصفة لعقد الملف، ومصفوفة القدرات للأدوات المدعومة. يشرح دليل الأعمال اختيار أول مهمة مفيدة واختبارها.