Projekte¶

Gib jedem Vorhaben sein eigenes Fach. Ein Projekt ist ein eigener Ordner auf dem Server deines Agenten, mit eigenen Dateien, eigenen Anweisungen und eigenen Unterhaltungen. Die Renovierung bleibt bei der Renovierung, die Abschlussarbeit bei der Abschlussarbeit — alles auf einem Agenten.

🏠 Allgemeindein Hauptordner

💬Wochenplan
💬Fragen zur Steuererklärung

📁 Renovierungneue Chats beginnen hier

📝„Budget 15.000 €, immer drei Angebote vergleichen“
📄angebote.pdf · grundriss.png
💬Küchenfliesen
💬Termine mit dem Elektriker

📁 Familienurlaub👥 geteilt

📄tickets.pdf
💬Reiseplan Tag für Tag

Was dir ein Projekt bringt¶

Ein eigener Ordner

Der Agent arbeitet im Ordner des Projekts: Dateien, die du in seinen Unterhaltungen schickst, landen dort, genauso wie die Dateien, die er erstellt, der Code, den er ausführt, und die Jobs, die er einplant.
Eigene Anweisungen

Eine Notiz, die der Agent zu Beginn jeder Unterhaltung im Projekt liest: wofür es da ist, wie gearbeitet wird, worauf er achten soll.
Eigene Unterhaltungen

Die Unterhaltungsliste zeigt das Projekt, in dem du gerade bist, und jeder neue Chat beginnt dort. Nichts zu merken, nichts hinterher zu sortieren.
Privat oder geteilt

Auf einem Agenten, den du mit anderen teilst, kann ein Projekt nur dir gehören oder mit allen geteilt sein, samt Dateien und Unterhaltungen.

Alles andere ist in jedem Projekt ein und dasselbe: Gedächtnis und Persona des Agenten, seine Skills, Modell und Einstellungen, Schlüssel und Anmeldungen sowie dein Guthaben. Dateimanager und Terminal im Panel zeigen immer den ganzen Server. Ein Projektwechsel ändert, wo der Agent arbeitet, nicht, wer er ist.

1 Projekte einschalten¶

Projekte sind aus, bis jemand sie einschaltet, und solange sie aus sind, siehst du nichts davon: Jede Unterhaltung arbeitet in deinem Hauptordner. Weil sie neu sind, kennzeichnet das Panel sie mit Beta.

Panel: Einstellungen → Projekte → Projekte verwenden.
Telegram: Schick /projects und tippe auf ▶️ Projekte einschalten.

Der Schalter gilt für den ganzen Agenten: Jeder, der ihn nutzt, ob Eigentümer oder eingeladener Nutzer, kann ihn ein- und ausschalten. Ausschalten rührt keinen Ordner an. Unterhaltungen, die in einem Projekt begonnen wurden, arbeiten dort weiter; nur neue landen wieder in deinem Hauptordner.

2 Ein Projekt anlegen¶

Panel: Öffne den Projektumschalter oben in der Seitenleiste und wähle Neues Projekt. Gib ihm einen Namen, drück Projekt hinzufügen, und schon bist du drin, mit einem neuen Chat, der auf dich wartet.
Telegram: /projects → ➕ Neues Projekt, dann schick den Namen. Der Bot legt das Projekt an und wechselt dich hinein.
Einstellungen → Projekte → + Neues Projekt legt eines an, ohne dass du das Projekt verlässt, in dem du gerade bist.

Jedes Projekt bekommt einen eigenen Ordner auf dem Server des Agenten.

💡 Ist bei deinem Agenten Zusätzliche Benutzer erlauben eingeschaltet, fragt das Panel außerdem Wer es sieht: Nur ich oder Alle Nutzer dieses Agenten. Das lässt sich später ändern, siehe Projekte auf einem geteilten Agenten. Ein in Telegram angelegtes Projekt ist zunächst privat.

3 Zwischen Projekten wechseln¶

Im Panel zeigt der Umschalter über der Unterhaltungsliste, in welchem Projekt du bist. Wähl ein anderes, und seine Unterhaltungen füllen die Liste; neue Chats beginnen dann dort. Projekte verwalten unten im selben Menü öffnet die Einstellungen.

