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_get

Recupera uma entrada da Query Library pelo id retornado por query_library_search.

Com params omitido ou vazio, ela retorna o template bruto, as declarações de parâmetros e as notas. Com um objeto params não vazio, o servidor valida os valores e os substitui no template. Ela retorna SQL somente quando a renderização é bem-sucedida. O modelo não precisa substituir os valores por conta própria.

Esta ferramenta não executa SQL nem verifica credenciais na nuvem. Essa validação de parâmetros é diferente da feita por validate_select_query, que analisa e planeja um SELECT com base no provider instalado.

Veja também: [ Visão geral do MCP ] [ query_library_search ] [ run_select_query ] [ run_mutation_query ] [ run_lifecycle_operation ]


Entradas​

ArgumentoObrigatórioDescrição
idSimID da consulta obtido nos resultados da pesquisa, por exemplo aws/s3/buckets-list.
paramsNãoObjeto que mapeia os nomes dos parâmetros declarados para valores. Omita-o ou passe {} para inspecionar o template sem renderizá-lo.
formatNãoRenderização do texto: markdown ou json. Quando omitido, usa a configuração de renderização do servidor (markdown por padrão).

Parâmetros desconhecidos são rejeitados. Parâmetros obrigatórios sem valor fornecido nem valor padrão são informados em missing_params. Os valores fornecidos são verificados em relação aos tipos e às restrições declarados; placeholders não resolvidos são erros.


Saída​

A visualização de texto padrão é um bloco KV com a identidade, o status de mutação, a próxima ferramenta, a validade, os links da origem e, quando houver, o template, o SQL renderizado ou os erros. Use o payload estruturado ou format: "json" para obter os metadados completos:

CampoDescrição
id, title, descriptionIdentidade e resumo da entrada.
mutation, verbSe a entrada altera recursos e, quando declarado, o tipo de operação dela (select, mutation ou lifecycle).
next_toolFerramenta de execução da entrada: run_select_query, run_mutation_query ou run_lifecycle_operation. A recuperação não a chama.
paramsDeclarações de parâmetros com nomes, tipos, indicadores de obrigatoriedade e, quando houver, valores padrão, descrições, exemplos, enums ou padrões.
template, notesTemplate bruto e notas do autor, retornados quando params é omitido ou está vazio.
rendered, validSe a renderização foi tentada e se foi bem-sucedida. Ambos são false ao inspecionar o template bruto.
sqlSQL renderizado, presente somente após uma renderização bem-sucedida.
missing_params, unknown_params, errorsDetalhes da validação quando a renderização falha. Não execute o SQL até que eles sejam resolvidos.
auth, permissionsQuando declaradas, as variáveis de ambiente de credenciais e as permissões nativas do provider necessárias para a execução. A recuperação em si não exige nenhuma delas.
cost, outputs, relatedQuando declarados, indicações de fan-out e de custo, descrições das colunas do resultado e IDs de entradas relacionadas.
doc_urlPágina da biblioteca legível por humanos.
source_tier, source_url, staleProcedência do conteúdo: primary, fallback ou snapshot, a URL ou o caminho incorporado correspondente e se o conteúdo foi servido do cache ou do snapshot após uma falha ao buscá-lo.

Um ID desconhecido ou malformado retorna um erro. Use query_library_search para encontrar IDs válidos.


Controle​

Permitida em todos os modos do servidor, sujeita à lista de permissões de ferramentas configurada. Recuperar ou renderizar um template de mutação ou de ciclo de vida não tem efeito do lado da nuvem e não requer aprovação. Executar o SQL retornado é uma chamada separada, regida pelo modo do servidor.


Exemplo​

Primeiro, inspecione uma entrada:

{
"id": "aws/s3/buckets-list"
}

Em seguida, forneça a região de roteamento que ela exige:

{
"id": "aws/s3/buckets-list",
"params": {
"region": "us-east-1"
}
}

Depois de verificar rendered e valid, valide o SELECT retornado com validate_select_query. Execute-o com a ferramenta indicada em next_tool, passando o sql retornado e definindo source como o id do item da biblioteca, para fins de atribuição. As credenciais e as permissões do provider são necessárias no momento da execução.