# Ihr Projekt
Ein Projekt ist ein Git-Repository, das die Konfiguration und den Zustand Ihres Agents enthält.
Canonical page: https://beeuni.ai/docs/de/project
Ein Projekt ist ein einzelnes Git-Repository. Es enthält ein Manifest, die Agentenkonfiguration und den Status, den dein Agent erzeugt. Es gibt keine separate Datenbank, die synchron gehalten werden muss.
Beeuni verwaltet ein Projekt auf zwei Arten:
- **Von Beeuni verwaltetes Repo** — Beeuni erstellt und hostet ein privates Repo. Standard.
- **Importiertes GitHub-Repo** — verbinde ein vorhandenes Repo. Beeuni greift über die GitHub API darauf zu.
In beiden Fällen hat das Projekt einen `default_branch`. Jede
[Session](/docs/de/work/sessions) zweigt davon ab. Jeder
[Änderungsantrag](/docs/de/work/change-requests) wird darin zusammengeführt. Jeder Branch eines
GitHub-Repos kann zu einem eigenen Projekt werden. `main` und `dev` können dann als separate Projekte laufen, jeweils mit eigenen Sessions und Änderungsanträgen.
## Ein Projekt ist nicht deine Codebasis
Ein Projekt enthält die Anweisungen deines Agenten, seine
[Connectors](/docs/de/connect/connectors), seine [Trigger](/docs/de/connect/triggers),
und sein Gedächtnis. Halte es klein — Beeuni klont es in jede Session.
Dein Code liegt anderswo. Wenn eine Aufgabe eine Codebasis erfordert, klont der Agent dieses Repository, erledigt die Arbeit und erstellt darin einen Änderungsantrag. Verwandle eine vorhandene Codebasis nicht in ein Projekt, indem du ihr ein Manifest hinzufügst. Erstelle stattdessen ein eigenes Projekt und verweise darin auf die Repositories, an denen der Agent arbeitet.
## Das Manifest
Jedes Projekt hat ein Manifest im Stammverzeichnis seines Repos, standardmäßig `beeuni.yaml`. Die Plattform liest die folgenden Schlüssel der obersten Ebene aus:
| Schlüssel | Konfiguriert |
|---|---|
| `default_agent` | welcher Agent standardmäßig ausgeführt wird |
| `agents` | Berechtigungen pro Agent: Connectors, Secrets, Skills, Beeuni-Berechtigungen |
| `sandbox` | das Sandbox-Image und die Hardware |
| `triggers` | geplante Automatisierung und Webhook-Automatisierung |
| `connectors` | welche externen Tools das Projekt erreichen kann |
| `env` | erwartete Umgebungsvariablennamen des Projekts (Werte stammen aus Secrets) |
Unbekannte Schlüssel werden ignoriert.
Ältere Projekte können weiterhin `beeuni.toml` (`beeuni_version: 1`) verwenden. Beeuni liest beide Formate. Unter [Legacy TOML](/docs/de/project/legacy-toml) findest du den Migrationspfad.
## Ein Projekt löschen
Lösche ein Projekt über **Delete project** unter **Danger zone** in den Einstellungen oder mit `beeuni projects rm`. Ab diesem Zeitpunkt kann nichts mehr für das Projekt handeln:
| Zugangsweg | Nach dem Löschen |
|---|---|
| LLM-Gateway-Schlüssel (`kgw_…`) | Werden mit `401` abgelehnt. |
| Öffentliche Freigabelinks | Antworten mit `410`. |
| Apps | Werden nicht bereitgestellt. |
| Neue Sessions | Werden abgelehnt: `404`, `code: "project_archived"`. |
| Slack und Teams | Antworten mit „Dieser Beeuni-Arbeitsbereich wurde gelöscht …“ und starten nichts. |
| E-Mail-Postfächer | Antworten einmal auf die erste E-Mail eines Threads: „Diese Adresse nimmt derzeit keine E-Mails entgegen. Niemand wird auf diese Nachricht antworten.“ Auf die nächste Antwort in diesem Thread innerhalb von 30 Tagen erfolgt keine Reaktion. E-Mails, deren Absenderauthentifizierung fehlschlägt, erhalten ebenfalls keine Antwort. |
| Bestehende Sessions | Nehmen keine neuen Nachrichten an: weder aus einem Chat-Thread noch von einem Trigger oder einer vor dem Löschen eingereihten Eingabeaufforderung. |
## In diesem Abschnitt
- [Manifest](/docs/de/project/manifest): Die vollständige Referenz zu beeuni.yaml.
- [Agents](/docs/de/project/agents): Markdown-Personas mit eingeschränkten Tools.
- [Modelle](/docs/de/project/models): Welches Modell eine Session verwendet und wer dafür bezahlt.
- [Secrets](/docs/de/project/secrets): Verschlüsselte Werte, die in eine Sandbox eingefügt werden.
- [Legacy TOML](/docs/de/project/legacy-toml): Migration von beeuni.toml.