Agent-Sessions Neu in 0.9.7

Sind Agent-Sessions eingeschaltet, kann ein Agent Teile seiner Aufgabe an andere Sessions auf demselben Relay abgeben. Er startet sie, gibt jeder einen Prompt, wartet auf sie und liest, was sie antworten. Jede Session, die er startet, ist eine gewöhnliche Konversation in deiner Liste: Du kannst sie öffnen, mitlesen, ihre Rückfragen beantworten und sie stoppen.

Typische Anwendungen:

Eine Arbeit aufteilen. „Starte pro Paket eine Session, die seine Abhängigkeiten aktualisiert und die Tests ausführt, und sag mir dann, welche fehlgeschlagen sind.“
Eine zweite Meinung einholen. „Lass eine Session mit einem anderen Modell diesen Plan prüfen, bevor du anfängst.“
Einen anderen Provider nutzen. „Lass eine Cursor-Session die Migration schreiben und prüf ihr Ergebnis selbst.“
In einem anderen Ordner arbeiten. „Starte eine Session im Doku-Repository und lass sie die Installationsseite passend aktualisieren.“

Ein zweites Relay ist dafür nicht nötig. Für Sessions auf einem anderen Relay müssen die Relays gekoppelt sein; siehe Ein Relay benennen.

Einschalten #

Standardmäßig ist es aus.

Öffne Settings → Relays (Einstellungen → Relays).
Schalte unter Agent sessions (Agent-Sessions) Agents may start and use sessions on this relay (Agents dürfen auf diesem Relay Sessions starten und nutzen) ein.

Das Relay braucht dafür mindestens einen aktivierten Provider. Ab dann können Agents auf diesem Relay jede Session hier auflisten und lesen, einer einen Prompt schicken, eine starten, auf sie warten, ihre Rückfrage beantworten, ihren Turn stoppen und sie archivieren. Schaltest du den Schalter aus, ist das Relay wieder für sie geschlossen.

Eine Konversation, die schon offen war

Eine Session erfährt, welche Tools sie hat, wenn ihr Agent-Prozess startet. Eine Konversation, die schon lief, bevor du den Schalter eingeschaltet hast, kann vielleicht erst Sessions starten, wenn ihr Agent neu gestartet ist: Kill session (Session beenden) im ⋯-Menü der Konversation erledigt das, ebenso ein Neustart des Relays.

Die Freigabekarte #

Wenn ein Agent in einer Konversation zum ersten Mal eine Session starten will, muss er dich fragen. In dieser Konversation erscheint eine Freigabekarte, die den Provider, den Ordner oder das Repository und den Prompt nennt:

This agent wants to start sessions on this relay (claude, the default folder).
Sessions it starts use this relay's accounts.

Deine Wahl	Was passiert
Allow (Erlauben)	Die Session startet. Der Agent dieser Konversation darf weitere Sessions starten, ohne erneut zu fragen, auch nach einem Neustart des Relays.
Deny (Ablehnen)	Nur dieser eine Aufruf wird abgelehnt.

Neu in 0.9.16 Nennt der Agent eine Session-Gruppe für die neue Session, sagt die Detailzeile der Karte, wohin sie kommt, zum Beispiel Group: Release 2.4 (grp_…). Die Gruppe wird nachgeschlagen, bevor die Karte erscheint; eine, die es nicht gibt, wird ohne Karte abgelehnt.

Die Freigabe gehört zur Konversation, nicht zum Relay: Ein Agent in einer anderen Konversation fragt nach seiner eigenen.

In den Relay-Modi ask und plan wirst du öfter gefragt. Dort fragt jede Aktion, die etwas ändert, zuerst: eine Session starten, ihr einen Prompt schicken, ihre Rückfrage beantworten, Neu in 0.9.16 ihre Einstellungen ändern, sie stoppen und archivieren.

Die Regeln #

