query_library_search

Busca en la Query Library de StackQL plantillas que coincidan con una intención expresada en lenguaje natural. Consúltela antes de componer SQL desde cero; después pase el id de un resultado a query_library_get para inspeccionar la plantilla y validar sus parámetros.

La herramienta solo recupera contenido de la Query Library. No ejecuta SQL, no llama a las API en la nube ni requiere credenciales de provider.

Consulte también: [ Descripción general de MCP ] [ query_library_get ] [ validate_select_query ]

---

Entradas

Argumento	Obligatorio	Descripción
intent	Sí	Descripción de la tarea en lenguaje natural.
provider	No	Filtra por provider, por ejemplo aws.
service	No	Filtra por servicio, por ejemplo s3.
tags	No	Array de tags. Una entrada debe coincidir con todos los tags proporcionados.
include_mutations	No	Incluye las plantillas de mutación. Valor predeterminado: false; se ignora en el modo read_only, donde las entradas de mutación siempre se excluyen.
limit	No	Número máximo de coincidencias. Valor predeterminado: 5 cuando se omite o no es positivo; limitado a 20.
format	No	Renderizado del texto: markdown o json. Cuando se omite, usa la configuración de renderizado del servidor (markdown de forma predeterminada).

---

Salida

La vista de texto predeterminada es una tabla ordenada por relevancia con id, title, mutation, required_params y score, seguida de la cita de la fuente y, en su caso, de la orientación para cuando no hay coincidencias. La carga útil estructurada contiene:

Campo	Descripción
hits	Entradas ordenadas por relevancia con id, title, description opcional, providers, services y required_params, además de mutation y score. Continúe con query_library_get para obtener las declaraciones de parámetros completas.
miss	true cuando no hay coincidencias o la puntuación más alta está por debajo del umbral de coincidencia. Aun así, se pueden devolver las coincidencias más cercanas con puntuación baja.
guidance	Cuando no hay coincidencias, dirige al agente a las instrucciones del servidor, las herramientas de descubrimiento y validate_select_query para escribir una consulta.
source_tier	Fuente del contenido: primary, fallback o snapshot.
source_url	URL o ruta integrada del catálogo utilizado, para citarlo.
stale	Cuando es true, el contenido se sirvió desde la caché o desde la instantánea integrada tras un error al obtenerlo.

Las entradas obsoletas se excluyen. El servidor almacena el catálogo en caché y puede recurrir, en lugar de la Query Library alojada, a su origen en GitHub y a una instantánea integrada.

---

Control

Permitida en todos los modos del servidor, sujeta a la lista de permitidos de herramientas configurada. No se necesitan aprobación ni credenciales de provider. Buscar plantillas de mutación no autoriza su ejecución.

---

Ejemplo

Argumentos de la herramienta:

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

Use un id de hits, como aws/s3/buckets-list, con query_library_get. Si miss es true, inspeccione las plantillas más cercanas como orientación o use list_methods y describe_method antes de escribir el SQL.