ناشر الدليل Dahshan Labs

بناء ونشر وكلاء ذكاء اصطناعي قابلين للنقل باستخدام AgentMug

يمثّل AgentMug العامل بملف .agent، وهو صيغة JSON موثّقة لتعريف المهمة. يمكن للمطوّرين إنشاء التعريف برمجياً والتحقّق منه واختيار بيئة تشغيل مدعومة. قابلية النقل تخص التعريف؛ ويجب التحقّق من الأدوات وبيانات الاعتماد ودعم التنفيذ في كل وجهة.

ابدأ بالصيغة ومصفوفة القدرات

اقرأ مواصفة .agent v1 ومخطط JSON Schema. تغطي مصفوفة القدرات المنشورة سحابة AgentMug وruntimeCore، أي الأدوات الأساسية المشتركة. ولا تسرد حتى الآن جميع أدوات سطح المكتب وواجهة الأوامر. راجع أيضاً توثيق الوجهة وفحوص جاهزيتها؛ فصحة الملف وحدها لا تثبت نجاح المهمة.

توثيق ذو صلة

أنشئ العامل وتحقّق منه

توفّر حزمة @agentmug/runtime الدوال buildAgentFile() وparseAgentFile() وserializeAgentFile() لإنشاء التعريف والتحقّق منه وتسلسله. احتفظ ببيانات الاعتماد خارج الملف وأعلن الاتصالات المطلوبة. استخدم مهارة التأليف الرسمية عند توليد التعريف بمساعد برمجي.

توثيق ذو صلة

شغّل محلياً أو استورد إلى السحابة

تستطيع واجهة أوامر AgentMug تشغيل ملفات .agent محلياً بمفاتيح نماذجك. يفحص الأمر npx @agentmug/cli check <file> المتطلبات دون تشغيل العامل. للسحابة، استخدم الاستيراد في الويب أو واجهة الاستيراد بالمصادقة. ينشئ الاستيراد عاملاً جاهزاً للاختبار، ولا يثبت نجاح تشغيله؛ راجع المعاينة وعالج الاتصالات والمصادر الناقصة.

توثيق ذو صلة

اختر بيئة التشغيل المناسبة

تستخدم السحابة نماذج مُدارة من AgentMug. ويستخدم سطح المكتب والتشغيل المحلي عبر الأوامر مفتاح مزوّدك أو نقطة نهاية محلية مدعومة. ملف .agent هو تعريف؛ وتوفّر بيئة التشغيل الاتصال بالنموذج ومنفّذات الأدوات وربط المصادر. لا تصبح الأداة السحابية محلية بمجرد تصدير الملف.

توثيق ذو صلة

اربط عبر MCP عند الحاجة

يوجد مساران مختلفان. يمرّر @agentmug/mcp-bridge الاستدعاء إلى عامل مستضاف، ويحتاج إلى مضيف متاح ومفتاح. أما أمر agentmug serve-mcp فيعرض ملفات .agent المحلية وينفّذها بمحرك واجهة الأوامر. يحتاج التشغيل المحلي إلى نموذج وأدوات مدعومة، وتُرفض الإجراءات التي تتطلب موافقة إذا لم يتوفر شخص يمنحها.

لاستخدام MCP محلياً، ثبّت واجهة الأوامر عبر npm install -g @agentmug/cli. اضبط أمر الخادم في عميل MCP على agentmug، ووسائطه على serve-mcp ثم المسار المطلق لملف .agent أو مجلد العمّال. مرّر بيانات اعتماد النموذج في بيئة ذلك الخادم. يستخدم هذا المسار stdio؛ ويشرح التوثيق أدناه إعداد الجسر المستضاف المنفصل.

توثيق ذو صلة

تحقّق من النتائج إلى جانب الملف

شغّل مهمة صغيرة ببيانات ممثّلة، وراجع نتائج الأدوات والمخرجات، وتحقّق من التغييرات الخارجية في النظام المستهدف. احتفظ بإصدارات تعريف .agent في مستودعك وكرّر الفحص عند تغيير الأدوات أو النماذج أو المتطلبات.

