إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

query_library_search

تبحث في StackQL Query Library عن قوالب تطابق نية مكتوبة باللغة الطبيعية. ارجع إليها قبل كتابة SQL من الصفر، ثم مرّر الحقل id لإحدى النتائج إلى query_library_get لفحص القالب والتحقق من صحة معلماته.

تسترد الأداة محتوى المكتبة فقط. ولا تنفذ SQL ولا تستدعي واجهات API السحابية ولا تتطلب بيانات اعتماد الموفر.

راجع أيضًا: [ نظرة عامة على MCP ] [ query_library_get ] [ validate_select_query ]


الإدخالات​

الوسيطةمطلوبالوصف
intentنعموصف المهمة باللغة الطبيعية.
providerلاالتصفية حسب الموفر، على سبيل المثال aws.
serviceلاالتصفية حسب الخدمة، على سبيل المثال s3.
tagsلامصفوفة من الوسوم. يجب أن يطابق الإدخال جميع الوسوم المقدمة.
include_mutationsلاتضمين قوالب عمليات تعديل البيانات. القيمة الافتراضية: false؛ ويتم تجاهلها في الوضع read_only، حيث يتم دائمًا استبعاد إدخالات عمليات تعديل البيانات.
limitلاالحد الأقصى لعدد النتائج المطابقة. القيمة الافتراضية: 5 عند حذفها أو عندما تكون قيمتها غير موجبة؛ ولا يمكن أن تتجاوز 20.
formatلاتنسيق عرض النص: markdown أو json. عند حذفها، تستخدم الأداة إعداد العرض الخاص بالخادم (markdown افتراضيًا).

الإخراج​

الإخراج النصي الافتراضي جدول مرتب يضم id وtitle وmutation وrequired_params وscore، يليه الاستشهاد بالمصدر وأي إرشادات عند عدم وجود تطابق. تحتوي الحمولة المنظمة على:

الحقلالوصف
hitsإدخالات مرتبة تتضمن id وtitle وdescription الاختياري وproviders وservices وrequired_params، بالإضافة إلى mutation وscore. استخدم بعد ذلك query_library_get للحصول على تعريفات المعلمات الكاملة.
misstrue عندما لا توجد نتائج مطابقة أو عندما تكون أعلى درجة أقل من حد التطابق. ومع ذلك قد تعاد أقرب التطابقات ذات الدرجات المنخفضة.
guidanceعند عدم وجود تطابق، يوجه الوكيل إلى تعليمات الخادم وأدوات الاكتشاف وvalidate_select_query لكتابة استعلام.
source_tierمصدر المحتوى: primary أو fallback أو snapshot.
source_urlعنوان URL أو المسار المضمن للكتالوج المستخدم، لغرض الاستشهاد.
staleعندما تكون القيمة true، فهذا يعني أن المحتوى جاء من ذاكرة التخزين المؤقت أو من اللقطة المضمنة بعد فشل الاسترداد.

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


التقييد​

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


مثال​

وسيطات الأداة:

{
"intent": "List S3 bucket names and regions",
"provider": "aws",
"service": "s3",
"limit": 5
}

استخدم قيمة id من hits، مثل aws/s3/buckets-list، مع query_library_get. إذا كانت قيمة miss هي true، فافحص أقرب القوالب للاسترشاد بها أو استخدم list_methods وdescribe_method قبل كتابة SQL.