Autorizzazioni, approvazioni e bozze | ElevenLabs Documentation

Come si autentica ElevenAgents Architect

Architect non usa un account di servizio separato né agisce con un’identità diversa. Nella dashboard di ElevenLabs, i suoi strumenti vengono eseguiti nel tuo browser, all’interno della sessione in cui hai effettuato l’accesso. Ogni operazione di lettura o scrittura che esegue, dal recupero della configurazione di un agente alla creazione di un branch, è una normale richiesta effettuata a tuo nome, con le autorizzazioni del tuo workspace.

Questo comporta tre conseguenze:

Architect può fare solo ciò che puoi fare tu. Se non puoi modificare un agente, Architect può leggerlo ma non può preparare modifiche. Se il tuo ruolo non consente il merge in un branch protetto, Architect non può eseguire il merge neanche lì.
Il suo lavoro viene registrato a tuo nome. Le versioni che pubblichi, i branch e le proposte di merge create da Architect mostrano te come autore. Nulla indica che siano stati creati da Architect.
Utenti diversi ottengono risultati diversi. Due membri del team che chiedono ad Architect la stessa modifica possono ottenere risultati diversi se i loro ruoli sono differenti.

Questa pagina descrive Architect nella dashboard di ElevenLabs, che è l’unico ambiente in cui Architect viene eseguito oggi. Architect arriverà anche su altre superfici, come Slack, ma non è ancora disponibile. In ogni superficie, Architect manterrà lo stesso modello: si autentica come la persona con cui sta parlando e agisce con le autorizzazioni di quella persona.

Cosa consente ogni ruolo

I ruoli di accesso agli agenti si applicano ad Architect esattamente come si applicano a te nella dashboard.

Il tuo accesso all’agente	Cosa può fare Architect per te
Visualizzatore	Leggere configurazione, conversazioni, test, branch e proposte. Analizzare e consigliare modifiche, ma non prepararle.
Editor	Tutto ciò che può fare un visualizzatore, oltre a preparare modifiche nelle bozze, creare branch, scrivere ed eseguire test, aprire proposte di merge ed eseguire il merge in branch non protetti.
Amministratore del workspace	Tutto ciò che può fare un editor, oltre a eseguire il merge in branch protetti e modificare la quota di traffico dei branch protetti.

Le risorse a livello di workspace, come strumenti, documenti della knowledge base e test, seguono le rispettive autorizzazioni di condivisione. Consulta Cosa può modificare Architect per sapere quali azioni si applicano all’agente e quali al workspace.

Modalità di approvazione

Ogni conversazione con Architect viene eseguita in una di tre modalità. Cambia modalità dal selettore nel compositore oppure premi Shift+Tab per scorrerle.

Modalità	Comportamento
Approvazione richiesta (predefinita)	Architect chiede conferma prima di azioni che interessano il traffico live o risorse condivise. Mostra esattamente cosa cambierà e attende che tu approvi o rifiuti.
Approvazione automatica	Architect non chiede conferma prima di alcuna azione, inclusi il merge di un branch, la modifica della ripartizione del traffico, l’eliminazione di una bozza, l’archiviazione di un agente o l’esecuzione di una chiamata di test. Usala solo per operazioni di cui sei sicuro.
Piano	Architect svolge ricerche con strumenti di sola lettura, scrive un piano e attende che tu lo approvi prima di modificare qualsiasi elemento. Dopo l’approvazione, le azioni sono soggette alle stesse limitazioni della modalità Approvazione richiesta.

La modalità scelta viene memorizzata nel browser. Non esiste un’impostazione del workspace che imponga una modalità a tutti. Per richiedere la revisione di ogni modifica a un agente live, proteggi il suo branch main affinché le modifiche debbano passare attraverso una proposta di merge approvata.

Quali azioni richiedono prima una conferma

Nella modalità Approvazione richiesta, Architect prepara le modifiche alla configurazione dell’agente nella tua bozza senza chiedere conferma, perché una bozza non influisce mai sui chiamanti live. Chiede conferma prima di:

Modifiche che hanno effetto immediato sui chiamanti live: eseguire il merge di un branch e modificare la ripartizione del traffico.
Modifiche alle risorse condivise del workspace: creare, aggiornare o eliminare strumenti, aggiornare o eliminare test e la maggior parte delle modifiche alla knowledge base.
Azioni distruttive: eliminare una bozza, eliminare una procedura, archiviare un agente o un branch.
Azioni nel mondo reale: effettuare una chiamata telefonica di test.

