본문으로 건너뛰기

빌더 스택 · 능력

도구 설계

모델이 잘 쓰는 도구는 사람용 API와 조금 다르다

같은 기능이라도 이름과 에러 메시지를 어떻게 쓰느냐에 따라 에이전트의 성공률이 크게 달라집니다. 도구 설명은 '문서'가 아니라 '판단 근거'입니다.

언제 쓰나

  • MCP 서버나 함수 호출 도구를 직접 만들 때
  • 에이전트가 도구를 엉뚱한 상황에 쓰거나 계속 재시도할 때

설정

원칙text
1. 이름은 동사로
   user_info          →  find_user_by_email

2. 에러는 다음 행동을 알려준다
   "권한 없음"        →  "관리자 승인이 필요합니다.
                          request_approval을 먼저 호출하세요."

3. 읽기와 쓰기를 한 도구에 섞지 않는다
   (권한 정책을 세울 수 없게 된다)

4. 반환값은 작게
   전체 레코드 대신 필요한 필드만
공유

관련해서 올라온 자료

최근 60일 동안 수집된 뉴스·저장소 중 이 주제와 겹치는 것들입니다.