Asteria Docs
Agenti

Condividere un agente

Dare un agente a un collega, pubblicarlo nella tua organizzazione e i due avvertimenti che vale la pena leggere.

Tre livelli, in ordine crescente di portata.

1. Condividere con persone specifiche

Gestisci accanto a Condivisione nel costruttore, oppure l'icona di condivisione sulla scheda dell'agente. È la normale finestra di condivisione: persone specifiche come Visualizzatore o Editor, oppure l'intera organizzazione.

Un Visualizzatore può usare l'agente. Un Editor può riscriverne le istruzioni e cambiarne gli strumenti.

Se il tuo agente usa raccolte che i destinatari non possono vedere, per loro l'agente non funzionerà: cercherà in documenti a cui non hanno accesso e non troverà niente, in silenzio.

Asteria se ne accorge e propone di condividere anche le raccolte. Accetta la proposta.

2. Pubblicare sul marketplace

Pubblica sul marketplace nel costruttore mette l'agente nella libreria della tua organizzazione, dove qualsiasi membro può trovarlo sotto Sfoglia e aggiungerlo al proprio elenco.

Due cose da capire prima di farlo:

Gira con la loro identità, non con la tua. Quando un collega usa il tuo agente pubblicato, questo agisce con i suoi permessi e i suoi account collegati. Non può raggiungere niente che lui non potrebbe raggiungere da solo.

Lo pagano loro. Il costo di esecuzione dell'agente viene addebitato a chi lo invoca, non a te.

Cosa può bloccare la pubblicazione

Strumenti MCP personali. Se il tuo agente usa uno strumento che viene da una connessione tua personale, la pubblicazione è bloccata: nessun altro può usarlo. Rimuovi lo strumento, oppure chiedi al tuo amministratore di configurarne l'equivalente come connessione a livello di organizzazione.

Su cosa verrai avvisato

Due avvisi che devi confermare, ed entrambi descrivono guasti che altrimenti i tuoi colleghi incontrerebbero durante l'uso:

Un sotto-agente che non tutti possono usare. I membri che invocano il tuo agente ricevono un errore quando prova a delegare.

Una raccolta fissata che non tutti possono vedere. Peggio, perché fallisce in silenzio: le ricerche non restituiscono niente, e l'agente risponde dalla conoscenza generale come se la raccolta fosse vuota. Nessuno riceve un errore. Ottengono solo una risposta peggiore e nessuna spiegazione.

Se vedi il secondo avviso, sistema la condivisione della raccolta prima di pubblicare, invece di limitarti a confermarlo.

Prima di confermare ottieni un'anteprima della scheda del marketplace.

3. Duplicazione

Per impostazione predefinita, chi trova il tuo agente può Duplicarlo: ottiene una copia propria e modificabile, e da lì in poi le due non hanno più niente in comune. La tua non eredita le sue modifiche e la sua non eredita le tue.

Puoi disattivare la duplicazione nella finestra di condivisione se vuoi che ci sia una sola versione canonica usata da tutti.

Quando qualcuno duplica un agente che punta a risorse a cui non ha accesso, quelle vengono saltate e gli viene detto quante sono.

Rimuovere dalla pubblicazione

Rimuovi dalla pubblicazione toglie l'agente dal marketplace e revoca la voce di libreria di ogni membro. Chi lo stava usando lo perde.

Le copie che le persone si sono fatte duplicando sono loro e non ne risentono, ed è l'argomento pratico per disattivare la duplicazione su qualsiasi cosa che potresti dover ritirare.

Segnalazioni

Qualsiasi membro può Segnalare un agente pubblicato ai tuoi amministratori, con una motivazione. Gli amministratori vedono la coda e o rimuovono l'agente dalla pubblicazione o ignorano la segnalazione.

Usalo per un agente che dà risposte sbagliate o inappropriate, non per uno che semplicemente non ti piace.

Tenere in vita un agente condiviso

La sezione Utilizzo mostra gli usi diretti, gli utenti unici, quando è stato invocato l'ultima volta e quante persone ne hanno fatto un fork.

Gli agenti pubblicati marciscono. La guida di stile cambia, il prodotto viene rinominato, il tono si sposta. Se l'utilizzo sale, l'agente è importante e vale la pena mantenerlo. Se è piatto da mesi, rimuovilo dalla pubblicazione invece di lasciarne uno stantio che un nuovo arrivato troverà e a cui darà fiducia.

Se Pubblica sul marketplace è disattivato, il tuo amministratore ha spento il marketplace degli agenti per la tua organizzazione. La condivisione con persone specifiche funziona comunque.

On this page