Condividere un agente di coding porta con sé un piccolo vocabolario. La maggior parte dei termini appartiene al linguaggio comune, ed è proprio per questo che spesso viene usata in modo approssimativo. Questa pagina fissa il significato di ciascuno in muti, dedicando a ognuno un singolo paragrafo, così che ogni definizione possa essere citata indipendentemente dal resto del post.
Stanza dell'agente
Una stanza dell'agente è uno spazio condiviso in cui un agente di coding in esecuzione sulla macchina di una persona può essere raggiunto da un piccolo gruppo di persone fidate. La stanza ospita la conversazione, la timeline delle richieste e le approvazioni. L'agente, il suo abbonamento, i suoi file e le sue credenziali rimangono sulla macchina del proprietario. Nulla viene condiviso per impostazione predefinita; la stanza rappresenta il confine invalicabile e nulla passa da una stanza all'altra. La spiegazione approfondita si trova in Cos'è una stanza dell'agente?
Agente
Un agente è un runtime come Claude Code o Codex vincolato a una directory di lavoro su una singola macchina, dotato di un handle, un avatar, uno stato online, una modalità di autorizzazione e una inbox. Una macchina può ospitare più agenti; un agente può appartenere a più stanze. Agli agenti viene assegnato un nome in base all'attività svolta (api, site, notes) anziché in base al modello sottostante.
Proprietario
Il proprietario è la persona sulla cui macchina è in esecuzione un agente. Il proprietario approva le richieste altrui, stabilisce le autorizzazioni permanenti ed è l'unico che può approvare uno dei quattro tipi di azioni pericolose o rispondere a una richiesta di credenziali tramite prompt. Il proprietario non è soggetto alle modalità di autorizzazione sul proprio agente, ma le sue azioni vengono registrate come quelle di chiunque altro.
Membro
Un membro è una persona presente in una stanza che non ne è il proprietario. I membri inviano richieste, visualizzano la timeline e ricevono i risultati. Ciò che un membro può eseguire è stabilito da approvazioni e autorizzazioni permanenti, mai dal semplice fatto di trovarsi nella stanza.
Inbox
La inbox è la coda dedicata al singolo agente in cui le richieste attendono quando la macchina è offline o occupata. Ciascun agente elabora la propria inbox in ordine, una richiesta alla volta; agenti diversi sulla stessa macchina operano in parallelo. Il proprietario può rimuovere o riordinare gli elementi in coda.
Richiesta
Una richiesta è una singola attività inviata a un agente. Ha un identificativo pubblico come R20260906-01 e uno stato: pending, approved, running, done, failed, cancelled o expired. Una richiesta può essere annullata, ritentata o ripresa con lo stesso id dopo un'interruzione.
Timeline
La timeline è il registro persistente e in tempo reale di una richiesta: messaggi, chiamate ai tool con riepilogo degli argomenti, diff dei file indicati per percorsi e conteggio righe, comandi con exit code e coda dell'output, artefatti (file, immagini, link), approvazioni, takeover ed errori. Viene trasmessa in streaming a tutti i partecipanti alla stanza man mano che si verificano gli eventi e rimane archiviata successivamente.
Modalità di autorizzazione
Una modalità di autorizzazione è l'insieme di regole dell'agente che determina cosa possa essere eseguito senza chiedere conferma, ereditato direttamente dal runtime: per Claude Code, plan, default, acceptEdits e bypassPermissions. Viene scelta per ciascun agente dal proprietario. Vedi Le modalità di autorizzazione di Claude Code spiegate.
Autorizzazione permanente
Un'autorizzazione permanente è la decisione del proprietario con cui consente a una persona specifica di eseguire un determinato agente in una stanza specifica senza richiedere l'approvazione per ogni singola richiesta. È revocabile in qualsiasi momento; revocarla annulla le richieste in coda di quella persona. I quattro tipi di azioni pericolose restano in pausa anche in presenza di un'autorizzazione permanente.
Approvazione
Un'approvazione è una pausa nell'esecuzione che attende che il proprietario accetti, rifiuti o prosegua in sola lettura, facoltativamente aggiungendo una nota che ha lo stesso peso della richiesta. Le approvazioni vengono richieste per effettuare push su un branch condiviso, eliminare elementi, spendere denaro e toccare credenziali, a prescindere dal livello di fiducia, e scadono dopo un intervallo prestabilito se non ricevono risposta. Vedi quattro azioni che un agente dovrebbe sempre chiedere prima di eseguire.
Takeover
Un takeover è la richiesta di intervento umano formulata da un agente durante un'esecuzione. I takeover relativi alle credenziali (login, codici di autenticazione a due fattori, accesso a chiavi) vengono instradati verso il proprietario. Le domande sull'intento ("intendevi staging?") vengono instradate verso chi ha inviato la richiesta. Entrambi visualizzano lo scambio nella stessa timeline.
Prendere in prestito un agente
Prendere in prestito un agente significa utilizzare l'agente di qualcun altro, sulla sua macchina e con il suo abbonamento, dal proprio contesto, all'interno di un'autorizzazione che il proprietario può revocare. Chi prende in prestito ottiene l'utilizzo, la timeline e i risultati, mai l'account, le credenziali o i file. Vedi Prendere in prestito un agente.
Daemon
Il daemon è il piccolo processo in background sulla macchina del proprietario che rileva i runtime installati, interroga il servizio delle stanze tramite una connessione in uscita, esegue le richieste localmente e carica gli eventi sulla timeline. Non carica mai file, variabili d'ambiente o chiavi, e non apre alcuna porta. Installato come servizio, si avvia al login e si riavvia automaticamente dopo un arresto anomalo.
Macchina
Una macchina è un computer abbinato a un account muti dal suo proprietario. Nulla viene eseguito finché il proprietario non approva la macchina nella web app. Le macchine comunicano il proprio indirizzo locale e pubblico affinché un proprietario con più macchine possa distinguerle, e possono essere revocate in qualsiasi momento.
Artefatto
Un artefatto è un file, un'immagine o un link prodotto da un agente durante una richiesta. Gli artefatti compaiono tra gli output della stanza per il download, incluse le immagini generate dall'agente al di fuori della sua directory di lavoro.
Se manca un termine di cui hai bisogno, le FAQ nella home page coprono le questioni relative al prodotto, e ciascun articolo sopraindicato approfondisce un singolo concetto.
Pubblicato il · Aggiornato il