Percorsi e destinazione dei file
Risolvi i percorsi relativi e consulta Home, cartelle di output e conservazione dei file.
Risoluzione dei percorsi
I percorsi relativi partono dalla cartella di chi esegue; quelli assoluti dalla radice condivisa del Workspace. Un percorso cambia la destinazione, mai i permessi. Gli agenti devono comunque avere accesso alle destinazioni condivise.
./reports/q3.md
Home dell’agente o cartella del workflow → reports/q3.md
/reports/q3.md
Cartella reports condivisa → q3.md
La destinazione richiede comunque i permessi.
| Percorso | Agente | Workflow |
|---|---|---|
./reports/q3.md | reports/q3.md nella sua Home. | reports/q3.md nella cartella del workflow. |
reports/q3.md | Come ./reports/q3.md. | Come ./reports/q3.md. |
/reports/q3.md | Cartella reports alla radice condivisa, se concessa. | Cartella reports alla radice condivisa. |
{{workflow.tmp}}/rows.csv | Variabile solo per workflow. | Cartella File temporanei di questa esecuzione. |
L’Assistente della dashboard lavora alla radice, dove queste forme relative e assolute coincidono. Usa percorsi espliciti ./ o / nelle istruzioni e nei passaggi. Gli strumenti restituiscono percorsi riutilizzabili nella stessa forma.
Home e cartelle dei workflow
| Posizione | Contenuto e accesso |
|---|---|
| Home dell’agente sotto Agents/ | Accesso fisso in lettura e scrittura per quell’agente; gli operatori la gestiscono. Gli altri agenti non possono sfogliarla. |
| AGENTS.md | Identità gestita dagli operatori; letta a ogni esecuzione e conversazione. |
| MEMORY.md | Memoria dell’agente; letta quando serve. |
| Skills/ | Procedure; lette quando la descrizione corrisponde al compito. |
| Scripts/ | Codice riutilizzabile eseguito con Esecutore di codice. |
| Chats/ | Una cartella per chat agente, etichettata con il membro; allegati originali dell’account. |
| tmp/ | File di lavoro dell’agente. I file che l’agente scrive qui non vengono mai allegati alle sue risposte; quelli scritti altrove sì. |
| Cartella del workflow sotto Workflows/ | Output e stato persistenti; variabile Cartella del workflow o percorsi ./. |
| File temporanei / Esecuzione | Cartella di lavoro separata per esecuzione; variabile File temporanei (questa esecuzione). |
Le Home contengono istruzioni leggibili: non conservarci mai segreti. I workflow hanno cartelle, non Home di agenti. Un passaggio agente mantiene la propria Home come base dei percorsi relativi e ottiene accesso alla cartella del workflow per quella esecuzione.
Rinominare un workflow non sposta la cartella. Eliminarlo conserva cartella e file persistenti; i temporanei passano nel Cestino. automations/ archiviato e .runs/ nascosto restano in sola lettura per gli operatori.
Dove finiscono gli output
| Origine | Destinazione predefinita |
|---|---|
| File con nome senza cartella | Cartella di chi esegue: Home dell’agente, cartella del workflow o radice della dashboard. |
| Immagini, video o documenti generati | images/, videos/ o documents/ sotto la cartella di chi esegue. |
| Download esterno o allegato email salvato | downloads/ sotto la cartella di chi esegue; downloads/ alla radice per l’Assistente della dashboard. |
| Risultato di uno strumento del workflow salvato senza percorso | Cartella temporanea di questa esecuzione; i risultati da conservare vanno nella cartella del workflow. Un passaggio agente salva invece nella Home dell’agente. |
| Allegato della chat agente | Cartella della chat sotto Chats/ nella Home. Eliminare la conversazione lascia il file. |
| Caricamento nella chat dashboard | La tua cartella sotto chat-attachments/ nel Workspace dell’account. |
| File dell’assistente personale di un membro | File personali di quel membro. |
Agenti dell’account, workflow e Assistente della dashboard salvano sempre nel Workspace dell’account. Una scrittura fallita o negata non ripiega sui File personali.
Conservazione
| Materiale o azione | Effetto sulla conservazione |
|---|---|
| Risultato voluminoso di uno strumento salvato fuori dalle cartelle temporanee | Temporaneo per impostazione predefinita; scade dopo 24 ore, salvo conservazione. |
| File in tmp/ di un agente o nella cartella temporanea di un workflow | Scade sette giorni dopo l’ultima scrittura; una nuova scrittura riavvia il conteggio. |
| Scadenza | La pulizia ogni ora sposta il file nel Cestino. |
| Cestino | Recuperabile per sette giorni, poi eliminato definitivamente; conta nell’archiviazione fino alla rimozione. |
| Mantieni, rinomina o spostamento | Rende permanente un file temporaneo. |
| Spostamento o rinomina in una cartella temporanea | Rifiutato; scrivi invece un nuovo file lì. |
| Modifica successiva dell’agente fuori dalle cartelle temporanee | Rende permanente il file temporaneo. |
| Scrittura in una cartella temporanea | Riapplica la scadenza di sette giorni, anche se prima era stato conservato. |
Salva i risultati da consegnare e lo stato necessario alle esecuzioni successive fuori dalle cartelle temporanee.