Built-in과 External 모드 분리로 Search 가시성 및 제어권 확보

Context

기존 AI 에이전트의 웹 검색 기능이 단일 체크박스로 추상화되어 실제 작동 방식과 비용, 공급자 선택 과정이 불투명한 Black-box 구조로 운영됨. 이로 인해 프로덕션 환경에서 요구되는 세밀한 비용 제어와 감사 가능성(Auditability) 확보에 한계가 발생함.

Technical Solution

• Provider-native 기능을 활용하는 Built-in 모드와 전용 Tool을 호출하는 External 모드로 search path를 이원화한 구조 설계
• Tavily, SerpAPI, Aliyun IQS 등 다수 공급자를 통합 관리하는 Search Engine Configuration 레이어 구축을 통한 벤더 종속성 제거
• internal/handler/agent.go 내 validateExternalWebSearch 로직을 통한 외부 엔진 설정 필수 검증으로 구성 오류(Footgun) 방지
• internal/tools/websearch/search.go에서 공급자별 응답 형식을 title, URL, snippet으로 표준화하는 Normalization 레이어 구현
• Built-in 모드 시 extra_body: {"enable_search": true}를 명시하고, External 모드 시 Tool call 경로를 통해 실행 단계와 입출력을 기록하는 관측 가능성(Observability) 확보