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

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

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НіОб'єкт, що зіставляє оголошені назви параметрів зі значеннями. Не вказуйте його або передайте {}, щоб переглянути шаблон без формування.
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Чи було виконано спробу формування і чи вдалася вона. Обидва мають значення false під час перегляду необробленого шаблону.
sqlСформований SQL; присутній лише після успішного формування.
missing_params, unknown_params, errorsПодробиці перевірки, якщо формування не вдалося. Не виконуйте SQL, доки їх не усунено.
auth, permissionsЯкщо оголошено, змінні середовища з обліковими даними й нативні дозволи провайдера, потрібні для виконання. Саме отримання не потребує ні того, ні іншого.
cost, outputs, relatedЯкщо оголошено, підказки щодо fan-out і витрат, описи стовпців результату й ідентифікатори пов'язаних записів.
doc_urlСторінка бібліотеки, зручна для читання людиною.
source_tier, source_url, staleПоходження вмісту: primary, fallback або snapshot, його URL або вбудований шлях, а також ознака того, чи було вміст надано з кешу або знімка після помилки отримання.

Для невідомого або неправильно сформованого ідентифікатора інструмент повертає помилку. Щоб знайти допустимі ідентифікатори, використовуйте query_library_search.


Контроль​

Дозволено в усіх режимах сервера з урахуванням налаштованого списку дозволених інструментів. Отримання або формування шаблону змінення даних чи операції життєвого циклу не має побічних ефектів у хмарі й не потребує схвалення. Виконання поверненого 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 запису бібліотеки, щоб зазначити джерело. Під час виконання потрібні облікові дані та дозволи провайдера.