Projecten¶

Geef elk stuk werk zijn eigen plank. Een project is een eigen map op de server van je agent, met eigen bestanden, eigen instructies en eigen gesprekken. De verbouwing blijft bij de verbouwing en de scriptie bij de scriptie, allemaal op één agent.

🏠 Algemeenje hoofdmap

💬Weekplanning
💬Vragen over de belastingaangifte

📁 Verbouwingnieuwe chats beginnen hier

📝“Budget € 15.000, altijd drie offertes vergelijken”
📄offertes.pdf · plattegrond.png
💬Keukentegels
💬Planning van de elektricien

📁 Gezinsvakantie👥 gedeeld

📄tickets.pdf
💬Planning per dag

Wat een project je geeft¶

Een eigen map

De agent werkt in de map van het project: bestanden die je in de gesprekken ervan stuurt, komen daar terecht, net als de bestanden die hij maakt, de code die hij uitvoert en de taken die hij inplant.
Eigen instructies

Een notitie die de agent aan het begin van elk gesprek in het project leest: waar het voor is, hoe er gewerkt wordt, waar hij op moet letten.
Eigen gesprekken

De gesprekkenlijst toont het project waarin je zit, en elke nieuwe chat begint daar. Niets om te onthouden, niets om achteraf te sorteren.
Privé of gedeeld

Op een agent die je met anderen deelt kan een project alleen van jou zijn, of gedeeld met iedereen, inclusief bestanden en gesprekken.

Al het andere is in elk project precies hetzelfde: het geheugen en de persona van de agent, zijn skills, het model en de instellingen, sleutels en aanmeldingen, en je krediet. Bestandsbeheer en Terminal in het paneel tonen altijd de hele server. Van project wisselen verandert waar de agent werkt, niet wie hij is.

1 Projecten aanzetten¶

Projecten staan uit totdat iemand ze aanzet, en zolang ze uit staan, zie je er niets van: elk gesprek werkt in je hoofdmap. Ze zijn nieuw, dus het paneel markeert ze als Bèta.

Paneel: Instellingen → Projecten → Projecten gebruiken.
Telegram: stuur /projects en tik op ▶️ Projecten aanzetten.

De schakelaar geldt voor de hele agent: iedereen die hem gebruikt, de eigenaar of een uitgenodigde gebruiker, kan hem aan- of uitzetten. Uitzetten laat alle mappen ongemoeid. Gesprekken die in een project zijn begonnen, blijven daar werken; alleen nieuwe gaan weer naar je hoofdmap.

2 Een project aanmaken¶

Paneel: open de projectwisselaar bovenaan de zijbalk en kies Nieuw project. Geef het een naam, druk op Project toevoegen en je zit erin, met een nieuwe chat die al klaarstaat.
Telegram: /projects → ➕ Nieuw project, en stuur dan de naam. De bot maakt het project aan en zet je er meteen in.
Instellingen → Projecten → + Nieuw project maakt er een aan zonder dat je het project verlaat waarin je zit.

Elk project krijgt een eigen map op de server van de agent.

💡 Als bij je agent Extra gebruikers toestaan aanstaat, vraagt het paneel ook Wie het kan zien: Alleen ik of Elke gebruiker van deze agent. Dat kun je later wijzigen, zie Projecten op een gedeelde agent. Een project dat je in Telegram aanmaakt, is in eerste instantie privé.

3 Wisselen tussen projecten¶

In het paneel toont de wisselaar boven de gesprekkenlijst in welk project je zit. Kies een ander, dan vult de lijst zich met de gesprekken daarvan en beginnen nieuwe chats daar. Projecten beheren onderaan hetzelfde menu opent de instellingen.

In Telegram toont /projects (of /menu → Instellingen → 📁 Projecten) je projecten: 🏠 je hoofdmap, 📁 je eigen projecten, 👥 de gedeelde, met ✅ bij het actieve. Tik op een ander om te wisselen. Hoort de chat waarin je zit bij een ander project, dan begint er meteen een nieuw gesprek in het project dat je koos, en de vastgezette titel begint met de naam van het project. /sessions toont daarna de gesprekken van dat project, met de projectnaam bovenaan.

Hernoemen, delen, instructies en verwijderen doe je in het paneel.

Goed om te weten:

Een gesprek blijft waar het begon. Wisselen verplaatst nooit een chat die al loopt. Die houdt zijn project, zijn map en zijn instructies; de wisselaar bepaalt waar de volgende begint.
Paneel en Telegram kiezen los van elkaar. Je kunt in Telegram in Verbouwing zitten terwijl het paneel Scriptie toont. Elk onthoudt zijn eigen keuze.

4 Geef het project instructies¶

Instellingen → Projecten → de ⋯ naast een project → Instructies…

Schrijf daar wat de agent moet weten: waar het project voor is, wie erbij betrokken zijn, welke beslissingen al genomen zijn, hoe je het werk graag gedaan ziet. De agent leest het aan het begin van elk gesprek in dit project, zodat je de achtergrond niet telkens opnieuw hoeft uit te leggen.

Bijvoorbeeld

“Verbouwing van ons appartement. Budget € 15.000, klaar in maart. Vergelijk altijd minstens drie offertes. Houd in kosten.xlsx een lopende kostentabel bij en werk die bij zodra er een offerte binnenkomt.”

Zet het belangrijkste bovenaan

Een gesprek dat al loopt, houdt de instructies waarmee het begon, dus een wijziging geldt vanaf de volgende chat. Lange instructies zijn geen probleem, maar alleen de eerste paar duizend tekens bereiken de agent direct; de rest leest hij zo nodig uit het bestand.

