بنى مهندس خدمة RAG محلية لتوثيق API CAD على Habr

نشر مهندس على Habr تفصيلاً حول كيفية قيامه بتجميع خدمة RAG محلية للعمل مع توثيق API لأنظمة التصميم بمساعدة الكمبيوتر (CAD)، موضحاً ذلك بسبب الضغط من العملاء على شركات الهندسة التي تقلل الميزانيات والجداول الزمنية للمشاريع.

لماذا أصبحت توثيق CAD مرشحة للأتمتة

وفقاً للمؤلف، في السنوات الأخيرة عاشت الهندسة تحت شعار "نفس الشيء، لكن أرخص وأسرع": يقلل العملاء الميزانيات والجداول الزمنية، والمقاولون يبحثون عن العمليات التي يمكن تحسينها. الأتمتة في التصميم هي أحد أول المرشحين لهذا التحسين، لأن هناك العديد من العمليات الروتينية في التصميم، ويمكن تفويض جزء كبير منها إلى البرامج النصية والأدوات البرمجية الصغيرة بدلاً من تنفيذها يدويًا من قبل مهندس.

• المؤلف هو مهندس قام بشكل مستقل ببناء خدمة RAG محلية لـ CAD API
• السبب وراء المشروع هو عمليات التصميم الروتينية التي يمكن تفويضها إلى البرامج النصية
• السياق العام هو تقليل الميزانية والجدول الزمني من عملاء خدمات الهندسة

نحن نتحدث تحديداً عن APIs أنظمة التصميم بمساعدة الكمبيوتر، وليس الرسومات نفسها: عادةً ما تُكتب البرامج النصية والأدوات لإجراءات متكررة مثل توليد التقارير بكميات كبيرة، والتحقق من المعاملات للامتثال للمعايير الداخلية، أو معالجة الملفات بكميات كبيرة — مهام يقوم بها المهندس يدويًا عشرات المرات لكل مشروع، لكنها تُدفع بسوء كعمل إبداعي.

ما يوفره RAG المحلي في هذا السيناريو

RAG (توليد معزز بالاسترجاع) هو نهج حيث يبحث النموذج، قبل الإجابة، عن أجزاء ذات صلة في قاعدة المستندات الخاصة به بدلاً من الاعتماد فقط على ما تعلمه أثناء التدريب. بالنسبة لتوثيق CAD API، هذا مناسب بشكل خاص: عادةً ما يتم وصف مثل هذه APIs في أدلة ضخمة وأجزائية ومحدثة بانتظام، والنشر المحلي يجعل من الممكن الاحتفاظ بالبيانات الهندسية الحساسة والتوثيق المملوك داخل محيط الشركة، دون إرسالها إلى الخدمات السحابية الخارجية.

هذا هو بالضبط السبب الذي جعل المؤلف يختار حلاً محلياً بدلاً من مساعد ذكاء اصطناعي سحابي جاهز: بالنسبة لبيانات الهندسة، فإن مسألة السرية غالباً ما تكون أكثر أهمية من سهولة الإعداد، والوصول إلى النسخة الحالية من توثيق API حرج، لأن أنظمة CAD تغير واجهاتها وطرقها بانتظام. النشر "الداخلي"، بدون إرسال الطلبات إلى خدمة خارجية، يزيل أيضاً مسألة أين تتسرب صيغ المواصفات التقنية الداخلية وأجزاء من التوثيق المغلق للبائع.

ما الصعوبات التي تنشأ عادةً في مثل هذه المشاريع

توثيق API التقنية مادة غير مريحة لخط أنابيب RAG الكلاسيكي: تحتوي على جداول عديدة مع معاملات، وروابط لأقسام أخرى، وملاحظات إصدار، وكلمات متخصصة محددة لمنصة CAD معينة، والتي لا تنقسم بشكل جيد إلى أجزاء بالطرق المعيارية. عادة ما يتعين على مطوري مثل هذه الخدمات التفكير بشكل منفصل في تقسيم المستندات إلى أجزاء دلالية، وتحديث الفهرس عند إطلاق نسخة API جديدة، والتحقق من أن النموذج لا يخلط بين الطرق المتشابهة في الاسم لكن السلوك مختلف. هذا عمل يدوي وشاق يكون عادة غير مرئي في النتيجة النهائية، لكنه يستغرق جزءاً كبيراً من الوقت لمثل هذا المشروع.

ماذا يعني هذا

القصة تعكس اتجاهاً أوسع: بينما يطلق البائعون الكبار مساعدي ذكاء اصطناعي عالمية، المهندسون الأفراد والفرق الصغيرة بشكل متزايد يجمعون أدوات RAG محلية متخصصة بدقة للروتين المحدد — العمل مع التوثيق والعمليات القالبية والمعايير الداخلية. بالنسبة لمنظمات الهندسة والمشروع حيث يهم سرية الرسومات والامتثال الدقيق لنسخة API، تثبت مثل هذه الأدوات المحلية محلية الصنع غالباً أنها أكثر عملية من توصيل خدمة ذكاء اصطناعي سحابية خارجية بقاعدة توثيق الشركة بالكامل.