Construtor de Ferramentas para Agentes

Ferramentas são a forma como os agentes de IA interagem com o mundo. Uma ferramenta bem projetada é a diferença entre um agente que funciona e um que alucina, falha silenciosamente ou custa 10x mais tokens do que o necessário.

Esta habilidade abrange o design de ferramentas, desde o esquema até o tratamento de erros. Melhores práticas de JSON Schema, escrita de descrições que realmente ajudam o LLM, validação e o emergente padrão MCP que está se tornando a língua franca para ferramentas de IA.

Insight chave: As descrições das ferramentas são mais importantes do que as implementações das ferramentas. O LLM nunca vê seu código - ele apenas vê o esquema e a descrição.

Guia Detalhado

Leia o guia detalhado antes de executar esta habilidade. Ele retém o procedimento completo e o material de referência. Trate seus requisitos de segurança, pré-requisitos e validação como obrigatórios. Para trabalho focado, carregue as seções relevantes; para trabalho de ponta a ponta, leia o guia completamente.

Exemplo em Python

""" import anthropic from anthropic import beta_tool

client = anthropic.Anthropic()

@beta_tool def get_weather(location: str, unit: str = "fahrenheit") -> str: '''Obtém o clima atual em um determinado local.

Args:
    location: A cidade e estado, ex: São Paulo, SP
    unit: Unidade de temperatura, 'celsius' ou 'fahrenheit'
'''
# Implementação
return json.dumps({"temperature": "22°C", "conditions": "Ensolarado"})

@beta_tool def search_web(query: str) -> str: '''Busca informações na web.

Args:
    query: A consulta de busca
'''
# Implementação
return json.dumps({"results": [...]})

O executor de ferramentas lida com o loop

runner = client.beta.messages.tool_runner( model="claude-sonnet-4-5", max_tokens=1024, tools=[get_weather, search_web], messages=[ {"role": "user", "content": "Qual o clima em Paris?"} ] )

Processa cada mensagem

for message in runner: print(message.content[0].text)

Ou apenas obtém o resultado final

final = runner.until_done() """

Quando Usar

• O usuário menciona ou implica: ferramenta de agente
• O usuário menciona ou implica: chamada de função
• O usuário menciona ou implica: esquema de ferramenta
• O usuário menciona ou implica: design de ferramenta
• O usuário menciona ou implica: servidor mcp
• O usuário menciona ou implica: ferramenta mcp
• O usuário menciona ou implica: uso de ferramenta
• O usuário menciona ou implica: construir ferramenta para agente
• O usuário menciona ou implica: definir função
• O usuário menciona ou implica: input_schema
• O usuário menciona ou implica: tool_use
• O usuário menciona ou implica: tool_result

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação, testes ou revisão de especialistas específicos do ambiente.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.