بوت Slack لوكلاء البرمجة: اربط وكيل Sharkly الخاص بك في Slack

باختصار

بوت Slack لوكلاء البرمجة هو تطبيق Slack مرتبط بوكيل ذكاء اصطناعي واحد، بحيث تتحول الرسائل المباشرة والإشارات إلى محادثات مع الوكيل، ويصل كل رد إلى السلسلة نفسها. في Sharkly، يرتبط كل بوت بوكيل واحد فقط، ويجيب ذلك الوكيل وفق التعليمات والنموذج والمهارات والمستودعات التي أعددتها له.

1. افتح api.slack.com/apps وأنشئ App Configuration Token، ثم انسخ Refresh Token الخاص به.
2. في Sharkly، افتح Integrations واختر Slack، ثم اختر Connect Agent.
3. حدّد الوكيل الذي تريد ربطه، ويمكنك اختياريًا تسمية التطبيق (يحدّ Slack أسماء التطبيقات عند 35 حرفًا).
4. الصق Refresh Token واختر Create & Install.
5. وافق على طلب OAuth في النافذة التي يفتحها Slack.
6. انتظر حتى تنتقل حالة البوت من Installing إلى Connected، ثم أرسل له رسالة مباشرة.

لماذا ينبغي لوكلاء البرمجة لديك أن يجيبوا في Slack

فريقك يستخدم وكلاء البرمجة بالفعل. أحدهم يفتح Claude Code في الطرفية، وآخر يكتب سكربتات لتشغيل Codex، ويبقى الناتج في سجل الأوامر الخاص بكل شخص. وفي الوقت نفسه، تُطرح في Slack الأسئلة التي يستطيع هؤلاء الوكلاء الإجابة عنها، لأن Slack هو المكان الذي يتحدث فيه الفريق.

لهذه الفجوة ثمن. عندما يسأل مدير المنتج عن سبب بدء تعطل نقطة نهاية التصدير، يذهب السؤال إلى أحد المطورين، الذي يسأل الوكيل ثم ينقل الإجابة عائدًا. هذه الوساطة تضيف ساعة كاملة إلى سؤال أجاب عنه الوكيل في تسعين ثانية.

يغلق Sharkly هذه الفجوة من جهة المنصة. Sharkly ليس بديلًا عن Claude Code أو Codex أو غيرهما من أدوات التنفيذ، بل يضيف حولها طبقة مشتركة للمهام والسياق والتحكم والمراجعة. ويمدّ تكامل Slack هذه الطبقة إلى مساحة عملك، فيحصل أعضاء الفريق على الإجابة في المكان الذي طُرح فيه السؤال.

اتصالان ومهمتان

يوفر التكامل نوعين مستقلين من الاتصال، والخلط بينهما هو السبب الأكثر شيوعًا للالتباس:

هما عمليتا تثبيت منفصلتان يدعمهما تطبيقان مختلفان في Slack، ويمكن استخدام أي منهما دون الآخر. وهناك حدّان إضافيان: ترتبط مساحة عمل Slack بمؤسسة Sharkly واحدة فقط في كل مرة، وتستخدم إجراءات Slack داخل أتمتات المساحة اتصالًا ثالثًا يعمل فيه Slack كإجراء لكنه لا يستطيع بدء سير عمل في هذا الإصدار. يغطي هذا الدليل ربط بوت الوكيل.

ما هو بوت Slack الخاص بوكيل Sharkly؟

يربط بوت الوكيل وكيل Sharkly واحدًا بتطبيق Slack واحد. تتحول الرسائل إلى محادثة مع الوكيل، ويعود الرد إلى الرسالة المباشرة أو السلسلة نفسها. والوكيل الذي يجيب هو نفسه الزميل المُعدّ في كل مكان آخر داخل Sharkly: التعليمات والنموذج والمهارات ومعرفة المستودعات نفسها.

الربط فردي تمامًا، ويمكنك ربط وكلائك الشخصيين إضافةً إلى الوكلاء المشتركين في المساحة والمسموح لك باستخدامهم.

يأتي التثبيت بواجهتين. الرسائل المباشرة تنشئ جلسة محادثة لقناة الرسائل المباشرة تلك، وتستكملها الرسائل اللاحقة، فيحتفظ الوكيل بالسياق بدل البدء من الصفر. أما الإشارات في القنوات فتزيل الإشارة وترسل الباقي إلى الوكيل وترد في سلسلة تبدأ من رسالتك.

@ReleaseShark summarize the decision in this thread and list the next steps

يتجاهل Sharkly الرسائل الصادرة من بوتات أخرى، وأحداث تعديل الرسائل، وأحداث الانضمام، ما يمنع حلقات الردود المتكررة عندما تتشارك عدة تطبيقات القناة نفسها.

