تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
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 للحصول على تعريفات المعلمات الكاملة. |
miss | true عندما لا توجد نتائج مطابقة أو عندما تكون أعلى درجة أقل من حد التطابق. ومع ذلك قد تعاد أقرب التطابقات ذات الدرجات المنخفضة. |
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.