더북(TheBook)

실행하면 결과는 다음과 같습니다.

Terminal icon_terminal

> uv run python examples/1_tool.py 
summarize_article
글을 3줄로 요약합니다.
'요약해줘', '핵심만 알려줘' 같은 요청이 들어올 때 사용합니다.
{'article': {'title': 'Article', 'type': 'string'}}

실행 결과를 보면 함수 이름, 설명, 입력값 정보가 자동으로 생성된 것을 확인할 수 있습니다. 별도의 Tool 메타데이터를 직접 작성하지 않았는데도 기본 정보가 자동으로 생성됩니다. @tool 데코레이터에 관한 자세한 내용은 다음 절에서 살펴보겠습니다.

에이전트는 이러한 정보를 바탕으로 Tool 사용 여부를 판단합니다. 따라서 description에는 실제 사용자가 자주 입력할 만한 표현을 포함하는 것이 좋습니다. 예를 들어, “요약해줘”, “핵심만 알려줘”, “짧게 정리해줘” 같은 표현을 함께 넣으면 에이전트가 Tool 사용 시점을 더 정확하게 판단할 수 있습니다.