In Telegram listet /projects (oder /menu → Einstellungen → 📁 Projekte) deine Projekte auf: 🏠 deinen Hauptordner, 📁 deine eigenen, 👥 die geteilten, mit ✅ beim aktiven. Tippe auf ein anderes, um zu wechseln. Gehört der Chat, in dem du gerade bist, zu einem anderen Projekt, beginnt sofort eine neue Unterhaltung im gewählten, und ihr angehefteter Titel beginnt mit dem Namen des Projekts. /sessions listet danach die Unterhaltungen dieses Projekts auf, mit dem Projektnamen ganz oben.

Umbenennen, Teilen, Anweisungen und Entfernen erledigst du im Panel.

Gut zu wissen:

Eine Unterhaltung bleibt, wo sie begonnen hat. Ein Wechsel verschiebt nie einen Chat, der schon läuft. Er behält sein Projekt, seinen Ordner und seine Anweisungen; der Umschalter entscheidet, wo der nächste beginnt.
Panel und Telegram wählen getrennt. Du kannst in Telegram in Renovierung sein, während das Panel Abschlussarbeit zeigt. Jedes merkt sich seine eigene Wahl.

4 Dem Projekt Anweisungen geben¶

Einstellungen → Projekte → das ⋯ neben einem Projekt → Anweisungen…

Schreib dort hinein, was der Agent wissen soll: wofür das Projekt da ist, wer beteiligt ist, welche Entscheidungen schon gefallen sind, wie du die Arbeit gern erledigt haben möchtest. Der Agent liest das zu Beginn jeder Unterhaltung in diesem Projekt, sodass du den Hintergrund nicht jedes Mal neu erklären musst.

Zum Beispiel

„Renovierung unserer Wohnung. Budget 15.000 €, fertig bis März. Immer mindestens drei Angebote vergleichen. Führe in kosten.xlsx eine laufende Kostentabelle und aktualisiere sie, sobald ein Angebot eingeht.“

Das Wichtigste nach oben

Eine laufende Unterhaltung behält die Anweisungen, mit denen sie begonnen hat; eine Änderung gilt also ab dem nächsten Chat. Lange Anweisungen sind kein Problem, aber nur die ersten paar Tausend Zeichen erreichen den Agenten direkt, den Rest liest er bei Bedarf aus der Datei.

Die Anweisungen liegen als ganz normale Datei (AGENTS.md) im Projektordner, du kannst also auch den Agenten bitten, sie für dich zu schreiben oder zu aktualisieren.

Dein Hauptordner¶

Jeder, der den Agenten nutzt, hat einen eigenen Hauptordner, der im Umschalter als Allgemein erscheint. Dort arbeiten Unterhaltungen, solange Projekte aus sind, und dort liegt alles aus der Zeit vor den Projekten.

Allgemein ist eher dein Zuhause als ein Projekt: Es lässt sich nicht umbenennen, teilen oder entfernen. Es ist auch der richtige Ort für Arbeit, die mehrere Projekte umfasst. In einem Projekt bleibt der Agent im Ordner dieses Projekts, von Allgemein aus kommt er dagegen an alle heran.

Projekte auf einem geteilten Agenten¶

Wenn du deinen Agenten mit anderen teilst, bekommt jeder seinen eigenen Hauptordner und seine eigenen Projekte. Jedes Projekt ist eins von beidem:

Privat (Standard)

Nur bei dir aufgeführt, und nur deine Unterhaltungen landen dort.
Geteilt

Bei allen Nutzern des Agenten aufgeführt und mit Geteilt markiert. Alle arbeiten mit denselben Dateien und Anweisungen, und auch die Unterhaltungen darin sind geteilt.

In einem geteilten Projekt gehören die Unterhaltungen allen. Jeder sieht sie in der Liste des Projekts und kann sie lesen, fortsetzen, umbenennen oder löschen. So können mehrere Leute im selben Chat arbeiten: im Panel oder in Telegram, wo /sessions sie mit 👥 markiert und ein Tipp dich dazuholt. Jede Nachricht zeigt, wer sie geschrieben hat, und der Agent weiß, wem er antwortet. Er beantwortet eine Nachricht nach der anderen: Wird gerade die Nachricht von jemand anderem beantwortet, sagen dir Panel oder Bot Bescheid, und du schickst deine, sobald die Antwort da ist.

