Tutorial 18: Strumenti e Set di Strumenti — Le Mani dell'IA

Questo fa parte della serie ufficiale di tutorial di Hermes Agent. Vedi tutti i tutorial

Immagina di dare al tuo assistente un coltellino svizzero — ogni strumento è una lama diversa, e un toolset è la piccola custodia che tiene le lame in ordine. È esattamente ciò che Tools e Toolsets fanno per Hermes Agent: danno alla tua IA delle “mani” per fare davvero cose, non solo chiacchierare.

Passo 1: Conosci gli Strumenti (Le Dita della Tua IA)

Hermes viene fornito con una cassetta degli attrezzi piena di strumenti integrati. Ecco il promemoria rapido:

Categoria	Cosa fa	Esempi
Web	Cerca su internet, legge pagine	`web_search`, `web_extract`
Terminale e File	Esegue comandi, modifica file	`terminal`, `read_file`, `patch`
Browser	Apre un vero browser, vede lo schermo	`browser_navigate`, `browser_vision`
Multimedia	Guarda immagini, crea arte, parla	`vision_analyze`, `image_generate`, `text_to_speech`
Orchestrazione agente	Pianifica, fa domande, scrive codice	`todo`, `clarify`, `execute_code`, `delegate_task`
Memoria	Ricorda chat passate	`memory`, `session_search`
Automazione	Pianifica attività	`cronjob`
Integrazioni	Parla con la casa intelligente, server MCP	`ha_*`, strumenti MCP

Consiglio per principianti: Non memorizzare tutto. Sappi solo che esistono. Sceglierai quelli che ti servono strada facendo.

Passo 2: Attiva gli Strumenti (Come Accendere una Luce)

Gli strumenti sono raggruppati in toolset — pensali come kit già pronti. Li attivi per singola sessione di chat o per piattaforma (ad esempio Telegram vs. il tuo computer).

Ecco come controllarli:

# Usa toolset specifici in una chat
hermes chat --toolsets "web,terminal"

# Vedi tutti gli strumenti disponibili (menu interattivo)
hermes tools

# Configura gli strumenti per una piattaforma specifica
hermes tools

Cosa vedrai: Quando esegui hermes tools, ottieni un menu intuitivo. Basta premere la barra spaziatrice per attivare/disattivare gli strumenti. È come scegliere gli ingredienti per una pizza — prendi quello che vuoi, lascia il resto.

Passo 3: Conosci i Toolset Comuni (I Tuoi Kit di Sempre)

Non devi ricordarli tutti, ma questi sono quelli che userai più spesso:

web — cerca e legge siti web
terminal — esegue comandi sul tuo computer
file — legge e modifica file
browser — automatizza un vero browser
vision — analizza immagini
memory — ricorda cose tra una chat e l’altra
cronjob — pianifica attività
delegation — lascia che Hermes crei sotto-agenti

Esempio: Vuoi che Hermes faccia una ricerca e salvi gli appunti in un file? Usa --toolsets "web,file" e sei a posto.

Passo 4: Strumenti Speciali (Le Gemme Nascoste)

Due extra interessanti che vale la pena conoscere:

1. Ricerca X (Twitter) — Cerca post su X, ma è disattivata di default. Servono credenziali xAI (SuperGrok o XAI_API_KEY). Attivala tramite hermes tools → 🐦 Ricerca X (Twitter).

2. Tool Gateway — Se sei un abbonato pagante di Nous Portal, ottieni ricerca web, generazione immagini, TTS e automazione browser senza chiavi API separate. Basta eseguire:

hermes model

Poi attiva i singoli strumenti con hermes tools.

Passo 5: Scegli il Backend del Terminale (Dove Vengono Eseguiti i Comandi)

Lo strumento terminal può eseguire comandi in posti diversi:

Backend	Cosa fa	Ideale per
`local`	Esegue sulla tua macchina (default)	Attività fidate, sviluppo
`docker`	Esegue in container isolati	Sicurezza, test
`ssh`	Esegue su un server remoto	Tenere l’agente lontano dal proprio codice
`singularity`	Usa container Singularity	HPC / calcolo scientifico

Consiglio per principianti: Inizia con local. Passa a docker quando sei preoccupato per la sicurezza.

Prossimo passo: ci immergeremo nel Sistema di Skill — come insegnare a Hermes nuovi trucchi che si adattano perfettamente al tuo flusso di lavoro.

Ora sai come dare a Hermes le sue “mani”. Nel prossimo articolo, ci immergeremo in come creare i tuoi strumenti personalizzati — così potrai insegnare a Hermes trucchi completamente nuovi che si adattano perfettamente al tuo flusso di lavoro.

Resta sintonizzato e buona automazione! 🚀