Le operazioni di lettura non richiedono mai conferma. Il prompt di approvazione contrassegna le eliminazioni che non possono essere annullate con l’etichetta Permanente. L’elenco completo delle azioni che richiedono prima una conferma è disponibile in Cosa può modificare Architect.

Tre passaggi richiedono sempre il tuo intervento, in ogni modalità:

Pubblicare una bozza. Architect apre la finestra di pubblicazione e tu selezioni Pubblica.
Approvare un piano nella modalità Piano.
Decidere cosa fare con una bozza esistente. Se il branch ha già una bozza che Architect non ha creato in questa chat, incluse le modifiche non salvate nell’editor, Architect si ferma e ti chiede se conservarla o eliminarla prima di preparare qualsiasi modifica.

Considerare attendibile uno strumento per la sessione

Il prompt di approvazione include una casella di controllo Considera attendibili questi strumenti per questa sessione. Quando la selezioni, le chiamate successive agli stessi strumenti in quella sessione vengono eseguite senza chiedere conferma. L’attendibilità termina quando avvii una nuova conversazione. Se non rispondi a un prompt di approvazione entro circa due minuti, la richiesta scade e Architect non esegue l’azione.

Bozze, versioni e branch

Architect usa lo stesso modello di versioning del resto di ElevenAgents.

Concetto	Cos’è	Come lo usa Architect
Bozza	Le modifiche non pubblicate in un branch. Ogni utente ha la propria bozza per branch.	Qui vengono preparate tutte le modifiche alla configurazione effettuate da Architect. La chat mostra un pannello delle modifiche preparate con Rivedi e pubblica.
Versione	Uno snapshot immutabile, creato quando viene pubblicata una bozza.	Tu pubblichi. Architect non può farlo. In un branch protetto, la finestra offre invece di pubblicare in un nuovo branch.
Branch	Una linea di versioni con un nome. Il traffico live viene instradato ai branch in base a una percentuale.	Architect crea un branch per le modifiche che richiedono revisione, così `main` non viene modificato finché il branch non viene unito.

“Nulla va live senza la tua approvazione” ha un significato preciso:

Le modifiche alla configurazione di un agente vengono preparate in una bozza e raggiungono i chiamanti live solo dopo che le pubblichi, in un branch che riceve traffico.
Nella modalità Approvazione richiesta, le azioni che interessano il traffico live o risorse condivise attendono la tua approvazione.
Nella modalità Approvazione automatica, Architect non può comunque pubblicare, ma può eseguire il merge dei branch e modificare le ripartizioni del traffico senza chiedere conferma, entro i limiti delle tue autorizzazioni.

Alcune modifiche esterne alla configurazione dell’agente hanno effetto nel workspace non appena vengono effettuate, ad esempio la creazione di uno strumento o di un documento della knowledge base. Non influiscono sul comportamento dell’agente finché non li usa, cosa che avviene quando pubblichi una bozza che li collega. Fanno eccezione le risorse del workspace già collegate ad agenti live: l’aggiornamento di uno strumento usato da un agente live modifica immediatamente quell’agente. Architect chiede conferma prima di aggiornare gli strumenti nella modalità Approvazione richiesta.

Cronologia delle versioni e ripristino

Ogni versione pubblicata registra cosa è cambiato e chi l’ha pubblicata.

Vedere cosa è cambiato: in Controllo versione > Branch, apri la Cronologia versioni di un branch. Confronta qualsiasi versione con quella precedente o con la versione live. Oppure chiedi ad Architect, ad esempio: “Cosa è cambiato in main nell’ultima settimana?” Legge per te la cronologia del branch e confronta le versioni.
Vedere chi ha effettuato la modifica: ogni versione mostra l’utente che l’ha pubblicata. Una modifica effettuata da Architect mostra l’utente che stava parlando con lui.
Ripristinare: seleziona Ripristina questa versione nella cronologia delle versioni. Il ripristino non rimuove la cronologia. Pubblica la vecchia configurazione come nuova versione. Puoi anche usare /rollback per far esaminare ad Architect le modifiche recenti e preparare un ripristino che poi pubblicherai.