Teilen oder privat machen im ⋯-Menü des Projekts: Mit allen Nutzern teilen oder Privat machen. Ein privat gemachtes Projekt verschwindet aus den Listen der anderen, und ihre Unterhaltungen daraus laufen in ihrem eigenen Hauptordner weiter.
Wer ein geteiltes Projekt verwaltet: die Person, die es angelegt hat, und der Eigentümer des Agenten. Umbenennen und Entfernen liegen bei ihnen. Nur wer es angelegt hat, kann es wieder privat machen.
Hintergrundjobs in einem geteilten Projekt gehören allen. Jeder Nutzer sieht sie unter Einstellungen → Hintergrundjobs, kann sie ändern und bekommt ihre Benachrichtigungen im Panel und in Telegram.
Wird ein Nutzer entfernt, bleiben die Projekte, die er geteilt hat, geteilt und gehen an den Eigentümer über. Seine privaten Projekte verschwinden aus den Listen, die Dateien bleiben auf dem Server.

Privat heißt ausgeblendet, nicht weggesperrt

Eingeladene Nutzer sind vertrauenswürdige Nutzer. Die Arbeit aller läuft unter demselben Konto auf dem Server des Agenten. Ein privates Projekt ist also in den Listen der anderen verborgen, aber kein Tresor. Was wirklich geheim ist, gehört nicht auf einen geteilten Agenten.

Ein Projekt entfernen oder endgültig löschen¶

Gelöscht wird in zwei Schritten, damit nichts aus Versehen verschwindet:

⋯ → Aus der Liste entfernen. Das Projekt verschwindet aus den Listen, aber seine Dateien und Unterhaltungen bleiben auf dem Server, und deine Unterhaltungen daraus erscheinen unter Allgemein. Du findest das Projekt unter Entfernte Projekte ganz unten in Einstellungen → Projekte, wo Zurück in die Liste es wiederherstellt.
Entfernte Projekte → ⋯ → Endgültig löschen… Das löscht den Ordner mit allen Dateien darin und allen Unterhaltungen, die darin gearbeitet haben, und lässt sich nicht rückgängig machen. Zur Bestätigung tippst du den Ordnernamen ein. Bei einem geteilten Projekt zeigt dir das Panel außerdem, wie viele andere Nutzer Unterhaltungen darin haben.

Gut zu wissen¶

Umbenennen ändert nur den Namen. Der Ordner behält den Namen, mit dem er angelegt wurde, sodass Links, Skripte und Tools, die ihn verwenden, weiter funktionieren. Das Anweisungsfenster zeigt den echten Namen des Ordners.
Geschickte Dateien bleiben beim Projekt. Eine Datei, die du in einer Unterhaltung eines Projekts schickst, wird nach uploads im Projektordner kopiert, und der Agent bearbeitet sie direkt dort. Bei ausgeschalteten Projekten werden Dateien wie bisher abgelegt.
Hintergrundjobs laufen in einem Projekt. Unter Einstellungen → Hintergrundjobs ist das erste Feld eines Jobs sein Projekt, und ein neuer Job beginnt in dem, das du gerade offen hast. Ein Job, um den du den Agenten in der Unterhaltung eines Projekts bittest, läuft in diesem Projekt. Der Job eines geteilten Projekts benachrichtigt alle, die den Agenten nutzen, jeder andere Job nur dich. Solange Projekte aus sind, benachrichtigt jeder Job nur die Person, der er gehört.
Die Suche umfasst alles. Der Agent durchsucht den Verlauf all deiner Unterhaltungen, egal in welchem Projekt, und kann dir sagen, aus welchem Projekt ein Treffer stammt.
Die API arbeitet in Allgemein. Aufrufe über die OpenAI-kompatible API des Agenten arbeiten immer im Hauptordner des Aufrufers.
Bis zu 50 Projekte passen auf einen Agenten, die aller Nutzer zusammengezählt. Ein Name darf bis zu 60 Zeichen lang sein.