تشغيل وكلاء Cursor Cloud عبر تطبيق Telegram: الدليل الشامل للإعداد

تتيح أداة Cursor Cloud Telegram Connector الجديدة للمطورين تشغيل وإدارة وكلاء الذكاء الاصطناعي عبر تطبيق Telegram مباشرة. يربط هذا النظام المبني بلغة Python بين روبوت Telegram مخصص وواجهة برمجة تطبيقات Cursor Cloud Agents، مما يسمح للمستخدمين بإنشاء الوكلاء، وتلقي ردودهم، وإرسال تعليمات المتابعة دون مغادرة واجهة الدردشة. من خلال دمج مسارات عمل منصة GitHub مباشرة في منصة المراسلة، يمكن للمطورين فحص طلبات السحب ودمج الأكواد البرمجية أثناء التنقل.

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

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

بالنسبة للفرق التي تستخدم منصة GitHub، يوفر الموصل تكاملاً عميقاً عند تكوين رمز GitHub اختياري. يمكن للمستخدمين فحص حالات طلبات السحب، وعرض التغييرات البرمجية مباشرة داخل كتل الأكواد في تطبيق Telegram، وتحديد طلبات السحب كجاهزة للمراجعة، وحتى تنفيذ عمليات الدمج (مع دعم طرق الدمج، أو السحق، أو إعادة البناء). يتم تخزين جميع حالات الجلسة، بما في ذلك تتبع الرسائل غير المقروءة وتقدم معالج الإعداد، بشكل دائم في قاعدة بيانات SQLite محلية.

يتطلب نشر الخدمة بعض المكونات الأساسية. يجب أن يكون لديك إصدار Python 3.12 أو أحدث مثبتاً، ورمز روبوت Telegram تم إنشاؤه عبر أداة @BotFather، ومعرف مستخدم Telegram الرقمي الخاص بك والذي تم الحصول عليه من أداة @userinfobot، ومفتاح واجهة برمجة تطبيقات من لوحة تحكم Cursor. إذا كنت تنوي استخدام ميزات طلبات السحب، يوصى بشدة باستخدام رمز وصول شخصي دقيق (PAT) من منصة GitHub مع أذونات القراءة والكتابة لطلبات السحب والمحتويات.

تتضمن عملية التكوين إعداد متغيرات البيئة. فيما يلي الخطوات المطلوبة لتشغيل الخدمة:

• إنشاء روبوت Telegram: ابحث عن أداة @BotFather في تطبيق Telegram، وأرسل أمر /newbot، واحفظ الرمز المقدم كمتغير TELEGRAM_BOT_TOKEN.
• الحصول على معرف المستخدم: أرسل أمر /start إلى أداة @userinfobot واحفظ المعرف الرقمي كمتغير TELEGRAM_ALLOWED_USER_ID لتقييد الوصول إلى الروبوت.
• إنشاء مفتاح واجهة برمجة تطبيقات Cursor: قم بإنشاء مفتاح جديد في لوحة تحكم Cursor واحفظه كمتغير CURSOR_API_KEY.
• إنشاء رمز GitHub (اختياري): قم بإنشاء رمز وصول شخصي دقيق في إعدادات مطوري GitHub واحفظه كمتغير GITHUB_TOKEN.
• تكوين الخدمة: انسخ ملف .env.example إلى ملف .env وأدخل المتغيرات المحفوظة.
• تشغيل التطبيق: قم بتنفيذ الخدمة محلياً باستخدام بيئة Python افتراضية أو انشرها عبر حاوية Docker، مع التأكد من تركيب وحدة تخزين /data للحفاظ على بيانات قاعدة بيانات SQLite.

بمجرد النشر، يعمل الروبوت بالكامل من خلال أوامر تطبيق Telegram. تقوم الخدمة باستطلاع واجهة برمجة تطبيقات Cursor كل 10 ثوانٍ لجلب التحديثات وتسليم رسائل المساعد غير المقروءة مع عرض Markdown الكامل المحول إلى تنسيق HTML الخاص بتطبيق Telegram. فيما يلي القائمة الكاملة للأوامر المدعومة:

• /current: عرض معلومات حول الوكيل النشط (الاسم، الحالة، المستودع، الفروع، رابط طلب السحب).
• /history <count>: إعادة تشغيل آخر عدد محدد من رسائل المحادثة للوكيل الحالي.
• /agents: سرد الوكلاء قيد التشغيل والمنتهين؛ انقر للتحديد أو لفتح السلاسل.
• /focus: عرض خيارات قابلة للنقر لاختيار الوكيل النشط.
• /configure_unread: تعيين سلوك الرسائل غير المقروءة إلى كامل، أو عدد، أو لا شيء.
• /unfocus: مسح الوكيل النشط المحدد حالياً.
• /stop: إيقاف الوكيل قيد التشغيل ومسح التحديد النشط.
• /clear: تحديد جميع الرسائل غير المقروءة كمقروءة للوكيل النشط.
• /close: إغلاق سلسلة تطبيق Telegram المرتبطة دون حذف الوكيل.
• /threadmode: تبديل توجيه سلسلة تطبيق Telegram لكل وكيل بين التشغيل والإيقاف.
• /newagent: تشغيل معالج من 4 خطوات لإنشاء وكيل جديد (النموذج، المستودع، الفرع، الموجه).
• /pr: عرض حالة طلب سحب الوكيل النشط وأزرار الإجراءات.
• /diff: عرض التغييرات البرمجية لطلب سحب الوكيل النشط في كتلة تعليمات برمجية.
• /ready: تحديد طلب سحب الوكيل النشط كجاهز للمراجعة.
• /merge: دمج طلب سحب الوكيل النشط.
• /cancel: إحباط معالج /newagent قيد التقدم.
• /resetdb: مسح وإعادة تهيئة حالة قاعدة بيانات SQLite المحلية.
• /help: عرض الأوامر المتاحة.

يسلط إصدار أداة Cursor Cloud Telegram Connector الضوء على اتجاه متزايد نحو عمليات التطوير غير المتزامنة التي تركز على الأجهزة المحمولة. من خلال استخدام قاعدة بيانات SQLite خفيفة الوزن لإدارة الحالة وفاصل استطلاع قابل للتكوين يبلغ 10 ثوانٍ، أنشأ المطور أداة سريعة الاستجابة لا ترهق موارد النظام. يستفيد قرار تضمين وضع المحادثات المترابطة بشكل خاص من ميزات المجموعات المتقدمة في تطبيق Telegram، مما يمنع إرهاق الإشعارات عند إدارة وكلاء ذكاء اصطناعي متعددين في وقت واحد. تسد هذه الأداة الفجوة بشكل فعال بين إنشاء الأكواد البرمجية الآلية والإشراف البشري، مما يثبت أنه يمكن إدارة مهام عمليات التطوير المعقدة بأمان وكفاءة من الهاتف الذكي.

هل أحتاج إلى رمز GitHub لاستخدام روبوت Telegram؟

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

كيف يتعامل الروبوت مع الرسائل الواردة من وكلاء ذكاء اصطناعي متعددين؟

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

هل بياناتي آمنة عند استخدام هذه الأداة؟

نعم، تم تصميم الخدمة ليتم استضافتها ذاتياً. من خلال تقييد الوصول باستخدام متغير TELEGRAM_ALLOWED_USER_ID، يمكن فقط لحساب Telegram الخاص بك التفاعل مع الروبوت وإصدار الأوامر إلى واجهة برمجة تطبيقات Cursor الخاصة بك.