Gli agenti conversazionali
Un agente è la configurazione completa che determina come Askme AI risponde in una conversazione: il modello usato, le istruzioni che ne guidano il comportamento, le basi di conoscenza consultate, i connettori da cui può usare strumenti esterni, le condizioni di passaggio a un operatore e le policy di guardrail che gli si applicano. Ogni organizzazione può creare più agenti, ciascuno pensato per un caso d'uso o un canale specifico.
Che cos'è un agente
Un agente riunisce in un'unica configurazione un modello, scelto tra quelli che l'amministratore ha reso disponibili all'organizzazione, e le istruzioni in linguaggio naturale che ne definiscono tono, competenze e limiti. A questi elementi si aggiungono, quando servono, una o più basi di conoscenza consultate per rispondere con fonti verificabili, uno o più connettori che mettono a disposizione strumenti esterni, le regole di passaggio a operatore e le policy di guardrail dell'organizzazione.
L'agente è l'oggetto che i canali invocano per generare una risposta: Askme Chat, le integrazioni via API e l'anteprima della console usano tutti la stessa configurazione.
L'elenco degli agenti
La voce Agenti del menu laterale apre la pagina Agenti AI, con l'elenco degli agenti dell'organizzazione. Per ciascun agente la tabella riporta Nome (con icona e descrizione), Modello, Conoscenza (le basi collegate), Stato e Ultima modifica. Il campo di ricerca e i filtri per nome, stato e modello restringono l'elenco; selezionando una riga si apre la pagina dell'agente.
Quando si arriva all'elenco dalla pagina di una base di conoscenza, la tabella mostra solo gli agenti che la usano e in alto compare il filtro Filtrati per conoscenza, che si rimuove con l'apposita icona.
Il pulsante Nuovo agente avvia la creazione di un agente (vedere Creare e configurare un agente); è visibile solo a chi ha il permesso di creare agenti.
Gli stati
| Stato | Significato |
|---|---|
| Bozza | Configurazione in corso. Ogni agente nasce in questo stato, l'unico in cui le istruzioni possono restare vuote |
| Attivo | Agente pubblicato e pronto per i canali che lo usano |
| In pausa | Agente sospeso: risponde con il messaggio di indisponibilità e la configurazione resta intatta |
| Archiviato | Agente ritirato dalle liste operative; le conversazioni passate restano consultabili |
Il passaggio ad Attivo richiede istruzioni compilate. Solo un agente attivo può essere messo in pausa, e un agente archiviato non può tornare direttamente attivo: occorre prima riportarlo in Bozza. Le modalità per cambiare lo stato sono descritte in Creare e configurare un agente.
La pagina dell'agente
La creazione e la modifica avvengono nella stessa pagina. A sinistra si trovano le sezioni della configurazione, ciascuna in un riquadro che si apre e si chiude selezionandone il titolo; a destra il pannello Navigazione elenca le sezioni, evidenzia quella che si sta leggendo e, con un clic su una voce, la apre e la porta in vista, mentre sotto di esso il pannello Anteprima chat consente di provare l'agente senza lasciare la pagina (vedere Anteprima chat). Accanto alla voce Conoscenza il pannello riporta il numero di basi collegate, e il titolo Navigazione chiude e riapre l'elenco, che su una finestra di altezza ridotta parte chiuso. Per lasciare più spazio a entrambe le colonne, il menu laterale viene compresso.
L'intestazione riunisce l'icona dell'agente, il nome e la descrizione, modificabili direttamente nel titolo, l'indicatore di salvataggio, il selettore dello stato e il menu Altre azioni. Non esiste un pulsante di salvataggio: ogni modifica viene salvata automaticamente.
Chi può consultare gli agenti ma non modificarli vede la stessa pagina in sola lettura: i campi non sono modificabili, mentre restano disponibili l'anteprima e l'esportazione del codice.
Le sezioni di configurazione
Le sezioni sono pieghevoli. All'apertura della pagina è espansa solo Istruzioni; le altre mostrano nell'intestazione un riepilogo del loro contenuto, ad esempio il modello scelto o il numero di basi collegate, così da leggere la configurazione senza aprirle tutte.
| Sezione | Contenuto | Pagina |
|---|---|---|
| Istruzioni | Prompt di sistema, inserimento dei template con «@», variabili | Istruzioni dell'agente |
| Modello | Provider, modello, lunghezza massima della risposta, temperatura, ragionamento | Creare e configurare un agente |
| Conoscenza | Basi di conoscenza collegate, istruzioni di riformulazione della domanda, passaggi nel contesto e ricerca autonoma nella conoscenza | Conoscenza dell'agente (RAG) |
| Strumenti e connettori | Connettori da cui l'agente usa strumenti esterni | Server MCP |
| Passaggio a operatore | Condizioni di passaggio, intenti personalizzati, messaggi di rifiuto | Passaggio a operatore (handoff) |
| Guardrail | Policy dell'organizzazione applicate all'agente | Guardrail |
| Avanzate | Risposte conformi a uno JSON Schema | Output strutturato |
La sezione Guardrail è visibile solo a chi ha il permesso di consultare le policy di guardrail; la scelta delle policy per l'agente è descritta nella pagina Guardrail.