Pacchetto
Esporta, condividi e installa agenti come archivi portatili.
Cosa fa
Un agente, la sua struttura di cartelle, la configurazione, la conoscenza e i flussi di lavoro vengono serializzati in un unico archivio ZIP .agentpkg con un manifesto, un elenco di collaboratori e un record di provenienza. L'installazione segue un flusso in tre fasi: Pianificazione (ispezione a zero scritture), Revisione (verifica di un digest), Applicazione (scrittura con controllo di sicurezza TOCTOU). Sono disponibili tre modalità di distribuzione: esportazione diretta in un file, link di passaggio privati con token di condivisione in scadenza e una galleria showcase curata con esecuzioni di prova verificate come proof-of-concept.
Perché è importante
Un agente che non puoi spostare è un agente che non possiedi. Gli archivi portatili consentono a un agente di spostarsi tra account, strumenti e modelli senza perdere la propria conoscenza, e la fase di pianificazione prima dell'applicazione rende l'installazione una decisione, non un effetto collaterale.
Come funziona
Nessuna fuga di ID oltre i limiti del pacchetto
Gli UUID interni vengono rigenerati con uuidv5 durante la serializzazione, quindi un pacchetto non contiene identificatori di account, tenant o cartelle di origine.
Installazione in tre fasi con sicurezza TOCTOU
La Pianificazione ispeziona a zero scritture, la Revisione verifica un digest, l'Applicazione controlla nuovamente il digest prima di scrivere. Un pacchetto modificato tra la revisione e l'applicazione viene rifiutato.
Lo Showcase include esecuzioni di prova verificate
Un flusso di lavoro nella galleria showcase include un'esecuzione reale oscurata in modo da poterne osservare il funzionamento prima dell'installazione, e la verifica viene controllata al momento della visualizzazione.
Domande
- Cosa contiene un pacchetto?
- La struttura delle cartelle, ogni documento foglia, i file di configurazione .context e .agent, i flussi di lavoro e un manifesto con i metadati dei collaboratori e di provenienza. Nessuna credenziale, nessun embedding, nessuno stato di verifica.
- Posso condividere un pacchetto con qualcuno su un account diverso?
- Sì. Un link di passaggio privato contiene un token di condivisione a tempo. Il destinatario lo installa nel proprio account tramite lo stesso flusso pianificazione-revisione-applicazione.
The rest of the bag
AccessControl
Permessi per singolo documento che filtrano le risposte, non solo le pagine.
La risoluzione dei criteri è memorizzata nella cache per sessione per motivi di velocità; una modifica dei permessi si propaga all'invalidazione della cache anziché istantaneamente su ogni richiesta in corso.
Documentazione
Un albero di cartelle che l'agente legge e un file di configurazione a cui obbedisce.
L'estrazione copre PDF, fogli di calcolo e trascrizioni. I formati binari esotici non vengono analizzati.
Eventi
Un registro persistente di ciò che gli agenti hanno fatto e perché.
L'event bus in-process è un emettitore a nodo singolo, non un broker distribuito. Il record persistente tra gli agenti è un registro delle attività Postgres separato.
That was step 6 of 6: a reply leaves, and the trail stays. Questo è l'intero percorso, dall'arrivo a una registrazione riproducibile.