# Cos’è un agente?

Un collega di intelligenza artificiale con le proprie istruzioni, strumenti, memoria e spazio di lavoro persistente.

Source: https://docs.opser.com/it/agents/overview/

## Un agente ha un posto dove lavorare

Un agente Opser è un collega di intelligenza artificiale che può intraprendere azioni per completare un'attività. Combina un modello di linguaggio con istruzioni, strumenti, memoria e un filesystem persistente. Può indagare le informazioni, scrivere ed eseguire codice, lavorare con i record aziendali, creare documenti e creare app quando tali funzionalità sono abilitate.

**Una conversazione con l’agente · Dati fittizi**

L’intestazione della chat mostra l’avatar dell’agente — un personaggio azzurro dall’aria amichevole — e il suo nome. L’agente esamina i dati disponibili e salva un piano per il portale clienti in portal-plan.md nel suo workspace persistente.


Il modello gestisce il ragionamento e il linguaggio. Il runtime circostante Opser fornisce lo spazio di lavoro e le azioni che può intraprendere. Cambiare i modelli non trasforma una conversazione diversa nella stessa cosa di un agente diverso.

## Cosa conserva un agente tra i compiti

| Fondazione | Come viene utilizzato |
| --- | --- |
| Identità e istruzioni | Il suo nome, il comportamento, la conoscenza del ruolo e la guida permanente |
| Contesto aziendale e personale | Informazioni sulla tua organizzazione e sulle persone che serve |
| Memoria | Fatti che l'agente può salvare e recuperare per il lavoro futuro |
| File persistenti | File di origine, script, note e risultati conservati nell'area di lavoro dell'agente |
| Strumenti | Azioni per la lettura, il calcolo, l'aggiornamento, la costruzione e la comunicazione |
| Competenze | Istruzioni per lo svolgimento di un tipo di lavoro con tali strumenti |
| Connessioni e accesso | Gli account esterni, le app e i record che sono autorizzati a utilizzare |

Ogni agente ha una sola chat continua, condivisa da tutti quelli che possono usarlo, e non si azzera mai. Quando diventa lunga, l'agente tiene un riepilogo dei messaggi precedenti e cerca nella chat i dettagli esatti quando gli servono; i file salvati e il contesto configurato restano invariati.

## Da una richiesta a un risultato

