Skip to navigation

Condividere un agente

Chi può usarlo, chi può modificarlo, e come si lavora senza versioni

View as Markdown

Un agente appena creato è privato: esiste, lo puoi usare e provare, ma nessun altro lo vede. Condividerlo è il momento in cui il suo comportamento diventa un fatto aziendale, non più una tua configurazione.

Non c’è un pulsante «pubblica»: c’è Condividi, in alto nell’editor. Prima di premerlo, fai i controlli di Provare e mettere a punto.

Chi può fare cosa

RuoloCosa può fare
VisualizzatoreUsare l’agente in chat, aprirne la configurazione in sola lettura e vederne le statistiche
EditorAnche modificare istruzioni, conoscenza, azioni e impostazioni, eseguire i test e duplicarlo
ProprietarioAnche condividere, cambiare i ruoli degli altri ed eliminare l’agente

Nella pratica quasi tutti sono Visualizzatore: è il ruolo di chi l’agente lo usa e basta, ed è quello giusto per la maggior parte del team. Editor si dà a chi conosce il mestiere che l’agente svolge, cioè chi lo correggerà quando una procedura cambia, e conviene che siano almeno due persone, altrimenti l’agente si ferma alla prima assenza.

Condividerlo

1

Apri Condividi

Si apre il pannello con chi ha già accesso.

Il pannello Condividi di un agente: in alto la ricerca con il ruolo da assegnare accanto, sotto chi ha già accesso (il proprietario e un gruppo con il suo numero di membri) e in fondo l'accesso generale su Privato
2

Aggiungi persone o gruppi

Scrivi un nome nel campo in alto e scegli il Ruolo per i nuovi accessi. I gruppi sono la via da preferire: dài accesso a Ufficio gare invece che a sette persone, e chi entrerà nell’ufficio domani lo troverà già disponibile.

3

Decidi l'accesso generale

Sotto trovi due opzioni: Privato, dove entra solo chi hai indicato, e Chiunque nel workspace, che lo rende disponibile a tutti. La seconda è la scelta giusta per gli agenti di servizio, come policy HR o supporto IT, che è meglio se tutti trovano da soli.

4

Fallo sapere

Copia link ti dà l’indirizzo dell’agente da incollare in una chat o in un’email. Nel messaggio scrivi a cosa serve e una domanda di esempio: è quello che fa la differenza fra un agente usato e uno ignorato.

Il link non è un lasciapassare. Chi lo riceve senza avere accesso non apre l’agente: la condivisione la decidi nel pannello, non passando l’indirizzo.

Perché il pulsante è grigio

I tre livelli di condivisione non sono la stessa cosa dal punto di vista dei permessi, e questa è la causa più comune di un comando che non risponde.

LivelloCosa serve per farlo
Condividere con una personaNessun permesso particolare: lo può fare chiunque sia proprietario dell’agente
Condividere con un gruppoIl permesso di condividere agenti con i gruppi
Mettere l’accesso generale su Chiunque nel workspaceIl permesso, diverso dal precedente, di rendere un agente visibile a tutta l’area di lavoro

Il controllo scatta solo quando la condivisione si allarga. Rinominare un agente già condiviso da altri, o restringere l’accesso, non richiede niente.

Se aggiungere una persona funziona e aggiungere un gruppo no, non è un guasto: sono due permessi separati. Chiedi a chi amministra l’area di lavoro di guardare il tuo ruolo. → Ruoli e permessi

Cosa vede chi lo usa

Chi ha accesso trova l’agente nella pagina Agenti, dove un clic sulla scheda apre subito una chat, oppure lo richiama con @. Ci parla come parlerebbe in una chat normale, e la conversazione resta sua: nessuno vede i messaggi dei colleghi.

Dal menu ⋯ della scheda, Modifica agente apre la configurazione. Un Visualizzatore la vede in sola lettura, con l’etichetta Solo visualizzazione e il pulsante Avvia una chat al posto di Salva: istruzioni, conoscenza e azioni non sono nascoste a chi può usare l’agente. Tienine conto quando scrivi le istruzioni.

Anche le statistiche le vede chiunque abbia accesso all’agente, compresi i nomi delle persone che lo usano di più.

Chi amministra l’area di lavoro può inoltre assegnare il badge Verificato agli agenti approvati ufficialmente. È il segnale che distingue l’agente che l’azienda sostiene da quello che qualcuno ha costruito per sé e ha condiviso.

Cosa cambia subito e cosa no

Un agente non ha due copie, una in prova e una pubblicata: quello che salvi vale per tutti da subito, anche quando salvi solo per provare una modifica nell’Anteprima. Ma «subito» non vale per ogni campo allo stesso modo, e la differenza si vede su chi sta già parlando con l’agente in quel momento.

