Loading...
    • Construir
    • Administración
    • Modelos y precios
    • SDKs de cliente
    • Referencia de la API
    Search...
    ⌘K
    Primeros pasos
    Introducción a ClaudeInicio rápido
    Construir con Claude
    Descripción general de funcionesUsar la API de mensajesGestionar razones de parada
    Capacidades del modelo
    Pensamiento extendidoPensamiento adaptativoEsfuerzoModo rápido (beta: vista previa de investigación)Salidas estructuradasCitasMensajes en streamingProcesamiento por lotesResultados de búsquedaRechazos en streamingSoporte multilingüeEmbeddings
    Herramientas
    Descripción generalCómo funciona el uso de herramientasHerramienta de búsqueda webHerramienta de recuperación webHerramienta de ejecución de códigoHerramienta de memoriaHerramienta BashHerramienta de uso del ordenadorHerramienta de edición de texto
    Infraestructura de herramientas
    Búsqueda de herramientasLlamada programática de herramientasStreaming detallado de herramientas
    Gestión del contexto
    Ventanas de contextoCompactaciónEdición de contextoCaché de promptsConteo de tokens
    Trabajar con archivos
    Files APISoporte de PDFImágenes y visión
    Skills
    Descripción generalInicio rápidoMejores prácticasSkills para empresasSkills en la API
    MCP
    Servidores MCP remotosConector MCP
    Ingeniería de prompts
    Descripción generalMejores prácticas de promptsHerramientas de prompts en Console
    Probar y evaluar
    Definir el éxito y crear evaluacionesUsar la herramienta de evaluación en ConsoleReducir la latencia
    Reforzar las barreras de seguridad
    Reducir alucinacionesAumentar la consistencia de salidaMitigar jailbreaksReducir la filtración de prompts
    Recursos
    Glosario
    Notas de versión
    Claude Platform
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Definir tu agente

    Herramientas

    Configure las herramientas disponibles para su agente.

    Claude Managed Agents proporciona un conjunto de herramientas integradas que Claude puede usar de forma autónoma dentro de una sesión. Usted controla qué herramientas están disponibles especificándolas en la configuración del agente.

    También se admiten herramientas personalizadas definidas por el usuario. Su aplicación ejecuta estas herramientas por separado y envía los resultados de las herramientas de vuelta a Claude; Claude puede usar los resultados para continuar con la tarea en cuestión.

    Todas las solicitudes de la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.

    Herramientas disponibles

    El conjunto de herramientas del agente incluye las siguientes herramientas. Todas están habilitadas de forma predeterminada cuando incluye el conjunto de herramientas en la configuración de su agente.

    HerramientaNombreDescripción
    BashbashEjecutar comandos bash en una sesión de shell
    ReadreadLeer un archivo del sistema de archivos local
    Writewrite

    Was this page helpful?

    • Herramientas disponibles
    • Configuración del conjunto de herramientas
    • Deshabilitar herramientas específicas
    • Habilitar solo herramientas específicas
    • Herramientas personalizadas
    • Mejores prácticas para definiciones de herramientas personalizadas
    Escribir un archivo en el sistema de archivos local
    EditeditRealizar reemplazo de cadenas en un archivo
    GlobglobCoincidencia rápida de patrones de archivos usando patrones glob
    GrepgrepBúsqueda de texto usando patrones regex
    Web fetchweb_fetchObtener contenido de una URL
    Web searchweb_searchBuscar información en la web

    Configuración del conjunto de herramientas

    Habilite el conjunto de herramientas completo con agent_toolset_20260401 al crear un agente. Use el array configs para deshabilitar herramientas específicas o anular su configuración.

    agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Coding Assistant",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "configs": [
        {"name": "web_fetch", "enabled": false}
      ]
    }
  ]
}
EOF
)

    Deshabilitar herramientas específicas

    Para deshabilitar una herramienta, establezca enabled: false en su entrada de configuración:

    {
  "type": "agent_toolset_20260401",
  "configs": [
    { "name": "web_fetch", "enabled": false },
    { "name": "web_search", "enabled": false }
  ]
}

    Habilitar solo herramientas específicas

    Para comenzar con todo desactivado y habilitar solo lo que necesita, establezca default_config.enabled en false:

    {
  "type": "agent_toolset_20260401",
  "default_config": { "enabled": false },
  "configs": [
    { "name": "bash", "enabled": true },
    { "name": "read", "enabled": true },
    { "name": "write", "enabled": true }
  ]
}

    Herramientas personalizadas

    Además de las herramientas integradas, puede definir herramientas personalizadas. Las herramientas personalizadas son análogas a las herramientas de cliente definidas por el usuario en la API de Messages.

    Las herramientas personalizadas le permiten ampliar las capacidades de Claude para realizar una mayor variedad de tareas. Cada herramienta define un contrato: usted especifica qué operaciones están disponibles y qué devuelven; Claude decide cuándo y cómo llamarlas. El modelo nunca ejecuta nada por sí solo. Emite una solicitud estructurada, su código ejecuta la operación y el resultado fluye de vuelta a la conversación.

    agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Weather Agent",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401"
    },
    {
      "type": "custom",
      "name": "get_weather",
      "description": "Get current weather for a location",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": {"type": "string", "description": "City name"}
        },
        "required": ["location"]
      }
    }
  ]
}
EOF
)

    Una vez que haya definido la herramienta a nivel del agente, el agente invocará las herramientas durante el transcurso de una sesión. Consulte Flujo de eventos de sesión para ver el flujo completo.

    Mejores prácticas para definiciones de herramientas personalizadas

    • Proporcione descripciones extremadamente detalladas. Este es, con diferencia, el factor más importante en el rendimiento de las herramientas. Sus descripciones deben explicar qué hace la herramienta, cuándo debe usarse (y cuándo no), qué significa cada parámetro y cómo afecta el comportamiento de la herramienta, y cualquier advertencia o limitación importante. Cuanto más contexto pueda darle a Claude sobre sus herramientas, mejor será para decidir cuándo y cómo usarlas. Apunte a al menos 3-4 oraciones por descripción de herramienta, más si la herramienta es compleja.
    • Consolide operaciones relacionadas en menos herramientas. En lugar de crear una herramienta separada para cada acción (create_pr, review_pr, merge_pr), agrúpelas en una sola herramienta con un parámetro action. Menos herramientas, pero más capaces, reducen la ambigüedad en la selección y hacen que su superficie de herramientas sea más fácil de navegar para Claude.
    • Use espacios de nombres significativos en los nombres de las herramientas. Cuando sus herramientas abarcan múltiples servicios o recursos, prefije los nombres con el recurso (por ejemplo, db_query, storage_read). Esto hace que la selección de herramientas sea inequívoca a medida que crece su biblioteca.
    • Diseñe las respuestas de las herramientas para devolver solo información de alta relevancia. Devuelva identificadores semánticos y estables (por ejemplo, slugs o UUIDs) en lugar de referencias internas opacas, e incluya solo los campos que Claude necesita para razonar sobre su siguiente paso. Las respuestas infladas desperdician contexto y dificultan que Claude extraiga lo que importa.