Referencia de herramientas

Esta página es una referencia para las herramientas que Anthropic proporciona y las propiedades opcionales que puedes establecer en cualquier definición de herramienta. Para una introducción conceptual al uso de herramientas, consulta Uso de herramientas con Claude. Para orientación sobre cómo implementar el uso de herramientas en tu aplicación, consulta Definir herramientas.

Herramientas proporcionadas por Anthropic

Anthropic proporciona dos tipos de herramientas: herramientas de servidor que se ejecutan en la infraestructura de Anthropic, y herramientas de cliente donde Anthropic define el esquema pero tu aplicación maneja la ejecución. Ambos tipos aparecen en el array tools de tu solicitud junto con cualquier herramienta definida por el usuario.

Para compatibilidad de modelos, consulta la página de cada herramienta. Los modelos compatibles varían según la herramienta y la versión de la herramienta.

Versionado de herramientas

La mayoría de las herramientas proporcionadas por Anthropic llevan un sufijo _YYYYMMDD en la cadena type. Se lanza una nueva versión cuando el comportamiento, esquema o compatibilidad de modelos de la herramienta cambia. Las versiones anteriores permanecen disponibles para que las integraciones existentes continúen funcionando.

Cuando una herramienta tiene múltiples versiones activas, la relación entre ellas varía:

• Basada en capacidad: web_search_20260209 y web_fetch_20260209 añaden filtrado dinámico de contenido sobre sus predecesores. code_execution_20260120 añade llamada de herramientas programática desde dentro del sandbox. En cada caso, tanto la versión nueva como la antigua son actuales; cuál uses depende de si necesitas la nueva capacidad.
• Basada en modelo: text_editor_20250728 es para modelos Claude 4 y text_editor_20250124 es para modelos anteriores. La versión que uses depende del modelo que apuntes.
• Variante, no versión: tool_search_tool_regex_20251119 y tool_search_tool_bm25_20251119 son dos algoritmos de búsqueda lanzados juntos. Ninguno reemplaza al otro.
• Heredado: code_execution_20250522 solo soporta Python. code_execution_20250825 añade Bash y operaciones de archivo.

El tipo mcp_toolset no tiene versionado por fecha; el versionado se lleva en el encabezado anthropic-beta en su lugar.

Propiedades de definición de herramientas

Cada herramienta en el array tools, incluyendo herramientas definidas por el usuario, acepta propiedades opcionales que controlan cómo se carga la herramienta, quién puede llamarla y cómo se validan sus entradas. Estas propiedades se componen: puedes establecer defer_loading y cache_control y strict en la misma herramienta.

Valores de allowed_callers

allowed_callers es un array que acepta cualquier combinación de:

Omitir "direct" del array (por ejemplo, "allowed_callers": ["code_execution_20260120"]) significa que la herramienta es llamable solo desde dentro de la ejecución de código. El bloque tool_use de la respuesta incluye un campo caller que identifica qué llamador llamó a la herramienta. Consulta Llamada de herramientas programática para el tratamiento completo, incluyendo la forma de respuesta caller y el comportamiento de error.

defer_loading y almacenamiento en caché de indicaciones

Las herramientas con defer_loading: true se eliminan de la sección de herramientas renderizadas antes de que se calcule la clave de caché. No aparecen en el prefijo de indicación del sistema en absoluto. Cuando la búsqueda de herramientas descubre una herramienta diferida y devuelve una tool_reference para ella, la definición completa de la herramienta se expande en línea en ese punto en el cuerpo de la conversación, no en el prefijo.

Esto significa que defer_loading: true preserva tu caché de indicaciones. Puedes añadir herramientas diferidas a una solicitud sin invalidar una entrada de caché existente, y el caché permanece válido en el turno donde se descubre la herramienta y el turno donde se llama.

Para cómo combinar defer_loading con puntos de ruptura cache_control, consulta la guía de almacenamiento en caché de indicaciones de la herramienta de búsqueda de herramientas.