---
title: "Votre projet"
description: "Un projet est un dépôt Git qui contient la configuration et l’état de votre agent."
---

Un projet correspond à un dépôt Git. Il contient un manifeste, la configuration de l’agent et l’état que celui-ci produit. Aucune base de données distincte n’est à synchroniser.

Beeuni gère un projet de deux façons :

- **Dépôt géré par Beeuni** — Beeuni crée et héberge un dépôt privé. C’est l’option par défaut.
- **Dépôt GitHub importé** — connectez un dépôt existant. Beeuni interagit avec lui via l’API GitHub.

Dans les deux cas, le projet a une `default_branch`. Chaque
[session](/docs/fr/work/sessions) en part. Chaque
[demande de modification](/docs/fr/work/change-requests) y est fusionnée. Chaque branche d’un
Dépôt GitHub peut devenir son propre projet. `main` et `dev` peuvent alors s’exécuter comme des projets distincts, chacun avec ses propres sessions et demandes de modification.

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

## Un projet n’est pas votre base de code

Un projet contient les instructions de votre agent, ses
[connecteurs](/docs/fr/connect/connectors), ses [déclencheurs](/docs/fr/connect/triggers),
et sa mémoire. Gardez-le léger : Beeuni le clone dans chaque session.

Votre code se trouve ailleurs. Lorsqu’une tâche nécessite une base de code, l’agent clone ce dépôt, y effectue le travail et y ouvre une demande de modification. Ne transformez pas une base de code existante en projet en y ajoutant un manifeste. Créez plutôt un projet dédié et indiquez les dépôts sur lesquels l’agent travaille.

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

## Le manifeste

Chaque projet possède un manifeste à la racine de son dépôt, `beeuni.yaml` par défaut. La plateforme lit les clés de premier niveau suivantes :

| Clé | Configure |
|---|---|
| `default_agent` | l’agent exécuté par défaut |
| `agents` | les autorisations par agent : connecteurs, secrets, compétences et autorisations Beeuni |
| `sandbox` | l’image du bac à sable et le matériel |
| `triggers` | l’automatisation planifiée et par webhook |
| `connectors` | les outils externes auxquels le projet peut accéder |
| `env` | les noms de variables d’environnement attendus par le projet (les valeurs proviennent des secrets) |

Les clés inconnues sont ignorées.

Les anciens projets peuvent encore utiliser `beeuni.toml` (`beeuni_version: 1`). Beeuni lit les deux formats. Consultez [TOML hérité](/docs/fr/project/legacy-toml) pour connaître la procédure de migration.

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

## Supprimer un projet

Supprimez un projet avec **Delete project** sous **Danger zone** dans ses paramètres, ou avec `beeuni projects rm`. À partir de ce moment, rien ne peut agir au nom du projet :

| Moyen d’accès | Après la suppression |
|---|---|
| Clés de la passerelle LLM (`kgw_…`) | Refusées avec `401`. |
| Liens de partage publics | Répondent `410`. |
| Applications | Ne sont plus servies. |
| Nouvelles sessions | Refusées : `404`, `code: "project_archived"`. |
| Slack et Teams | Répondent « Cet espace de travail Beeuni a été supprimé… » et ne démarrent rien. |
| Boîtes de réception e-mail | Répondent une seule fois au premier e-mail d’un fil : « Cette adresse n’accepte pas les e-mails pour le moment. Personne ne répondra à ce message. » La réponse suivante dans ce fil, dans les 30 jours, ne reçoit aucune réponse, et les e-mails dont l’authentification de l’expéditeur échoue ne reçoivent jamais de réponse. |
| Sessions existantes | Ne reçoivent aucun nouveau message : ni d’un fil de discussion, ni d’un déclencheur, ni d’une invite mise en file d’attente avant la suppression. |

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

## Dans cette section

<CardGroup>
  <Card icon="file-text" title="Manifeste" href="/docs/fr/project/manifest">La référence complète de beeuni.yaml.</Card>
  <Card icon="bot" title="Agents" href="/docs/fr/project/agents">Des personas Markdown avec des outils à portée limitée.</Card>
  <Card icon="brain" title="Modèles" href="/docs/fr/project/models">Le modèle utilisé par une session et qui le paie.</Card>
  <Card icon="key" title="Secrets" href="/docs/fr/project/secrets">Valeurs chiffrées injectées dans un bac à sable.</Card>
  <Card icon="scroll-text" title="TOML hérité" href="/docs/fr/project/legacy-toml">Migration depuis beeuni.toml.</Card>
</CardGroup>
