Gli Strumenti permettono di estendere le capacità di un agente IA, abilitando l'accesso a funzioni avanzate come la consultazione di sistemi interni, l'esecuzione di validazioni, l'ottenimento di informazioni dinamiche o l'esecuzione di azioni specifiche all'interno del tuo business.
Mentre le Conoscenze forniscono informazioni statiche, gli Strumenti permettono all'agente di agire, consultare o elaborare dati in tempo reale.
Questa guida spiega come crearli, configurarli e gestirli.
1. Cos'è uno strumento?
Uno strumento è una funzione personalizzata che l'agente può invocare quando lo ritiene necessario per risolvere una richiesta dell'utente.
Queste funzioni possono essere semplici (es: validare un numero d'ordine) o complesse (es: consultare un inventario con logica di business applicata).
Ogni strumento è composto da:
Una definizione di base: nome, descrizione, etichetta, stato.
Parametri: che aiutano l'agente a inviare informazioni allo strumento.
Codice avanzato: che contiene la logica dello strumento.
2. Creare un nuovo strumento
Per creare uno strumento, vai al modulo Agenti → Strumenti → Crea nuovo strumento. Vedrai la seguente struttura:
Configurazione base
Questa sezione definisce l'identità e lo scopo dello strumento.
Nome dello strumento: deve essere chiaro e descrittivo.
Esempi: "Consulta Inventario", "Verifica Stato Ordine", "Calcola Costo Spedizione".
Descrizione: spiega in linguaggio naturale cosa fa. L'agente userà questa descrizione per decidere quando richiamare lo strumento.
Esempio: "Restituisce lo stato dell'ordine in base all'ID inserito dall'utente."
Etichetta: serve per organizzare logicamente gli strumenti (es: "Ordini", "Inventario", "Pagamenti").
Strumento attivo: permette di abilitare o disabilitare lo strumento senza eliminarlo.
Parametri
I parametri sono i dati che l'agente deve inviare allo strumento quando lo utilizza.
Esempi tipici:
idOrdine,emailCliente,skuProdotto,importoTotale.Ogni parametro include: Nome, Descrizione e Tipo (testo, numero, booleano).
L'agente usa queste informazioni per strutturare la chiamata in modo corretto.
Impostazione avanzata (Codice)
Qui si definisce la logica reale dello strumento. È un blocco di codice che viene eseguito quando l'agente invoca la funzione. All'interno di questo codice puoi:
Connetterti ad API interne.
Elaborare dati.
Validare informazioni.
Restituire risultati strutturati.
Il risultato restituito dallo strumento è ciò che l'agente utilizzerà successivamente per rispondere all'utente.