AI Tool Schema Validator
tool 정의 JSON을 붙여넣으면 형식(Anthropic·OpenAI·MCP)을 감지하고 name, description, parameter schema의 기본 구조를 검사합니다.
입력한 tool 정의는 브라우저에서만 분석되며 서버로 전송되지 않습니다.
입력한 tool 정의는 브라우저에서만 분석되며 서버로 전송되지 않습니다.
AI Tool Schema란?
LLM에게 도구(함수)를 쓰게 하려면, 도구의 이름·설명·인수 형태를 JSON Schema로 정의해 API에
전달합니다. Anthropic은 input_schema, OpenAI는 function.parameters,
MCP는 inputSchema라는 키를 쓰지만 안쪽은 모두 JSON Schema입니다. 이 정의가
잘못되면 API가 요청을 거부하거나, 더 나쁘게는 모델이 도구를 엉뚱하게 호출합니다. 이 도구는
그 정의의 구조를 API 호출 전에 브라우저에서 검사합니다.
검사 항목
- Anthropic(input_schema)·OpenAI(function.parameters)·MCP(inputSchema) 형식 자동 감지
- name 필수 여부와 허용 문자(영문·숫자·밑줄·하이픈, 64자) 검사
- description 누락·부실 경고
- JSON Schema 타입 오타 검사 (str → string 등 힌트 제공)
- required와 properties 불일치, enum·items 구조 검사
- 여러 tool 배열과 중복 이름 검사
확인하지 않는 것
$ref·oneOf·anyOf·allOf 등의 고급 JSON Schema 기능은 해석하지 않고 해당 부분을 검사에서 제외합니다. 특정 API가 이 정의를 실제로 수락하는지, 모델이 도구를 의도대로 호출하는지, 함수 구현이 동작하는지는 검사하지 않습니다.
관련 가이드
AI tool schema는 계약서다 — 계약이 어긋나는 3가지 방식
타입 오타, 영원히 이행 불가능한 required, 모델이 추측하게 만드는 애매한 정의를 실제 JSON Schema 검증기로 재현하며 정리한 가이드입니다.