Claude Platform Docs
MessagesInfraestructura de herramientas

Combinaciones de herramientas

Combinaciones comunes de herramientas de Anthropic para agentes de investigación, agentes de programación y agentes de larga duración.

Las herramientas proporcionadas por Anthropic están diseñadas para funcionar juntas. Los patrones comunes de agentes combinan herramientas que cubren etapas complementarias de un flujo de trabajo: una herramienta recopila o descubre, otra procesa o actúa. Las combinaciones a continuación son puntos de partida, no prescripciones. Mézclalas para adaptarlas a tu tarea.

Cada fragmento muestra solo el arreglo tools. Consulta Manejar llamadas a herramientas para ver la forma completa de la solicitud.

Agente de investigación: web_search + code_execution

La búsqueda encuentra fuentes; la ejecución de código analiza y sintetiza. Claude busca datos y luego escribe Python para procesarlos, tabularlos o visualizarlos. Esta combinación es adecuada para preguntas que requieren tanto información actualizada como cómputo no trivial sobre esa información, como "compara las ganancias de este trimestre entre los cinco principales proveedores de nube".

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20260521", "name": "code_execution" }
  ]
}

El flujo suele ser buscar, luego ejecutar y, opcionalmente, buscar de nuevo si la primera pasada reveló una brecha. La ejecución de código se realiza del lado del servidor, por lo que no hay un sandbox del lado del cliente que administrar.

Agente de programación: text_editor + bash

El editor de texto lee y modifica archivos; bash ejecuta pruebas y comandos de compilación. Este es el ciclo canónico de desarrollo de software: inspeccionar el código, hacer una edición, ejecutar las pruebas, repetir. Ambas herramientas se ejecutan del lado del cliente, por lo que tu aplicación controla qué archivos y comandos son accesibles.

{
  "tools": [
    { "type": "text_editor_20250728", "name": "str_replace_based_edit_tool" },
    { "type": "bash_20250124", "name": "bash" }
  ]
}

Combina esto con un directorio de trabajo restringido y una lista de comandos permitidos si el agente opera sobre código no confiable. Consulta Herramienta de editor de texto y Herramienta bash para ver los contratos de ejecución.

Citar y luego obtener: web_search + web_fetch

La búsqueda muestra URL candidatas; fetch recupera el contenido completo de la página para las relevantes. Esto evita obtener todo de antemano. Claude ejecuta una búsqueda, inspecciona los fragmentos, elige los dos o tres resultados que realmente parecen relevantes y obtiene solo esos.

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "web_fetch_20260209", "name": "web_fetch" }
  ]
}

Esta combinación es útil cuando la respuesta se encuentra en contenido extenso (páginas de documentación, artículos, especificaciones) que un fragmento de búsqueda no puede capturar por completo. Fetch extrae la página completa para que Claude pueda citar pasajes específicos.

Agente de larga duración: memory + cualquier otra herramienta

La memoria persiste el estado entre conversaciones; las otras herramientas hacen el trabajo. Agrega memoria a cualquier agente que necesite recordar sesiones anteriores, como un agente de soporte que recuerda los problemas previos de un cliente o un asistente de proyecto que hace seguimiento de las decisiones tomadas la semana pasada.

{
  "tools": [{ "type": "memory_20250818", "name": "memory" }]
}

Agrega tus otras herramientas junto a memory en el mismo arreglo.

La memoria es ortogonal a tus otras herramientas. No cambia cómo se comportan; le da a Claude un lugar donde anotar y luego recuperar hechos que de otro modo se perderían cuando la "context window" (ventana de contexto) se reinicia. Consulta Herramienta de memoria para ver el modelo de almacenamiento.

Todo en uno: computer_use

La herramienta de uso de computadora abarca la mayoría de las demás al operar un escritorio completo. Claude ve capturas de pantalla y emite acciones de mouse y teclado, lo que significa que puede manejar cualquier aplicación que un humano pueda. Usa esto cuando la tarea requiera interacción arbitraria con la GUI que herramientas más específicas no pueden alcanzar: software heredado sin una API, pasos de verificación visual o flujos de trabajo que abarcan múltiples aplicaciones de escritorio.

{
  "tools": [{ "type": "computer_toolset_20260801" }]
}

La entrada del conjunto de herramientas no acepta name ni dimensiones de pantalla: las coordenadas se expresan en el espacio de píxeles de las capturas de pantalla que devuelves, y puedes desactivar acciones individuales a través del campo configs de la entrada.

El uso de computadora es la opción más general y también la más lenta, porque Claude normalmente necesita una captura de pantalla nueva después de cada lote de acciones. Prefiere herramientas más específicas cuando cubran tu caso de uso, y recurre al uso de computadora cuando nada más encaje. Si la tarea permanece dentro de un navegador web, usa el patrón de agente de navegador de la siguiente sección. Consulta Herramienta de uso de computadora para ver la configuración del sandbox.

Agente de navegador: browser_use

Cuando toda la tarea ocurre dentro de páginas web (llenar formularios, leer contenido de páginas, trabajar entre pestañas), la herramienta de uso de navegador es más adecuada que el uso de computadora. Tu aplicación maneja un navegador que controla y devuelve capturas de pantalla o el estado de la página; Claude llama a herramientas miembro conscientes de la página como read_page, find, form_input y get_page_text junto con clics y escritura, de modo que puede actuar sobre referencias a elementos además de coordenadas de píxeles.

{
  "tools": [{ "type": "browser_toolset_20260801" }]
}

Al igual que el conjunto de herramientas de uso de computadora, la entrada no acepta name, y desactivas herramientas miembro individuales a través de su campo configs. Consulta Herramienta de uso de navegador para ver el contrato de ejecución.

Próximos pasos

Catálogo completo de herramientas proporcionadas por Anthropic con cadenas de tipo y parámetros.

Cómo funciona el uso de herramientas y cuándo usar herramientas de Anthropic en lugar de definir las tuyas.

Was this page helpful?