Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

query_library_search

Pesquisa na Query Library do StackQL os templates que correspondem a uma intenção em linguagem natural. Consulte-a antes de escrever SQL do zero e, em seguida, passe o id de um resultado para query_library_get para inspecionar o template e validar os parâmetros dele.

A ferramenta apenas recupera conteúdo da biblioteca. Ela não executa SQL, não chama APIs na nuvem e não exige credenciais de provider.

Veja também: [ Visão geral do MCP ] [ query_library_get ] [ validate_select_query ]


Entradas​

ArgumentoObrigatórioDescrição
intentSimDescrição da tarefa em linguagem natural.
providerNãoFiltra por provider, por exemplo aws.
serviceNãoFiltra por serviço, por exemplo s3.
tagsNãoArray de tags. Uma entrada precisa corresponder a todas as tags fornecidas.
include_mutationsNãoInclui templates de mutação. Valor padrão: false; ignorado no modo read_only, em que as entradas de mutação são sempre excluídas.
limitNãoNúmero máximo de resultados. Valor padrão: 5 quando omitido ou não positivo; limitado a 20.
formatNãoRenderização do texto: markdown ou json. Quando omitido, usa a configuração de renderização do servidor (markdown por padrão).

Saída​

A visualização de texto padrão é uma tabela classificada com id, title, mutation, required_params e score, seguida da citação da origem e, quando houver, das orientações para o caso sem correspondência. O payload estruturado contém:

CampoDescrição
hitsEntradas classificadas com id, title, description opcional, providers, services e required_params, além de mutation e score. Use query_library_get em seguida para obter as declarações de parâmetros completas.
misstrue quando não há resultados ou quando a pontuação mais alta fica abaixo do limite de correspondência. Correspondências mais próximas com pontuação baixa ainda podem ser retornadas.
guidanceNo caso sem correspondência, direciona o agente às instruções do servidor, às ferramentas de descoberta e a validate_select_query para escrever uma consulta.
source_tierOrigem do conteúdo: primary, fallback ou snapshot.
source_urlURL ou caminho incorporado do catálogo usado, para citação.
staleQuando true, o conteúdo foi servido do cache ou do snapshot incorporado após uma falha ao buscá-lo.

Entradas obsoletas são excluídas. O servidor mantém o catálogo em cache e, em vez da biblioteca hospedada, pode recorrer à fonte dela no GitHub e a um snapshot incorporado.


Controle​

Permitida em todos os modos do servidor, sujeita à lista de permissões de ferramentas configurada. Não são necessárias aprovação nem credenciais de provider. Pesquisar templates de mutação não autoriza a execução deles.


Exemplo​

Argumentos da ferramenta:

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

Use um id de hits, como aws/s3/buckets-list, com query_library_get. Se miss for true, inspecione os templates mais próximos para obter orientação ou use list_methods e describe_method antes de escrever o SQL.