إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يتكامل امتداد PostgreSQL مع مساعدي الذكاء الاصطناعي عبر ثلاثة أسطح: @pgsql المشارك في الدردشة (تعليمة Visual Studio برمجية فقط)، أدوات وضع الوكيل، ومزود خادم MCP من PostgreSQL Tools. تساعدك هذه الصفحة على اختيار نقطة الدخول المناسبة وفهم التكوين المشترك الذي ينطبق على الثلاثة جميعا.
تعمل الإضافة بنظام تعليمة Visual Studio برمجية (مع GitHub Copilot) وCursor (مع الذكاء الاصطناعي المدمج فيه). معظم الميزات تعمل بنفس الطريقة في كلا المحررين؛ يتم التلشير إلى عدد قليل من السلوكيات الخاصة بالمحرر طوال هذا المقال.
المتطلبات الأساسية
قبل استخدام أي ميزة مدعومة بالذكاء الاصطناعي، تأكد من استيفاء المتطلبات التالية:
- تم تثبيت إضافة PostgreSQL ولديك على الأقل اتصال قاعدة بيانات واحد مضبوط.
- مساعد ذكاء اصطناعي متوفر في محررك:
- تعليمة Visual Studio برمجية: قم بتثبيت GitHub Copilotأو GitHub Copilot Chat وتسجيل الدخول باشتراك نشط.
- المؤشر: لا يوجد تركيب إضافي؛ يتم استخدام الذكاء الاصطناعي المدمج تلقائيا.
ملحوظة
ميزات Copilot مفعلة افتراضيا (pgsql.copilot.enableهي true). عندما تضبط هذا على false، فإن @pgsql مشارك في الدردشة (تعليمة Visual Studio برمجية فقط)، وقائمة محرر إجراءات الاستعلام في الذكاء الاصطناعي، وأدوات وضع الوكيل، ومزود خادم MCP كلها مخفية.
نصيحة
تعمل المساعدة الذكية بشكل أفضل عندما يكون لديك اتصال قاعدة بيانات نشط بالفعل. إذا لم تتواصل بعد، ابدأ ب Connections and Identity.
اختر نقطة الدخول المناسبة
| إذا كنت تريد ... | ابدأ من هنا | التوافر | تعرف على المزيد |
|---|---|---|---|
| اطرح سؤالا واعيا بالمخطط عن قاعدة بياناتك | @pgsql مشارك في الدردشة | تعليمة Visual Studio برمجية فقط | @pgsql مشارك في الدردشة |
| ابدأ وضع الوكيل مع قاعدة بيانات محددة بالفعل ضمن النطاق | Connect AI من عقدة قاعدة بيانات في شجرة الاتصالات | تعليمة Visual Studio برمجية وCursor | وضع الوكيل |
| شرح أو أعد كتابة أو حلل SQL من المحرر | القائمة الفرعية لإجراءات الاستعلام بالذكاء الاصطناعي في قائمة سياق المحرر | تعليمة Visual Studio برمجية وCursor | إجراءات المحرر |
| أتمتة مهمة قاعدة بيانات متعددة الخطوات | قم بتوصيل الذكاء الاصطناعي على عقدة قاعدة بيانات لبدء وضع الوكيل | تعليمة Visual Studio برمجية وCursor | وضع الوكيل |
| عرض أدوات PostgreSQL على مضيفات متوافقة مع MCP | مزود خوادم MCP من PostgreSQL Tools | تعليمة Visual Studio برمجية وCursor | خادم MCP |
الاستخدام @pgsql في الدردشة الواعية بالمخطط
ملحوظة
المشارك @pgsql في الدردشة مسجل فقط في تعليمة Visual Studio برمجية، حيث يتصل ب GitHub Copilot Chat. في المؤشر، استخدم Connect AI من عقدة قاعدة بيانات في شجرة الاتصالات لبدء وضع الوكيل بنفس سياق المخطط، أو اعتمد على خادم MCP في سطح الدردشة الأصلي للمؤشرات.
يقوم الامتداد بتسجيل مشارك في الدردشة @pgsql (المعرف: vscode-postgresql.chat-agent) للمحادثات الواصلة على المخطط في Copilot Chat GitHub. اكتب @pgsql متبوعا بسؤالك، وسيجيب المشارك باستخدام سياق مخطط حي من قاعدة بياناتك المتصلة.
لبدء سير عمل مدفوع بالأدوات مع قاعدة بيانات موجودة بالفعل ضمن النطاق، انقر بزر الفأرة الأيمن على عقدة قاعدة بيانات في شجرة الاتصالات واختر Connect AI.
للحصول على إرشادات المستخدم النهائي، ونماذج الطروحات، وحل المشكلة، استمر @pgsql مشارك في الدردشة.
استخدم إجراءات المحرر للمساعدة التي تركز على الاستعلام
عندما يكون لديك SQL مفتوحا في محرر الاستعلامات، انقر بزر الفأرة الأيمن للعثور على قائمة فرعية لإجراءات الاستعلام الخاصة بالذكاء الاصطناعي . يحتوي على الإجراءات التالية:
| الإجراء | الوصف |
|---|---|
| استعلام شرح | يعرض شرحا بسيطا لما يفعله الاستعلام. |
| استعلام إعادة الكتابة | يقترح نسخة بديلة من الاستعلام مع الحفاظ على النتيجة المقصودة. |
| تحليل أداء الاستعلام | يعمل EXPLAIN ANALYZE على قاعدة البيانات المتصلة، ثم يرسل خطة التنفيذ إلى الذكاء الاصطناعي للتحليل. |
يمكنك أيضا اختيار اسأل الذكاء الاصطناعي عن هذا الاستعلام من شريط أدوات المحرر لفتح محادثة متجذرة في محتوى المحرر الحالي.
لإعادة تعيين خيارات تضمين الاستعلامات التي تم تذكرها لتحليل الخطط، قم بتشغيل تفضيلات إدراج الاستعلام الواضح لتحليل الذكاء الاصطناعي من لوحة الأوامر.
استخدم وضع الوكيل لسير العمل المعتمد على الأدوات
وضع الوكيل يمنح مساعد الذكاء الاصطناعي وصولا إلى أدوات PostgreSQL ليتمكن من الاتصال، وفحص المخطط، وتشغيل الاستعلامات، وفتح السكريبتات، والعمل على مهام متعددة الخطوات في محادثة واحدة. انقر بزر الفأرة الأيمن على عقدة قاعدة بيانات في شجرة الاتصالات واختر Connect AI لبدء جلسة وضع الوكيل.
بالنسبة لعائلات الأدوات، وأمثلة سير العمل، وحل الأخطاء، استمر في وضع الوكيل.
استخدم خادم MCP في المضيفين المدعومين
يقوم الامتداد بتسجيل مزود خادم MCP من PostgreSQL Tools (ID: pgsql-tools-mcp-server-provider) الذي يعرض نفس سطح أداة PostgreSQL من خلال بروتوكول سياق النموذج. يمكن للمضيفين المتوافقين مع MCP اكتشاف هذه الأدوات وتفعيلها دون الحاجة لاستخدام سير عمل الدردشة المدمجة.
بالنسبة للمضيفين المدعومين، وسلوك التسجيل التلقائي، وعائلات الأدوات التي تظهر عبر MCP، استمر في خادم MCP.
تكوين وضع الوصول
يتحكم الإعداد pgsql.copilot.accessMode في مقدار الوصول إلى قاعدة البيانات التي يحصل عليها مساعد الذكاء الاصطناعي عبر وضع الوكيل وأدوات MCP. الإعداد الافتراضي هو القراءة/الكتابة (rw).
| إعداد القيمة | تسمية واجهة المستخدم | ما يمكن لمساعد الذكاء الاصطناعي فعله |
|---|---|---|
ro |
اقرأ فقط | عمليات القراءة فقط: SELECT, SHOW, EXPLAIN, فحص المخطط |
rw |
القراءة/الكتابة | عمليات القراءة بالإضافة إلى عبارات تعديل البيانات وDDL، مع تأكيد صريح |
تجاوز لكل اتصال
يمكنك أيضا ضبط وضع الوصول على الاتصالات الفردية. في حوار الاتصال، قم بتوسيع قسم Copilot (الذكاء الاصطناعي في Cursor) وضبط وضع الوصول ل Copilot (وضع الوصول الذكي الاصطناعي في Cursor) إلى واحد من:
| خيار | السلوك |
|---|---|
| استخدم الإعداد العالمي | يعود إلى القيمة العالمية pgsql.copilot.accessMode (الافتراضي) |
| اقرأ فقط | تفرض الوصول للقراءة فقط لهذا الاتصال بغض النظر عن الإعداد العام |
| القراءة/الكتابة | تفرض وصول القراءة/الكتابة لهذا الاتصال بغض النظر عن الإعداد العام |
يقوم الامتداد بحل وضع الوصول الفعال باستخدام هذه السلسلة الاحتياطية: قيمة لكل اتصال → إعداد عالمي pgsql.copilot.accessMode → الافتراضي (rw).
تنبيه
استخدم القراءة فقط لقواعد بيانات الإنتاج إلا إذا كنت تريد عمدا توفير تغييرات في المخطط أو البيانات عبر مساعد الذكاء الاصطناعي.
تكوين إعدادات إضافية
| اعداد | ما الذي يتحكم فيه | افتراضي |
|---|---|---|
pgsql.copilot.enable |
يفعل أو يعطل جميع تكاملات الذكاء الاصطناعي في الإضافة | true |
pgsql.copilot.accessMode |
وضع الوصول العالمي للذكاء الاصطناعي (قراءة فقط أو قراءة/كتابة) | rw |
pgsql.copilot.autoAttachQuery |
ما إذا كان نص استعلام SQL متوفرا عند تحليل الخطط باستخدام الذكاء الاصطناعي: اسأل في كل مرة، دائما تضم، أم لا تدرج أبدا | ask |
pgsql.copilot.modelOptions |
تعديل النماذج المتقدم (الحد الأقصى للرموز، درجة الحرارة، top_p) لسير عمل الذكاء الاصطناعي في الإضافة | - |
تعريفات الإعدادات تحتفظ بالبادئة pgsql.copilot.* في كلا المحررين للتوافق مع الإصدارات السابقة، حتى عندما تقول التسميات المرئية للمستخدم "AI".
تكاملات الذكاء الاصطناعي الخاصة بالميزات
تشمل عدة ميزات نقاط تكامل مخصصة للذكاء الاصطناعي:
| الميزة | القدرة الذكاء الاصطناعي |
|---|---|
| Query plan visualizer | تحليل بيانات خطة التنفيذ باستخدام Analysis باستخدام Copilot (أو التحليل باستخدام الذكاء الاصطناعي في Cursor) |
| لوحة تحكم الخادم | افتح جلسات الدردشة من أزرار اسأل Copilot (اسأل الذكاء الاصطناعي في المؤشر) على لوحات الاستعلامات، الانتظار، الجلسات، والخرائط المترية |
| مصور المخطط | تصور علاقات المخطط من خلال سير عمل وضع الوكيل |