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

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

query_library_get

تسترد أحد إدخالات Query Library بواسطة قيمة id التي تعيدها الأداة query_library_search.

عند حذف params أو تركها فارغة، تعيد الأداة القالب الخام وتعريفات المعلمات والملاحظات. ومع كائن params غير فارغ، يتحقق الخادم من صحة القيم ويدرجها في القالب. ولا تعيد SQL إلا عند نجاح إنشائه من القالب. ولا يحتاج النموذج إلى إدراج القيم بنفسه.

لا تنفذ هذه الأداة SQL ولا تتحقق من بيانات الاعتماد السحابية. ويختلف تحققها من صحة المعلمات عن validate_select_query، التي تحلل جملة SELECT وتخططها على الموفر المثبت.

راجع أيضًا: [ نظرة عامة على MCP ] [ query_library_search ] [ run_select_query ] [ run_mutation_query ] [ run_lifecycle_operation ]


الإدخالات​

الوسيطةمطلوبالوصف
idنعممعرف الاستعلام من نتائج البحث، على سبيل المثال aws/s3/buckets-list.
paramsلاكائن يربط أسماء المعلمات الواردة في التعريف بقيمها. احذفه أو حدّد {} لفحص القالب دون إنشاء SQL منه.
formatلاتنسيق عرض النص: markdown أو json. عند حذفه، يتم استخدام إعداد العرض في الخادم (markdown افتراضيًا).

يتم رفض المعلمات غير المعروفة. ويتم الإبلاغ في missing_params عن المعلمات المطلوبة التي لم تقدم لها قيم ولا قيم افتراضية. ويتم التحقق من القيم المقدمة مقابل الأنواع والقيود الواردة في التعريف؛ وتعد العناصر النائبة التي لم يتم حلها أخطاء.


الإخراج​

طريقة العرض النصية الافتراضية هي كتلة KV تتضمن الهوية وحالة تعديل البيانات والأداة التالية وحالة الصحة وروابط المصدر وأي قالب أو SQL ناتج أو أخطاء. استخدم الحمولة المنظمة أو format: "json" للحصول على بيانات التعريف الكاملة:

الحقلالوصف
id, title, descriptionهوية الإدخال وملخصه.
mutation, verbما إذا كان الإدخال يغير الموارد، ونوع عمليته عند تعريفه (select أو mutation أو lifecycle).
next_toolأداة التنفيذ الخاصة بالإدخال: run_select_query أو run_mutation_query أو run_lifecycle_operation. لا يستدعيها الاسترداد.
paramsتعريفات المعلمات مع الأسماء والأنواع ومؤشرات الإلزام وأي قيم افتراضية أو أوصاف أو أمثلة أو قيم تعداد أو أنماط.
template, notesالقالب الخام وملاحظات المؤلف، وتعاد عند حذف params أو تركها فارغة.
rendered, validما إذا كانت محاولة إنشاء SQL من القالب قد جرت ونجحت. كلاهما false عند فحص القالب الخام.
sqlSQL الناتج، ولا يوجد إلا بعد نجاح إنشائه من القالب.
missing_params, unknown_params, errorsتفاصيل التحقق من الصحة عند فشل إنشاء SQL من القالب. لا تنفذ SQL حتى يتم حل هذه المشكلات.
auth, permissionsعند تعريفها، متغيرات البيئة الخاصة ببيانات الاعتماد والأذونات الأصلية للموفر اللازمة للتنفيذ. ولا يحتاج الاسترداد نفسه إلى أي منهما.
cost, outputs, relatedعند تعريفها، تلميحات حول التوزيع المتوازي والتكلفة، وأوصاف أعمدة النتائج، ومعرفات الإدخالات ذات الصلة.
doc_urlصفحة المكتبة المخصصة للقراءة البشرية.
source_tier, source_url, staleمنشأ المحتوى: primary أو fallback أو snapshot، وعنوان URL الخاص به أو مساره المضمن، وما إذا كان المحتوى قد قدم من ذاكرة التخزين المؤقت أو اللقطة بعد فشل الحصول عليه.

يعيد المعرف غير المعروف أو غير صحيح التنسيق خطأ. استخدم query_library_search للعثور على معرفات صالحة.


التقييد​

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


مثال​

ابدأ بفحص أحد الإدخالات:

{
"id": "aws/s3/buckets-list"
}

ثم حدّد منطقة التوجيه المطلوبة له:

{
"id": "aws/s3/buckets-list",
"params": {
"region": "us-east-1"
}
}

بعد التحقق من rendered وvalid، تحقق من صحة جملة SELECT التي تعيدها الأداة باستخدام validate_select_query. ثم استخدم الأداة المذكورة في next_tool لتنفيذها، مع تمرير قيمة sql المرجعة وتعيين source إلى قيمة id الخاصة بإدخال المكتبة لنسبة التنفيذ إليه. وتلزم بيانات اعتماد الموفر وأذوناته وقت التنفيذ.