/agents), subito sopra Flussi di lavoro. Il titolo della pagina è
Agenti. È disponibile anche nella tavolozza dei comandi (⌘ K).
Che cos’è un agente
Un agente combina cinque elementi, salvati insieme come revisione:
Un agente legge i propri file collegati per chiunque lo esegua e, per il resto, solo ciò a cui ha accesso il membro per conto del quale viene eseguito. Esegue soltanto le azioni selezionate. Hive considera non attendibili i testi della persona e dell’attività, quindi nessuna istruzione dell’agente può ampliarne le autorizzazioni o aggiungere un’azione.
Allegare file come conoscenze
Nel passaggio 2 dell’editor dell’agente, Conoscenze e strumenti, la riga File elenca i file della Biblioteca che l’agente legge (consulti Come è organizzato l’editor). Per aggiungerne uno:- Selezioni + Aggiungi file e scelga file già presenti nella Sua Biblioteca, oppure apra Carica file nello stesso selettore per caricarne di nuovi.
- Apra Google Drive, OneDrive o SharePoint nello stesso selettore per aggiungere un file dal Suo account connesso: cerchi per nome i file di Drive e OneDrive, partendo da quelli modificati più di recente, oppure esplori un sito SharePoint, le sue raccolte documenti e le relative cartelle. Consulti File da Google Drive, OneDrive e SharePoint.
- Trascini i file dal computer sulla riga File o nell’area di composizione Crea. Un contorno tratteggiato con la dicitura Rilasci i file per aggiungerli a questo agente indica dove verranno inseriti.
File da Google Drive, OneDrive e SharePoint
Un file aggiunto da Google Drive, OneDrive o SharePoint viene copiato nella Sua Biblioteca, poi allegato come un file caricato (Allegato · Salvare per conservarlo). L’agente legge la copia, mai il file originale: un’esecuzione non resta quindi in attesa dell’originale e non può fallire a causa sua. È necessario il ruolo di Operatore o superiore e l’account deve essere stato connesso da Lei in Integrazioni; se non è connesso alcun account, il selettore lo segnala. Nella riga File, ogni copia indica la provenienza e quando Hive l’ha controllata l’ultima volta, ad esempio Copiato da Google Drive · controllato 2 h fa. Solo la persona che l’ha aggiunta può aggiornarla:- Selezioni Aggiorna sul file per controllare subito l’originale.
- Quando apre l’agente in Agent Studio, Hive controlla le Sue copie il cui ultimo controllo risale a più di un’ora prima.
- Quando distribuisce l’agente, Hive controlla nuovamente le Sue copie.
Chi può leggere i file di un agente
I file e le cartelle allegati a un agente fanno parte dell’agente. Quando lo condivide, chiunque possa eseguirlo ha accesso a quei file quando lo esegue nella sua pagina di esecuzione, in Ask e in Continua in chat, anche ai file che solo Lei può aprire nella Biblioteca:- Durante le esecuzioni. L’agente legge i file allegati nella sua pagina di esecuzione, in una chat di Ask in cui qualcuno lo seleziona e in Continua in chat. Hive li legge con i diritti di accesso alla Biblioteca di chi ha salvato l’ultima versione dell’agente.
- Immagini. Quando il modello dell’agente legge le immagini (un modello con capacità visive), un’immagine JPEG, PNG, GIF o WebP allegata gli viene fornita come immagine vera e propria nella pagina di esecuzione, in Ask e in Test nell’editor. Un modello che non legge le immagini riceve invece la descrizione dell’immagine fornita da Hive (consulti Come Hive legge i file che sceglie).
- Nelle chat. Chi esegue l’agente può aprire dalla chat un file usato dall’agente, in sola lettura: basta selezionare il nome del file sotto Fonti. Un PDF o un’immagine si apre in una nuova scheda; qualsiasi altro file viene scaricato.
- In nessun altro contesto. I file non vengono aggiunti alla Biblioteca, alla ricerca o al Drive di chi esegue l’agente, che non può aprirli al di fuori di una chat con l’agente. L’apertura dell’originale in Google Drive, OneDrive o SharePoint è possibile solo se il servizio lo consente.
- Rimuovendo un file dall’agente e salvando quest’ultimo, l’accesso si interrompe immediatamente: le nuove esecuzioni non lo leggono più, non è più possibile aprirlo dalle chat dell’agente e le risposte precedenti nelle chat che lo hanno usato vengono nascoste. Il risultato di un’esecuzione nella relativa pagina resta visibile a chi l’ha avviata.
- Se chi ha salvato l’ultima versione dell’agente lascia l’area di lavoro o non può più aprire uno dei suoi file, i file dell’agente vengono letti solo per chi può aprirli nella propria Biblioteca, finché qualcuno che può aprirli tutti non salva nuovamente l’agente.
- Chi è escluso dalla Biblioteca nella Sua area di lavoro non può usare i file di un agente, come prima. Un client di IA connesso al server MCP di Hive non può eseguire agenti né aprire le loro chat, quindi non legge mai i file di un agente in questo modo.
Dove vengono eseguiti gli agenti
Ogni agente distribuito è disponibile in Ask, sulla propria pagina di esecuzione e nei flussi di lavoro. Non occorre scegliere dove compare. Il link pubblico è separato: lo attiva da Link pubblico nell’editor.Ask Hive
Scelga l’agente nel selettore degli agenti del campo di composizione di Ask, al posto di Hive predefinito.
Pagina di esecuzione dedicata
Compili il modulo dell’agente, lo esegua, legga la risposta e consulti le esecuzioni precedenti.
Pianificazioni
Esegua l’agente secondo una pianificazione ricorrente con un prompt e un fuso orario fissi.
Flussi di lavoro
Aggiunga un agente distribuito a un flusso di lavoro dalla Biblioteca degli agenti del generatore.
Link pubblici
Condivida un agente al di fuori dell’area di lavoro, se questa funzione è abilitata nella Sua area di lavoro.
Cosa può usare un agente nei diversi contesti di esecuzione
Le competenze obbligatorie dell’area di lavoro si aggiungono alle
istruzioni dell’agente in ciascuno di questi contesti, tranne nel caso di un link pubblico.
Utilizzare un agente nei flussi di lavoro
Distribuisca l’agente. Le revisioni distribuite compaiono quindi nella Biblioteca degli agenti del generatore di flussi di lavoro, sotto Agenti nel menu Aggiungi passaggio e nel pannello Aggiungi un passaggio. Un passaggio del flusso di lavoro mantiene la revisione con cui è stato aggiunto; quando ne distribuisce una più recente, il passaggio propone Aggiorna alla revisione N. Un passaggio del flusso di lavoro legge solo file e cartelle della Biblioteca o link a Google Docs come conoscenze e fonti dell’esecuzione. Per questo, la Biblioteca degli agenti disattiva un agente con altre conoscenze, competenze, sottoagenti o un’operazione di scrittura di un connettore, oppure con altre fonti, e indica cosa modificare. L’accesso al web, Dati personali dell’utente (dati di Hive inclusi) e le app connesse in sola lettura sono utilizzabili in un passaggio: veda Web, dati di Hive e app connesse. Le azioni selezionate vengono eseguite nel passaggio. Un agente creato prima che esistessero i passaggi dei flussi di lavoro deve essere ricreato a partire da un modello riutilizzabile. Veda Passaggi della Biblioteca degli agenti.Eseguire un agente direttamente
Ogni agente pubblicato dispone di una propria pagina di esecuzione all’indirizzo/agents/<agent id>/run. La apra con Esegui nel
menu ⋯ della scheda dell’agente, oppure con Esegui questo agente e visualizza le sue esecuzioni nel riquadro Test
dell’editor. Può usarla se ha il ruolo di Operatore o superiore e l’accesso all’esecuzione dell’agente: non è necessario
poter modificare l’agente e la pagina non mostra mai le sue versioni in bozza.
La pagina mostra il nome e la descrizione dell’agente, seguiti dal modulo:
- Campi: gli input richiesti dall’agente.
- Fonti: i file e le cartelle della Biblioteca, o altre fonti, che l’agente legge per questa esecuzione. Quando una fonte accetta file della Biblioteca, può aggiungere un file non ancora presente nella Biblioteca con Carica nella Biblioteca nel relativo selettore; Hive lo seleziona per Lei al termine del caricamento. È necessario il ruolo di Operatore o superiore. Ogni file può avere una dimensione massima di 25 MB e deve essere di un tipo accettato dalla Biblioteca. Viene collocato nella cartella principale della Sua Biblioteca e ne segue le regole di condivisione, come qualsiasi altro caricamento.
- Account: quali dei Suoi account collegati usa l’agente quando lavora con le app collegate.
- Istruzioni di esecuzione (facoltative): una nota per questa esecuzione.
- Domande iniziali della conversazione: le domande iniziali dell’agente, elencate sotto Istruzioni di esecuzione (facoltative). Ne selezioni una per inserirla nelle istruzioni di esecuzione; questa operazione non avvia l’esecuzione.
File scritti da un’esecuzione nella Sua Biblioteca
Un agente con un modello di file Word o Excel può scrivere il documento o la cartella di lavoro che promette, ad esempio una lettera d’incarico o una proposta, come nuovo file nella Sua Biblioteca quando è Lei ad avviarlo dalla relativa pagina di esecuzione:- Il Suo file. Il file è di Sua proprietà, scritto a Suo nome: al livello principale della Sua Biblioteca oppure in una delle cartelle associate all’agente che è privata per Lei e alla quale può aggiungere file. Le cartelle condivise con chiunque altro e quelle della Base di conoscenza non vengono mai utilizzate, così ciò che l’agente ha letto per Lei non finisce mai dove l’autore dell’agente o un collega potrebbe aprirlo.
- Sul modello dell’agente. Un file Word viene scritto sul modello Word dell’agente e una cartella di lavoro sul suo modello Excel, se Lei può aprire tale modello. Un modello privato viene utilizzato solo per un file che rimane privato per Lei; altrimenti il file adotta la veste grafica della Sua area di lavoro. Se si utilizza uno dei modelli iniziali di Hive, l’intestazione e il piè di pagina riportano il nome del Suo studio al posto di «[Company name]» e «[Firm name]»: il nome registrato nell’anagrafica del Suo studio o, in mancanza di questo, il nome della Sua area di lavoro. Se Hive non conosce nessuno dei due, i segnaposto rimangono nel file affinché Lei li compili.
- Solo nuovi file. Un’esecuzione non modifica, sostituisce, sposta né elimina mai un file già presente nella Sua Biblioteca. Scrive al massimo tre file, ciascuno come bozza da verificare.
- Nel risultato. Ogni file è elencato nella sezione Artefatti del risultato dell’esecuzione, con il pulsante Apri, che lo apre nella Sua Biblioteca; anche la risposta contiene un link al file.
- Registrazione. Ogni file scritto da un’esecuzione viene registrato nel registro di audit come «L’esecuzione dell’agente ha creato un file nella Biblioteca», insieme all’agente, all’esecuzione e al file.
Cronologia esecuzioni
Sotto il modulo, Cronologia esecuzioni elenca le esecuzioni dell’agente, dalla più recente:- Lei vede le proprie esecuzioni. Gli amministratori dell’area di lavoro vedono le esecuzioni di tutti e possono filtrarle per persona.
- Ogni esecuzione indica chi l’ha avviata: Lei per le Sue esecuzioni, il nome del membro per quelle altrui, oppure Membro dell’area di lavoro per chi non fa più parte dell’area di lavoro. L’elenco Esecuzioni recenti nella pagina dell’agente in Agent Studio mostra le stesse informazioni, in ogni riga e in Avviata da quando apre un’esecuzione.
- Può filtrare per stato. Carica altro mostra le esecuzioni meno recenti.
- L’elenco include le esecuzioni avviate da questa pagina, in Ask, da una pianificazione, da un flusso di lavoro e quelle meno recenti avviate con Esegui ora.
- Ogni esecuzione ha un proprio link, quindi una notifica relativa a un’esecuzione la apre qui.
- Un’esecuzione fermata da un limite appare come bloccata, con il motivo: l’area di lavoro ha esaurito i crediti, è stato raggiunto il limite mensile di un membro o dell’agente, l’area di lavoro è in sola lettura o ha un pagamento scaduto, oppure i criteri sui modelli non consentono il modello dell’agente. Consulti Crediti e utilizzo.
- La richiesta e l’inizio della risposta vengono mostrati solo per le Sue esecuzioni. Per l’esecuzione di un’altra persona, un amministratore vede chi l’ha eseguita, quando, come è stata avviata e il suo stato, ma non la richiesta, la risposta, i grafici o i passaggi. Questo vale per la pagina di esecuzione, la cronologia esecuzioni e le esecuzioni recenti nella pagina dell’agente. La risposta di un agente in una chat di Ask fa parte di quella chat, quindi chiunque possa aprire la chat la vede, incluso un amministratore che può leggere le chat dei membri.
- Un’esecuzione la cui chat di Ask è stata eliminata è in sola lettura: può aprirla e leggerne la risposta, ma non proseguirla.
Esplorare e organizzare gli agenti
L’elenco mostra gli agenti di cui Lei è proprietario e quelli condivisi con Lei. Gli amministratori possono anche vedere gli agenti di tutta l’area di lavoro.- Ordina per Più popolari, Aggiornati di recente o A – Z.
- Ogni scheda mostra quante volte l’agente è stato eseguito negli ultimi 30 giorni e quando è avvenuta l’ultima esecuzione. Vengono conteggiate tutte le modalità di esecuzione: Esegui ora, pianificazioni e attivazioni, la pagina dell’agente, Ask e i passaggi dei flussi di lavoro. Per Lei vengono conteggiate le esecuzioni che ha avviato; per un amministratore, quelle di tutti. Più popolari ordina in base alle stesse esecuzioni.
- Ogni scheda indica il proprietario dell’agente: Lei, oppure il membro che lo ha creato. Un agente configurato per Lei da Hive nella Sua area di lavoro (veda Suggeriti per la Sua area di lavoro) mostra Hive come proprietario, mai il nome di una persona.
- Filtra per stato: In produzione, Bozza, In pausa o Archiviato.
- Cerca agenti per nome e descrizione. Fissi quelli che usa più spesso, in modo che compaiano in Agenti fissati.
- Importa agente importa un agente esportato come nuova bozza. Sfoglia modelli consente di partire da un agente già pronto creato da Hive (veda Modelli di Hive). + Crea agente apre lo strumento di creazione, dove può scrivere o dettare ciò che l’agente deve fare (veda Creare un nuovo agente).
- Quando una scheda non contiene ancora agenti, lo segnala e propone Crea agente se il Suo ruolo consente di crearne uno. Se invece una ricerca o un filtro non trova risultati, Le viene chiesto di cancellarlo.
Azioni rapide sulla scheda di un agente
Ogni scheda agente ha un menu ⋯, così può intervenire sull’agente senza aprirlo:Stati degli agenti
Chi può fare cosa
Agent Studio rispetta i ruoli dell’area di lavoro (vedere Ruoli e autorizzazioni):- Creare un agente: Responsabile di reparto, Amministratore o Proprietario. Gli altri utenti vedono «Solo un responsabile, un amministratore o un proprietario può creare agenti». Con Starter, un’area di lavoro può avere 3 agenti non archiviati, contando quelli di tutti i membri; Team e i piani superiori non hanno un limite fisso. Una volta raggiunto il limite, la creazione o la copia di un altro agente viene rifiutata; un’area di lavoro che supera il limite del proprio piano (ad esempio dopo un passaggio a un piano inferiore) non può pubblicare un agente finché non ne archivia alcuni.
- Eseguire un agente: Operatore o ruolo superiore, con accesso all’esecuzione di quell’agente.
- Eliminare un agente: Responsabile di reparto o ruolo superiore.
- Gestire le impostazioni degli agenti dell’area di lavoro: Amministratore o ruolo superiore.
- Condividere: un agente è privato e accessibile solo al proprietario finché quest’ultimo non lo condivide con collaboratori specifici. La condivisione di un agente non condivide mai gli account collegati del proprietario. Consente però a chiunque possa eseguirlo di usare i file allegati all’agente quando lo esegue dalla relativa pagina di esecuzione, in Ask e in Continua in chat, e di aprirli dalle sue chat, senza aggiungerli alla propria Biblioteca: vedere Chi può leggere i file di un agente. Il nome e l’icona dell’agente restano visibili sulle risposte che ha fornito in una chat di Ask, per tutti coloro con cui la chat è condivisa; vedere Usare un agente in Ask.
Sicurezza integrata
Le azioni di un agente seguono queste regole:- Le azioni selezionate seguono il livello dell’account. Un’azione selezionata dell’agente viene eseguita dall’account personale del membro ed è il livello di tale account, con gli eventuali limiti dell’area di lavoro applicati, a determinarne il comportamento: con Azione viene eseguita subito; con Bozza attende su una scheda di approvazione; con Lettura non viene eseguita alcuna azione e la risposta lo segnala. Questo vale indipendentemente da come è iniziata l’esecuzione: da un membro, una pianificazione, un evento di un’app o un segnale. Consulti Cosa fanno autonomamente gli agenti e i flussi di lavoro.
- Destinazione di un’azione. Un’azione il cui destinatario, canale, numero di telefono o link non proviene dalle istruzioni dell’agente o da quanto il membro ha digitato in Hive per quell’esecuzione, ad esempio un indirizzo trovato dall’agente in un’email che ha letto, attende l’approvazione di quel membro sotto forma di scheda invece di essere eseguita: nella chat o in Rivedi decisione nella sua pagina Segnali. L’input salvato di una pianificazione non conta come parole digitate personalmente da qualcuno. Inserisca personalmente nelle istruzioni gli indirizzi, i canali e i link che l’agente può usare: Descrivilo e la chat Crea non ne aggiungono mai uno che Lei non abbia salvato o digitato nella descrizione, e lo segnalano invece di aggiungerlo (consulti Creare un agente). Consulti Destinazione di un’azione.
- Azioni attivate o disattivate. Imposti Cosa può fare su Legge e risponde soltanto in Avanzate nel passaggio 3, Input e output, e l’agente non eseguirà alcuna azione.
- Solo le azioni selezionate. Un agente esegue soltanto le azioni selezionate per le app associate. Hive rifiuta qualsiasi altra azione prima che raggiunga un account. Un agente configurato prima che fosse possibile scegliere le azioni per ogni app non ne esegue alcuna finché Lei non le seleziona.
- Strumenti MCP per chiunque lo esegua. Uno strumento MCP selezionato viene eseguito tramite la connessione personale di chi avvia l’esecuzione allo stesso server. A chi non dispone di tale connessione viene chiesto di collegare il server (oppure, se Hive non è riuscito a caricarne gli strumenti, viene segnalato il problema); a chi ha due connessioni allo stesso server viene chiesto di scollegarne una. Uno strumento modificato dal server dopo la selezione viene rifiutato con una nota che chiede all’autore di selezionarlo di nuovo in Agent Studio, e la risposta segnala gli eventuali strumenti selezionati solo per la connessione personale dell’autore. È possibile selezionare nuovi strumenti solo dai server che chi modifica l’agente ha collegato.
- Budget. Limiti rigidi su durata dell’esecuzione, chiamate al modello, passaggi di azione, scritture esterne e token. Un’esecuzione prevede al massimo tanti turni quanti ne consente il budget di chiamate al modello, e mai più di 16. I nuovi agenti iniziano con i valori predefiniti di Hive (8 chiamate al modello); un agente creato da un modello che concatena più strumenti inizia con un numero maggiore; la selezione della prima azione di un agente consente una scrittura esterna per esecuzione; gli agenti creati in precedenza mantengono i budget con cui sono stati salvati. Superato il budget di scrittura, Hive rifiuta ulteriori azioni. Un’azione che attende l’approvazione a causa della propria destinazione non consuma il budget di scrittura, ma conta come uno dei passaggi di azione dell’esecuzione. Si applica inoltre il limite di token per singola esecuzione del Suo piano, anche in Ask.
- Limiti dell’area di lavoro. Il limite orario delle azioni e i tetti di spesa continuano ad applicarsi alle azioni. Un’azione bloccata da questi limiti viene rifiutata e l’agente ne spiega il motivo.
- Crediti. Il lavoro del modello di un agente, sia che venga eseguito qui, secondo una pianificazione o quando qualcuno lo interpella in Ask, usa crediti IA: su Business, i crediti del membro che lo esegue (per un’esecuzione pianificata, il proprietario della pianificazione; per un link pubblico, chi lo ha pubblicato), senza un limite mensile per agente oltre ai crediti personali di quel membro e al suo limite di ricarica; su un piano precedente, il fondo condiviso dell’area di lavoro, fino a un limite mensile per agente di 2.000 crediti su Starter e Team e 10.000 su Business ed Enterprise. Se Lei ha aumentato il budget di token di un agente oltre il valore predefinito, un’esecuzione per cui Hive stima un costo superiore a £5 (500 crediti su un piano precedente) Le chiede conferma prima di iniziare; un agente con il budget predefinito non la chiede mai. La finestra Pubblica mostra il costo massimo stimato di ogni esecuzione prima che l’agente venga messo in servizio: in sterline su Business, in crediti su un piano precedente. Un’esecuzione pianificata o avviata da un evento che ha esaurito i crediti attende fino a 72 ore che siano disponibili nuovi crediti, e la scheda dell’agente in Agent Studio mostra 1 esecuzione in attesa di crediti (o il numero corrispondente), oppure Eseguire quando i crediti saranno di nuovo disponibili? quando un’esecuzione è in attesa da 72 ore (consulti In attesa di crediti).
- Errori ripetuti. Un’azione che non riesce tre volte in un’ora sullo stesso account viene messa in pausa solo su quell’account, e l’agente indica fino a quando. Ricollegando l’account si rimuove la pausa. Consulti Quando un’azione continua a non riuscire.
- Contenuti esterni. Un agente avviato da un evento di un’app (una nuova email, una nuova operazione) legge ciò che una persona esterna all’area di lavoro ha scritto e continua ad agire. Un’azione che invierebbe contenuti a un indirizzo, canale o link tratto da quel contenuto attende l’approvazione, ma un’azione su un record esistente, come rispondere a un ticket di assistenza, inviare o annullare una fattura o eliminare un contatto, non viene sospesa in questo modo. Selezioni soltanto le azioni che ritiene opportuno consentire su tali contenuti e mantenga basso il budget di scrittura.
- Interruttore di arresto. Quando un amministratore attiva l’interruttore di arresto, gli agenti smettono di agire insieme a tutto il resto. Un’esecuzione o un test già in corso si interrompe prima di eseguire un’azione, accedere all’esterno di Hive (una ricerca web o un’app collegata) o salvare la risposta. Fino a quel momento può effettuare ulteriori chiamate al modello, addebitate come di consueto, ma nulla di ciò che produce viene salvato o consegnato. Mettere in pausa, archiviare o ritirare dalla pubblicazione l’agente, oppure rimuovere la persona che ha avviato l’esecuzione (o assegnarle un ruolo inferiore a Operatore), interrompe un’esecuzione in corso negli stessi punti.
- Resoconti. Le azioni completate vengono registrate nel registro di audit.
Gli agenti riutilizzabili dei membri sono disattivati per impostazione predefinita. Li vedrà solo se Hive li ha attivati per la Sua area di lavoro. I link pubblici degli agenti sono disponibili per tutte le aree di lavoro: consulti Link pubblici degli agenti.
Limiti in sintesi
Consulti il riferimento sui limiti per tutti i limiti.
Contenuti correlati
Creare un agente
Descriva, configuri, testi e pubblichi il Suo primo agente.
Pubblicare e valutare
Analisi, feedback, pianificazioni e link pubblici.