NextPDF Connect

لمحة سريعة

⁨NextPDF Connect⁩ هي حزمة nextpdf/server. تعمل كخدمة طويلة الأمد تُتيح محرك ⁨PDF 2.0⁩ من ⁨NextPDF⁩ لوكلاء الذكاء الاصطناعي (⁨AI⁩) وعملاء بروتوكول نقل النص التشعبي (⁨HTTP⁩). يتوفر سجل الأدوات نفسه عبر ثلاث وسائل نقل: بروتوكول سياق النموذج (⁨MCP⁩) عبر الإدخال والإخراج القياسيين، وواجهة برمجة تطبيقات (⁨API⁩) بأسلوب نقل الحالة التمثيلي (⁨REST⁩) موصوفة بمستند ⁨OpenAPI 3.1⁩، و⁨gRPC⁩ مُعرَّف بحزمة ⁨Protocol Buffers⁩ nextpdf.connect.v1. تُعلن كل أداة عن مستوى مخاطرها. ويجب أن تجتاز الأدوات في أعلى مستوى بوابة تأكيد بمشاركة بشرية (⁨HITL⁩) قبل تنفيذها.

استخدم هذا القسم عند تشغيل الخادم أو دمجه. ابدأ بـنظرة عامة لفهم البنية، ثم اختر وسيلة نقل، واستخدم مرجع ⁨API⁩ للحصول على رموز الأدوات والخدمات الدقيقة.

خريطة الأقسام

تغطي هذه الصفحات مفاهيم الخادم وتهيئته وعملياته.

الصفحة	استخدمها من أجل
نظرة عامة	حدود الحزمة، ووسائل النقل الثلاث، ولماذا يُعد عدد الأدوات خاصية تُحتسب في وقت التشغيل.
البدء السريع	أول مصافحة ⁨MCP⁩ قابلة للتشغيل وطلب ⁨REST⁩ توضيحي مطابق لها.
التهيئة	ملف ⁨MCP⁩ بصيغة ⁨YAML⁩، ومتغيرات البيئة NEXTPDF_*، وتجاوز المخاطر المسموح به للترقية فقط.
الإقلاع والاكتشاف	كيف تهيّئ كل وسيلة نقل خادمها وتكتشف الأدوات والمستويات عند الإقلاع.
كتالوج الأدوات	مجموعة الأدوات الأساسية المُتحقق منها والمتاحة دائمًا، وكيف يُحتسب العدد الإجمالي في وقت التشغيل.
مستويات مخاطر ⁨HITL⁩	نموذج المخاطر رباعي المستويات وتحدي التأكيد للأدوات التي تتطلب موافقة.
النشر	ملفات تعريف عمّال ⁨RoadRunner⁩، و⁨Docker⁩، ومخازن مدعومة بـ⁨Redis⁩، وأمان طبقة النقل (⁨TLS⁩) المتبادل لـ⁨gRPC⁩.
الأمان والعمليات	المصادقة، وأمان النقل، ونموذج التهديد، ونهج إقامة البيانات.

لكل وسيلة نقل صفحة مرجعية خاصة بها.

صفحة وسيلة النقل	استخدمها من أجل
وسيلة نقل ⁨MCP⁩	تأطير استدعاءات الإجراءات البعيدة بترميز كائنات ⁨JavaScript⁩ (⁨JSON-RPC⁩) 2.0 عبر ⁨stdio⁩، وطرق initialize / tools/list / tools/call.
وسيلة نقل ⁨REST⁩	خط معالجة ⁨RoadRunner⁩ بمعيار ⁨PSR-15⁩، وعقد ⁨OpenAPI 3.1⁩، ومصادقة الحامل (⁨bearer⁩)، والمسارات المقيدة حسب المستوى.
وسيلة نقل ⁨gRPC⁩	خدمة nextpdf.connect.v1.NextPDFConnect، واستدعاءات ⁨RPC⁩ ببث من جانب الخادم، ومصادقة البيانات الوصفية.

واجهات ⁨API⁩ الأساسية

استخدم هاتين الصفحتين عند البناء استنادًا إلى الخادم.

الصفحة	الدور
مرجع ⁨API⁩	كل أداة مُسجّلة بالاسم والفئة، ورموز خدمة ⁨gRPC⁩ ورسائلها، ونموذج الأخطاء، وحدود المعدل.
دليل المطوّر	حدود المعمارية، ودورة حياة وقت التشغيل، وتحديد المستوى، وبوابة التأكيد، ونقاط التوسعة، وقائمة فحص الاختبار.

انظر أيضًا

• نظرة عامة — نقطة الدخول المفاهيمية للحزمة
• مرجع ⁨API⁩ — رموز الأدوات و⁨RPC⁩ والرسائل الدقيقة
• دليل المطوّر — كيفية بناء الخادم وتوسيعه وتشغيله
• الأمان والعمليات — المصادقة ونموذج التهديد