مركز المطورين
ملاحظات التكامل لمن يبنون مسارات عمل حول مجموعة الأدوات.
توثّق هذه الصفحة الواجهات القابلة للقراءة آلياً التي يتيحها Paperlane للمطورين والقائمين على التكامل والوكلاء، والحدود التي يُتوقع من تلك التكاملات احترامها.
بيانات وصفية لإمكانات الأدوات#
تعرض كل أداة تعريفاً يشمل تنسيقات الإدخال والإخراج، ومخطط الخيارات، وما إذا كان التنفيذ محلياً في المتصفح أو يتطلب اتصالاً بالشبكة، وبياناً صريحاً بأي قيود معروفة (مثلاً، الأدوات التي ترفض عمداً عملية لا تستطيع تنفيذها بشكل صحيح؛ راجع مثال Encrypt PDF في صفحة الأمان).
مسارات اكتشاف الوكلاء#
يوفر /llms.txt فهرساً موجزاً ومنظماً للموقع، صُمم لتتمكن الأدوات والوكلاء المعتمدون على نماذج اللغة الكبيرة من جلبه بسرعة. ويتضمن قسم WebMCP يسرد أسماء كل الأدوات وأغراضها بنص واضح.
يوسّع /llms-full.txt ذلك الفهرس ليشمل كتالوج الأدوات كاملاً — وصفاً من سطر واحد وإجابة مباشرة من 40 إلى 60 كلمة لكل أداة — إلى جانب مسارات الثقة والدعم (ومنها هذه الصفحة)، ليستفيد منه الوكلاء الذين يريدون صورة أشمل في طلب واحد.
يعرض /pricing.md معلومات الأسعار بصيغة Markdown واضحة، كي لا يضطر الوكيل أو البرنامج النصي إلى تحليل HTML المعروض للإجابة عن سؤال حول الأسعار.
يصف /agents/webmcp.json (المتاح أيضاً على /.well-known/webmcp.json، وهو المسار المتعارف عليه في المجتمع الذي تتحقق منه بعض أدوات الزحف المتوافقة مع WebMCP وعمليات تدقيق Lighthouse) واجهة WebMCP الأصلية للمتصفح، ويسرد معرّفات جميع الأدوات دون حاجة الوكيل إلى استخراجها من الدليل المرئي.
حدود الخصوصية والبيانات الوصفية#
تُفصل بايتات المستند عن البيانات الوصفية الآمنة للخصوصية الخاصة بالمهام (الأداة التي شُغّلت، والمدة التي استغرقتها، وما إذا نجحت) فصلاً تاماً. إذا أنشأت تكاملاً أو طبقة تسجيل اعتماداً على Paperlane، فحافظ على هذا الفصل: لا تسجل محتوى المستند أو النص المستخرج أو أسماء الملفات ضمن التحليلات، حتى لأغراض تصحيح الأخطاء.
أسماء الملفات هي الاستثناء الوحيد، وذلك حصراً في أداة WebMCP المسماة list_loaded_files الموجودة في صفحة الأداة نفسها، والمخصصة لتمكين الوكيل من إخبار المستخدم بالملفات التي يراها محمّلة؛ ولا تُرجع أي أداة بايتات المستندات في أي مكان أو تحت أي اسم.
توقعات المعدل والنطاق#
تعامل مع الأدوات المحلية باعتبارها عمليات يشغّلها تكاملك داخل جلسة المتصفح الخاصة بالمستخدم، لا كواجهة برمجية دفعية على الخادم؛ فالتنفيذ المحلي مرتبط عمداً بجهاز المستخدم. وينبغي استخدام الميزات المعتمدة على الشبكة التي تتصل بخادم خلفي بمعدل معقول يبدأه شخص، بدلاً من تشغيلها آلياً على نطاق واسع.