Strumenti
Cosa sono gli strumenti e come conferiscono capacita ai tuoi agenti.
Cos'e uno strumento
Uno strumento (tool) e una capacita che assegni al tuo agente affinche possa eseguire azioni durante una conversazione. Senza strumenti, l'agente puo solo conversare. Con gli strumenti, puo cercare dati, generare report, inviare messaggi, collegarsi a sistemi esterni e molto altro.
Tipi di strumenti
| Tipo | Descrizione | Esempio |
|---|---|---|
| Query (Interrogazione) | Cerca informazioni nelle tue collezioni di dati | Cercare un'apparecchiatura per numero di serie, consultare lo storico di un cliente |
| Action (Azione) | Esegue funzioni all'interno del tuo sistema | Generare un report PDF, assegnare un'attivita, localizzare il personale |
| HTTP | Si collega ad API esterne e servizi web | Chiamare un'API REST, consultare un servizio esterno |
Creare uno strumento
- Vai su Strumenti nella barra laterale.
- Clicca su Crea Tool.
- Completa la configurazione:
| Campo | Descrizione |
|---|---|
| Nome | Identificativo univoco (senza spazi, es: buscar_equipo) |
| Descrizione | Spiega cosa fa lo strumento. L'agente usa questa descrizione per decidere quando utilizzarlo. Include un pulsante Ottimizza con IA |
| Tipo | Interrogazione (Query), Azione (Action) o HTTP |
| Parametri | Dati che l'agente richiede all'utente per eseguire lo strumento |
| Messaggi | Messaggi di risposta configurabili: successo, errore e fallback |
| Async | Toggle per eseguire lo strumento in modo asincrono |
Nome e descrizione
Il nome e l'identificativo tecnico che l'agente usa internamente. Deve iniziare con una lettera e puo contenere solo lettere, numeri, trattini e underscore.
La descrizione e fondamentale: l'agente la legge per decidere quando usare lo strumento. Scrivi una descrizione chiara e specifica. Puoi usare il pulsante Ottimizza con IA per migliorarla automaticamente.
Parametri
I parametri definiscono quali informazioni l'agente deve chiedere all'utente prima di eseguire lo strumento. Ogni parametro ha:
- Nome — Identificativo del parametro (es:
serial_number) - Tipo — string, number, boolean
- Descrizione — Cosa rappresenta questo dato
- Obbligatorio — Se l'agente deve ottenerlo necessariamente
Messaggi di risposta
Ogni strumento ha tre messaggi configurabili che l'agente usa per comunicare il risultato all'utente:
| Messaggio | Quando viene utilizzato |
|---|---|
| Successo | Quando lo strumento viene eseguito correttamente |
| Errore | Quando si verifica un errore durante l'esecuzione |
| Fallback | Quando non si ottengono risultati o la risposta e vuota |
Esecuzione asincrona
Il toggle Async permette che lo strumento venga eseguito in background senza bloccare la conversazione. Utile per operazioni che possono richiedere piu tempo, come chiamate HTTP lente o generazione di report.
Assegnare strumenti a un agente
Gli strumenti si assegnano durante la creazione o la modifica di un agente (WhatsApp o email). Un agente puo avere piu strumenti assegnati.
L'agente decide automaticamente quando usare ogni strumento basandosi sulla conversazione e sulla descrizione dello strumento.
Suggerimento automatico dei parametri
Quando crei uno strumento di tipo Interrogazione dati, puoi usare la funzione di suggerimento automatico. Selezionando una collezione, il sistema suggerisce automaticamente:
- Nome descrittivo per lo strumento
- Descrizione contestuale
- Parametri basati sui campi della collezione
Questo accelera la creazione e assicura che i parametri corrispondano ai dati disponibili.