# Il tuo progetto

Un progetto è un repository Git che contiene la configurazione e lo stato del tuo agente.

Canonical page: https://beeuni.ai/docs/it/project

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](/docs/it/work/sessions) parte da esso. Ogni
[richiesta di modifica](/docs/it/work/change-requests) 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.

<a id="a-project-is-not-your-codebase"></a>

## Un progetto non è la tua codebase

Un progetto contiene le istruzioni del tuo agente, i suoi
[connettori](/docs/it/connect/connectors), i suoi [trigger](/docs/it/connect/triggers),
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.

<a id="the-manifest"></a>

## 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](/docs/it/project/legacy-toml) per il percorso di migrazione.

<a id="deleting-a-project"></a>

## 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. |

<a id="in-this-section"></a>

## In questa sezione

- [Manifest](/docs/it/project/manifest): Il riferimento completo a beeuni.yaml.
- [Agenti](/docs/it/project/agents): Personas in Markdown con strumenti con ambito limitato.
- [Modelli](/docs/it/project/models): Quale modello usa una sessione e chi paga.
- [Segreti](/docs/it/project/secrets): Valori crittografati inseriti in una sandbox.
- [TOML legacy](/docs/it/project/legacy-toml): Migrazione da beeuni.toml.