Regel
Höchstens 4 bei der Arbeit	Von den Sessions, die der Agent einer Konversation gestartet hat, dürfen 4 gleichzeitig einen Turn in der Queue oder laufend haben. Eine fünfte wird abgelehnt, bis eine davon fertig ist.
Nur eine Ebene	Eine Session, die ein Agent gestartet hat, kann selbst keine Sessions starten, Neu in 0.9.16 außer du erlaubst es für diese Session (unten).
Nicht bei sich selbst	Ein Agent kann der Konversation, in der er läuft, keinen Prompt schicken, sie nicht stoppen, archivieren, nicht auf sie warten oder ihr antworten, Neu in 0.9.16 und auch ihre Einstellungen nicht ändern.
Neu in 0.9.16 Einstellungen ändern	Die Einstellungen der Sessions, die seine eigene Konversation gestartet hat, ändert ein Agent frei. Jede andere Session, deine oder die eines anderen Agents, braucht einmal pro Konversation dein Allow. Siehe `update_session`.
30 Prompts, dann wirst du gefragt	Hat ein Agent 30 Prompts an andere Agents gesendet, ohne dass dazwischen eine Nachricht von dir kam, fragt der nächste dich auf einer Karte. Allow startet die Zählung neu. Neu in 0.9.16 Nur eine Nachricht, die du geschrieben hast, zählt als deine: Relay-Ereignisse, die Nachfrage nach einem Nutzungslimit und die Notiz nach einem Neustart setzen die Zählung nicht zurück. Geplante Prompts an andere Sessions zählen ebenfalls.
Deine Konten	Sessions, die ein Agent startet, laufen über die Provider-Konten dieses Relays und zählen gegen deren Verbrauch.
Nichts wird für dich aufgeräumt	Das Relay archiviert diese Sessions nie von selbst. Sie bleiben in deiner Liste, bis du sie archivierst oder löschst oder der Agent eine archiviert.

Eine gestartete Session Sessions starten lassen Neu in 0.9.16 #

Eine Session, die ein Agent gestartet hat, kann keine eigenen Sessions starten. Um das für eine solche Session aufzuheben, öffne ihren 🧠-Dialog und schalte Agents in this conversation may start sessions (even though an agent started it) (Agents in dieser Konversation dürfen Sessions starten, auch wenn ein Agent sie gestartet hat) ein. Der Schalter erscheint nur bei Sessions, die ein Agent gestartet hat.

Die anderen Regeln gelten für sie weiter: höchstens 4 bei der Arbeit, dein Allow für die erste Session und Agents may start and use sessions on this relay. Nur du kannst den Schalter setzen: Ein Agent, ob von diesem Relay oder von einem gekoppelten, wird abgelehnt. Agents sehen ihn als "mayCreateSessions": true in list_sessions und read_session.

Was ein Agent starten kann #

Eine Session mit jedem Provider, der auf dem Relay aktiviert ist: GitHub Copilot, OpenAI, Claude, Claude API, Cursor, Grok, DeepSeek oder Claude Cloud. Ein OpenAI-Image-Chat lässt sich so nicht starten.

In einem Ordner. Der Agent kann den Arbeitsordner nennen. Nennt er keinen, bekommt die Session den Standardordner des Relays.
In einem Repository, bei Claude Cloud. Eine Cloud-Session nimmt statt eines Ordners ein GitHub-Repository und optional einen Branch. Sie arbeitet auf einem frischen Klon in einer Sandbox bei Anthropic, daher muss der Agent ihr sagen, auf welchem Branch sie arbeiten soll und dass sie pushen soll.

Der Agent kann auch das Modell, den Relay-Modus und den Reasoning-Effort wählen. Was er weglässt, richtet sich nach der Session, in der er arbeitet.

Eine neue Session weiß nichts von der Konversation, aus der sie gestartet wurde. Sie bekommt nur den Prompt, den der Agent für sie schreibt. Scheint einer gestarteten Session Kontext zu fehlen, dann schau dort nach: Öffne sie und lies die erste Nachricht.

Was du siehst #

