Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

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_urlURL або вбудований шлях використаного каталогу для цитування.
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.