Agenti

Strumenti dell'agente

Scegli gli strumenti che un agente AI può chiamare in FlowHunt AI Studio, collega i server MCP e risolvi il problema di uno strumento che richiede un account.

Open in ChatGPT Open in Claude

Gli strumenti sono il modo in cui un agente agisce sul mondo invece di limitarsi a rispondere a parole. Durante una conversazione l’agente decide se chiamare uno strumento, in base alla descrizione dello strumento e al tuo messaggio di sistema. Nel builder, gli strumenti si trovano nella sezione Apps della scheda Preferences.

Inizia in piccolo

Assegna a un agente solo gli strumenti necessari al suo compito. Meno strumenti lo rendono più veloce e più facile da prevedere.

Cosa ha un nuovo agente#

Un nuovo agente parte con tre strumenti:

Rimuovi quelli che non ti servono.

Aggiungere uno strumento#

  1. In Apps, clicca Add app. Se non ci sono ancora app, la sezione mostra No apps yet e lo stesso pulsante.
  2. Nella finestra di dialogo, l’interruttore in alto ha due origini: Use FlowHunt tools e Connect your MCP.
  3. Con Use FlowHunt tools, cerca con Search tools… e scegli uno strumento. Nel builder dell’agente la finestra di dialogo si apre con il filtro Connected attivo, quindi la lista inizia con gli strumenti che il tuo workspace può già raggiungere. Clicca Connected per disattivare il filtro e vedere gli altri.
  4. Per gli strumenti con parametri, il passaggio Configure Tool ti permette di decidere per ogni parametro se è l’AI a definirlo (AI Decides) o se lo fissi tu (User-defined). Un parametro che blocchi non è modificabile dall’agente. Scegli Skip & Add per mantenere i valori predefiniti oppure Add with Config per usare i tuoi valori.

Ogni app appare come una riga con i suoi strumenti, uno stato e un menu a tre punti chiamato App actions. Usa Remove app per rimuoverla di nuovo.

Rinominare uno strumento per l’agente#

In Advanced Settings, nella configurazione dello strumento, puoi sovrascrivere il Tool Name e la Tool Description che l’agente vede. Fallo quando aggiungi lo stesso strumento due volte per compiti diversi. Il nome accetta lettere, numeri e underscore, e FlowHunt richiede un nome distinto quando due strumenti entrerebbero in conflitto. La descrizione è la tua occasione per dire “Usa questo strumento quando…”.

Collegare un server MCP#

Scegli Connect your MCP nella finestra di dialogo per aggiungere un server Model Context Protocol. Tutti i server MCP di un agente sono raccolti insieme in una sola voce MCP Client. La riga di un server mostra uno stato:

  • Connected: il server è configurato e pronto.
  • Authorized: hai effettuato l’accesso con OAuth.
  • Connect: il server richiede credenziali. Usa Configure connection.

Per ospitare i tuoi server, vedi server MCP ospitati.

Risolvere uno strumento che richiede un account#

La riga di uno strumento contrassegnata con Connect richiede un’integrazione. Cliccala per aprire la finestra di dialogo di connessione, accedi e lo stato passa a Connected. Vedi collegare gli account.

Se qualcosa va storto#

  • Se l’agente non usa mai uno strumento, menzionalo per nome nel System Message e rendi specifica la descrizione dello strumento.
  • Se uno strumento fallisce durante un’esecuzione, la causa è di solito un account scollegato. Vedi integrazione scollegata.

Passaggi successivi#

Preferences Scrivi il messaggio di sistema che indica all’agente quando usare i suoi strumenti. Usare le integrazioni Collega i servizi su cui un agente può agire.