Ihr Projekt
Ein Projekt ist ein Git-Repository, das die Konfiguration und den Zustand Ihres Agents enthält.
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 zweigt davon ab. Jeder
Änderungsantrag 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, seine Trigger, 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 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. |