Ricerca Strumenti — Carica Strumenti su Richiesta

Immagina di portare un portachiavi con 3000 chiavi solo per aprire la porta di casa. È esattamente ciò che succede quando il tuo assistente AI ha centinaia di strumenti esterni caricati nella sua memoria di lavoro — ogni strumento arriva con il suo “manuale d’uso” (JSON Schema), e l’AI deve leggerli tutti, anche per un compito banale.

Tool Search risolve tutto questo dando alla tua AI un magazziniere intelligente: tiene solo pochi strumenti di uso quotidiano a portata di mano e recupera il resto solo quando serve davvero.

Perché Dovrebbe Interessarti?

Quando colleghi molti servizi esterni (GitHub, Cloudflare, Linear, ecc.) a Hermes Agent, ognuno aggiunge un blocco di documentazione alla finestra di contesto dell’AI. È una “memoria di lavoro” preziosa — e viene diluita da istruzioni irrilevanti. Il risultato? Risposte più lente, ragionamento peggiore e, a volte, l’AI “dimentica” completamente le tue istruzioni principali.

Come Funziona

Con Tool Search attivo, l’AI non vede più tutti gli strumenti direttamente. Invece, vede tre strumenti “ponte”:

tool_search(query, limit?)     # Cerca nel catalogo strumenti
tool_describe(name)            # Legge il manuale completo di uno strumento
tool_call(name, arguments)     # Esegue uno strumento

Un flusso tipico funziona così:

# 1. Trova lo strumento giusto
tool_search("create a github issue")
# → restituisce gli strumenti corrispondenti

# 2. Leggi il suo manuale
tool_describe("mcp_github_create_issue")
# → mostra i parametri richiesti

# 3. Chiamalo
tool_call("mcp_github_create_issue", {"title": "Fix bug", "body": "..."})
# → issue creato con successo

Punto chiave: quando l’AI chiama tool_call, il sistema “scarta” il ponte ed esegue lo strumento reale. Tutti i controlli di sicurezza e i flussi di approvazione restano attivi — l’AI semplicemente vede di meno, ma fa la stessa cosa.

Quando Entra in Azione?

Tool Search usa una strategia di divulgazione a livelli:

Livello	Condizione	Cosa vede l’AI
0	Nessuno strumento esterno	Tutti gli strumenti mostrati direttamente, nessun ponte
1	Pochi strumenti	Ponte + elenco breve (nome + descrizione in una riga)
2	Molti strumenti (es. i 3300 di Cloudflare)	Ponte + riepilogo in una riga per server (nome + numero di strumenti)

Tocco di classe: se mescoli uno strumento piccolo (Linear) con uno gigante (Cloudflare), il sistema mantiene l’elenco completo di Linear e compatta solo Cloudflare in una singola riga — niente nascondimenti generalizzati.

Gli Strumenti Core Restano Sempre

Gli strumenti integrati di Hermes (terminale, I/O file, ricerca web) non vengono mai caricati in modalità lazy. Restano sempre disponibili direttamente perché sono le capacità fondamentali dell’AI. Solo gli strumenti MCP esterni e i plugin vengono riposti nel “magazzino”.

Considerazioni Finali

Tool Search è come dare alla tua AI un sistema di inventario just-in-time — risolve il problema della “diluizione dell’attenzione” quando il numero di strumenti esplode. Consiglio pratico: se la tua AI sembra lenta o fuori fuoco su compiti semplici, controlla quanti strumenti esterni sono collegati. Attiva Tool Search e probabilmente noterai un miglioramento evidente sia in velocità che in precisione. Per l’uso quotidiano, tieni il numero di strumenti sotto 10 per l’esperienza più fluida.

---