유효한 스키마를 사용하면 AI 에이전트가 제공해야 하는 데이터의 구조를 이해할 수 있습니다.
WebMCP 스키마 유효성 감사 실패 방법
다음과 같은 경우 감사가 실패합니다.
- 양식에
tooldescription이 있지만toolname속성이 누락되었습니다. - 양식에
toolname이 있지만tooldescription속성이 누락되었습니다. - 필수 양식 필드에
name속성이 누락되었습니다.
선택적 필드에 name이 있지만
toolparamdescription 또는 연결된 <label>이 누락된 경우 Lighthouse에서 경고도 표시합니다.
해결 방법
- 대칭성 보장: 모든 도구에 이름과 설명을 모두 제공합니다.
- 입력에 이름 추가: 도구 양식 내의 모든 입력 요소에 고유한
name속성이 있는지 확인합니다. - 매개변수 컨텍스트 제공: 에이전트가 예상되는 값을 이해할 수 있도록 입력에
toolparamdescription을 추가합니다.