Skip to navigation

Creare il primo agente

Il percorso completo, dalla creazione alla condivisione
View as Markdown

Un agente è un assistente configurato una volta per un compito che si ripete: sa chi è, su quali documenti si basa, cosa può fare e come deve rispondere. Chi lo usa non deve sapere com’è fatto: lo richiama con @ e comincia a chiedere.

La differenza con la chat normale è che l’agente non dimentica il suo mestiere. Non gli devi rispiegare ogni volta il contesto, le fonti da citare e il tono da tenere.

Da dove si parte

Apri Agenti dalla barra laterale. Qui trovi quelli già disponibili per te, filtrabili per ambito, e i comandi per crearne uno nuovo.

La pagina Agenti: in alto Sfoglia i template e il pulsante Crea agente con la freccia accanto, sotto i filtri per ambito, il riquadro Parti da un template e le schede degli agenti

Prima di aprire l’editor, mettiti d’accordo con te stesso su una frase: «Questo agente serve a ___ , per ___ .» Se non riesci a completarla, il problema non è la configurazione: vedi Quando serve un agente.

Le vie per crearlo sono tre e arrivano tutte allo stesso editor. Parti con l’AI se hai in mente il compito ma non sai ancora come scrivere le istruzioni, a mano se sai già cosa mettere in ogni campo, da un template se il tuo caso somiglia a uno degli esempi pronti.

Con l’AI

1

Premi Crea agente

Si apre la schermata Crea il tuo agente con l’AI. Ci porta anche la scheda Nuovo agente, in fondo all’elenco degli agenti.

La schermata Crea il tuo agente con l'AI: il campo in cui descrivere l'agente con il modello che fa il lavoro, e sotto Prova con un esempio con quattro descrizioni pronte
2

Descrivi cosa deve fare

Scrivi il compito in due o tre frasi e invia, oppure clicca uno degli esempi sotto Prova con un esempio. Si apre l’editor, e i campi a sinistra si compilano sotto i tuoi occhi.

L'editor mentre l'AI lavora: a sinistra il nome già scritto e il cursore che sta compilando la descrizione, in basso L'AI sta lavorando, a destra la richiesta e i passaggi del ragionamento
3

Rileggi quello che ha scritto

Controlla soprattutto le istruzioni: la parte su cosa l’agente non deve fare la conosci solo tu. Poi completa i campi come spiegato più sotto, in Costruirlo.

L'editor a lavoro finito: nome, descrizione e istruzioni compilati a sinistra, a destra il messaggio dell'AI che invita a rifinire un campo o ad aprire l'Anteprima, e in alto il pulsante Crea

A mano

1

Apri la freccia accanto a Crea agente

Si apre un menu con due voci: Crea con l’AI e Crea manualmente.

Il menu della freccia accanto a Crea agente, con Crea manualmente evidenziato sotto Crea con l'AI
2

Scegli Crea manualmente

Si apre l’editor vuoto e compili tu ogni campo, come spiegato più sotto, in Costruirlo. Se sei già nella schermata dell’AI, Vai all’editor in alto a destra porta allo stesso punto.

L'editor di un agente nuovo con i campi vuoti a sinistra e a destra la scheda Crea con l'AI, pronta se vuoi farti aiutare su un campo

Da un template

1

Premi Sfoglia i template

Si apre la galleria Template di agenti: otto agenti di esempio, divisi per categoria (Supporto, Vendite, Marketing, HR, Dati, Ingegneria, Produttività, Ricerca), con la ricerca Cerca template. Ci arrivi anche da Vedi tutti → nel riquadro Parti da un template.

La galleria Template di agenti: la ricerca Cerca template, le categorie in fila e le schede dei template con nome, categoria e descrizione
2

Clicca un template

Si apre l’Anteprima template, con le Istruzioni e i Messaggi di partenza che l’agente avrà.

L'Anteprima template di un agente di esempio: descrizione, istruzioni e messaggi di partenza, e in basso il pulsante Usa questo template evidenziato
3

Premi Usa questo template

Si apre l’editor con i campi già compilati. L’agente però non esiste ancora: lo diventa quando premi Crea, e fino a quel momento puoi cambiare tutto. I nomi dei template nel riquadro Parti da un template portano qui direttamente, senza passare dalla galleria.

Dalla pagina Agenti si apre la galleria dei template, si sceglie un template, se ne legge l'anteprima e Usa questo template apre l'editor con nome, descrizione e istruzioni già scritti
4

Adattalo al tuo caso

Un template è un punto di partenza generico: riscrivi almeno le istruzioni con le regole del tuo caso, poi prosegui da Costruirlo, qui sotto.

Costruirlo

1

Dagli un nome, un'icona e una descrizione

Il nome lo vedranno i colleghi in un elenco: Assistente gare d’appalto è più utile di Agente Marco. L’icona serve a riconoscerlo a colpo d’occhio, la Descrizione compare nella chat e spiega in una riga a cosa serve.

La parte alta dell'editor: l'icona dell'agente, che si cambia cliccandola, e sotto i campi Nome e Descrizione già compilati
2

Scrivi le istruzioni

È il campo che determina la qualità di tutto il resto: chi è l’agente, cosa fa, cosa non deve fare, come risponde.

Il campo Istruzioni con il testo dell'agente, e sotto Ottimizza e il pulsante per ingrandire il campo

→ Scrivere istruzioni efficaci

3

Aggiungi le frasi di avvio