Un agente può suddividere un'attività in passaggi, ispezionare gli input, scegliere strumenti, chiedere un dettaglio mancante, eseguire uno script e rivedere l'output. Alcune azioni richiedono l'approvazione. La chat mostra ciò che l'agente scrive e produce, con una breve frase che dice cosa sta facendo mentre lavora; attiva i suoi passaggi quando vuoi ispezionare ogni azione. Vedi [cosa vedi mentre l'agente lavora](https://docs.opser.com/it/agents/conversations/#what-you-see-while-the-agent-works).

Ad esempio, un agente può leggere diversi file di origine, calcolare un confronto, salvare uno script riutilizzabile e produrre un report. Se il risultato appartiene a un'app installata, può utilizzare gli strumenti supportati per creare o aggiornare il record. Leggi [Strumenti integrati](https://docs.opser.com/it/agents/tools/) e [Codice e script](https://docs.opser.com/it/capabilities/code/).

## I tuoi agenti

Inizi con un agente predefinito e puoi creare altri agenti per diversi tipi di lavoro, ad esempio un product manager, un ricercatore o un redattore. Ogni agente ha un proprio spazio di lavoro, una configurazione e delle connessioni, e un proprietario, che ne controlla le impostazioni. Su un agente specialista, anche le persone con accesso possono insegnargli cosa sapere e come comportarsi (vedi [Contesto e memoria](https://docs.opser.com/it/agents/context/)). Ogni [piano](https://docs.opser.com/it/billing/plans/) ti permette di creare tutti gli agenti che ti servono.

Un agente non ottiene l'accesso ai file privati di un'altra persona o a un servizio non connesso solo perché li menzioni. Chiedigli di identificare la fonte mancante o l'autorizzazione quando non può completare un'attività.

## Dare accesso alle persone

Qualsiasi agente può essere dato ad altre persone, compreso l'agente predefinito con cui inizi. Il suo proprietario o un amministratore apre **Accesso** nelle impostazioni dell'agente e sceglie **Aggiungi persone**, oppure lo chiede all'agente nella sua chat, che chiede l'approvazione prima di dare o togliere l'accesso. Accesso elenca tutti quelli che possono usare l'agente, a partire dal proprietario. Un agente può servire un team attorno a un processo come il coordinamento delle richieste o la preparazione di rapporti operativi.

Tutti quelli che hanno accesso usano l'agente insieme: una sola chat che tutti vedono e in cui tutti scrivono, dove ogni messaggio mostra chi l'ha scritto, oltre alle automazioni dell'agente e ai loro risultati, ai suoi file, alla sua memoria e agli account a cui è collegato. Le connessioni appartengono all'agente, non alla persona che le ha create. Ognuno ha il proprio stato di lettura.

Quando qualcuno oltre al proprietario può usare un agente, i volti delle persone con accesso compaiono in alto a destra nella chat, subito prima del pulsante di ricerca, sia nella pagina della chat sia nella chat laterale. Selezionali per vedere chi ha accesso; il proprietario o un amministratore vede lì anche **Gestisci accesso**, che apre **Accesso**. Quando qualcuno riceve accesso, una riga nella chat lo dice nel punto in cui è successo: quella persona può vedere tutta la chat, anche i messaggi precedenti.

Un agente non fa mai più di quanto potrebbe il suo proprietario, né più di quanto la persona che gli parla può fare in Opser. Dare accesso non è una scorciatoia per aggirare i permessi sui record. Prima di aggiungere qualcuno, controlla cosa contengono già la chat, i file e la memoria dell'agente e a quali account è collegato: quella persona potrà vederli e usarli.

Apri **Impostazioni → Agenti** per gestire gli agenti a tua disposizione. La creazione di agenti richiede l'autorizzazione. La condivisione è inclusa in ogni piano, anche in Free.

## Delega del lavoro

Per un compito più lungo, l'agente principale può delegare una parte limitata del lavoro a un subagente e riportare il suo rapporto nella conversazione. Un subagente riceve un task brief e strumenti selezionati; non è un altro agente permanente che è necessario configurare.

La delegazione non espande l’autorità. I subagenti non possono porvi domande o completare le azioni approvate da soli. La conversazione principale gestisce queste decisioni e riunisce i risultati.

## Riconoscere i tuoi agenti

Ogni agente ha un'identità salvata: un nome e un avatar composto da una forma e un colore, con un volto espressivo. Il tuo agente predefinito nasce come “Agent” con un avatar assegnato in modo casuale; quando crei un altro agente, puoi assegnargli un'identità specifica per il suo ruolo. Le impostazioni **Generali** permettono di rinominarlo e scegliere un altro aspetto. Chiunque possa usare un agente ne vede la stessa identità.

**I tuoi agenti · Dati fittizi**

Tre agenti, ognuno con il proprio avatar: l’agente Opser, usato solo dal suo proprietario, come personaggio azzurro arrotondato; un agente Assistenza usato da quattro persone, a forma di fiore albicocca; e un agente Report usato da due persone, a forma di stella color menta.


La barra laterale dello spazio di lavoro elenca gli agenti a tua disposizione sopra le app, ciascuno con avatar, nome e attività non letta. Scegline uno per aprire la sua chat; una chat vuota ti accoglie con l'avatar di quell'agente e l'intestazione della chat mostra l'avatar accanto al nome. L'animazione dell'avatar rispetta la tua preferenza di movimento ridotto.

## Configurare e utilizzare l'agente

L'intestazione della chat ha un pulsante di ricerca e un ingranaggio. L'ingranaggio apre le impostazioni dell'agente in un pannello accanto alla chat, senza lasciarla. Mostra l'agente, poi le sue sezioni, ognuna con la sua icona: **Generali**, **Plugin**, **Approvazioni**, **Automazioni**, **File** e **Accesso**. Una sezione aperta mostra una freccia indietro, la sua icona e il suo nome, poi una riga che dice a cosa serve; la freccia risale di un livello. Trascina il bordo del pannello per ridimensionarlo e chiudilo con **×**; su un telefono si apre come un foglio. L'agente può modificare da solo quasi tutte queste impostazioni quando glielo chiedi in chat. I controlli disponibili dipendono dal tuo accesso.

Continua con [la tua chat con un agente](https://docs.opser.com/it/agents/conversations/), [contesto e memoria](https://docs.opser.com/it/agents/context/), oppure [file persistenti](https://docs.opser.com/it/agents/files/).