query_library_search

Durchsucht die StackQL Query Library nach Vorlagen, die zu einer natürlichsprachlichen Absicht passen. Konsultieren Sie es, bevor Sie SQL von Grund auf schreiben, und übergeben Sie dann die id eines Treffers an query_library_get, um die Vorlage zu inspizieren und ihre Parameter zu validieren.

Das Tool ruft ausschließlich Inhalte der Query Library ab. Es führt kein SQL aus, ruft keine Cloud-APIs auf und benötigt keine Provider-Anmeldedaten.

Siehe auch: [ MCP-Übersicht ] [ query_library_get ] [ validate_select_query ]

---

Eingaben

Argument	Erforderlich	Beschreibung
intent	Ja	Natürlichsprachliche Beschreibung der Aufgabe.
provider	Nein	Filter nach Provider, zum Beispiel aws.
service	Nein	Filter nach Service, zum Beispiel s3.
tags	Nein	Array von Tags. Ein Eintrag muss zu jedem übergebenen Tag passen.
include_mutations	Nein	Mutationsvorlagen einschließen. Standardmäßig false; im Modus read_only ignoriert, in dem Mutationseinträge immer ausgeschlossen sind.
limit	Nein	Maximale Anzahl der Treffer. Standardmäßig 5, wenn nicht angegeben oder nicht positiv; begrenzt auf 20.
format	Nein	Textrendering: markdown oder json. Wenn nicht angegeben, wird die Rendering-Einstellung des Servers verwendet (standardmäßig markdown).

---

Ausgabe

Die Standard-Textansicht ist eine nach Rang sortierte Tabelle mit id, title, mutation, required_params und score, gefolgt von der Quellenangabe und etwaigen Hinweisen bei Fehltreffern. Die strukturierte Payload enthält:

Feld	Beschreibung
hits	Nach Rang sortierte Einträge mit id, title, optionaler description, providers, services und required_params sowie mutation und score. Rufen Sie anschließend query_library_get für die vollständigen Parameterdeklarationen auf.
miss	true, wenn es keine Treffer gibt oder der höchste Score unter der Übereinstimmungsschwelle liegt. Nächstliegende Treffer mit niedrigem Score können dennoch zurückgegeben werden.
guidance	Verweist den Agenten bei einem Fehltreffer auf die Server-Instruktionen, die Discovery-Tools und validate_select_query, um eine Abfrage zu schreiben.
source_tier	Quelle des Inhalts: primary, fallback oder snapshot.
source_url	URL oder eingebetteter Pfad des verwendeten Katalogs, zur Quellenangabe.
stale	Bei true wurde der Inhalt nach einem fehlgeschlagenen Abruf aus dem Cache oder dem eingebetteten Snapshot bereitgestellt.

Veraltete Einträge werden ausgeschlossen. Der Server cacht den Katalog und kann von der gehosteten Query Library auf ihre GitHub-Quelle und einen eingebetteten Snapshot zurückfallen.

---

Freigabe

In jedem Servermodus erlaubt, vorbehaltlich der konfigurierten Tool-Allowlist. Es sind weder Genehmigung noch Provider-Anmeldedaten erforderlich. Die Suche nach Mutationsvorlagen autorisiert nicht deren Ausführung.

---

Beispiel

Tool-Argumente:

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

Verwenden Sie eine id aus hits, etwa aws/s3/buckets-list, mit query_library_get. Wenn miss gleich true ist, inspizieren Sie die nächstliegenden Vorlagen zur Orientierung oder verwenden Sie list_methods und describe_method, bevor Sie SQL schreiben.