- Claude Developer Platform에 3가지 새로운 기능이 추가되어, 모델이 수천 개의 외부 도구를 효율적으로 탐색·호출·학습할 수 있는 고급 도구 사용 구조 제공
- Tool Search Tool은 필요한 시점에만 도구 정의를 불러와 토큰 사용량을 최대 85% 절감하고, 대규모 MCP 환경에서 정확도 74~88% 수준 향상
- Programmatic Tool Calling은 코드 실행 환경에서 도구를 병렬 호출해 토큰 절감(37%) , 지연 시간 감소, 정확도 향상을 달성
- Tool Use Examples는 실제 호출 예시를 통해 JSON Schema로 표현할 수 없는 도구 사용 패턴과 매개변수 관계를 학습하게 함
- 세 기능은 대규모 AI 에이전트의 효율적 오케스트레이션 기반을 제공하며, 복잡한 워크플로우 자동화의 핵심 구성 요소
AI 에이전트의 도구 사용 확장
- 미래의 AI 에이전트는 수백~수천 개의 도구를 통합적으로 활용해야 함
- 예시로 IDE 보조 도구, 운영 코디네이터, Slack·GitHub·Jira·Google Drive 등과의 연동 제시
- 기존 방식은 모든 도구 정의를 미리 로드해야 해 맥락 창(context window) 을 빠르게 소모
- 새로운 접근은 필요 시점에 도구를 탐색·로드하고, 코드 기반 호출과 예시 학습을 통해 효율성 확보
Tool Search Tool
- 기존 MCP 환경에서는 다수의 서버 연결 시 도구 정의가 10만 개 이상의 토큰을 차지
- 예: GitHub(26K), Slack(21K), Jira(17K) 등 누적 시 134K 토큰 초과 사례
- Tool Search Tool은 도구를 on-demand 방식으로 검색·로드
- 초기 로드 시 약 500토큰만 사용, 필요 도구만 추가 로드
- 전체 토큰 사용량 약 8.7K로 감소, 95%의 컨텍스트 절약
- 내부 테스트 결과, MCP 평가 정확도 Opus 4: 49%→74%, Opus 4.5: 79.5%→88.1% 향상
-
defer_loading: true설정을 통해 도구를 지연 로드 가능- 자주 쓰는 도구만 항상 로드하고 나머지는 검색 시점에 불러옴
- 정규식(regex)·BM25 기반 검색 도구 기본 제공, 임베딩 기반 커스텀 검색도 가능
- 적용 권장 조건: 10개 이상 도구, 10K 토큰 이상 정의, 선택 오류 빈번한 환경
Programmatic Tool Calling
- 기존 자연어 기반 호출은 중간 결과 누적과 다중 추론 패스로 인해 비효율 발생
- 예: 10MB 로그 분석 시 전체 데이터가 맥락에 포함되어 토큰 낭비
- Programmatic Tool Calling(PTC)은 코드 실행 환경에서 도구를 병렬 호출
- Claude가 Python 코드로 루프·조건문·데이터 변환을 수행
- 중간 결과는 모델 맥락에 포함되지 않고, 최종 결과만 반환
- 예시: 분기별 예산 초과자 탐색 작업에서 2,000개 항목 대신 결과 1KB만 맥락에 포함
-
효과
- 토큰 사용량 43,588→27,297(37% 감소)
- 지연 시간 단축(20회 호출 시 19회 추론 제거)
- 정확도 향상: 내부 검색 25.6→28.5%, GIA 벤치마크 46.5→51.2%
-
적용 권장 조건
- 대규모 데이터 요약, 3단계 이상 종속 호출, 병렬 실행 필요 작업
- 단일 호출이나 작은 응답에는 비효율적
Tool Use Examples
- JSON Schema는 구조만 정의할 뿐, 사용 패턴·형식 규칙·매개변수 관계를 표현하지 못함
- 예: 날짜 형식, ID 규칙, 중첩 객체 사용 시점 등 불명확
- Tool Use Examples는 도구 정의에 실제 입력 예시(input_examples) 를 추가
- 예시를 통해 Claude가 날짜 형식(YYYY-MM-DD), ID 규칙(USR-XXXXX), 선택 매개변수 조합 등을 학습
- 내부 테스트에서 복잡한 매개변수 처리 정확도 72%→90% 로 향상
-
적용 권장 조건
- 중첩 구조·선택 매개변수가 많은 도구
- 도메인별 규칙이 Schema로 표현되지 않는 API
- 유사 도구 간 구분이 필요한 경우
세 기능의 통합 활용 및 베스트 프랙티스
- 세 기능은 서로 보완적으로 작동
- Tool Search Tool → 필요한 도구 탐색
- Programmatic Tool Calling → 효율적 실행
- Tool Use Examples → 정확한 호출
-
적용 우선순위
- 컨텍스트 초과 → Tool Search Tool
- 중간 결과 과다 → Programmatic Tool Calling
- 매개변수 오류 → Tool Use Examples
-
설정 팁
- 도구 이름·설명을 명확히 작성해 검색 정확도 향상
- 자주 쓰는 3~5개 도구는 항상 로드, 나머지는 지연 로드
- 코드 실행용 도구는 반환 형식 명시
- 예시 데이터는 실제적이고 간결하게 작성(1~5개 예시)
시작하기
- 세 기능은 베타 버전으로 제공
-
betas=["advanced-tool-use-2025-11-20"]헤더 추가 후 사용 가능 - 포함 도구:
tool_search_tool_regex_20251119,code_execution_20250825등
-
- 공식 문서와 GitHub cookbook에서 API 예시 및 구현 가이드 제공
- 이 기능들은 단순 함수 호출을 넘어 지능적 오케스트레이션으로 발전하는 기반 기술로 제시됨
- 복잡한 워크플로우와 대규모 데이터 환경에서 동적 탐색·효율적 실행·정확한 호출을 실현하는 핵심 구성 요소로 강조됨