Busca de Ferramentas — Carregar Ferramentas sob Demanda

Imagine carregar um chaveiro com 3000 chaves só para abrir a porta da sua casa. É exatamente isso que acontece quando seu assistente de IA tem centenas de ferramentas externas carregadas na memória de trabalho — cada ferramenta vem com um “manual do usuário” (JSON Schema), e a IA precisa ler todos eles, mesmo para uma tarefa trivial.

Tool Search resolve isso dando à sua IA um gerente de armazém inteligente: ela mantém apenas algumas ferramentas do dia a dia à mão e busca o restante somente quando necessário.

Por que se preocupar?

Quando você conecta muitos serviços externos (GitHub, Cloudflare, Linear, etc.) ao Hermes Agent, cada um adiciona um pedaço de documentação à janela de contexto da IA. Essa é uma “memória de trabalho” preciosa — e ela acaba diluída por instruções irrelevantes. O resultado? Respostas mais lentas, raciocínio pior e, às vezes, a IA “esquece” completamente suas instruções principais.

Como Funciona

Com o Tool Search ativado, a IA não vê mais todas as ferramentas diretamente. Em vez disso, ela vê três ferramentas “ponte”:

tool_search(query, limit?)     # Busca no catálogo de ferramentas
tool_describe(name)            # Lê o manual completo de uma ferramenta
tool_call(name, arguments)     # Executa uma ferramenta

Um fluxo típico é assim:

# 1. Encontre a ferramenta certa
tool_search("criar uma issue no github")
# → retorna ferramentas correspondentes

# 2. Leia o manual
tool_describe("mcp_github_create_issue")
# → mostra os parâmetros necessários

# 3. Execute
tool_call("mcp_github_create_issue", {"title": "Corrigir bug", "body": "..."})
# → issue criada com sucesso

Ponto-chave: quando a IA chama tool_call, o sistema “desembrulha” a ponte e executa a ferramenta real. Todas as verificações de segurança e fluxos de aprovação continuam valendo — a IA simplesmente vê menos, mas faz o mesmo.

Quando Isso Entra em Ação?

O Tool Search usa uma estratégia de divulgação em camadas:

Nível	Condição	O que a IA vê
0	Sem ferramentas externas	Todas as ferramentas mostradas diretamente, sem ponte
1	Poucas ferramentas	Ponte + lista curta (nome + descrição em uma linha)
2	Muitas ferramentas (ex.: 3300 do Cloudflare)	Ponte + resumo de uma linha por servidor (nome + quantidade de ferramentas)

Detalhe legal: se você misturar uma ferramenta pequena (Linear) com uma gigante (Cloudflare), o sistema mantém a lista completa da Linear e só colapsa o Cloudflare em uma única linha — sem esconder tudo de forma genérica.

Ferramentas Principais Sempre Presentes

As ferramentas nativas do Hermes (terminal, I/O de arquivos, busca na web) nunca são carregadas sob demanda. Elas permanecem diretamente disponíveis porque são as capacidades centrais da IA. Apenas ferramentas MCP externas e plugins vão para a “prateleira do armazém”.

Considerações Finais

O Tool Search é como dar à sua IA um sistema de inventário just-in-time — ele resolve o problema de “diluição de atenção” quando o número de ferramentas explode. Dica prática: se sua IA parece lenta ou fora do alvo em tarefas simples, verifique quantas ferramentas externas estão conectadas. Ative o Tool Search e você provavelmente verá um aumento notável tanto em velocidade quanto em precisão. Para uso diário, mantenha o número de ferramentas abaixo de 10 para a experiência mais fluida.

---