CampoQuando fa effetto
Nome, Istruzioni, Azioni, CreativitàDal messaggio successivo, anche nelle conversazioni già aperte
Modello, se l’agente ne ha uno specificoDal messaggio successivo: le chat con quell’agente sono bloccate sul suo modello
Modello, se l’agente è su AutoSolo dalle conversazioni nuove: quelle aperte restano sul modello con cui sono nate

Non sperimentare su un agente condiviso: non c’è un annulla, e chi ci sta parlando vede il cambiamento. Per lavorare a una versione diversa usa Duplica.

Se la modifica è sostanziale (cambia il perimetro, il tono, le azioni che l’agente può fare) dillo a chi lo usa. Un agente che da un giorno all’altro risponde in modo diverso senza spiegazioni fa perdere fiducia più di un agente che sbaglia.

Come si lavora senza versioni

Gli agenti non hanno versioni: non c’è uno storico da consultare, non c’è un ripristino, e non esiste una bozza separata da quella in servizio. Chi arriva dai workflow, dove versioni e pubblicazione esistono, se lo aspetta e non lo trova.

Il sostituto è Duplica, dal menu in alto nell’editor. Il metodo che funziona è questo.

1

Duplica prima di toccare

Ottieni una copia privata, con nome (copia), che nessuno vede e senza il badge Verificato. La copia si porta dietro la configurazione e la conoscenza, ma non i test. Da lì in poi l’originale resta fermo e continua a servire i colleghi.

2

Lavora sulla copia

Cambia istruzioni, conoscenza, azioni. Provala nell’Anteprima. I test non vengono copiati: se ti servono, ricrea sulla copia i casi più importanti.

3

Riporta le modifiche in un colpo solo

Quando la copia funziona, riscrivi i campi sull’originale in un unico salvataggio. Riportare metà configurazione e finire domani significa lasciare l’agente condiviso in uno stato che non hai mai provato.

4

Tieni la copia finché non sei sicuro

È l’unica cosa che assomiglia a un ripristino: finché la copia esiste, sai esattamente com’era la configurazione prima. Eliminala quando la nuova ha superato una settimana d’uso.

Conviene anche annotare da qualche parte cosa hai cambiato e quando: nella descrizione dell’agente, o in un documento del team. Senza uno storico, quella riga è tutto ciò che avrete fra sei mesi per capire perché l’agente risponde così.

Tenerlo in vita

Un agente lasciato a se stesso invecchia: i documenti cambiano, le procedure pure, e nessuno se ne accorge finché una risposta non fa danno. Tre abitudini bastano.

  • Dopo ogni cambio ai documenti collegati, rifai le domande chiave nell’Anteprima. È il momento in cui un agente comincia a sbagliare senza che nessuno tocchi la sua configurazione, e i test non lo vedono, perché non leggono i documenti.
  • Guarda le Statistiche una volta al mese. Conversazioni, messaggi e utenti attivi dicono se l’agente è vivo. Se non lo usa nessuno, o è inutile o dal nome non si capisce a cosa serva: nel secondo caso si risolve cambiando nome e descrizione.
  • Raccogli gli errori come casi di test. Quando un collega segnala una risposta sbagliata, quella domanda diventa un caso nella scheda Test: così non tornerà.

Quando un agente non serve più

Solo il Proprietario può eliminare un agente. Prima, controlla che non sia usato altrove: finché un workflow lo usa come nodo o nelle sue impostazioni, il comando per eliminarlo non compare, né nella scheda né nell’editor. La sezione Usato nei workflow dell’editor ti mostra dove è usato, nella bozza e nella versione pubblicata di ciascun workflow.

La sezione Usato nei workflow nell'editor: il workflow che usa l'agente, con il ruolo di Operatore nella bozza e nella versione pubblicata, e sotto la riga che avverte di togliere i riferimenti prima di poterlo eliminare

Tolti i riferimenti, dall’elenco degli agenti Elimina agente nel menu ⋯ della scheda chiede conferma: «Eliminare definitivamente l’agente…? L’azione non può essere annullata.»

Elimina nel menu ⋯ dell’editor, invece, cancella l’agente subito, senza chiedere conferma. Se vuoi una conferma prima di perdere l’agente, usa l’elenco.

Se l’agente serviva e serve ancora ma tu cambi ruolo, non eliminarlo: passa il ruolo di Proprietario a chi lo erediterà, prima di lasciare il team. Un agente senza nessuno che lo manutenga continua a rispondere, ed è il modo più silenzioso di diffondere informazioni superate.