De instructies staan als gewoon bestand (AGENTS.md) in de map van het project, dus je kunt de agent ook vragen ze voor je te schrijven of bij te werken.

Je hoofdmap¶

Iedereen die de agent gebruikt, heeft een eigen hoofdmap, die in de wisselaar als Algemeen verschijnt. Daar werken gesprekken zolang projecten uit staan, en daar staat alles van vóór de projecten.

Algemeen is eerder je thuisbasis dan een project: je kunt het niet hernoemen, delen of verwijderen. Het is ook de plek voor werk dat meerdere projecten beslaat. Vanuit een project blijft de agent binnen de map van dat project, vanuit Algemeen kan hij bij allemaal.

Projecten op een gedeelde agent¶

Als je je agent met anderen deelt, krijgt iedereen een eigen hoofdmap en eigen projecten. Elk project is een van twee soorten:

Privé (standaard)

Alleen voor jou zichtbaar in de lijst, en alleen jouw gesprekken komen erin.
Gedeeld

Zichtbaar voor elke gebruiker van de agent en gemarkeerd als Gedeeld. Iedereen werkt met dezelfde bestanden en instructies, en ook de gesprekken erin zijn gedeeld.

In een gedeeld project zijn de gesprekken gemeenschappelijk terrein. Iedereen ziet ze in de lijst van het project en kan ze lezen, voortzetten, hernoemen of verwijderen, zodat meerdere mensen in dezelfde chat kunnen werken: in het paneel, of in Telegram, waar /sessions ze markeert met 👥 en je met één tik aanschuift. Bij elk bericht staat wie het schreef, en de agent weet wie hij antwoordt. Hij beantwoordt één bericht tegelijk: wordt het bericht van iemand anders nog beantwoord, dan laat het paneel of de bot je dat weten, en stuur je het jouwe zodra het antwoord er is.

Delen of privé maken via het ⋯-menu van het project: Delen met alle gebruikers of Privé maken. Een project dat privé wordt gemaakt, verdwijnt uit de lijsten van de anderen, en hun gesprekken eruit gaan verder in hun eigen hoofdmap.
Wie een gedeeld project beheert: degene die het heeft aangemaakt, en de eigenaar van de agent. Hernoemen en verwijderen is aan hen. Alleen de maker kan het weer privé maken.
Achtergrondtaken in een gedeeld project zijn van iedereen. Elke gebruiker ziet ze onder Instellingen → Achtergrondtaken, kan ze wijzigen en krijgt de meldingen ervan in het paneel en in Telegram.
Wordt een gebruiker verwijderd, dan blijven de projecten die die persoon deelde gedeeld en gaan ze over naar de eigenaar. De privéprojecten van die persoon verdwijnen uit de lijsten, en de bestanden blijven op de server.

Privé betekent onzichtbaar, niet achter slot en grendel

Uitgenodigde gebruikers zijn vertrouwde gebruikers. Ieders werk draait onder hetzelfde account op de server van de agent, dus een privéproject is verborgen in de lijsten van anderen, maar het is geen kluis. Houd wat echt geheim is weg van een gedeelde agent.

Een project verwijderen, of definitief wissen¶

Verwijderen gaat in twee stappen, zodat er niets per ongeluk verdwijnt:

⋯ → Uit de lijst verwijderen. Het project verdwijnt uit de lijsten, maar de bestanden en gesprekken blijven op de server, en jouw gesprekken eruit verschijnen onder Algemeen. Je vindt het project terug onder Verwijderde projecten onderaan Instellingen → Projecten, waar Terug in de lijst het terugzet.
Verwijderde projecten → ⋯ → Definitief verwijderen… Dit wist de map met alle bestanden erin en alle gesprekken die erin werkten, en dat kan niet ongedaan worden gemaakt. Ter bevestiging typ je de mapnaam. Bij een gedeeld project laat het paneel ook zien hoeveel andere gebruikers er gesprekken in hebben.

Goed om te weten¶

Hernoemen verandert alleen de naam. De map houdt de naam waarmee hij is aangemaakt, zodat links, scripts en tools die hem gebruiken blijven werken. Het instructievenster toont de echte naam van de map.
Bestanden die je stuurt, blijven bij het project. Een bestand dat je in een gesprek van een project stuurt, wordt gekopieerd naar uploads in de projectmap, en de agent werkt er meteen daar mee. Met projecten uit worden bestanden bewaard zoals voorheen.
Achtergrondtaken draaien in een project. Onder Instellingen → Achtergrondtaken is het eerste veld van een taak het project, en een nieuwe taak begint in het project dat je open hebt. Een taak waar je de agent in een gesprek van een project om vraagt, draait in dat project. Een taak van een gedeeld project stuurt meldingen naar iedereen die de agent gebruikt, elke andere taak alleen naar jou. Zolang projecten uit staan, stuurt elke taak alleen meldingen naar degene van wie hij is.
Zoeken doorzoekt alles. De agent doorzoekt de geschiedenis van al je gesprekken, in welk project ze ook zitten, en kan je vertellen uit welk project een resultaat komt.
De API werkt in Algemeen. Aanroepen via de OpenAI-compatibele API van de agent werken altijd in de hoofdmap van de aanroeper.
Maximaal 50 projecten passen op één agent, die van iedereen bij elkaar opgeteld. Een naam mag maximaal 60 tekens lang zijn.