Creare un agente
Questa pagina descrive i primi passi del wizard di creazione di un agente: informazioni generali, scelta del provider e del modello, parametri di generazione e salvataggio. Le altre sezioni della configurazione (system prompt, Knowledge Base, server MCP, handoff, output strutturato) sono descritte nelle rispettive pagine, collegate al termine di questa.
Prerequisiti
- Permesso di creazione agenti sul tenant.
- Se si prevede di collegare una Knowledge Base fin da subito, una KB già creata (vedere Le Knowledge Base).
Informazioni generali
Nel primo passo del wizard si indicano:
- Nome agente (obbligatorio, massimo 100 caratteri);
- Descrizione, utile per distinguere agenti simili nell'elenco;
- Agente padre (opzionale) — se selezionato, l'agente eredita il system prompt e i server MCP del padre secondo le regole descritte in Gli agenti conversazionali.
Scelta del provider e del modello
Ogni agente utilizza un provider e un modello linguistico specifico, selezionabile da un catalogo che indica anche la fascia di costo (Free/Budget/Mid/Premium) di ciascuna opzione. Il catalogo effettivamente proposto dipende dal piano del tenant: i piani con accesso limitato mostrano solo le fasce incluse.
Per il dettaglio del catalogo, dei costi per token e delle catene di fallback tra modelli vedere Modelli LLM e provider.
Parametri del modello
- Temperature — valori bassi (0,0-0,3) producono risposte più precise e ripetibili, valori alti (0,7-1,0) risposte più creative e variabili;
- Top P e Max Tokens — regolano rispettivamente la diversità lessicale e la lunghezza massima della risposta;
- Reasoning — per i modelli che lo supportano compare il toggle Abilita Reasoning con il relativo Reasoning Effort (Minimo/Basso/Medio/Alto): valori più alti aumentano la qualità del ragionamento a scapito della latenza e del consumo di crediti.
Salvare e attivare
L'agente viene salvato in stato Bozza al termine del wizard, indipendentemente da quali sezioni siano già state compilate. Per attivarlo:
- Completare almeno il system prompt (vedere System prompt e istruzioni).
- Aprire il dettaglio dell'agente e impostare lo stato su Attivo.
- Facoltativo ma consigliato: verificare il comportamento con una conversazione di prova (vedere Provare un agente) prima di renderlo disponibile ai canali di produzione.
Risultato atteso
L'agente compare nell'elenco con lo stato scelto. In stato Attivo è immediatamente selezionabile in Chat e utilizzabile dai canali collegati (Askme Chat, API).
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'attivazione viene rifiutata | System prompt vuoto | Compilare il system prompt prima di cambiare stato |
| Il modello desiderato non compare nel catalogo | Il piano del tenant non include quella fascia di costo | Verificare il piano in Modelli LLM e provider o richiedere l'aggiornamento del piano |
| Le risposte sono troppo generiche o troppo estrose | Temperature non adeguata al caso d'uso | Abbassare la temperature per risposte più aderenti alle istruzioni, alzarla per maggiore varietà |