> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Panoramica di Agent Studio

> Crei agenti IA specializzati basati sul Cervello aziendale e sulla Biblioteca, con le sole azioni da Lei selezionate, e li usi in Ask, pianificazioni e flussi di lavoro.

Agent Studio è lo strumento per creare **agenti specializzati, configurati per un compito, basati sul Suo Cervello aziendale e vincolati alle Sue regole.** Ask Hive è un assistente generico. Un agente è uno specialista salvato e gestito per versioni: ad esempio, un addetto al sollecito dei pagamenti che scrive con il Suo tono, un autore di proposte che conosce i Suoi modelli o un assistente per lo smistamento di una casella di posta condivisa.

Nella barra laterale, selezioni **Agent Studio** (`/agents`), subito sopra **Flussi di lavoro**. Il titolo della pagina è
**Agenti**. È disponibile anche nella tavolozza dei comandi (<kbd>⌘</kbd> <kbd>K</kbd>).

## Che cos’è un agente

Un agente combina cinque elementi, salvati insieme come **revisione**:

| Parte | Che cosa controlla |
| - | - |
| **Istruzioni** | Il compito, la persona e l’obiettivo dell’agente, descritti in linguaggio naturale. |
| **Input** | Il modo in cui si avvia: un **Prompt** a testo libero (l’impostazione predefinita), **Sceglie Hive** o un **Modulo** strutturato con campi tipizzati. |
| **Conoscenza** | I file e le cartelle della Biblioteca che può leggere. Chiunque possa eseguire l’agente vi ha accesso quando lo esegue dalla relativa pagina di esecuzione, in Ask e in Continua in chat, anche se si tratta di un file che solo Lei può aprire: consulti [Chi può leggere i file di un agente](#who-can-read-an-agents-files). Fino a un totale di circa 50.000 token, vengono inviati integralmente al modello. Oltre questa soglia, l’agente riceve un elenco (nome, data, prime righe) e apre i file necessari uno alla volta: nelle proprie esecuzioni, quando qualcuno lo interroga in Ask, quando un altro agente gli affida un’attività, come passaggio di un flusso di lavoro, in un test della bozza e tramite il suo [link pubblico](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links), dove ogni apertura è di dimensioni più contenute. Un [test completo](https://docs.get-hive.ai/agents/build-an-agent.md) legge comunque i file integralmente. I valori aggregati di un foglio di calcolo collegato (CSV, TSV o Excel), come una somma, una media o un conteggio, vengono calcolati esattamente su tutte le righe anziché essere stimati dal modello. Consulti [Come Hive legge i file scelti](https://docs.get-hive.ai/it/library/library.md#how-hive-reads-the-files-you-choose). |
| **Integrazioni** | Le app connesse con cui lavora. Può sempre leggere i dati di un’app collegata ed esegue solo le azioni che Lei attiva, come **Invia email** in Gmail o **Crea operazione** in HubSpot. Ogni azione attiva riporta **Viene eseguita automaticamente quando qualcuno esegue questo agente.** |
| **Comportamento dell’agente** | **Che cosa può fare** (**Legge e risponde soltanto** o **Può eseguire azioni nelle Sue app**), quali dati personali dell’utente può leggere (**Dati personali dell’utente**), **Cerca sul web**, **Crea immagini**, **Creatività** (**Preciso**, **Bilanciato** o **Creativo**) e che cosa accade **Quando i crediti si esauriscono o si raggiungono i limiti**. |

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](https://docs.get-hive.ai/agents/build-an-agent.md#how-the-editor-is-laid-out)). 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](#files-from-google-drive-onedrive-and-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.

I file caricati vengono aggiunti alla Sua Biblioteca come file privati e sono soggetti ai consueti controlli: fino a 10 file alla volta,
ciascuno di un tipo supportato e non superiore a 25 MB. Per caricarli è necessario il ruolo di Operatore o superiore.

Ogni caricamento compare subito nella riga **File**. Mostra **Elaborazione…** mentre Hive ne legge
il contenuto, poi **Allegato · Salvare per conservarlo** quando l’agente può usarlo. Salvi l’agente (**Salva
bozza**, oppure **Pubblica modifiche** per un agente già pubblicato) per conservare l’allegato come parte di una nuova revisione; fino a quel momento, **Scarta modifiche** lo rimuove, mentre il
file resta nella Sua Biblioteca. Se un caricamento non riesce, il relativo indicatore mostra il motivo, con **Riprova** e
**Rimuovi**. Lo stesso accade se un file è ancora in elaborazione dopo 10 minuti o se Hive non riesce a verificarne
lo stato per 10 volte consecutive.

Selezioni il nome di un file nella riga **File** per aprirlo nella stessa anteprima usata dalla Biblioteca: un file Word o
PowerPoint si apre sulle sue [pagine](https://docs.get-hive.ai/it/library/library.md#pages-and-text), con **Testo** accessibile con un clic.
L’anteprima rispetta le Sue autorizzazioni di accesso alla Biblioteca: se non può aprire un file nella Biblioteca, qui non viene mostrata alcuna azione
per aprirlo, ma solo **×** per rimuoverlo. L’apertura di un file non modifica mai l’agente.

### 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](https://docs.get-hive.ai/it/integrations/overview.md); 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.

Non viene eseguito alcun controllo in background e l’apertura dell’agente da parte di altri non avvia alcun controllo. Quando
l’originale è cambiato, Hive lo copia di nuovo e conserva il contenuto precedente nella cronologia delle versioni
del file. L’agente usa subito il nuovo contenuto, anche nelle versioni distribuite, come accadrebbe
dopo una modifica a un file della Biblioteca. Se un controllo non riesce a raggiungere l’originale, la copia continua a funzionare e
la riga **File** ne indica il motivo, ad esempio **Impossibile aggiornare: riconnetta Google Drive**. Consulti [File copiati
da Google Drive, OneDrive e SharePoint](https://docs.get-hive.ai/it/library/library.md#files-copied-from-google-drive-onedrive-and-sharepoint).

### 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](https://docs.get-hive.ai/it/library/library.md#how-hive-reads-the-files-you-choose)).
* **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](https://docs.get-hive.ai/developers/mcp-server.md) non può eseguire agenti né aprire le loro
  chat, quindi non legge mai i file di un agente in questo modo.

I file che una persona sceglie per una singola esecuzione (una fonte dell’esecuzione o un file in un campo del modulo) continuano a essere letti con
i diritti di accesso di quella persona; lo stesso vale per i file di un agente a cui un altro agente affida un’attività e
per quelli di un’esecuzione avviata con **Esegui ora**, secondo una pianificazione o tramite un passaggio di consegne da Segnali. Un
passaggio di un flusso di lavoro legge i file di un agente con i diritti del membro per conto del quale il flusso di lavoro viene
eseguito, mentre un [link pubblico](https://docs.get-hive.ai/agents/publish-and-evaluate.md) li legge con i diritti di chi lo ha pubblicato.

## Dove vengono eseguiti gli agenti

Ogni agente distribuito è disponibile in Ask, sulla [propria pagina di esecuzione](#run-an-agent-directly) e nei
flussi di lavoro. Non occorre scegliere dove compare. Il link pubblico è separato: lo attiva da **Link pubblico** nell’editor.

> [card] [Ask Hive](https://docs.get-hive.ai/it/ask/ask-hive.md)
>
> Scelga l’agente nel selettore degli agenti del campo di composizione di Ask, al posto di Hive predefinito.

> [card] [Pagina di esecuzione dedicata](#run-an-agent-directly)
>
> Compili il modulo dell’agente, lo esegua, legga la risposta e consulti le esecuzioni precedenti.

> [card] [Pianificazioni](https://docs.get-hive.ai/admin/scheduled-tasks.md)
>
> Esegua l’agente secondo una pianificazione ricorrente con un prompt e un fuso orario fissi.

> [card] [Flussi di lavoro](https://docs.get-hive.ai/workflows/workflow-steps.md)
>
> Aggiunga un agente distribuito a un flusso di lavoro dalla Biblioteca degli agenti del generatore.

> [card] [Link pubblici](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> 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

| Contesto di esecuzione | Cosa legge | Azioni |
| - | - | - |
| Una chat di Ask | I suoi [file allegati](#who-can-read-an-agents-files), i dati del membro dichiarati in **Dati personali della persona** e le app associate, con la Sua identità, oltre al web quando consentito. Funzionano anche gli strumenti **Cervello aziendale**, **Grafico** e **Immagine** e un file aperto, entro tale ambito. | Le azioni selezionate, effettuate dai Suoi account secondo il livello consentito da ciascun account, applicando gli eventuali limiti dell’area di lavoro: subito con **Azione**, dopo la Sua approvazione con **Bozza** e mai con **Lettura** (le schede di approvazione compaiono nella chat). Con **Azione**, un’azione il cui destinatario, canale, numero o link non proviene dalle istruzioni dell’agente o dai Suoi messaggi attende comunque la Sua approvazione nella chat. La risposta dell’agente indica cosa ha fatto. |
| Una configurazione di esecuzione (una chat di Ask dedicata o un modulo nella pagina dell’agente) | I suoi [file allegati](#who-can-read-an-agents-files), le fonti di esecuzione da Lei scelte, i dati del membro dichiarati in **Dati personali della persona** e le app associate e collegate, con la Sua identità, oltre al web quando consentito. | Le azioni selezionate, effettuate dai Suoi account secondo il livello consentito da ciascun account, applicando gli eventuali limiti dell’area di lavoro: subito con **Azione**, dopo la Sua approvazione con **Bozza** e mai con **Lettura**, e registrate nell’esecuzione, fino a cinque per esecuzione. Con **Azione**, un’azione il cui destinatario, canale, numero o link non proviene dalle istruzioni dell’agente o da quanto Lei ha digitato per l’esecuzione attende comunque la Sua approvazione. Con un modello di file Word o Excel, fino a tre [nuovi file nella Sua Biblioteca](#files-a-run-writes-to-your-library). |
| Un passaggio di un flusso di lavoro | Le proprie conoscenze e fonti di esecuzione, i dati del membro dichiarati in **Dati personali della persona** e le app associate e collegate, con l’identità del membro per conto del quale viene eseguito il flusso di lavoro, oltre al web quando consentito. Una ricerca sul web può includere qualsiasi contenuto letto dal passaggio, che viene ricevuto dal fornitore di ricerca di Hive. | Le azioni selezionate, effettuate dagli account di quel membro secondo il livello consentito da ciascun account, applicando gli eventuali limiti dell’area di lavoro: subito con **Azione**, dopo l’approvazione con **Bozza** e mai con **Lettura**. Fino a cinque per passaggio. Con **Azione**, un’azione il cui destinatario, canale, numero o link non proviene dalle istruzioni dell’agente o da un valore fisso digitato nel passaggio attende comunque l’approvazione. |
| Un link pubblico | Solo le proprie conoscenze e il messaggio del visitatore. | Nessuna. |

Le [competenze obbligatorie](https://docs.get-hive.ai/skills/skills.md#how-hive-uses-skills) 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](https://docs.get-hive.ai/workflows/workflow-steps.md#web-hive-data-and-connected-apps-in-an-agent-library-step). 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](https://docs.get-hive.ai/workflows/workflow-steps.md#agent-library).

## 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](https://docs.get-hive.ai/it/library/library.md). 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.

Un agente precedente, salvato prima che fossero disponibili le configurazioni di esecuzione, mostra invece un modulo più semplice: i suoi campi,
**Istruzioni di esecuzione (facoltative)** ed **Esegui ora**, senza caricamenti né Continua in chat.

Selezioni **Esegui**. La risposta appare sotto il modulo, per prima, con le fonti e gli eventuali file
creati raccolti in sezioni compresse sottostanti. Quando le istruzioni di esecuzione richiedono un grafico, ad esempio «rappresenta i ricavi per
regione», l’agente lo genera da un foglio di calcolo allegato o che legge, oppure dai numeri che Lei
ha digitato; il grafico viene mostrato e salvato con la risposta, con il nome della fonte sotto, come in
[Visualizzare i dati](https://docs.get-hive.ai/ask/tools-and-modes.md). Anche un’esecuzione avviata da Agent Studio — **Esegui ora**, una pianificazione, un
evento di un’app, un segnale o un altro agente — conserva i grafici generati, fino a quattro, mostrati sotto la
risposta quando apre l’esecuzione; un grafico generato da numeri di esempio è etichettato come dati di esempio e la
risposta lo specifica. I grafici vengono mostrati o nascosti esattamente come la risposta dell’esecuzione. Se l’agente consente domande successive, **Continua in chat** apre l’esecuzione come
chat di Ask, così può proseguire la conversazione basandosi su un massimo di 50 risposte precedenti; oltre tale limite,
Hive Le chiede di avviare una nuova sessione. In caso contrario, ogni esecuzione fornisce una sola risposta: esegua di nuovo l’agente per
porre una nuova domanda.

L’esecuzione inizia non appena seleziona **Esegui**. Hive legge le fonti una sola volta, con i Suoi diritti di accesso attuali,
quando l’agente elabora la risposta: se Lei non può più aprire una fonte, l’esecuzione non riesce e lo segnala.
Il passaggio di un flusso di lavoro che usa un agente salvato funziona allo stesso modo. Se l’esecuzione ha sospeso alcune azioni a causa della loro
destinazione, la risposta indica quante attendono la Sua approvazione in **Rivedi decisione** nella
pagina **Segnali**.

### File scritti da un’esecuzione nella Sua Biblioteca

Un agente con un [modello di file](https://docs.get-hive.ai/agents/build-an-agent.md#ground-it-in-your-knowledge) 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](https://docs.get-hive.ai/approvals/audit-log.md) come
  «L’esecuzione dell’agente ha creato un file nella Biblioteca», insieme all’agente, all’esecuzione e al file.

L’esecuzione di un passaggio di un flusso di lavoro (incluse quelle pianificate o avviate da eventi di app), un **Test** dell’autore e un
[link pubblico](https://docs.get-hive.ai/agents/publish-and-evaluate.md) non scrivono mai file: utilizzi il passaggio
[Crea PDF](https://docs.get-hive.ai/workflows/workflow-steps.md#create-pdf) di un flusso di lavoro per archiviare un PDF da un flusso di lavoro. Sono necessari il
ruolo di Operatore o superiore e l’accesso alla Biblioteca, come per qualsiasi file che aggiunge.

Se il modello di IA dell’agente smette di funzionare durante un’esecuzione, quest’ultima indica quale modello ha avuto un errore, cosa ha
segnalato il fornitore di IA (ad esempio che ha rifiutato la richiesta, con lo stato HTTP e il
codice di errore del fornitore) e come procedere: attendere e riprovare quando il fornitore è occupato, modificare
la richiesta quando un filtro di sicurezza l’ha bloccata oppure riprovare e poi scegliere un altro modello nelle
impostazioni dell’agente quando il fornitore continua a rifiutarla. Lo stesso messaggio compare in Agent Studio, in
Ask e nel passaggio con agente salvato di un flusso di lavoro.

### 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](https://docs.get-hive.ai/admin/credits-and-usage.md).
* 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](https://docs.get-hive.ai/it/get-started/inbox.md#suggested-for-your-workspace)) 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](https://docs.get-hive.ai/agents/build-an-agent.md#templates-by-hive)). **+ Crea agente** apre lo strumento di creazione, dove può scrivere o dettare ciò che l’agente deve fare (veda [Creare un nuovo agente](https://docs.get-hive.ai/agents/build-an-agent.md#start-a-new-agent)).
* 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:

| Azione | Funzione | Chi la vede |
| - | - | - |
| **Modifica** / **Apri** | Apre l’agente. I proprietari e gli amministratori che possono modificarlo vedono **Modifica**; tutti gli altri vedono **Apri**. | Chiunque possa vedere l’agente |
| **Esegui** | Apre la [pagina di esecuzione](#run-an-agent-directly) dell’agente, con il modulo e la cronologia esecuzioni. Solo per gli agenti in stato **Attivo** che Lei può eseguire. | Membri che possono eseguire l’agente |
| **Usa in Ask** | Avvia una nuova chat di Ask con l’agente selezionato. Solo per gli agenti in stato **Attivo** che Lei può eseguire. | Membri che possono eseguire l’agente |
| **Fissa in alto** / **Rimuovi dall’alto** | Aggiunge l’agente agli **Agenti fissati** o lo rimuove. | Tutti |
| **Copia link** | Copia un link che apre l’agente in Agent Studio. Solo chi può vedere l’agente può aprirlo. | Tutti |
| **Duplica** | Copia l’agente in una nuova bozza privata, dopo che Lei le ha assegnato un nome. | Membri che possono modificare l’agente e creare agenti |
| **Condividi** | Apre le impostazioni di condivisione dell’agente. | Proprietari e amministratori che possono gestire l’accesso all’agente |
| **Link pubblico** | Apre il link pubblico dell’agente, dove può attivarlo o revocarlo. Consulti [Link pubblici degli agenti](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links). | Proprietari e amministratori, per gli agenti di cui sono proprietari |
| **Archivia** | Archivia l’agente dopo la Sua conferma. Diventa di sola lettura e la sua cronologia viene conservata. Se l’agente è occupato in quel momento (ad esempio, mentre si sta avviando una delle sue esecuzioni), Hive attende qualche secondo; se è ancora occupato, appare «Hive è occupato con questo agente. Riprovi tra un momento.» e non cambia nulla, quindi riprovi. La messa in pausa funziona allo stesso modo. | Proprietari e amministratori |
| **Elimina definitivamente** | Elimina un agente archiviato dopo che Lei ne ha digitato il nome per confermare. L’operazione è irreversibile. Le esecuzioni precedenti e il relativo utilizzo restano nei registri della Sua area di lavoro e continuano a essere conteggiati nell’utilizzo del piano. Questo vale anche per un agente che aveva condiviso tramite un link pubblico: il link resta disattivato e le conversazioni dei visitatori e il relativo utilizzo restano nei Suoi registri. Le chat che usavano l’agente restano come chat ordinarie e le esecuzioni dei flussi di lavoro che lo usavano possono ancora essere aperte: il relativo passaggio mostra **Agente eliminato** e i risultati di quel passaggio e dei successivi non vengono più mostrati, mentre restano visibili stato, tempi e costo di ogni passaggio. Non può eliminare l’agente mentre una delle sue esecuzioni è ancora in corso. | Proprietari e amministratori |

### Stati degli agenti

| Stato | Significato |
| - | - |
| `draft` (**Bozza**) | Ancora in fase di creazione. Può visualizzarne l’anteprima, ma non può pianificarlo o pubblicarlo. |
| `deployed` (**Attivo**) | Una revisione salvata è attiva e può essere usata in Ask, nelle pianificazioni e nei flussi di lavoro. |
| `paused` (**In pausa**) | Temporaneamente fermo. **Riprendi** lo riattiva con la stessa revisione. |
| `archived` (**Archiviato**) | Ritirato e nascosto dall’uso ordinario. |

## Chi può fare cosa

Agent Studio rispetta i ruoli dell’area di lavoro (vedere [Ruoli e autorizzazioni](https://docs.get-hive.ai/admin/roles-and-permissions.md)):

* **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](#who-can-read-an-agents-files). 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](https://docs.get-hive.ai/it/ask/ask-hive.md#use-an-agent-in-ask).

Gli amministratori possono disattivare Agent Studio per l’area di lavoro o limitarne l’uso a membri e gruppi selezionati nelle [impostazioni dell’area di lavoro](https://docs.get-hive.ai/admin/workspace-settings.md).

## 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](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do).
* **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](https://docs.get-hive.ai/agents/build-an-agent.md)). Consulti [Destinazione di un’azione](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#where-an-action-sends).
* **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](https://docs.get-hive.ai/admin/earlier-plans.md), 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](https://docs.get-hive.ai/workflows/runs-and-errors.md#waiting-for-credits)).
* **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](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#when-an-action-keeps-failing).
* **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](https://docs.get-hive.ai/admin/safety-and-control.md), 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](https://docs.get-hive.ai/approvals/audit-log.md).

Può comunque vedere lo stato di un’esecuzione salvata e interrompere un’esecuzione non terminata se la relativa fonte nella Biblioteca diventa
indisponibile. Un’esecuzione terminata conserva la propria risposta: può aprirla in seguito anche se nel frattempo ha perso
l’accesso a una fonte che aveva letto. La perdita dell’accesso si applica dalla Sua esecuzione o domanda successiva, che non
leggerà più quella fonte né la citerà.

> [!NOTE]
>
> 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](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links).

## Limiti in sintesi

| Elemento | Limite |
| - | - |
| Prompt di base | 16.000 caratteri |
| Persona, obiettivo | 4.000 caratteri ciascuno |
| Input | 50 |
| Collegamenti alle conoscenze | 100 |
| App associate | 20, con un massimo di 50 azioni selezionate ciascuna |
| Competenze | 10 |
| Domande iniziali della conversazione | 12 |
| Chiamate al modello (turni) in una singola esecuzione | Il budget di chiamate al modello dell’agente (8 per impostazione predefinita), fino a 16 |
| Nuovi file scritti nella Biblioteca da una singola esecuzione | 3 |
| Deleghe ad altri agenti | 20, fino a 5 livelli di profondità |
| Agenti per area di lavoro (agenti non archiviati di tutti i membri) | Nessun limite su Business e Team; 3 su Starter |
| Token per esecuzione, incluse tutte le esecuzioni pianificate, avviate da eventi e pubbliche (input / output) | 3.000.000 / 300.000 su Business, Team ed Enterprise (per Enterprise il limite può variare in base al contratto); 300.000 / 30.000 su Starter |
| Modelli per le esecuzioni avviate da una pianificazione, un evento di un’app o un segnale | Efficient o Balanced; Frontier viene rifiutato a meno che non sia in uso la chiave della Sua organizzazione |

Consulti il [riferimento sui limiti](https://docs.get-hive.ai/developers/limits-reference.md#agent-studio) per tutti i limiti.

## Contenuti correlati

> [card] [Creare un agente](https://docs.get-hive.ai/agents/build-an-agent.md)
>
> Descriva, configuri, testi e pubblichi il Suo primo agente.

> [card] [Pubblicare e valutare](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> Analisi, feedback, pianificazioni e link pubblici.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.