Loading...
    • Construir
    • Admin
    • Modelos e preços
    • SDKs de cliente
    • Referência da API
    Search...
    ⌘K
    Primeiros passos
    Introdução ao ClaudeInício rápido
    Construindo com Claude
    Visão geral dos recursosUsando a API de MensagensTratando razões de parada
    Capacidades do modelo
    Pensamento estendidoPensamento adaptativoEsforçoModo rápido (beta: prévia de pesquisa)Saídas estruturadasCitaçõesMensagens em streamingProcessamento em loteResultados de pesquisaRecusas em streamingSuporte multilíngueEmbeddings
    Ferramentas
    Visão geralComo o uso de ferramentas funcionaFerramenta de busca na webFerramenta de busca webFerramenta de execução de códigoFerramenta de memóriaFerramenta BashFerramenta de uso do computadorFerramenta de edição de texto
    Infraestrutura de ferramentas
    Busca de ferramentasChamada programática de ferramentasStreaming refinado de ferramentas
    Gerenciamento de contexto
    Janelas de contextoCompactaçãoEdição de contextoCache de promptContagem de tokens
    Trabalhando com arquivos
    Files APISuporte a PDFImagens e visão
    Skills
    Visão geralInício rápidoMelhores práticasSkills para empresasSkills na API
    MCP
    Servidores MCP remotosConector MCP
    Engenharia de prompt
    Visão geralMelhores práticas de promptingFerramentas de prompting no Console
    Testar e avaliar
    Definir sucesso e criar avaliaçõesUsando a Ferramenta de Avaliação no ConsoleReduzindo latência
    Fortalecer guardrails
    Reduzir alucinaçõesAumentar consistência de saídaMitigar jailbreaksReduzir vazamento de prompt
    Recursos
    Glossário
    Notas de versão
    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 seu agente

    Ferramentas

    Configure as ferramentas disponíveis para o seu agente.

    Claude Managed Agents fornece um conjunto de ferramentas integradas que Claude pode usar de forma autônoma dentro de uma sessão. Você controla quais ferramentas estão disponíveis especificando-as na configuração do agente.

    Ferramentas personalizadas definidas pelo usuário também são suportadas. Sua aplicação executa essas ferramentas separadamente e envia os resultados de volta para Claude; Claude pode usar os resultados para continuar a tarefa em questão.

    Todas as requisições da API Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.

    Ferramentas disponíveis

    O conjunto de ferramentas do agente inclui as seguintes ferramentas. Todas são habilitadas por padrão quando você inclui o conjunto de ferramentas na configuração do seu agente.

    FerramentaNomeDescrição
    BashbashExecuta comandos bash em uma sessão de shell
    ReadreadLê um arquivo do sistema de arquivos local
    Writewrite

    Was this page helpful?

    • Ferramentas disponíveis
    • Configurando o conjunto de ferramentas
    • Desabilitando ferramentas específicas
    • Habilitando apenas ferramentas específicas
    • Ferramentas personalizadas
    • Melhores práticas para definições de ferramentas personalizadas
    Escreve um arquivo no sistema de arquivos local
    EditeditRealiza substituição de strings em um arquivo
    GlobglobCorrespondência rápida de padrões de arquivo usando padrões glob
    GrepgrepPesquisa de texto usando padrões regex
    Web fetchweb_fetchBusca conteúdo de uma URL
    Web searchweb_searchPesquisa na web por informações

    Configurando o conjunto de ferramentas

    Habilite o conjunto completo de ferramentas com agent_toolset_20260401 ao criar um agente. Use o array configs para desabilitar ferramentas específicas ou substituir suas configurações.

    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
)

    Desabilitando ferramentas específicas

    Para desabilitar uma ferramenta, defina enabled: false em sua entrada de configuração:

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

    Habilitando apenas ferramentas específicas

    Para começar com tudo desativado e habilitar apenas o que você precisa, defina default_config.enabled como false:

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

    Ferramentas personalizadas

    Além das ferramentas integradas, você pode definir ferramentas personalizadas. Ferramentas personalizadas são análogas às ferramentas de cliente definidas pelo usuário na API de Mensagens.

    Ferramentas personalizadas permitem que você estenda as capacidades de Claude para realizar uma variedade maior de tarefas. Cada ferramenta define um contrato: você especifica quais operações estão disponíveis e o que elas retornam; Claude decide quando e como chamá-las. O modelo nunca executa nada por conta própria. Ele emite uma solicitação estruturada, seu código executa a operação e o resultado flui de volta para a conversa.

    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
)

    Depois de definir a ferramenta no nível do agente, o agente invocará as ferramentas durante o curso de uma sessão. Consulte Fluxo de eventos da sessão para o fluxo completo.

    Melhores práticas para definições de ferramentas personalizadas

    • Forneça descrições extremamente detalhadas. Este é de longe o fator mais importante no desempenho das ferramentas. Suas descrições devem explicar o que a ferramenta faz, quando deve ser usada (e quando não deve), o que cada parâmetro significa e como afeta o comportamento da ferramenta, e quaisquer ressalvas ou limitações importantes. Quanto mais contexto você puder dar a Claude sobre suas ferramentas, melhor ele será em decidir quando e como usá-las. Procure pelo menos 3-4 frases por descrição de ferramenta, mais se a ferramenta for complexa.
    • Consolide operações relacionadas em menos ferramentas. Em vez de criar uma ferramenta separada para cada ação (create_pr, review_pr, merge_pr), agrupe-as em uma única ferramenta com um parâmetro action. Ferramentas menos numerosas e mais capazes reduzem a ambiguidade de seleção e tornam sua superfície de ferramentas mais fácil de navegar para Claude.
    • Use namespacing significativo nos nomes das ferramentas. Quando suas ferramentas abrangem múltiplos serviços ou recursos, prefixe os nomes com o recurso (por exemplo, db_query, storage_read). Isso torna a seleção de ferramentas inequívoca à medida que sua biblioteca cresce.
    • Projete respostas de ferramentas para retornar apenas informações de alto sinal. Retorne identificadores semânticos e estáveis (por exemplo, slugs ou UUIDs) em vez de referências internas opacas, e inclua apenas os campos que Claude precisa para raciocinar sobre seu próximo passo. Respostas sobrecarregadas desperdiçam contexto e dificultam que Claude extraia o que importa.