Strumenti dell'agente

NoTrack Coder trasforma la risposta del modello in azioni analizzando i tag degli strumenti che emette ed eseguendoli sul tuo computer. Non chiami tu stesso gli strumenti — lo fa il modello — e vedi ognuno di essi come una scheda. Questo è l'intero set di strumenti.

File

• read_file — legge il contenuto di un file.
• write_file — crea o sovrascrive un file.
• append_file — aggiunge alla fine di un file.
• edit_file — sostituisce una parte specifica di testo in un file.
• delete_file, make_dir, move_file, copy_file — le solite operazioni sui file.
• list_dir, grep, glob — elenca una directory, cerca nel contenuto dei file, trova corrispondenze per pattern.

Tutti i percorsi si risolvono dentro la cartella di lavoro della chat a meno che non siano assoluti.

Shell

• shell — esegue un comando. Su Windows la shell è PowerShell. Puoi comunque scrivere i comuni idiomi Unix — NoTrack Coder li traduce al volo: && di primo livello → ;, -o /dev/null → NUL, 2>/dev/null → $null (solo fuori dalle virgolette, così un ssh "… && …" remoto resta intatto). Il successo viene giudicato dal reale codice di uscita del processo, quindi un curl che ha ottenuto un 200/403 scrivendo su stderr non viene segnalato come errore (niente più ritentativi inutili). I comandi pericolosi (cancellazione forzata ricorsiva, azzeramento del disco, invio di script remoti a una shell) vengono bloccati, e quelli rischiosi chiedono conferma in modalità Chiedi.

I segreti nell'output degli strumenti (chiavi private, password .env, token bearer) vengono automaticamente oscurati prima di raggiungere il contesto del modello.

Web

• web_search — cerca in due fonti in parallelo e restituisce entrambe, etichettate: DuckDuckGo (web generale) e freeserp.ai (un indice senza chiave di siti recenti / costruiti con IA, ciascuno con un Domain Rating). Il modello sceglie da solo il/i risultato/i rilevante/i.
• http_get — recupera il contenuto di un URL.

Media e documenti

• gen_image — genera un'immagine reale nella cartella della chat — vedi Generazione di immagini.
• ocr — legge il testo da un'immagine usando l'OCR integrato di Windows.

Orchestrazione

• task — avvia un sub-agente parallelo per un'attività autonoma.
• run_on_model — affida un'attività a un altro modello/endpoint collegato (ad es. instrada un passaggio difficile verso un modello più grande).
• skill — carica un playbook SKILL.md su richiesta.
• mcp — chiama uno strumento esposto da un connettore MCP collegato (vedi Connettori).
• list_capabilities — elenca i modelli collegati e cosa sanno fare.

Conoscenza e memoria

• search_knowledge — cerca nella base di conoscenza locale (sessioni passate + note distillate).
• remember — salva un fatto in memoria. Viene eseguito solo quando chiedi esplicitamente all'agente di ricordare qualcosa.

Perché a volte vedi dei ritentativi

I modelli più deboli (non censurati / a bassa quantizzazione) a volte usano male uno strumento — sintassi del tag sbagliata, comandi Unix su Windows, o una risposta troppo lunga che viene tagliata. Le protezioni di NoTrack Coder le intercettano, correggono il modello e riprovano, così l'attività si completa comunque — solo con qualche scheda di correzione visibile in più. Un modello più forte produce esecuzioni più pulite.

Prossimo: Endpoint e modelli.