온디맨드 스키마 Describe 도구 (슬림 1차 + Enum 후속)

고정 context(예: SGLang 40K)에서 통짜 describe_table(Enum members·valueDomain·expression 포함)이 Truncation/BadRequest를 내면 SQL 생성·채점이 붕괴한다. 1차는 슬림 요약, Enum/상세는 후속 도구로 분리한다.

도구 역할

도구기본 페이로드비고
describe_table컬럼명·타입·hasValueDomainmembers 제거. 컬럼>N이면 columnNames(+columnsWithValueDomain)
get_column_values(table, column)Enum/도메인 값필요할 때만
describe_columns(table, columns)소수 컬럼 상세DESCRIBE_COLUMNS_MAX 등으로 상한

MCP 공개 표면은 search/describe/execute처럼 얇게 두고, 온디맨드는 backend analyst tool로 흡수해도 된다.

예산 상수(개념)

DESCRIBE_JSON_CHARS_MAX   # 단발 describe (초기 12k → 멀티턴에선 2.5k 등 하향)
SEARCH_JSON_CHARS_MAX
MULTI_TURN_TOOL_CHARS_MAX # 라운드 누적 envelope
valueDomain: ≤소수 컬럼 × members≤K, expression 드롭

단발 캡만 맞추고 멀티턴 envelope를 안 보면 3~4턴에 다시 overflow한다 — LLM-Tool-Payload-Context-Trim.md.

수용 기준 예

🔗 관련 문서