Ga naar inhoud

Ruimtes gebruiken

Deze gids laat je zien hoe je ruimtes gebruikt. Een ruimte is het berichtenoppervlak in Control Center: een kamer binnen één werkruimte met een of meer deelnemers (jij en/of agenten), die voor elke repo waarvoor hij is aangemaakt een eigen copy-on-write-worktree bezit.

Een-op-een- en ruimtes met veel agenten zijn allebei gewoon ruimtes; het enige verschil is het aantal deelnemers. De enige uitzondering zijn ruimtes die agenten openen om met elkaar te praten — zie Ruimtes tussen agenten hieronder.

  1. Ga naar Ruimtes
  2. Klik op de +-knop naast de kop Ruimtes
  3. Geef de ruimte een naam — dit is verplicht. Een lege naam wordt geweigerd; het dialoogvenster blijft open
  4. Voeg optioneel agenten uit de werkruimte toe
  5. Als de werkruimte repo’s heeft, kies je voor welke repo’s deze ruimte worktrees aanmaakt. Alle repo’s zijn standaard geselecteerd; vink je elke repo uit, dan ontstaat een ruimte waarin niets is uitgecheckt
  6. Bevestig

Ruimtes zijn gebonden aan één werkruimte: je ziet alleen agenten uit de huidige werkruimte en een ruimte toont nooit gegevens uit een andere werkruimte.

Elke repo wordt uitgecheckt op repos/<name>/ in de ruimte. Een repo die zijn eigen agentskills meebrengt, draagt ze bij aan de agent die er op dat moment in werkt — één set per keer, en die wisselt mee met de agent. Vanuit de composer bereik je ze allemaal met /skill:<repo>:<name>. Zie Repogebonden skills.

Het oppervlak staat op /workspaces/<id>/spaces, en één ruimte op /workspaces/<id>/spaces/<spaceId>.

Een nieuwe ruimte begint in de standaardmodus. Wijzig hem via de modusvervolgkeuzelijst helemaal links in de werkbalk van de composer — niet in het aanmaakdialoogvenster (dat heeft geen modusveld) en niet in de kop van de ruimte.

Modus Effect
Agent Volledige toegang. De standaardmodus; intern chat, met het label “Agent” in de keuzelijst
Plan Alleen lezen en onderzoeken; het resultaat is een getypeerd plan
Orkestratie Alleen lezen en onderzoeken plus één propose_orchestration-werkwoord; het plan wordt pas uitgevoerd nadat je het goedkeurt

Shift+Tab wisselt tussen planmodus en agentmodus zonder de keuzelijst te openen.

Er bestaat een vierde modus, review, maar die wordt niet in de keuzelijst aangeboden — hij wordt automatisch toegepast op PR-reviewruimtes.

De modus wordt op de ruimte opgeslagen, dus dezelfde agent kan in de ene ruimte in planmodus zitten en in de andere in agentmodus. Elk gesprek in een ruimte deelt de modus van die ruimte.

Zie Modi voor het volledige model.

Klik op het personenpictogram in de kop van de ruimte om Deelnemers beheren te openen. Voor elke agent die al in de ruimte zit, kun je:

  • hem uit de ruimte verwijderen
  • zijn Autonomie voor deze ruimte instellen: Standaard, Alleen voorstellen, Handelen met goedkeuring of Vrij handelen

De autonomieknop geldt per (ruimte, agent), dus een agent die je in de ene ruimte vertrouwt, kun je in een andere op alleen-voorstellen houden.

Beweeg over een bericht en klik op het smiley-pictogram om het reactiepalet te openen. Het is een vaste set van zes: 👍 👎 🎉 ❤️ 👀 ✅. Er is geen vrije emoji-kiezer — als je er een aanklikt, wordt hij voor jou aan- of uitgezet en verschijnen de gebundelde chips onder het bericht.

Een ruimte herbergt meerdere gesprekken tegelijk en die zijn allemaal gelijk — geen ervan is het hoofdgesprek. Een ruimte houdt altijd minstens één levend gesprek: je kunt het laatste actieve gesprek niet archiveren, en als je een ruimte opent die er nog geen heeft, wordt er een titelloos blijvend gesprek aangemaakt.

Gesprekken verschijnen als tabbladen in de editor en, zodra er meer dan één is, als geneste rijen onder de ruimte in de zijbalk. Nieuw gesprek staat in het nieuw-tabbladmenu van de editor en maakt een titelloos gesprek aan zonder titelvraag — het titelmodel noemt het naar het eerste bericht. Gebruik er een om parallel werk te doen met dezelfde agent en worktree.

Elk gesprek houdt zijn eigen berichtgeschiedenis en agentsessies bij, terwijl het de worktrees en de modus van de ruimte deelt. Een tabblad sluiten verbergt het gesprek; Gesprek archiveren (de rij in de zijbalk of het contextmenu van het chattabblad) archiveert alleen dat gesprek.

Beweeg over een bericht en kies Thread starten. Dat opent een gesprek dat aan dat bericht verankerd is: het anker initialiseert de agentcontext van het nieuwe gesprek met één regel en de geschiedenis van het bovenliggende gesprek wordt niet gekopieerd.

Zodra een thread reacties heeft, krijgt het bericht waar hij aan hangt een rij eronder — de gezichten van wie heeft gesproken, het aantal reacties en wanneer de laatste reactie binnenkwam. Die rij is de weg terug: erop klikken opent (of focusseert) het tabblad van de thread. Het is het enige spoor dat een thread achterlaat in de stream waaruit hij is vertakt, en daarom staat die rij er.

Het tabblad van een thread heet Thread: <name> en draagt het vertakkingspictogram, zodat twee tabbladen op dezelfde ruimte nooit met elkaar verward worden.

Threads nestelen nooit — verankeren aan een bericht dat al in een thread zit, wordt geweigerd. De kop van het gesprek linkt terug naar het ankerbericht. Het ankerbericht verwijderen verwijdert de thread, en het archiveren van het bovenliggende gesprek blokkeert de bestaande threads niet.

Leesmarkeringen zijn gekoppeld aan de ruimte, niet aan het gesprek: elk gesprek in de ruimte openen maakt de hele ruimte gelezen. Ongelezen telt nog steeds over alle gesprekken van een ruimte, threads inbegrepen. Wanneer gesprekken onder de ruimte worden vermeld, staat de ongelezen-stip bij het gesprek met ongezien werk in plaats van bij de bovenliggende rij.

Ruimtes die agenten openen om met elkaar te praten, staan apart in de zijbalk onder Agenten, standaard ingeklapt en gedempt weergegeven. Ze laten je ongelezen-badge nooit oplopen — agentengepraat is stil door zijn opzet, niet door een instelling die je moet zien te vinden.

Het soort ruimte is een van vijf waarden: topic (de standaard voor alles wat jij maakt), agentPeer, system (door pipelines beheerd), pr (aangemaakt wanneer een PR-oppervlak een worktree-anker nodig heeft en verborgen in de zijbalk tot er berichten zijn) en slack (aangemaakt door de chatbrug voor een Slack-thread of bot-DM, en behandeld als een gewoon menselijk gesprek).