Apidog

منصة تطوير API تعاونية متكاملة

تصميم API

توثيق API

تصحيح أخطاء API

محاكاة API

اختبار API الآلي

كيفية استخدام وضع وكيل المؤشر

@apidog

@apidog

Updated on مارس 29, 2025

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

سيقوم هذا الدليل بإرشادك خلال استخدام وضع وكيل كرسور بشكل فعال، من الإعداد إلى التقنيات المتقدمة، helping you leverage this powerful tool to enhance your productivity while maintaining control over your development process. سواء كنت مطوراً متمرساً يسعى لتبسيط سير العمل أو مبتدئًا متحمسًا لاستغلال قوة الذكاء الاصطناعي في رحلتك البرمجية، سيوفر لك هذا الدليل المعرفة والاستراتيجيات اللازمة لتعظيم إمكانيات وضع وكيل كرسور في مشاريعك.

للمستخدمين الذين يعملون مع واجهات البرمجة، يقدم APIdog بديلاً منعشًا لـ Postman يتكامل بسلاسة مع سير عملك التطويري.

زر

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

بينما تستفيد من قدرات كرسور المدعومة بالذكاء الاصطناعي في البرمجة، فإن الجمع بينها وبين APIdog يخلق مجموعة قوية لبناء واختبار واجهات برمجة التطبيقات بكفاءة. سواء كنت تعمل على خدمات RESTful، أو GraphQL، أو WebSockets، يوفر APIdog المرونة والأداء اللازمين للتعامل مع بيئات واجهات برمجة التطبيقات المعقدة مع الحفاظ على تجربة مستخدم نظيفة وسهلة تتكامل مع نهج كرسور المبتكر في تحرير الشيفرة.

زر

ما هو وضع وكيل كرسور؟

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

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

البدء في وضع وكيل كرسور

التثبيت والإعداد

قبل الغوص في وضع الوكيل، تحتاج إلى تثبيت وإعداد كرسور بشكل صحيح لضمان الأداء الأمثل. ابدأ بزيارة cursor.com وتنزيل النسخة المناسبة لنظام التشغيل الخاص بك (ويندوز، ماك أو إس، أو لينوكس).

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

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

تفعيل وضع الوكيل

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

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

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

تكوين وضع الوكيل لأداء مثالي

إعداد قواعد الذكاء الاصطناعي

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

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

تفعيل وضع YOLO في كرسور لأقصى قدر من البرمجة الديناميكية

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

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

تطبيقات عملية لوضع الوكيل

توليد الشيفرة المتعددة الملفات وإعادة الهيكلة

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

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

إعداد المشروع وإدارة الاعتمادات

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

على سبيل المثال، يمكنك أن توجه وضع الوكيل "لإنشاء تطبيق React جديد باستخدام TypeScript وTailwind CSS وReact Router، وإعداد هيكل مجلد أساسي للمكونات، والصفحات، والأدوات المساعدة." سيقوم الذكاء الاصطناعي بإنشاء الملفات اللازمة، وكتابة سكريبتات التكوين، وتشغيل أوامر المحطة لتثبيت الاعتمادات وتهيئة المشروع. يمكنه أيضًا إنشاء مكونات وصفحات نموذجية بناءً على تعليماتك، مما يمنحك أساسًا قويًا للعمل عليه. تعتبر هذه القدرة ذات قيمة خاصة عند بدء مشاريع جديدة أو عند إنشاء نماذج أولية لاستكشاف تقنيات مختلفة، حيث تقلل الوقت المستغرق في المهام المتكررة وتتيح لك التركيز على الجوانب الفريدة لتطبيقك.

تصحيح الأخطاء وحل المشكلات

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

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

تقنيات متقدمة لإتقان وضع الوكيل

تعزيز السياق مع وثائق المشروع

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

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

استغلال دفاتر الملاحظات للسياق المستمر

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

يمكن أن تحتوي دفاتر الملاحظات على أنواع مختلفة من المعلومات، بما في ذلك قرارات هيكلة المشاريع، وإرشادات التطوير، وقوالب الشيفرة القابلة لإعادة الاستخدام، والاتفاقيات الخاصة بالفريق. يمكنك الإشارة إلى هذه الدفاتر في تعليماتك باستخدام عناوينها، مما يتيح لك الحفاظ على الاتساق عبر التفاعلات دون الحاجة إلى تقديم نفس المعلومات مرارًا وتكرارًا. على سبيل المثال، إذا كان لديك دفتر ملاحظات بعنوان "الاتفاقيات الخاصة بواجهات البرمجة" ي outlines your project's approach to API design, you can refer to it when asking Agent Mode to create new endpoints, ensuring that they follow your established patterns. تعتبر هذه الميزة ذات قيمة خاصة للحفاظ على الاتساق في المشاريع طويلة الأمد أو عند العمل مع عدة أعضاء في الفريق الذين يحتاجون إلى الالتزام بنفس المعايير.

فهرسة الوثائق الخارجية

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

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

الخاتمة

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

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

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