Install
git clone https://github.com/dkships/pm-copilot.git
cd pm-copilot
npm install
cp .env.example .env
npm run buildلمن يناسب
إن كنت مدير منتج وتريد مقابلة تذاكر دعم العملاء وطلبات الميزات ومحادثات دعم الذكاء الاصطناعي قبل تقرير الخطوة التالية، فإن هذه الخدمة تناسب ذلك. يصفها النص الرسمي بأنها خادم MCP للتحقق الثلاثي.
تناسب من يستطيع استنساخ المستودع محليًا وتشغيل ناتج البناء بـ node ويملك بيانات اعتماد HelpScout. HelpScout إلزامي. ProductLift وChatbase اختياريان: هيّئ واحدًا أو كليهما أو لا شيء، ويتغير التحليل تبعًا لذلك. بلا HelpScout لا يعطي النص الرسمي مسارًا قابلًا للاستخدام.
التحليل يلمس نص العميل الأصلي. يوضح النص الرسمي أن أرقام SSN وأرقام البطاقات التي تجتاز فحص Luhn والبريد والهاتف تُحجب قبل التحليل، وأن ردود الوكلاء تُصفّى من الاقتباسات. هذا ليس بلا مخاطر: موضوعات التذاكر تدخل التحليل مع ذلك.
إكمال المحاولة الأولى في 3 دقائق
المسار الرسمي الموصى به هو الاستنساخ والبناء محليًا. المتطلب: جهّز بيانات اعتماد HelpScout.
نفّذ الخطوات الرسمية:
git clone https://github.com/dkships/pm-copilot.git
cd pm-copilot
npm install
cp .env.example .env
npm run build
بعد نسخ قالب متغيرات البيئة املأ بيانات اعتمادك الحقيقية. النص الرسمي يكتب فقط Edit with your credentials ولا يسرد أسماء المتغيرات؛ لا تخترع أسماء مفاتيح، غيّر فقط البنود الموجودة في القالب. بعد البناء، في عميل MCP اجعل command هو node ووجّه args إلى dist/index.js في المستودع المحلي. المثال الرسمي يستخدم عنصرًا نائبًا لمسار مطلق؛ غيّره إلى المسار الحقيقي بعد الاستنساخ ولا تنسخ دليل العنصر النائب. احفظ وأعد التحميل وتأكد أن الخدمة متصلة.
ثم نفّذ استدعاءً واحدًا: استدعِ synthesize_feedback. يوضح النص الرسمي أنه يقابل تذاكر HelpScout وطلبات ProductLift ومحادثات Chatbase ويعيد تحليلًا مطابقًا حسب الموضوع مع درجات أولوية. حقول المعاملات غير مكتوبة؛ استدعِ وفق التعريف الذي يعرضه العميل. في المرة الأولى يمكنك تهيئة HelpScout فقط وترك الاثنين الآخرين بلا تهيئة.
إشارة النجاح: يعود تحليل بموضوعات ودرجات أولوية. إن ظهر خطأ اعتماد فتحقق أولًا أن .env مُلئ لـ HelpScout حسب القالب وليس ملفًا فارغًا.
حالات الاستخدام
الحالة الأولى: تحليل موضوعات بـ HelpScout فقط. استدعِ synthesize_feedback. يوضح النص الرسمي أن المصدرين الآخرين اختياريان وأن التحليل يتكيف. نطاق زمن التذاكر وتصفية البريد غير مكتوبين. عند النجاح ينبغي أن ترى مطابقة موضوعات ودرجات أولوية. لا تعامل الدرجات كخارطة طريق مرتّبة.
الحالة الثانية: مع وجود HelpScout، أضف ProductLift أو Chatbase أو كليهما، ثم استدعِ synthesize_feedback مجددًا. يوضح النص الرسمي أنه يقابل أنواع المصادر الثلاثة هذه. الأوزان بين المصادر غير مكتوبة. عند النجاح ينبغي أن ترى تحليل موضوعات يحسب أيضًا الطلبات أو المحادثات. ينبغي ألا يظهر في الاقتباسات كلام وكيل غير مُصفّى، لكن لا تفترض أن كل PII قد أُزيل.
حدود الاستخدام
HelpScout إلزامي؛ ProductLift وChatbase اختياريان. بيانات العملاء تدخل التحليل؛ أنواع PII التي يسميها النص الرسمي فقط تُحجب أولًا. الاستعلامات تخرج إلى تلك الخدمات عبر الشبكة.
النص الرسمي لا يكتب حد معدل ولا تراجع. نتائج التحليل ليست قرار إصدار. هذه الصفحة تسمّي فقط synthesize_feedback؛ لا تخترع أسماء أدوات تخطيط أخرى. يجب أن يشير dist/index.js في الإعداد إلى ناتج البناء المحلي.