Referencia de herramientas

Esta página es una referencia de las herramientas que Anthropic proporciona y de 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 obtener 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 se encarga de la ejecución. Ambos tipos aparecen en el array tools de tu solicitud junto con cualquier herramienta definida por el usuario.

Para la 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 publica una nueva versión cuando cambia el comportamiento, el esquema o la compatibilidad de modelos de la herramienta. Las versiones anteriores permanecen disponibles para que las integraciones existentes sigan funcionando.

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

• Por capacidad: web_search_20260209 y web_fetch_20260209 añaden filtrado de contenido dinámico respecto a sus predecesoras; web_fetch_20260309 añade una opción para omitir la caché; web_search_20260318 y web_fetch_20260318 añaden control de inclusión de respuestas. code_execution_20260120 añade llamadas programáticas a herramientas desde dentro del sandbox; code_execution_20260521 revela el límite de tiempo por celda en la descripción de la herramienta. En cada caso, tanto la versión nueva como la antigua son actuales; cuál uses depende de si necesitas la nueva capacidad.
• Por 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 al que apuntes.
• Variante, no versión: tool_search_tool_regex_20251119 y tool_search_tool_bm25_20251119 son dos algoritmos de búsqueda publicados juntos. Ninguno reemplaza al otro.
• Legado: code_execution_20250522 solo admite Python. code_execution_20250825 añade Bash y operaciones de archivos.

El tipo mcp_toolset no está versionado por fecha; el versionado se transmite en el encabezado anthropic-beta en su lugar.



Propiedades de definición de herramientas

Cada herramienta en el array tools, incluidas las 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, cache_control y strict en la misma herramienta.



Valores de allowed_callers

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

Tanto "code_execution_20260120" como "code_execution_20260521" se aceptan en allowed_callers y son intercambiables: una solicitud que use cualquiera de las versiones de la herramienta de ejecución de código satisface a las herramientas que listen cualquiera de los llamadores. Los bloques de respuesta siempre etiquetan al llamador como code_execution_20260120 independientemente de qué versión haya declarado la solicitud.

Omitir "direct" del array (por ejemplo, "allowed_callers": ["code_execution_20260120"]) guía a Claude a llamar a la herramienta 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 Llamadas programáticas a herramientas para el tratamiento completo, incluida la forma de la respuesta caller y el comportamiento de errores.



defer_loading y almacenamiento en caché de prompts

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

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

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