이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.
query_library_search
StackQL Query Library에서 자연어 의도와 일치하는 템플릿을 검색합니다. SQL을 처음부터 작성하기 전에 이 도구를 먼저 확인하세요. 그런 다음 결과의 id 값을 query_library_get 도구에 전달하여 템플릿을 살펴보고 매개 변수의 유효성을 검사합니다.
이 도구는 라이브러리 콘텐츠만 조회합니다. SQL을 실행하거나 클라우드 API를 호출하지 않으며, 프로바이더 자격 증명도 필요하지 않습니다.
참고 항목:
[ MCP 개요 ] [ query_library_get ] [ validate_select_query ]
입력
| 인수 | 필수 | 설명 |
|---|---|---|
intent | 예 | 작업을 설명하는 자연어 텍스트입니다. |
provider | 아니요 | 프로바이더로 필터링합니다(예: aws). |
service | 아니요 | 서비스로 필터링합니다(예: s3). |
tags | 아니요 | 태그 배열입니다. 항목은 지정된 모든 태그와 일치해야 합니다. |
include_mutations | 아니요 | 변경 템플릿을 포함합니다. 기본값은 false입니다. read_only 모드에서는 무시되며, 이 모드에서는 변경 항목이 항상 제외됩니다. |
limit | 아니요 | 반환할 최대 결과 수입니다. 생략하거나 양수가 아니면 기본값은 5입니다. 최댓값은 20입니다. |
format | 아니요 | 텍스트 렌더링 형식(markdown 또는 json)입니다. 생략하면 서버의 렌더링 설정을 사용합니다(기본값은 markdown). |
출력
기본 텍스트 보기는 id, title, mutation, required_params, score 열로 구성된 순위별 표이며, 그 뒤에 출처 인용과 결과가 없을 때의 안내가 이어집니다. 구조화된 페이로드에는 다음 필드가 포함됩니다.
| 필드 | 설명 |
|---|---|
hits | 순위가 매겨진 항목으로, id, title, 선택적 description, providers, services, required_params 필드와 mutation, score 필드를 포함합니다. 전체 매개 변수 선언은 이어서 query_library_get 도구로 확인하세요. |
miss | 결과가 없거나 최고 점수가 일치 임계값보다 낮으면 true입니다. 이 경우에도 점수가 낮은 가장 가까운 일치 항목이 반환될 수 있습니다. |
guidance | 결과가 없을 때 에이전트가 쿼리를 작성할 수 있도록 서버 지침, 탐색 도구, validate_select_query 도구를 안내합니다. |
source_tier | 콘텐츠 출처(primary, fallback 또는 snapshot)입니다. |
source_url | 인용에 사용할, 사용된 카탈로그의 URL 또는 내장 경로입니다. |
stale | true이면 가져오기에 실패하여 캐시 또는 내장 스냅샷에서 콘텐츠가 제공된 것입니다. |
더 이상 사용되지 않는 항목은 제외됩니다. 서버는 카탈로그를 캐시하며, 호스팅된 라이브러리에서 GitHub 소스와 내장 스냅샷으로 대체할 수 있습니다.
게이트 제어
구성된 도구 허용 목록에 따라 모든 서버 모드에서 허용됩니다. 승인이나 프로바이더 자격 증명은 필요하지 않습니다. 변경 템플릿을 검색한다고 해서 해당 템플릿의 실행 권한이 부여되지는 않습니다.
예제
도구 인수:
{
"intent": "List S3 bucket names and regions",
"provider": "aws",
"service": "s3",
"limit": 5
}
hits 필드의 id 값(예: aws/s3/buckets-list)을 query_library_get 도구에 사용하세요. miss 필드가 true이면 SQL을 작성하기 전에 가장 가까운 템플릿을 살펴보고 참고하거나 list_methods 및 describe_method 도구를 사용하세요.