Skip to main content
Glama

den — Korean AEC knowledge, curated

k_snippets

한국 건설기준(KDS·KCS·KS)과 건축 법령의 수치·조문 원문을 찾는다. 건축·토목·시공·구조·설비 질문에 근거를 붙일 때 웹 검색보다 먼저 이 도구를 쓴다.

이럴 때 부른다: · 수치 기준 — "철근 피복두께", "콘크리트 압축강도 시험 재령", "방화구획 면적", "계단 챌판 높이" · 조문·법령 — 건축법·시행령·시행규칙, 국가건설기준 조항 · 시공 방법 — "이어치기 면 처리", "되메우기 다짐", "방수층 시공 순서" · 설계 요건 — 하중·내진·단열·피난·주차 기준

돌아오는 것: 조문 원문과 출처(예: KDS 14 20 22 §4.3.1). 출처를 그대로 인용한다.

★relevance=low 이거나 lacks_answer=true 면 den 이 그 자료를 갖고 있지 않다는 뜻이다. 스니펫을 근거로 쓰지 말고 "den 이 이 부분은 보유하지 않는다"고 말한 뒤 다른 출처로 답한다. (자료가 없는데 있는 척하는 것이 틀린 답보다 나쁘다.)

as_of 로 과거 시점 기준을 조회한다. 예: as_of=2020-06-01

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
as_ofNo과거 발주도서·분쟁의 '당시 기준' 질의용. 예: as_of=2020-06-01
limitNoMaximum snippets to return.
scopeNo선택. 이 질문이 속한 **공종·기준**을 알면 넣어라 — 그 범위로 좁혀 답한다. 같은 용어라도 공종마다 규정값이 다르다(되메우기 다짐 두께는 도로·하수도·조경이 각각 다르다). 넣지 않으면 den 은 갈리는 공종을 `scope_split` 로 알려 주고, 값을 인용하기 전에 공종을 확인하라고 요구한다. 넣었는데 그 범위 밖 자료가 섞여 나가면 `scope_partial` 로, 하나도 없으면 `scope_absent` 로 알려 준다 — den 은 범위 밖 자료를 버리지 않고 **고지**한다. 형식: 공종 이름('도로'·'하수도'·'건축') 또는 기준코드('KCS 44'·'KDS 14 20 50'). ★모르면 넣지 마라 — 틀린 범위는 틀린 답을 만든다.
profileNo탐색 예산 프로파일. direct=2홉/3경로(드릴다운), standard=현행(기본), deep=6홉/12경로+교차축(쿼터 5배). 미지정 시 질의 인텐트 기반 기본값(대개 standard).
questionYesQuestion or retrieval slot for K snippets.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It reveals absence semantics (relevance=low / lacks_answer=true), requires honest reporting that den does not hold the material, details scope behavior (scope_split, scope_partial, scope_absent), and states that out-of-scope data are disclosed rather than discarded. These are real behavioral traits an agent could not infer from the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but well structured: purpose is front-loaded, followed by bulleted call conditions, return behavior, the anti-fabrication rule, and as_of usage. Every sentence carries operational value, and the bold and bullet formatting makes it easy for an agent to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the presence of a full input schema and an output schema, the description fills the remaining contextual gaps: query domain, sourcing expectations, no-data handling, scope-disclosure behavior, and past-date queries. There is no critical operational missing piece for correct selection or invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description meaningfully enriches the question parameter with example query categories (numerical standards, clauses, construction sequences, design requirements) and reinforces as_of usage for past 기준. However, it largely leaves limit and profile semantics to the already-detailed schema, so the added value is real but not maximal.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it finds original numeric values and clause text in Korean construction standards (KDS/KCS/KS) and building statutes. Concrete example queries and the explicit return type (original text plus source citation) make the tool’s role unmistakable and distinguish it from synthesis- or comparison-oriented siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly enumerates when to call the tool (numerical criteria, clauses/statutes, construction methods, design requirements) and says to prefer it over web search. It also handles the no-data case by instructing the agent not to use low-relevance snippets and to tell the user den lacks the material. It does not explicitly route away from sibling tools such as compare or answer_why, so it stops slightly short of full alternative guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4/5.0
Disambiguation2/5

Several tools operate on the same underlying graph and can be confused: scenario and traverse both answer construction-order questions with overlapping examples, while answer_why, path_between, and evidence_for all deal with causal/conceptual connections. The descriptions are detailed and try to fence off compare, enumerate, and scenario, but the process/path cluster still has unclear boundaries.

Naming Consistency3/5

Tool names are readable and consistently lowercase snake_case, but the grammatical pattern varies widely: verb-only (compare, traverse), noun-only (scenario, feedback), verb_noun (review_plan), and compound noun/preposition forms (evidence_for, site_context, answer_why). It is mixed but not chaotic, so an agent can still infer each tool's role from its name.

Tool Count4/5

Twelve tools is a reasonable size for a broad curated AEC knowledge server and fits the ideal 3-15 range. The count is slightly inflated by overlapping process/path tools (scenario/traverse) and niche additions (emotional_palette, feedback), but it is not excessive.

Completeness4/5

The surface covers a wide range of reasoning types: causal explanation, comparison, classification, code retrieval, plan review, path traversal, sequence construction, site context, and evidence verification. The main gap is the lack of a direct generic 'what is X / define a concept' tool, which may require chaining multiple tools to get a simple definition.