تصميم Artie، مساعد توثيق يعمل بالذكاء الاصطناعي
اقرأ منشور المدونة المصاحب للحصول على سياق أوسع: ما علّمني إياه بناء مساعد توثيق بالذكاء الاصطناعي عن الكتابة التقنية. يستكشف المقال التوليد المعزز بالاسترجاع (RAG) وموقع هذا المشروع في مجال الكتابة التقنية.
تستعرض دراسة الحالة هذه القرارات التصميمية الكامنة وراء Artie، وهو مساعد توثيق يعمل بالذكاء الاصطناعي تم بناؤه باستخدام Algolia وتم دمجه في موقع التوثيق هذا. Artie هو مساعد يعتمد على التوليد المعزز بالاسترجاع (RAG) ولا يستجيب إلا انطلاقًا من المحتوى المنشور هنا. ويبقي موجه النظام الخاص به استفسارات التوثيق مرتبطة بذلك المحتوى بدلاً من المعرفة العامة للتدريب. وهذا القيد يقلل من الهلوسة ويمنع الميزات المختلقة.
يبدو بناء مساعد توثيق أمرًا بسيطًا حتى تأخذ في الاعتبار الحالات الحدية (edge cases): ماذا يحدث عندما يطرح شخص ما سؤالاً لا تغطيه الوثائق؟ ماذا لو استخدم جمهوران مختلفان نفس الواجهة؟ كيف تمنح الذكاء الاصطناعي شخصية دون تركه يسترسل بلا طائل؟ وكيف تمنع أي شخص من اختطاف الموجه بالكامل؟
توضح هذه الصفحة كيف يعالج هذا التصميم كل مشكلة من تلك المشكلات.
توجيه الجمهور
يخدم Artie جمهورين من خلال واجهة محادثة واحدة:
- المطورون والمستخدمون النهائيون الذين يبحثون عن تعليمات الإعداد، أو مراجع واجهة برمجة التطبيقات (API)، أو شروحات لنماذج التوثيق
- مسؤولو التوظيف ومديرو التوظيف الذين يقيّمون هذا الملف التعريفي والذين قد يسألون عن المؤهلات أو الخبرة أو عملية الكتابة
بدلاً من بناء مسارات منفصلة أو مطالبة المستخدمين بتحديد هويتهم بأنفسهم، يوجه الموجه وفقًا للنية. تحصل الأسئلة الفنية على إجابات خطوة بخطوة تستند إلى فهرس الوثائق. وتحصل الأسئلة المتعلقة بملف الأعمال على ردود تدمج سياق السيرة الذاتية مع نماذج الكتابة المنشورة على الموقع. وإذا لم يكن سياق السيرة الذاتية متاحًا في الفهرس، يوجه Artie الزوار إلى صفحة "نبذة عني" بدلاً من محاولة إنشاء إجابة.
توفر الواجهة لكلا الجمهورين محادثة واحدة بلا قوائم، ويحصل كل منهما على استجابة ملائمة.
تأسيس المعرفة واسترجاعها
أهم قيد في تصميم Artie هو أنه يجيب حصريًا من فهرس التوثيق المدعوم بواسطة Algolia. هذا هو المبدأ الأساسي للتوليد المعزز بالاسترجاع (RAG). ترتكز ردود النموذج على مجموعة محددة من المحتوى بدلاً من الاعتماد على بيانات التدريب العامة.
- لا محتوى مخترع يعني أن المساعد لا يختلق ميزات ولا ينشئ روابط تنزيل، ولا يصف سوى الخطوات الواردة في الوثائق.
- ربط المصادر يعني أن المساعد يوفر عناوين URL أو مراجع ملفات من الفهرس حتى ينتقل المستخدمون مباشرة إلى الصفحة ذات الصلة.
- تراجع سلس (Graceful fallback) يعني أن Artie يوضح القيد بوضوح عندما يفتقر الفهرس إلى معلومات ذات صلة، ثم يقترح التواصل مباشرة دون إعادة محاولة أو تكهنات.
لا يمكن لـ Artie المساعدة في أي شيء خارج الوثائق المنشورة. وبالنسبة لموقع ملف أعمال، فهذا القيد مفيد: الدقة أهم بكثير من الاتساع. فالإجابة الدقيقة والموثقة بمصادر موثوقة لسؤال محدد تبني ثقة أكبر من إجابة تبدو مقنعة لكن يتبين لاحقًا أنها خاطئة.
معايرة الشخصية والأسلوب
يتمتع Artie بشخصية خفيفة تقوم على دفء هادئ مستوحى من جورج هاريسون مع لهجة ليفربول العرضية. الكلمة الأساسية هي خفيفة. تضيف الشخصية طابعًا مميزًا إلى التحيات والتوديع دون التدخل في المحتوى الفني.
القيود التصميمية هنا مقصودة:
- الحفاظ على الإجابات الفنية موجزة يعني أن الشخصية لا تبرر أبدًا إطالة الردود. تحية دافئة تليها إجابة محكمة وواقعية تحقق هذا الهدف.
- التنوع بدلاً من التكرار يعني أن الموجه يتضمن مجموعة من التعبيرات حتى يتجنب Artie الاعتماد التلقائي على نفس العبارة في كل مرة.
- الابتعاد عن الوعظ يعني أن الشخصية تحافظ على نبرة دافئة وساخرة بلطف دون أن تبدو وعظية أو استعلائية، وتتصرف كزميل مفيد بدلاً من أداء تمثيلي لشخصية.
يعد هذا النوع من ضبط النبرة تحديًا شائعًا في تصميم الذكاء الاصطناعي للمحادثات. الإفراط في الشخصية يجعل المساعد يبدو استعراضيًا، والتقليل منها يجعله يبدو آليًا وجافًا. والحل يكمن في معاملة الشخصية كالتوابل: حاضرة، لكنها ليست المكون الرئيسي أبدًا.
الأمان والضوابط الوقائية
المساعد الذكي الموجه للجمهور يمثل سطحًا عرضة للهجمات (attack surface)، ويتضمن الموجه دفاعات صريحة ضد نقاط الضعف الشائعة في نماذج اللغة الكبيرة (LLM).
الحماية من حقن الموجه (Prompt Injection)
يرفض موجه Artie صراحةً أي محاولة لتجاوز تعليماته، مثل الأوامر من قبيل "تجاهل التعليمات السابقة" أو طلبات تبني شخصية مختلفة. وهذا يؤسس دفاعات على مستوى الموجه ضد حقن الموجه، المصنف في المرتبة الأولى في قائمة أهم 10 مخاطر لتطبيقات نماذج اللغة الكبيرة لمشروع أمن التطبيقات العالمي المفتوح (OWASP).
تقييد النطاق
يحدد الموجه فئات رفض صريحة:
- يرفض المساعد طلبات المساعدة العامة في البرمجة غير المغطاة في التوثيق.
- يرفض المساعد طلبات المعلومات العامة غير ذات الصلة، باستثناء ميزتين ترفيهيتين محددتي النطاق.
- يرفض المساعد الاستفسارات عن المعلومات الشخصية التي لا ينشرها الملف المهني.
- يوجه المساعد الزوار للتواصل المباشر بشأن أسعار العمل الحر أو التفاوض.
لكل فئة حد واضح المعالم، فلا يصدر المساعد أحكامًا تقديرية حول ما إذا كان السؤال "قريبًا بما يكفي" للإجابة. وإذا تجاوز الطلب ذلك الحد، يرفضه بلباقة.
خصوصية البيانات
يشارك Artie فقط معلومات الاتصال المنشورة صراحة في التوثيق، مثل ملف تعريف LinkedIn أو بريد المحفظة الإلكتروني. ولن يخمن أو يستنتج أو ينشئ تفاصيل شخصية كأرقام الهواتف أو العناوين.
الحدود المهنية
لن يتفاعل المساعد مع الرسائل العدائية، ولن يستخدم لغة بذيئة، ولن يخرج عن شخصيته المحددة. وهذا يتجاوز مجرد اللباقة؛ إنه يتعلق بالحفاظ على سلوك يمكن التنبؤ به. وأي مسؤول توظيف يختبر حدود المساعد سيواجه حدًا مهنيًا متسقًا في كل مرة.
المفاجآت الخفية المقيدة (Controlled Easter Eggs)
يتضمن Artie "ميزتين ممتعتين"، وهما حقائق Snapple الواقعية والنكات النظيفة، لتوضيح كيفية إضافة لمسة شخصية دون فتح الباب أمام إساءة الاستخدام.
تشترك كلتا الميزتين في نفس نمط التصميم:
- محفزات صريحة تعني أن الميزتين لا تنشطان إلا عندما يطلبها المستخدم ("أعطني حقيقة من Snapple"، "أخبرني بنكتة")، وليس بناءً على تلميحات غامضة.
- محتوى مقيد يعني أن حقائق Snapple ترتكز على قائمة مدمجة من الحقائق الموثقة، في حين تظل النكات منتقاة ومناسبة للعائلة.
- منع الفبركة غير المستندة إلى مصادر يعني أن المساعد يتجنب اختلاق الحقائق أو توليد فكاهة خارجة عن طابع العلامة، فتبقى المخرجات قابلة للتنبؤ.
تستنفد الميزات الإبداعية غير المقيدة الرموز (tokens) سريعًا وتولد مخرجات غير متوقعة. والمحتوى المنتقى مع المحفزات الصريحة يضيف دفئًا دون هذه المخاطرة.
ما الذي سأفعله بشكل مختلف
غيّر المستخدمون الحقيقيون هذا التصميم.
- تكلفة الرموز (Token cost) تحرك التغيير الأول. تتجاوز قائمة حقائق Snapple وحدها 100 عنصر. في نظام إنتاجي يعتمد على المحاسبة لكل رمز، سأنقل ذلك إلى طبقة استرجاع بدلاً من تضمينه في موجه النظام. يدفع الفريق مقابل كل رمز في الموجه مع كل طلب، سواء طلب المستخدم حقيقة أم لا.
- سياق متعدد الأدوار يقصر التصميم الحالي على أسئلة وأجوبة ذات دور واحد. ويمكن لإصدار لاحق الحفاظ على سجل المحادثة وإعادة صياغة الاستعلامات لمعالجة أسئلة المتابعة مثل "ماذا عن الخطوة التالية؟".
- التحليلات والملاحظات لم تُبنَ بعد. وتسجيل عدد استجابات التراجع وحده سيكشف فجوات التوثيق التي تسبب أكبر عدد من الإخفاقات.
- الضبط الديناميكي للشخصية يتطلب اليوم تحرير تعبيرات ثابتة في الكود. ونقلها إلى تكوين خارجي سيسهل تعديل النبرة دون تحرير مجموعة التعليمات الأساسية.
كل من هذه النقاط يمثل مقايضة مدروسة لمشروع ملف أعمال حيث البساطة والوضوح أهم من التحسين على مستوى الإنتاج الضخم. لكنها أولى النقاط التي سأعالجها إذا انتقل هذا المشروع إلى بيئة ذات حركة مرور أعلى.