إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
وضع الوكيل يسمح لمساعد الذكاء الاصطناعي في محررك باستخدام أدوات PostgreSQL من الامتداد كجزء من محادثة متعددة الخطوات واحدة. بدلا من الإجابة فقط على سؤال، يمكن للمساعد الاتصال بقاعدة بيانات، وفحص المخطط، وتشغيل الاستعلامات، وفتح السكريبتات، ومساعدتك في التنقل من خلال سير العمل من البداية إلى النهاية.
يعمل وضع الوكيل في كل من تعليمة Visual Studio برمجية (مع GitHub Copilot) وCursor (مع الذكاء الاصطناعي المدمج فيه). يعرض الامتداد نفس سطح أداة PostgreSQL في كلا المحررين؛ فقط لوحة الدردشة التي تفتح تختلف.
استخدم وضع الوكيل عندما تريد من الذكاء الاصطناعي اتخاذ إجراءات منظمة، وليس فقط شرح أو صياغة SQL.
المتطلبات الأساسية
قبل البدء، تأكد من أن لديك:
- تم تثبيت إضافة PostgreSQL.
- ميزات Copilot/AI مفعلة في الامتداد (
pgsql.copilot.enableهوtrue). - على الأقل اتصال قاعدة بيانات واحد تم تكوينه في الامتداد.
- مساعد ذكاء اصطناعي متوفر في محررك:
- تعليمة Visual Studio برمجية: GitHub Copilot أو GitHub Copilot Chat مثبت ومفعل.
- المؤشر: لا يوجد تركيب إضافي؛ يتم استخدام الذكاء الاصطناعي المدمج تلقائيا.
وضع وكيل التشغيل
- اتصل بالخادم أو قاعدة البيانات المستهدفة في امتداد PostgreSQL.
- في شجرة الاتصالات ، انقر بزر الفأرة الأيمن على قاعدة البيانات التي تريد استخدامها.
- اختر Connect AI.
- تابع المحادثة في لوحة الدردشة التي تبدأ بسير العمل الذي تريد إكماله.
- في تعليمة Visual Studio برمجية، هذه هي لوحة GitHub Copilot Chat في وضع الوكيل.
- في Cursor، هذه هي لوحة الذكاء الاصطناعي الأصلية الخاصة ب Cursor؛ يوفر الامتداد مقدمة موجزة موجهة إلى MCP حتى يعرف المساعد عن أدوات PostgreSQL المتاحة.
بعد بدء الجلسة، يمكن للذكاء الاصطناعي دمج أدوات PostgreSQL خلف الكواليس أثناء عملها على طلبك.
اختر وضع الوصول المناسب
الإعداد pgsql.copilot.accessMode يتحكم في مقدار الوصول الذي يحصل عليه وضع الوكيل إلى قاعدة البيانات. يحتفظ معرف الإعداد ببادئته pgsql.copilot.* للتوافق؛ التسمية المرئية للمستخدم هي وضع الوصول Copilot في تعليمة Visual Studio برمجية ووضع الوصول الذكي في Cursor.
| الوضع | ما يمكن للذكاء الاصطناعي فعله | الاستخدام الموصى به |
|---|---|---|
ro |
عمليات القراءة فقط مثل SELECT، SHOW، EXPLAIN، فحص المخططات والتحليل |
أنظمة الإنتاج أو البيئات المشتركة التي تريد فيها تحقيق بدون تغييرات |
rw |
عمليات القراءة بالإضافة إلى عبارات تعديل البيانات وDDL، مع تأكيد صريح قبل التنفيذ | التطوير المحلي، صناديق الرمل القابلة للتصرف، وبيئات الاختبار المسيطر عليها |
تنبيه
استخدم ro الوضع لقواعد بيانات الإنتاج إلا إذا كنت تريد عمدا أن تتوفر تغييرات في المخطط أو البيانات عبر وضع الوكيل.
فهم عائلات الأدوات
يمكن لوضع الوكيل استخدام عدة عائلات أدوات حسب سير العمل.
| عائلة الأدوات | ماذا تفعل | عندما تستخدمه |
|---|---|---|
| أدوات الاتصال | قائمة الملفات الشخصية، الاتصال، الفصل، قائمة قواعد البيانات | بدء أو تبديل السياق |
| أدوات سياق المخطط | جلب تعريفات الكائنات أو تصور المخطط | فهم الجداول، والمشاهدات، والدوال، والفهارس، والعلاقات |
| أدوات الاستعلام | شغل استعلامات القراءة، فحص خطط الاستعلام، فتح السكربتات | ابحث في البيانات، تحقق من الأفكار، أو راجع SQL المولد |
| أدوات التعديل | شغل DDL أو DML مع التأكيد | تطبيق المخطط المسيطر عليه أو تغييرات البيانات في rw الوضع |
| أدوات استيراد البيانات | وصف ملفات CSV وحملها بشكل جماعي | تخطيط وتنفيذ سير عمل استيراد CSV |
نصيحة
في كورسور، تظهر نفس الأدوات أيضا من خلال تسجيل خادم MCP. يمكن لدردشة المؤشر الأصلية الاتصال بهم مباشرة دون الحاجة لاستخدام نقطة الدخول في Connect AI . راجع خادم MCP لمزيد من التفاصيل.
استخدم وضع الوكيل لسير العمل الشائع
توضح الأمثلة التالية كيفية استخدام وضع الوكيل للمهام التي تتراوح من استكشاف قاعدة بيانات جديدة إلى تحسين الاستعلامات.
استكشف قاعدة بيانات غير مألوفة
اطلب من الذكاء الاصطناعي الاتصال بقاعدة البيانات، وسرد الكائنات الرئيسية، وملخص مناطق المخطط التي تهم مهمتك.
Example:
اتصل بقاعدة بيانات التطوير الخاصة بي، وأدرج الجداول في المخطط العام، وأخبرني أيها يبدو مرتبطا بالعملاء والطلبات.
التحقيق في أداء الاستعلام
اطلب من الذكاء الاصطناعي دمج سياق المخطط مع تنفيذ الاستعلامات أو فحص الخطة.
Example:
اتصل بقاعدة بيانات المرحلة، شغل هذا الاستعلام في وضع القراءة فقط، واشرح أي جزء من خطة التنفيذ يدفع التكلفة.
تحميل أو إعادة تشكيل البيانات
استخدم وضع الوكيل عندما يتضمن سير العمل سكريبتات أو عمليات مبنية على CSV.
Example:
راجع ملف CSV هذا، وأخبرني ما هو المخطط الذي يقصده، وجهز خطة استيراد آمنة للجدول
sales.records.
الانتقال من المسودة إلى المراجعة اليدوية
عندما تريد نقطة مراجعة بشرية قبل التنفيذ، اطلب من الذكاء الاصطناعي فتح SQL المولود في محرر الاستعلامات بدلا من تشغيله فورا.
اعرف متى تستخدم وضع الوكيل بدلا من @pgsql
استخدم @pgsql مشارك في الدردشة عندما تريد إجابة واعية للمخطط أو مسودة استفسار.
@pgsql المشارك متاح فقط بنظام تعليمة Visual Studio برمجية.
استخدم وضع الوكيل (المتوفر في كل من تعليمة Visual Studio برمجية وCursor) عندما تريد من الذكاء الاصطناعي أن:
- اتصل بقاعدة البيانات المناسبة لك،
- سلسلة عدة أدوات في محادثة واحدة،
- فحص النتائج قبل الخطوة التالية، أو
- أعد سكريبت أو سير عمل تعديل محكم.
ملحوظة
في وضع المؤشر، وضع الوكيل هو المسار الأساسي لأن @pgsql المشارك في الدردشة غير متاح هناك. يمكن الوصول إلى نفس سطح الأداة أيضا من خلال دردشة المؤشر الأصلية عبر خادم MCP.
استكشاف أخطاء وضع الوكيل
إذا لم يتصرف وضع الوكيل كما هو متوقع، تحقق من وضع الوصول وتوفر الأدوات أولا.
الذكاء الاصطناعي لا يستطيع تعديل قاعدة البيانات
تحقق pgsql.copilot.accessMode وتأكد من أن الاتصال النشط لم يتم حله إلى ro.
الأداة التي تتوقعها غير متوفرة
تأكد من تفعيل تكامل Copilot وأنك بدأت من قاعدة بيانات بها سياق اتصال PostgreSQL صالح.
طلب اتصال يفشل
تأكد من أن ملف الاتصال لا يزال موجودا، وبيانات الاعتماد متاحة، ويمكن للامتداد الاتصال بنفس قاعدة البيانات خارج وضع الوكيل.
أريد سير عمل أبسط يعتمد على الدردشة أولا
في تعليمة Visual Studio برمجية، استخدم @pgsql مشارك في الدردشة عندما تريد شرحا أو صياغة استعلامات أو أسئلة مخطط بدون أتمتة مدفوعة بالأدوات. في كورسور، اطرح نفس أنواع الأسئلة من الدردشة الأصلية. أدوات MCP الخاصة بالإضافة لا تزال قابلة للاكتشاف، لكن الدردشة تتصرف بشكل أكثر حوارية دون إدخال صريح في وضع الوكيل.