كيف تربط وكيل ذكاء اصطناعي بـ Slack

تحتاج إلى وكيل يمكنك إعداده (راجع دليل البدء) وإلى صلاحية لإنشاء App Configuration Token في Slack وتثبيت تطبيق للفريق المستهدف.

1. افتح api.slack.com/apps وابحث عن Your App Configuration Tokens.
2. أنشئ App Configuration Token وانسخ Refresh Token الخاص به (وثائق Slack). تعامل معه كسرّ، ولا ترسله إلا عبر نموذج الاتصال في Sharkly.
3. في Sharkly، افتح Integrations واختر Slack.
4. اختر Connect Agent وحدّد الوكيل الذي تريد ربطه.
5. يمكنك اختياريًا إدخال اسم للتطبيق. وإذا تركته فارغًا، يُستخدم اسم الوكيل.
6. الصق Refresh Token واختر Create & Install.
7. أكمل تفويض OAuth في Slack من النافذة التي تُفتح. وإذا لم يظهر شيء، فاسمح بالنوافذ المنبثقة وأعد المحاولة.
8. انتظر حتى تتغير حالة البوت من Installing إلى Connected.

يستبدل Sharkly رمز التحديث (refresh token) برمز وصول قصير الأجل لإعداد التطبيق، وينشئ التطبيق من manifest يغطي هوية البوت وواجهة Slack Assistant وإعادة توجيه OAuth وواجهة الاستدعاء (callback) الخاصة بـ Events API والصلاحيات، ثم يفتح Slack لتثبيته.

تحقق من ذلك بإرسال رسالة مباشرة إلى البوت. فالرد يؤكد أن المسار كامل: استُقبل الحدث، وأُنشئت الجلسة، واكتمل التشغيل، وسُلّمت الاستجابة. وإذا بقي البوت في حالة Installing، فهذا يعني أن واجهة استدعاء OAuth لم تخزّن رمز البوت بعد، لذا أعد فتح نافذة التثبيت وأكمل الطلب. وإذا لم يكن الوكيل قابلًا للاختيار، فهو مرتبط بالفعل بتطبيق آخر.

مشغّلات بوت Slack: الإشارة، والتفاعل بالرموز التعبيرية، وأي رسالة

افتراضيًا، يستجيب البوت للرسائل المباشرة والإشارات في القنوات فقط، ولا شيء غير ذلك. في إعدادات Slack الخاصة بالوكيل، يظهر كل مشغّل في صف يمكنك تفعيله أو تعطيله:

• Mentioned in a channel هو الوضع الافتراضي. لا يعمل الوكيل إلا عندما يذكر أحدهم البوت، ويصل الرد في سلسلة تحت الإشارة.
• Emoji reaction in a channel يحوّل التفاعل إلى مشغّل. تفاعل بالرمز التعبيري المُعدّ، ويفتح البوت سلسلة مع السياق المجاور.
• Any channel message يشغّل الوكيل على الرسائل العادية في القنوات التي تحددها صراحةً. ولا يمكن تطبيقه على كل القنوات، كما أن التطبيقات الأخرى التي تنشر هناك قد تشغّله.

القاعدتان اللتان تحفظان الأمور معقولة: أبقِ على وضع الإشارة فقط في القنوات المشتركة، حيث يخلق التشغيل الواسع ضوضاء ويعرّض الوكيل لسياق غير ذي صلة. ولا تفعّل Any channel message إلا في قناة مخصصة يتوقع فيها الجميع أن تصل الرسائل إلى الوكيل. أما مشغّل الرموز التعبيرية فيقع بين هذين الطرفين، إذ لا شيء يصل إلى الوكيل ما لم يتفاعل شخص عن قصد.

كل سلسلة في القناة هي محادثة مستقلة مع الوكيل، لذا فإن سلسلتين في قناة واحدة تعنيان جلستين بسياق منفصل، ويمكن للناس متابعة السلسلة دون ذكر البوت مرة أخرى. كما يفعّل التطبيق Slack Assistant، وهي اللوحة التي يوفرها Slack لتطبيقات الذكاء الاصطناعي.

المحادثة في Slack ليست مهمة

لا تنشئ محادثات بوت الوكيل مهام من تلقاء نفسها، وهذا الحد مقصود. والقاعدة الواردة في المحادثة مقابل إسناد المهام تنطبق كما هي: تحدّث عندما تحتاج إلى إجابة، وأسند مهمة عندما تحتاج إلى نتيجة سيراجعها أحدهم.