Sono gli esempi che compaiono a chi apre una chat con l’agente, come pulsanti da cliccare. Scrivine una per riga: finita una, sotto ne compare un’altra, fino a 12. Due o tre bastano, e servono più di quanto sembri: sono il modo più rapido per far capire cosa si può chiedere e cosa no.

Le frasi di avvio scritte una per riga, il contatore in alto a destra e il campo vuoto pronto per la successiva: sono richieste complete, non parole chiave
4

Dagli la conoscenza

Nel riquadro Knowledge premi Allega: puoi caricare file dal computer oppure collegare una base di conoscenza della Libreria. Da quel momento l’agente cerca lì dentro quando la domanda lo richiede e cita da dove ha preso l’informazione.

Il riquadro Knowledge ancora vuoto, con il pulsante Allega evidenziato

→ Dare conoscenza a un agente

5

Collega le azioni

Se deve fare qualcosa oltre che rispondere, come aprire un ticket, mandare un’email o cercare in un gestionale, usa Aggiungi azione.

Il riquadro Azioni con la Ricerca web già collegata e il pulsante Aggiungi azione evidenziato

→ Collegare azioni

6

Scegli modello e creatività

Auto va bene per quasi tutto. La Creatività conviene tenerla intorno a 0.3 quando l’agente ha documenti allegati e deve attenersi a quelli, e più alta quando il suo lavoro è scrivere.

Il Modello su Auto e il cursore della Creatività portato su 0.3, verso l'estremo Deterministico
7

Premi Crea

Il pulsante sta in alto a destra. Compare «Modifiche salvate.», resti nell’editor e da qui in poi il pulsante diventa Salva. L’agente esiste, ma resta privato: nessun collega lo vede finché non lo condividi.

Anche il primo messaggio che mandi nell’Anteprima crea l’agente, se non l’avevi ancora fatto.

La barra in alto nell'editor di un agente nuovo: il pulsante Crea evidenziato a destra, accanto a Schedula e Condividi ancora spenti
8

Provalo prima di condividerlo

Usa l’Anteprima e fagli le domande che gli farebbero i colleghi, comprese quelle a cui non dovrebbe saper rispondere.

La scheda Anteprima nella colonna di destra dell'editor: il saluto dell'agente, le frasi di avvio come pulsanti e il campo di scrittura in basso

→ Provare e mettere a punto

9

Condividilo

Con una persona, con un gruppo o con tutta l’area di lavoro, scegliendo chi può solo usarlo e chi può modificarlo.

→ Condividere un agente

L’editor, in due colonne

A sinistra c’è la configurazione, a destra due schede che lavorano sulla stessa cosa da due angoli diversi.

L'editor di un agente nuovo: in alto le schede Configurazione, Statistiche e Test e il pulsante Crea; a sinistra nome, descrizione, tipo di agente e istruzioni; a destra l'Anteprima, dove le frasi di avvio compaiono già come pulsanti
SchedaA cosa serve
Crea con l’AIDescrivi a parole cosa deve fare l’agente e i campi a sinistra si compilano sotto i tuoi occhi. Puoi anche chiedere una correzione mirata: «tono più formale», «aggiungi la ricerca web». Puoi scegliere il modello che fa il lavoro
AnteprimaUna chat di prova con l’agente. I messaggi non vengono salvati. Usa agente apre una chat vera in una nuova scheda del browser

In alto trovi le tre schede dell’agente: Configurazione, Statistiche e Test. Le ultime due diventano disponibili dopo il primo salvataggio, come i pulsanti Schedula e Condividi.

Partire da Crea con l’AI è il modo più rapido per avere una bozza ragionevole in un minuto. Rileggi però sempre le istruzioni che ha scritto: la parte su cosa l’agente non deve fare la conosci solo tu.

Le impostazioni che si dimenticano

CampoPerché guardarlo
Al superamento dei limitiDecide cosa succede quando l’agente esaurisce il budget d’uso: passare a un modello di base o mettersi in pausa
EtichetteServono a ritrovarlo e a filtrarlo quando gli agenti diventano venti. Al massimo tre
Modalità agenteUso interno per i colleghi dentro Userbot, Customer Service se deve parlare con i clienti sui canali esterni. Compare solo se il Customer Service è attivo nell’area di lavoro e hai il permesso di creare agenti di quel tipo
Tipo di agenteSemplice copre quasi tutti i casi. Multi-Agente non ha istruzioni proprie: orchestra un workflow
Tipo di inputPrompt è la chat normale. Form fa compilare dei campi prima di partire
SchedulaFa lavorare l’agente da solo a orari fissi, con un’attività schedulata

L’elenco completo, con i limiti di ciascun campo e cosa succede quando li superi, sta in Tutti i campi di un agente.

Come lo useranno i colleghi

Chi ha accesso all’agente lo trova in tre punti: nella pagina Agenti, dove un clic sulla scheda apre subito una chat, scrivendo @ nel campo della chat, e nell’elenco delle conversazioni recenti una volta che ci ha parlato. Ogni conversazione con l’agente resta privata di chi l’ha aperta: si vedono le statistiche d’uso, non i messaggi.

Se non vedi Crea agente, e con lui Sfoglia i template, il riquadro dei template e la scheda Nuovo agente, chi amministra l’area di lavoro ha riservato la creazione degli agenti a certi ruoli. Puoi comunque usare quelli che ti hanno condiviso.