Made for Agent
اللغة: العربية

نقاط النهاية

4.1 جدول نقاط النهاية

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

الطريقة المسار الإلزام الغرض
GET /.well-known/lmsp.json إلزامية اكتشاف الخدمة والقدرات
GET /lmsp/v1/openapi.json إلزامية مواصفة الواجهة المقروءة آليًا
GET /lmsp/v1/health إلزامية فحص الحياة والجاهزية
POST /lmsp/v1/pair إلزامية استبدال رمز الاقتران برمز Bearer
GET /lmsp/v1/models إلزامية سرد النماذج المحلية
GET /lmsp/v1/models/{model_id} إلزامية الحصول على نموذج واحد
POST /lmsp/v1/responses إلزامية توليد متزامن أو مبثوث
GET /lmsp/v1/responses/{response_id} اختيارية استرجاع استجابة مخزَّنة
POST /lmsp/v1/tasks إلزامية إنشاء مهمة توليد غير متزامنة
GET /lmsp/v1/tasks/{task_id} إلزامية الحصول على مهمة غير متزامنة
POST /lmsp/v1/tasks/{task_id}/cancel إلزامية إلغاء مهمة غير متزامنة
GET /lmsp/v1/tasks/{task_id}/events اختيارية الاشتراك في تدفق الأحداث أو استئنافه
POST /lmsp/v1/models/{model_id}/load اختيارية تحميل نموذج مسبقًا
POST /lmsp/v1/models/{model_id}/unload اختيارية إلغاء تحميل نموذج

نقاط النهاية المتوافقة مع OpenAI تحت /v1 ونقاط النهاية الاختيارية المتوافقة مع Ollama مدرجة في الصفحة 8.

4.2 الاصطلاحات

  • المتون. متون الطلبات والاستجابات بصيغة JSON (application/json)، باستثناء تدفقات الأحداث (text/event-stream) والأخطاء (application/problem+json).
  • معاملات المسار. الاسم بين قوسين معقوفين، مثل {model_id}، عنصر نائب. ويجب أن تُرمَّز القيم بترميز النسبة المئوية. ويُرسَل معرّف نموذج مثل qwen3:14b-q4_k_m على هيئة qwen3%3A14b-q4_k_m.
  • المصادقة. تتطلب كل نقطة نهاية Authorization: Bearer <token>، باستثناء /.well-known/lmsp.json و/lmsp/v1/openapi.json و/lmsp/v1/health و/lmsp/v1/pair.
  • نقاط النهاية الاختيارية. يجب أن ترد نقطة النهاية الاختيارية التي لا تنفذها الخدمة بـ 501 Not Implemented مع رمز الخطأ unsupported_capability.
  • الإصدارات والأخطاء. قد تحمل الطلبات ترويسات إصدار، ويستخدم كل خطأ صيغة واحدة. وكلاهما معرَّف في الصفحة 9.
  • العقد. وثيقة OpenAPI المنشورة في /lmsp/1.0/openapi.json هي الصورة المقروءة آليًا لهذه الصفحة. والنص هو المعياري حيث يختلف الاثنان.