13장 Qwen-Agent로 도구형 작업자를 만든다

Qwen-Agent는 Qwen 모델에 도구 호출, 계획, 메모리, 애플리케이션 연결을 제공하는 프레임워크다. 제품 UI와 달리 코드에서 허용 도구와 결과 형식을 통제할 수 있다. 이 책의 도구는 normalize_source 하나로 시작한다.

입력은 URL·문서명·인용문이고 출력은 정규 URL·언어·해시다. 도구는 웹을 다시 탐색하지 않으며 주어진 값을 결정론적으로 변환한다. 모델은 도구를 “호출할지” 정하고, 실제 정규화 규칙은 코드가 소유한다. 이 분리가 중요한 이유는 URL 중복 제거를 모델의 문장 감각에 맡기면 실행마다 달라지기 때문이다.

API가 없으면 fixture provider가 같은 AgentResult를 반환한다. live 어댑터가 추가되어도 도메인 코드는 공급자 응답을 직접 읽지 않는다. 근거: Qwen-Agent 가이드.