In der Konversationsliste trägt eine Session, die ein Agent gestartet hat, via agent · "title" (über Agent · „Titel“), mit dem Titel der Konversation, in der der Agent läuft. Dieselbe Zeile steht im Header unter dem Titel der Session; ein Klick darauf öffnet jene Konversation.
Neu in 0.9.11 In einer Gruppe. Die Session steht eingerückt unter der Konversation, die sie gestartet hat, in einer Session-Gruppe, deren Kopfzeile zusammenfasst, was läuft und was auf dich wartet. Neu in 0.9.16 Hat der Agent eine bestehende Gruppe genannt, steht die Session stattdessen in dieser Gruppe.
An den Nachrichten trägt ein Prompt, den der Agent gesendet hat, eine Badge mit derselben Markierung und dem Modell des Agents, damit du ihn von einer eigenen Nachricht unterscheiden kannst.
In der Antwort des Agents erscheint jeder Aufruf als Aktivitätszeile mit einem 🛰️: die Aktion und die Session, an die sie ging.
Rückfragen. Stellt eine gestartete Session eine Rückfrage, wartet ihre Karte wie gewohnt in dieser Session. Der Agent, der sie gestartet hat, erfährt von der Rückfrage; er ist angewiesen, sie dir vorzulegen, statt sie selbst zu beantworten, außer du hast ihm gesagt, selbst zu entscheiden.

Wie lange ein Agent wartet #

Schickt ein Agent einer Session einen Prompt, wartet er eine Weile auf die Antwort und bekommt, was da ist, wenn die Zeit um ist; danach kann er erneut warten. Der Schieberegler Longest wait per tool call (Längste Wartezeit pro Tool-Aufruf) unter dem Schalter legt die längste einzelne Wartezeit fest: standardmäßig 10 Minuten, von 2 bis 60 Minuten.

Das Limit gilt auch, wenn die Agents dieses Relays auf eine Session auf einem gekoppelten Relay warten; deshalb lässt sich der Regler verschieben, ob der Schalter an ist oder nicht.

Ein Turn, der wartet, zählt weiter gegen Max turn duration (Maximale Turn-Dauer) unter Settings → General (Einstellungen → Allgemein). Für Arbeit, die länger dauert, als ein Turn sollte, kann ein Agent stattdessen die Sessions beobachten und geweckt werden, wenn sie fertig sind.

Nach Provider #

Provider	Kann andere Sessions starten und nutzen	Kann von einem Agent gestartet werden
Claude	ja	ja
GitHub Copilot und OpenAI, beide Engines	ja	ja
Cursor	ja	ja
Grok	ja	ja
DeepSeek Neu in 0.9.17	ja	ja
Claude Cloud	nein: Die Tools des Relays reichen nicht in die Cloud-Sandbox	ja, mit einem Repository statt eines Ordners
OpenAI Image	nein	nein

Davon abgesehen funktionieren Agent-Sessions bei jedem Provider gleich.

Wenn es nicht funktioniert #

Was passiert	Warum, und was zu tun ist
Der Agent sagt, er habe dafür kein Tool	Der Schalter ist aus, oder der Agent der Konversation ist gestartet, bevor du ihn eingeschaltet hast. Siehe Einschalten.
Der Agent meldet `REMOTE_RELAY_SESSION_LIMIT`	Vier seiner Sessions sind noch bei der Arbeit. Er muss warten, bis eine fertig ist.
Der Agent meldet `REMOTE_RELAY_NESTED_SESSION`	Der Agent läuft selbst in einer Session, die ein Agent gestartet hat. Nur die Agents deiner eigenen Konversationen können Sessions starten.
Der Agent meldet `REMOTE_RELAY_PROVIDER_UNAVAILABLE`	Der Provider, den er verlangt hat, ist auf diesem Relay nicht aktiviert. Neu in 0.9.18 Bei einem Wechsel der Abrechnung auch: Claude API oder Claude ist nicht eingerichtet, oder das Monatslimit ist erreicht; `remoteCode` sagt, was davon.
Der Turn des Agents endet, während er wartet	Das Warten ist an Max turn duration gestoßen. Bitte ihn, kürzer zu warten oder stattdessen die Sessions zu beobachten.

Alle Codes stehen unter Fehler.