توثيق ذو صلة

مهمة أولى يمكنك اختبارها

مثال صغير لتجربته على جهازك.

نزّل hello.agent إلى مجلد عملك. لا يحتوي على أدوات ويطلب رداً نصياً قصيراً باستخدام Claude. اضبط ANTHROPIC_API_KEY في بيئة الطرفية، ثم افحص المتطلبات قبل التشغيل. يوضح توثيق واجهة الأوامر كيفية ضبط متغيّر البيئة.

تنزيل hello.agentإعداد واجهة الأوامر وأوامرها

أوامر توضيحية بعد حفظ hello.agent

npx @agentmug/cli check ./hello.agent
npx @agentmug/cli run ./hello.agent --input "Say hello in one sentence."

يفحص الأمر check الإعدادات دون تشغيل العامل ويعرض المتطلبات الناقصة. بعد إكمال الإعداد، يُفترض أن يعيد التشغيل الناجح رداً نصياً قصيراً. تحقّق بنفسك من الرد وحالة خروج العملية؛ يستدعي الأمر الثاني النموذج وقد تترتب عليه رسوم المزوّد.

مقارنة السحابة وسطح المكتب وواجهة الأوامر وMCP

الخيارمكان التنفيذ وما ينبغي التحقّق منه
السحابة

تستضيف AgentMug التنفيذ وتدير الاتصال بالنموذج. اربط حساباتك في السحابة وتحقّق من الأدوات والمصادر التي يحتاجها العامل.

توثيق ذو صلة

سطح المكتب

يُنفّذ العامل على جهازك باستخدام إعدادات النموذج الخاصة بك. التنفيذ المحلي لا يعني أن النموذج يعمل دون إنترنت. راجع الأنظمة والأدوات المدعومة وربط المصادر.

توثيق ذو صلة

واجهة الأوامر

تشغيل محلي من الطرفية باستخدام إعدادات نموذجك. استخدم check قبل run؛ ويحتاج التكرار إلى مُجدول خارجي مثل cron. تُرفض الإجراءات المشروطة بالموافقة عند التشغيل دون مستخدم حاضر.

توثيق ذو صلة

MCP

مسار تكامل وليس بيئة تنفيذ واحدة: يستدعي mcp-bridge عاملاً مستضافاً، وينفّذ serve-mcp عبر واجهة الأوامر ملفات محلية. تظل بيئة التشغيل المختارة مسؤولة عن النموذج والأدوات وبيانات الاعتماد.

توثيق ذو صلة

أسئلة شائعة

هل صيغة .agent مفتوحة؟
المواصفة ومخطط JSON Schema متاحان علناً، وحزمة @agentmug/runtime بترخيص Apache-2.0. هذه صيغة موثّقة خاصة بـAgentMug، وليست معياراً عاماً لجميع وكلاء الذكاء الاصطناعي. راجع ترخيص كل حزمة أو خدمة منفصلة قبل الاستخدام.
هل يعمل كل عامل في كل بيئة؟
لا. الملف قابل للنقل لكن دعم الأدوات وبيانات الاعتماد يختلف. راجع مصفوفة القدرات وفحوص جاهزية الوجهة وعالج القدرات الناقصة قبل الاعتماد على العامل.
هل يستطيع مساعد برمجي إنشاء عامل؟
نعم. زوّده بمهارة التأليف الرسمية والمواصفة ومصفوفة القدرات. تحقّق من ملف .agent الناتج وراجع معاينة الاستيراد قبل التشغيل.
من أين أبدأ؟
استخدم التوثيق للإعداد والأمثلة، والمواصفة لعقد الملف، ومصفوفة القدرات للأدوات المدعومة. يشرح دليل الأعمال اختيار أول مهمة مفيدة واختبارها.

مصادر وخطوات تالية

تابع مع الدليل الآخر: اختيار مهمة عمل واختبارها