عندما ينشئ الوكيل مهمة من Slack، يمكنك ربط السلسلة الحالية في الوقت نفسه. وبعد الربط، تبقى تعليقات المهمة ورسائل السلسلة متزامنة. وربط السلاسل هو ما يمنح هذا التكامل قيمته: تبدأ المناقشة في Slack، وتتحول إلى مهمة، ومنذ تلك اللحظة تعود التطورات والعوائق والنتائج إلى المهمة، بينما تبقى السلسلة محدثة لمن كانوا في المحادثة.

متى يكون بوت Slack الخيار الخاطئ

إذا كنت تريد إنشاء المهام ومعاينة الروابط فقط. فاستخدم اتصال مساحة العمل وحده. فالأوامر المائلة والاختصارات وروابط العودة إلى المهام وفتح الروابط تأتي كلها من التطبيق المشترك.

إذا كنت تريد رسائل قنوات مجدولة أو مدفوعة بأحداث. فهذا إجراء Slack داخل سير عمل أتمتة، وليس محادثة. ولأن أحداث Slack لا يمكنها تشغيل سير العمل في هذا الإصدار، فابدأ من جدول زمني أو تغيير حالة أو كلمة مفتاحية في تعليق أو webhook.

إذا كان العمل يتطلب تنفيذًا على مستودع مع مراجعة في النهاية. فأسند مهمة. استخدم البوت للسؤال، والمهام للبناء.

إذا كنت تريد بوتًا واحدًا يمثّل فريقك بالكامل. فهذا الربط غير موجود. عدة متخصصين ينسقون في عمل حقيقي مكانهم في Crew يعمل على مهمة، لا في قناة مليئة بالبوتات.

الأمان والصلاحيات

• يُستبدل App Configuration Refresh Token أثناء الإعداد ولا يُستخدم كرمز البوت المثبّت. أما client secret وsigning secret ورمز بوت OAuth التي تُنشأ فتُشفَّر أثناء التخزين.
• يتم التحقق من عمليات الاستدعاء (callbacks) الخاصة بـ Events API باستخدام signing secret المخزّن؛ وتُرفض التوقيعات غير الصالحة، ويخضع حجم أجسام الأحداث لحد أقصى.
• راجع الصلاحيات (scopes) المطلوبة قبل التفويض: الإشارات، والرسائل المباشرة، وسجل السلاسل في القنوات العامة والخاصة، وإرسال الرسائل، وفتح الرسائل المباشرة، وتحديثات حالة Assistant.
• يدير المالكون والمشرفون مساحة العمل المشتركة وكل عمليات الربط؛ ويدير الأعضاء عمليات الربط الخاصة بالوكلاء الذين يمكنهم استخدامهم.

فصل الاتصال ليس إجراءً مدمّرًا: يتوقف الوكيل عن استقبال الرسائل عبر ذلك البوت، لكن سجل Slack يبقى كما هو ولا تتحول أي رسالة سابقة إلى مهمة.

الخاتمة

يكتسب بوت Slack لوكلاء البرمجة مكانته عندما يغيّر مكان إجراء المحادثة دون أن يغيّر مكان وجود العمل. اربط وكيلًا واحدًا تثق به بالفعل، وأبقِ على الوضع الافتراضي (الإشارة فقط) حتى تطلب قناة ما أكثر من ذلك، واستخدم ربط السلاسل في اللحظة التي تتحول فيها محادثة إلى عمل. وإذا لم يكن لديك وكيل بعد، فأنشئ واحدًا أولًا.

الأسئلة الشائعة

هل أحتاج إلى ربط مساحة عمل Slack قبل ربط بوت وكيل؟

لا. نوعا الاتصال مستقلان. وتحتاج إلى اتصال مساحة العمل فقط لإنشاء المهام من Slack، وروابط العودة إلى المهام، ومعاينات الروابط، ورسائل إشعارات صندوق الوارد (Inbox) المباشرة.

هل يمكن لبوت Slack واحد أن يخدم عدة وكلاء Sharkly؟

لا. يرتبط كل بوت بوكيل واحد فقط، ولا يحمل الوكيل سوى ربط واحد في كل مرة. ولإضافة عدة وكلاء إلى Slack، أنشئ بوتًا منفصلًا لكل واحد منهم.

هل تؤدي المحادثة مع البوت إلى إنشاء مهام تلقائيًا؟

لا. عندما تتحول محادثة إلى عمل يحتاج إلى مسؤول أو حالة أو مراجعة، أنشئ المهمة عن قصد. وإذا أنشأها الوكيل من Slack، يمكنك ربط السلسلة لتبقى التعليقات والرسائل متزامنة.

هل يمكن لرسالة في Slack أن تبدأ سير عمل أتمتة في Sharkly؟

ليس في هذا الإصدار. Slack متاح في سير العمل كإجراء، لكن مشغّلات Slack عبر Events API لم تُربط بعد.