وكيل البحث الذي بناه Roman لـ ZCode: من ضجيج المجتمع إلى أدلة للمنتج
يصف Roman، مشرف مجتمع لدى Z.ai، إضافة ZCode التي خطط لها وصممها وطورها، مع أدلة قابلة للتتبع وإجابة نهائية يكتبها إنسان.
مقدمة تحريرية
يتناول هذا المقال Roman، مشرف مجتمع لدى Z.ai، ومشروعه ZCode Discord Research Agent. المقال التالي بصيغة المتكلم هو رواية Roman لعمله في التخطيط والهندسة والتطوير. إنه عرض شخصي للمشروع، وليس إعلانا رسميا من Z.ai أو ادعاء بتكليف الشركة به أو اعتمادها أو تأييدها له.
مقال Roman بصيغة المتكلم
المشكلة التي اخترت حلها
في مجتمعات مثل Discord الخاص بـ Z.ai، يعبر المستخدمون عن احتياجاتهم الملحة قبل أن يلاحظ الجميع وجود اتجاه. رصد الاتجاهات أثناء تشكلها وسط هذا الحجم من المحادثات صعب. قررت بناء حل تقني لهذه المشكلة.
كانت المادة الخام موجودة، وهنا تكمن الصعوبة. قد يمتلئ مجتمع الدعم بالمعلومات ويظل التعلم منها صعبا. يصف شخص سير عمل معطلا في موضوع خطأ، ويبلغ آخر عن العطل نفسه بعنوان مختلف. وقد تكون المعلومة التشخيصية الوحيدة المفيدة داخل لقطة شاشة. تمزج المحادثة الطويلة بين شكاوى مباشرة وموافقات قصيرة وأسئلة عن وصول إصلاح. قراءة رسائل أكثر لا تنتج تلقائيا قرارا أفضل للمنتج.
خططت لـ ZCode Discord Research Agent وصممته وطورته لتقليص المسافة بين ما يقوله المجتمع وما يمكن لفريق المنتج التصرف بشأنه بمسؤولية. أردت طريقة قابلة للتكرار لفحص الملاحظات وحفظ أدلتها وإنتاج تقرير يستطيع مدير الدعم مراجعته. الغرض أن يكون البحث قابلا للدفاع عنه بالأدلة، إلى جانب تسريعه.
سير عمل للبحث
بنيت المشروع كإضافة أصلية لبيئة ZCode، وفي قلبه أدوات Python محلية. يبدأ العمل بتحديد النطاق والجمع ثم التحليل والتقارير، وعند الحاجة، استجابة تخضع للمراجعة. يجمع المكون المخصص لذلك رسائل المواضيع وبيانات المرفقات؛ ثم يطبق الوكيل منهج البحث. ويحول مولد التقارير التحليل المنظم إلى مستندات عمل.
ينبغي للجمع أن يحفظ ما قيل، وللتحليل أن يشرح معناه، وللتقرير أن يوضح الاستنتاج وحدوده. الفقرة المقنعة لا تعوض سلسلة الأدلة هذه.
وتظل الأحكام واضحة. التجميع الدلالي وفحص لقطات الشاشة والتمييز بين شكوى فعلية وتعليق عابر أجزاء من سير العمل الموجه بالوكيل. لا أدعي أن سكربت Python صغيرا يفهم كل محادثة تلقائيا.
هندسة تراعي بنية Discord
يجب أن تحترم أداة البحث بنية مصدرها. تحتوي منتديات Discord على مواضيع تضم المحادثات المهمة. يشمل المشروع اكتشاف الفئات والقنوات والمواضيع الحديثة والمؤرشفة، وجلب صفحات الرسائل وتنزيل المرفقات وبيان جمع محلي. تتعامل طبقة API مع إعادة المحاولة عند حدود المعدل وأخطاء الشبكة.
للجمع حدود مضبوطة لعدد المنتديات والمواضيع، وسقف افتراضي يبلغ 800 رسالة لكل موضوع. يتجاوز النظام ملفات المواضيع المخزنة مؤقتا بدلا من تحديثها باستمرار. تقلل هذه الخيارات العمل المتكرر، لكنها تقيد ما يمكن للتقرير ادعاؤه: العينة لا تثبت قراءة كل المحادثات، والموضوع المخزن ليس بالضرورة حديثا.
تعمل الأدوات محليا داخل بيئة المشغل، دون خدمة مستضافة منفصلة لبيانات الاعتماد. التشغيل المحلي خيار معماري، وليس ضمانا شاملا للخصوصية أو الأمان أو موافقة المنصة.
رصد الاتجاهات دون اختلاق اليقين
عشر رسائل لا تعني بالضرورة عشرة مستخدمين متأثرين. قد يكرر المؤلف شكواه في عدة مواضيع، وقد تكون بعض الردود أسئلة عن المستجدات فقط. وعبارة قصيرة مثل 'نفس المشكلة' تحمل معلومات أقل من وصف واضح للعطل.
لذلك يفصل سير العمل الشكاوى الصريحة عن الردود الحدية، ويستبعد أسئلة الحالة من أعداد الشكاوى، ويحسب نسخ النص نفسه من المؤلف نفسه مرة واحدة. يجمع البلاغات ذات الصلة في عائلات مشكلات مع الاحتفاظ بمراجع المواضيع الأصلية. كما يطلب فحص الصور المنزلة عندما تغيب معرفات تشخيصية مفيدة عن النص.
يسهل بذلك الاعتراض على الأرقام. ينبغي للمدير أن يسأل لماذا احتسب مؤلف معين، وأي موضوع يدعم الاستنتاج، وما الأدلة الناقصة. أردت تقريرا يتحمل هذه الأسئلة.
تقارير قابلة للفحص
تنتج طبقة التقارير ملف Excel متعدد الأوراق وHTML جاهزا للطباعة، مع إنشاء PDF عند توفر مكتبة ReportLab الاختيارية. يفصل الملف الملخص والمواضيع بحسب عائلات المشكلات والأدلة التفصيلية وتدقيق الردود وفحوص المرفقات.
يمكن للمدير البدء بالأولويات، بينما يعود من يفحص عطلا محددا إلى الأدلة. وإذا اعترض أحد على الاستنتاج في الشهر التالي، يظل المسار إلى المواضيع الأصلية محفوظا في التقرير.
مساعدة الدعم مع إجابة نهائية يكتبها إنسان
أكثر ما يهمني أن سير البحث نفسه يستطيع أيضا مساعدة فريق الدعم في عمله.
عند تلقي سؤال، يمكنه جمع أدلة المواضيع واسترجاع الوثائق من قاعدة معرفة محلية واقتراح حلول ممكنة مع مصادرها. يحصل المختص الذي يواجه خطأ غير مألوف على نقطة بداية مدروسة.
يكتب إنسان الإجابة النهائية عمدا. يقترح الوكيل ويقرر الإنسان ما يسمعه المجتمع. يتطلب إعداد الرد وثائق رسمية أو سابقة معتمدة من المشرفين وروابط دقيقة وتصعيدا صريحا عندما لا تجيب المصادر عن السؤال. ويمنع اختلاق وعود بإصلاحات أو مواعيد أو تعويضات. يظل الإرسال خطوة منفصلة يوافق عليها شخص مسبقا. أردت تسليم الأدلة مع إبقاء الحكم والصوت للإنسان.
جعل الأداة قابلة للاستخدام من الآخرين
تعاملت مع التثبيت كجزء من المنتج. يتضمن المستودع تعريف سوق إضافات خاصا به، لذلك يمكن استخدام ZIP منزل كمصدر للتثبيت. يسمح المسار الموثق لمدير الدعم بطلب تثبيت الإضافة المحلية من ZCode بدلا من إعداد بيئة Python يدويا.
تستخدم السكربتات الأساسية مكتبة Python القياسية؛ وإنشاء PDF المباشر يعتمد على مكتبة اختيارية. يحتوي الكود مسارات لـ macOS وWindows وLinux؛ والفحوص الحية المسجلة حاليا تخص macOS فقط، بما فيها جمع مواضيع فعلية وتنزيل مرفقات وإنتاج تقارير ودورة كاملة لقاعدة المعرفة. دعم Windows وLinux منفذ، لكن ملاحظات التحقق لا تزال تطلب فحوصا حية عليهما.
ما بنيته وما بقي
هذا تنفيذ مبكر بأجزاء عاملة وعمل غير مكتمل. سجل التحقق دليل على فحوص محددة، وليس إثباتا لحجم إنتاجي أو اعتماد أو وقت موفر مقاس. يحتاج نطاق الجمع وحداثة التخزين المؤقت والسلوك عبر الأنظمة وقواعد البحث المجتمعي الآلي إلى عمل إضافي قبل نشر أوسع. أفضل التصريح بهذه الحدود.
هذا هو العمل الهندسي الذي أريد القيام به: البدء بمشكلة تشغيلية واختيار سير مناسب وبناء أدواته وحصر الادعاءات في حدود الأدلة. تحول الرغبة في فهم المستخدمين إلى نظام يحول ملاحظاتهم إلى أولويات منتج قابلة للفحص.
عندما يقرر فريق ما يستحق الاهتمام، ينبغي أن يستطيع بيان السبب.
ملاحظة النشر
يصف Roman قدرات المشروع والفحوص المسجلة؛ وهي ليست اختبارات للمنتج أعيد تنفيذها بصورة مستقلة. توثق مستندات ZCode العامة آلية الإضافات والأسواق المحلية، ولا تثبت نتائج المشروع أو امتثاله لقواعد المنصة.