도구 참고자료

이 페이지는 Anthropic에서 제공하는 도구와 모든 도구 정의에서 설정할 수 있는 선택적 속성에 대한 참고자료입니다. 도구 사용에 대한 개념적 소개는 Claude를 사용한 도구 사용을 참조하세요. 애플리케이션에서 도구 사용을 구현하는 방법에 대한 지침은 도구 정의를 참조하세요.

Anthropic에서 제공하는 도구

Anthropic은 두 가지 종류의 도구를 제공합니다: Anthropic의 인프라에서 실행되는 서버 도구와 Anthropic이 스키마를 정의하지만 애플리케이션이 실행을 처리하는 클라이언트 도구입니다. 두 종류 모두 사용자 정의 도구와 함께 요청의 tools 배열에 나타납니다.

모델 호환성에 대해서는 각 도구의 페이지를 참조하세요. 지원되는 모델은 도구와 도구 버전에 따라 다릅니다.

도구 버전 관리

대부분의 Anthropic 제공 도구는 type 문자열에 _YYYYMMDD 접미사를 포함합니다. 도구의 동작, 스키마 또는 모델 지원이 변경되면 새 버전이 릴리스됩니다. 이전 버전은 기존 통합이 계속 작동하도록 유지됩니다.

도구에 여러 활성 버전이 있을 때, 그들 간의 관계는 다양합니다:

• 기능 기반: web_search_20260209 및 web_fetch_20260209는 이전 버전에 동적 콘텐츠 필터링을 추가합니다. code_execution_20260120은 샌드박스 내에서 프로그래밍 방식의 도구 호출을 추가합니다. 각 경우에 새 버전과 이전 버전 모두 현재 버전입니다. 어느 것을 사용할지는 새로운 기능이 필요한지 여부에 따라 달라집니다.
• 모델 기반: text_editor_20250728은 Claude 4 모델용이고 text_editor_20250124는 이전 모델용입니다. 사용하는 버전은 대상 모델에 따라 달라집니다.
• 변형, 버전 아님: tool_search_tool_regex_20251119 및 tool_search_tool_bm25_20251119는 함께 릴리스된 두 가지 검색 알고리즘입니다. 어느 것도 다른 것을 대체하지 않습니다.
• 레거시: code_execution_20250522는 Python만 지원합니다. code_execution_20250825는 Bash 및 파일 작업을 추가합니다.

mcp_toolset 타입은 날짜 버전이 지정되지 않습니다. 버전 관리는 anthropic-beta 헤더에서 수행됩니다.

도구 정의 속성

tools 배열의 모든 도구(사용자 정의 도구 포함)는 도구가 로드되는 방식, 누가 호출할 수 있는지, 입력이 어떻게 검증되는지를 제어하는 선택적 속성을 허용합니다. 이러한 속성은 구성됩니다: 동일한 도구에서 defer_loading과 cache_control 및 strict를 설정할 수 있습니다.

allowed_callers 값

allowed_callers는 다음의 조합을 허용하는 배열입니다:

배열에서 "direct"를 생략하면(예: "allowed_callers": ["code_execution_20260120"]), 도구는 코드 실행 내에서만 호출 가능합니다. 응답의 tool_use 블록에는 어떤 호출자가 도구를 호출했는지 식별하는 caller 필드가 포함됩니다. caller 응답 형태 및 오류 동작을 포함한 전체 처리는 프로그래밍 방식의 도구 호출을 참조하세요.

defer_loading 및 프롬프트 캐싱

defer_loading: true인 도구는 캐시 키가 계산되기 전에 렌더링된 도구 섹션에서 제거됩니다. 시스템 프롬프트 접두사에 전혀 나타나지 않습니다. 도구 검색이 지연된 도구를 발견하고 도구에 대한 tool_reference를 반환하면, 도구의 전체 정의는 접두사가 아닌 대화 본문의 해당 지점에서 인라인으로 확장됩니다.

이는 defer_loading: true가 프롬프트 캐시를 보존함을 의미합니다. 기존 캐시 항목을 무효화하지 않고 요청에 지연된 도구를 추가할 수 있으며, 도구가 발견되는 턴과 도구가 호출되는 턴 전체에서 캐시는 유효합니다.

defer_loading을 cache_control 중단점과 결합하는 방법은 도구 검색 도구 프롬프트 캐싱 지침을 참조하세요.