Il tuo progetto
Un progetto è un repository Git che contiene la configurazione e lo stato del tuo agente.
Un progetto è un singolo repository Git. Contiene un manifest, la configurazione dell’agente e lo stato prodotto dall’agente. Non esiste un database separato da mantenere sincronizzato.
Beeuni gestisce un progetto in due modi:
- Repository gestito da Beeuni — Beeuni crea e ospita un repository privato. Predefinito.
- Repository GitHub importato — collega un repository esistente. Beeuni vi opera tramite l’API di GitHub.
In entrambi i casi, il progetto ha un default_branch. Ogni
sessione parte da esso. Ogni
richiesta di modifica viene unita a esso. Ogni branch di un
repository GitHub può diventare un progetto autonomo. main e dev possono quindi essere eseguiti come progetti separati, ciascuno con le proprie sessioni e richieste di modifica.
Un progetto non è la tua codebase
Un progetto contiene le istruzioni del tuo agente, i suoi connettori, i suoi trigger, e la sua memoria. Mantienilo piccolo: Beeuni lo clona in ogni sessione.
Il tuo codice vive altrove. Quando un’attività richiede una codebase, l’agente clona quel repository, svolge il lavoro e apre una richiesta di modifica verso di esso. Non trasformare una codebase esistente in un progetto aggiungendovi un manifest. Crea invece un progetto dedicato e indirizzalo ai repository su cui lavora l’agente.
Il manifest
Ogni progetto ha un manifest nella radice del repository, beeuni.yaml per impostazione predefinita. La piattaforma legge queste chiavi di primo livello:
| Chiave | Configura |
|---|---|
default_agent |
quale agente viene eseguito per impostazione predefinita |
agents |
autorizzazioni per agente: connettori, segreti, competenze, autorizzazioni Beeuni |
sandbox |
l’immagine della sandbox e l’hardware |
triggers |
automazioni pianificate e tramite webhook |
connectors |
quali strumenti esterni il progetto può raggiungere |
env |
i nomi delle variabili d’ambiente richieste dal progetto (i valori provengono dai segreti) |
Le chiavi sconosciute vengono ignorate.
I progetti meno recenti possono ancora usare beeuni.toml (beeuni_version: 1). Beeuni legge entrambi i formati. Consulta TOML legacy per il percorso di migrazione.
Eliminazione di un progetto
Elimina un progetto con Elimina progetto nella sezione Zona pericolosa delle impostazioni oppure con beeuni projects rm. Da quel momento, nulla può agire per il progetto:
| Metodo di accesso | Dopo l’eliminazione |
|---|---|
Chiavi del gateway LLM (kgw_…) |
Rifiutate con 401. |
| Link di condivisione pubblici | Rispondono 410. |
| App | Non vengono servite. |
| Nuove sessioni | Rifiutate: 404, code: "project_archived". |
| Slack e Teams | Rispondono “Questo workspace Beeuni è stato eliminato…” e non avviano nulla. |
| Caselle email | Rispondono una volta alla prima email di un thread: “Questo indirizzo non accetta email al momento. Nessuno risponderà a questo messaggio.” La risposta successiva nello stesso thread entro 30 giorni non riceve nulla e le email che non superano l’autenticazione del mittente non ricevono mai risposta. |
| Sessioni esistenti | Non ricevono nuovi messaggi: né da un thread di chat, né da un trigger, né da un prompt accodato prima dell’eliminazione. |