각 단계에서 확인하는 내용은 다음과 같습니다.
표 5-5 단계별 Tool 테스트 방법
|
단계 |
확인 내용 |
문제 해결 방법 |
|
1단계 메타데이터 |
name, description, args가 올바르게 등록되었는지 확인 |
@tool 설정, docstring 수정 |
|
2단계 직접 호출 |
Tool이 정상 동작하는지 확인 |
내부 로직 수정 |
|
3단계 ToolException |
오류 처리 방식 확인 |
예외 처리 코드 추가 |
|
4단계 Tool 바인딩 |
LLM의 Tool 선택 확인 |
description 문구 수정 |
이 중 4단계가 가장 놓치기 쉽습니다. 앞 단계가 모두 정상인데 tool_calls에서 엉뚱한 Tool이 선택된다면 description이 모호할 가능성이 큽니다. 예를 들어 “단어 수가 몇 개인지 알려줘.”라는 요청에 다른 Tool이 선택된다면 description에 사용자가 실제로 입력할 만한 표현을 더 구체적으로 추가해야 합니다.
6장에서는 여러 Tool을 함께 사용하는데, Tool 개수가 늘어나더라도 같은 순서로 검증하면 문제 원인을 체계적으로 확인할 수 있습니다.