03beginner4 min read دقيقة قراءة
Chat ووضع Agent
استخدم لوحة Chat ووضع Agent في Cursor لطرح أسئلة حول قاعدة الكود وتخطيط الميزات والسماح لـ Cursor بتنفيذ تغييرات متعددة الملفات باستقلالية.
chatوضع-agentcomposerسياق-قاعدة-الكودوضع-التخطيط
استخدم لوحة Chat ووضع Agent في Cursor لطرح أسئلة حول قاعدة الكود وتخطيط الميزات والسماح لـ Cursor بتنفيذ تغييرات متعددة الملفات باستقلالية.
اضغط Cmd+L (Ctrl+L) لفتح لوحة Chat على الجانب الأيمن من المحرر. هنا تجري محادثة مع Cursor يمتلك السياق الكامل لقاعدة الكودك — ليس فقط الملف المفتوح، بل المشروع بأكمله، مفهرساً وقابلاً للبحث.
يمكنك طرح أسئلة، أو طلب تغييرات، أو وصف ميزة تريد بناءها. سيقرأ Cursor الملفات ذات الصلة، ويخطط لما يحتاج إلى التغيير، ويقترح التعديلات.
اكتب أي سؤال بالإنجليزي البسيط:
Where is user authentication handled in this project?
يبحث Cursor في قاعدة الكود باستخدام البحث الدلالي ويستجيب بمراجع الملفات ومقتطفات الكود وشرح — حتى لو لم تفتح تلك الملفات من قبل.
Where is user authentication handled in this project?
→ Authentication is handled in src/lib/auth.ts.
- signIn() and signOut() use NextAuth.js (app/api/auth/[...nextauth]/route.ts)
- Session is validated in middleware.ts (lines 12–28)
- Protected routes check session with withAuth() from src/lib/auth.ts
في chat، استخدم @ لتضمين سياق محدد:
| الإشارة | ما تتضمنه |
|---|---|
| @filename | محتوى ملف محدد |
| @folder | جميع الملفات في دليل |
| @web | نتيجة بحث ويب مباشرة |
| @docs | صفحة وثائق محددة |
| @git | تغييرات git الأخيرة أو commit محدد |
مثال:
@src/components/Button.tsx Why does this button flicker on first render?
يقرأ Cursor ذلك الملف ويعطي إجابة مستهدفة.
يتيح وضع Agent لـ Cursor العمل باستقلالية: يقرأ الملفات، ويجري تعديلات عبر ملفات متعددة، ويُشغّل أوامر طرفية، ويكرر حتى اكتمال المهمة.
لتفعيل وضع Agent، انقر على منتقي الوضع في لوحة chat وتحول من "Ask" إلى "Agent".
صف مهمة:
Add a rate-limiting middleware to all /api routes using upstash/ratelimit.
Install the package, write the middleware, and apply it to every route handler.
سيقوم Cursor بـ:
@upstash/ratelimitقبل أن يُجري Agent تغييرات، يمكنك استخدام وضع التخطيط لمراجعة استراتيجيته دون تطبيق أي شيء:
هذا مفيد بشكل خاص لإعادة الهيكلة الكبيرة حيث تريد التحقق من النهج أولاً.
في لوحة chat، يمكنك اختيار نموذج الذكاء الاصطناعي الذي يعمل على الاستجابة. يدعم Cursor كل النماذج الحدية الرئيسية:
يمكنك تغيير النماذج لكل محادثة. استخدم نماذج أرخص/أسرع للأسئلة السريعة ونماذج مميزة لإعادة الهيكلة المعقدة.
يختار Cursor تلقائياً نموذجاً لإكمالات Tab (نموذج Tab المتخصص). اختيار النموذج في Chat يؤثر فقط على استجابات chat و Agent.
في المرة الأولى التي تفتح فيها مشروعاً، يفهرس Cursor في الخلفية. يُنشئ هذا فهرس بحث دلالي على قاعدة الكودك — مما يتيح له إيجاد الكود ذي الصلة حتى عندما لا تعرف الملف أو اسم الدالة بالضبط.
يتحدث الفهرس مع تعديل الملفات. للمستودعات الكبيرة، قد يستغرق الفهرس الأولي بضع دقائق.
يمنحك Chat واجهة محادثة للأسئلة والتعديلات الصغيرة. يتولى وضع Agent المهام الثقيلة — المهام متعددة الملفات، وتثبيت الحزم، والإصلاحات التكرارية. سير العمل الموصى به: اسأل في Chat للاستكشاف، ثم أسند إلى Agent للتنفيذ. الوحدة التالية تغطي Rules وMCP — كيف تجعل Cursor يتبع اتفاقيات مشروعك تلقائياً.