같은 기능이라도 이름과 에러 메시지를 어떻게 쓰느냐에 따라 에이전트의 성공률이 크게 달라집니다. 도구 설명은 '문서'가 아니라 '판단 근거'입니다.
언제 쓰나
- MCP 서버나 함수 호출 도구를 직접 만들 때
- 에이전트가 도구를 엉뚱한 상황에 쓰거나 계속 재시도할 때
설정
1. 이름은 동사로
user_info → find_user_by_email
2. 에러는 다음 행동을 알려준다
"권한 없음" → "관리자 승인이 필요합니다.
request_approval을 먼저 호출하세요."
3. 읽기와 쓰기를 한 도구에 섞지 않는다
(권한 정책을 세울 수 없게 된다)
4. 반환값은 작게
전체 레코드 대신 필요한 필드만