خادم أدوات المحاكاة (Mock Tooling Server)

يتضمن برنامج Agent 365 CLI خادم أدوات وهمي لأغراض الاختبار والتطوير. يقوم هذا الخادم بمحاكاة تفاعلات خادم MCP (بروتوكول سياق النموذج)، ما يتيح لك اختبار قدرات أدوات عاملِك محليًا دون الحاجة إلى خوادم فعلية. لا يغطي أي وظائف أخرى في Agent 365.

فوائد استخدام الخادم الوهمي

يقدم الخادم الوهمي الفوائد التالية للتطوير المحلي والاختبار:

التطوير دون اتصال: اختبر برنامجك الوكيل بدون اتصال بالإنترنت أو تبعيات خارجية.
اختبار متسق: الحصول على ردود متوقعة لاختبار الحالات الحافة.
تصحيح الأخطاء: عرض جميع الطلبات والردود في الوقت الحقيقي
التكرار السريع: لا حاجة للانتظار لاستدعاءات API الخارجية أو إعداد بيئات اختبار معقدة.

المتطلبات

قبل استخدام الخادم الوهمي للأدوات، تأكد من وجود المتطلبات التالية:

واجهة سطر الأوامر Agent 365 مثبتة - استخدم خادم الأدوات الوهمي جنبًا إلى جنب مع واجهة سطر الأوامر. راجع Agent 365 CLI للاطلاع على تعليمات التثبيت.
- يجب أن يكون لديك على الأقل الإصدار 1.1.25-preview لاستخدام خادم أدوات المحاكاة.
مشروع عامل نموذجي - مشروع عامل محلي يمكنه الاتصال بخوادم MCP. راجع مستودع نماذج Agent365 للحصول على نقاط البداية المتاحة.

ابدأ تشغيل خادم الأدوات الوهمي

استخدم أمر a365 develop start-mock-tooling-server لبدء خادم الأدوات الوهمية.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

خيارات الأوامر

يدعم خادم أدوات المحاكاة الخيارات التالية:

خيار	الوصف	افتراضي
`-p, --port <port>`	رقم المنفذ لخادم الأدوات التجريبية	5309
`-v, --verbose`	تمكين التسجيل المطوّل	false
`-?, -h, --help`	عرض المساعدة ومعلومات الاستخدام	-
`-bg`	شغل الخادم فِي محطة طرفية جديدة.	-

الأمثلة

توضح الأمثلة التالية طرقاً شائعة لبدء خادم الأدوات الوهمي:

ابدأ بالإعدادات الافتراضية:

a365 develop start-mock-tooling-server

ابدأ بمنفذ مخصص:

a365 develop start-mock-tooling-server -p 8080

ابدأ بسجلات مفصلة:

a365 develop start-mock-tooling-server -v

عند تشغيل الأمر، يحدث ما يلي:

يبدأ تشغيل الخادم الوهمي على المنفذ المحدد (الافتراضي: localhost:5309).
يعرض سجلات الخادم والطلبات الواردة في الوحدة الطرفية.

استخدم خادمًا وهميًا مع عاملين نموذجيين

لربط عامل العينة الخاص بك بخادم الأدوات الوهمية:

الخطوة 1: تشغيل الخادم التجريبي

a365 develop start-mock-tooling-server

يبدأ الخادم ويعرض مخرجات مشابهة للمثال التالي:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

الخطوة 2: تكوين عاملك

اضبط متغير البيئة MCP_PLATFORM_ENDPOINT في عامل العينة الخاص بك ليشير إلى الخادم الوهمي:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

إذا كنت تستخدم منفذًا مخصصًا، استبدل 5309 برقم المنفذ الذي اخترته.

الخطوة 3: شغل عامل الخاص بك

اِبْدَأْ عامل العينة كما تفعل عادةً. يتصل عامل الآن بالخادم الوهمي بدلاً من خوادم MCP الفعلية.

الخطوة 4: مراقبة نشاط الخادم:

تعرض نافذة الطرفية الخاصة بالخادم التجريبي ما يلي:

الطلبات الواردة من عاملك
يَتِمُّ إِرْسَالُ الاِسْتِجَابَاتِ المُحَاكَاة (Mocked Responses) إِلَى الْخَارِج
حالة الاتصال والأخطاء (إن وجدت)

نماذج من سجلات الخادم التجريبي:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

إيقاف الخادم التجريبي

لإيقاف الخادم التجريبي، استخدم Ctrl+C في الطرفية التي يعمل فيها الخادم، أو أغلق نافذة الطرفية.

استكشاف الأخطاء وإصلاحها

يحتوي هذا القسم على معلومات حول كيفية استكشاف الأخطاء وإصلاحها في خادم أدوات المحاكاة.

تلميح

دليل استكشاف أخطاء Agent 365 يتضمن توصيات عالية المستوى لاستكشاف الأخطاء وحلها، وأفضل الممارسات، وروابط لمحتوى استكشاف الأخطاء لكل جزء من دورة تطوير Agent 365.

فشل الخادم التجريبي في البدء

العرض:Error: Address already in use

السبب: هناك عملية أخرى تستخدم بالفعل المنفذ الافتراضي (5309) أو المنفذ الذي حددته.

الحل:

استخدم منفذًا مختلفًا.

a365 develop start-mock-tooling-server -p 8080

أوقف العملية التي تستخدم المنفذ ثم حاول مرة أخرى.

لا يمكن للعامل الاتصال بالخادم الوهمي

العرض: تظهر سجلات العوامل أخطاء في الاتصال أو مهلة عند محاولة الوصول إلى الخادم الافتراضي.

السبب:

الخادم الوهمي لا يعمل.
متغير بيئة MCP_PLATFORM_ENDPOINT صحيح.
مشاكل في جدار الحماية أو تكوين الشبكة.