خادم أدوات المحاكاة

هام

يجب أن تكون جزءا من برنامج معاينة الحدود للحصول على وصول مبكر إلى Microsoft Agent 365. Frontier تربطك مباشرة بأحدث ابتكارات الذكاء الاصطناعي من Microsoft. تخضع المعاينات الحدودية لشروط المعاينة الحالية لاتفاقيات العملاء. نظرًا لأن هذه الميزات لا تزال قيد التطوير، فقد يتغير توفرها وقدراتها بمرور الوقت.

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

فوائد استخدام الخادم التجريبي

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

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

المتطلبات الأساسية

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

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

ابدأ خادم أدوات المحاكاة

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

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

# Short alias
a365 develop mts

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

يدعم خادم الأدوات التجريبية الخيارات التالية:

خيار	Description	Default
`-p, --port <port>`	رقم المنفذ لخادم النموذج	5309
`-v, --verbose`	تمكين التسجيل المطول	خطأ
`-?, -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: مراقبة نشاط الخادم

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

الطلبات الواردة من وكيلك
الردود الساخرة ترسل
حالة الاتصال والأخطاء (إن وجدت)

أمثلة على سجلات الخوادم:

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 في الطرفية التي يعمل فيها الخادم، أو أغلق نافذة الطرفية.

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

يحتوي هذا القسم على معلومات حول كيفية استكشاف المشاكل الشائعة في خادم أدوات النماذج التجريبية.

Tip

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

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

عَرَض:Error: Address already in use

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

الحل:

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

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

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

الوكيل لا يستطيع الاتصال بخادم الوهمية

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

يسبب:

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