Zum Hauptinhalt springen

Sessions, Host und Umgebung

Geltungsbereich: ServerRpc (serverweite Operationen, die an den Client gebunden sind) Eine Übersicht über RPC und die Liste aller RPC-Seiten finden Sie unter RPC.

Lebenszyklus von Runtime und Host (experimental)

host.unpublishSession() zieht eine Application-Publication von einem eigenen, laufenden Host zurück. Das Zurückziehen der Veröffentlichung löscht oder stoppt weder den ursprünglichen Session-Verlauf noch Worktrees oder laufende Arbeiten. Ist die Session bereits nicht veröffentlicht, ist unpublished gleich false; andere Publications als application führen zu einem Fehler.
host.dispose() beendet den Host-Listener mit der angegebenen hostId.
host.setSessionCreationPolicy() legt fest, ob ein laufender Host neue Remote-Sessions annimmt. Die Änderung trennt keine bestehenden Clients und gilt nur für spätere Zulassungen.
Bei einer vom SDK gestarteten stdio-Runtime ruft Client::stop() nach dem Trennen der Sessions und vor dem Schließen der JSON-RPC-Verbindung und des Prozesses runtime.shutdown auf. Das Trennen der Sessions (session.detach) teilt sich über alle Sessions hinweg eine gemeinsame Frist von 10 Sekunden. Ein Trennvorgang, der die Frist überschreitet, wird als Fehler in den Rückgabewert aufgenommen, und der Stoppvorgang wird fortgesetzt. Außerdem wird bis zu 10 Sekunden auf den Abschluss der Runtime-Bereinigung gewartet; bei einem Fehler wird dieser in den Rückgabewert aufgenommen und der restliche Stoppvorgang fortgesetzt. Bei Verbindungen zu externen Runtimes wie cli_url wird dieser RPC nicht aufgerufen, damit die gemeinsam genutzte Runtime nicht beendet wird. Wenn die CLI die zugehörige Anfrage nicht ermitteln kann und einen JSON-RPC-Fehler mit id: null zurückgibt, schlagen alle laufenden Anfragen mit einer JsonRpcException fehl. Die Exception enthält eine Diagnosemeldung, aus der zitierte Werte entfernt wurden und deren Länge begrenzt ist. Die Verbindung bleibt geöffnet. Da die CLI die Anfrage möglicherweise bereits verarbeitet hat, wiederholen Sie sie nicht automatisch, ohne sicherzustellen, dass dies unbedenklich ist. Das SDK weist ausgehende Anfragen mit mehr als 127 Verschachtelungsebenen, die die CLI nicht lesen kann, bereits vor dem Senden zurück. Zu tief verschachtelte Handler-Antworten ersetzt es durch einen JSON-RPC-Fehler.

cloudTasks (experimental: Cloud-Agent-Tasks)

cloudTasks() erstellt, löscht und ruft Tasks des Cloud-Coding-Agents ab, liest Session-Logs und Replays, ändert den Freigabestatus und ermittelt die Session, die zu einer Task-ID geöffnet werden soll. Jede Methode akzeptiert den passenden Params-Typ oder ein Array und gibt ein typisiertes DTO zurück. Ist ok im Erstellungsergebnis false, finden Sie in reason und message den Grund, aus dem der Dienst die Anfrage abgelehnt hat, und in statusCode, errorMessage und errorPayloadJson die Fehlerinformationen einer ausgeführten HTTP-Anfrage.

taskAnalytics (experimental: aufgezeichnete Trajektorien klassifizieren)

taskAnalytics()->classifyTrajectory() klassifiziert aufgezeichnete Copilot-Events oder ATIF-Daten, ohne eine Session zu erstellen. Archivierte Tools werden nicht ausgeführt, und weder dem Gesprächsverlauf noch der Klassifizierungstelemetrie wird etwas hinzugefügt. Übergeben Sie events in ihrer ursprünglichen Reihenfolge. Sie können außerdem classifiers, maxConcurrentRequests, judge und previousResult angeben. Mit validateOnly: true überspringt die Runtime die Inferenz und gibt nur das Ergebnis der lokalen Validierung zurück. Eine normale Klassifizierung sendet den Event-Inhalt an eine Modellverarbeitung, die Ihre GitHub-CAPI-Anmeldeinformationen verwendet. Es gibt keine automatische Schwärzung und keinen Schutz vor Prompt Injection. Genehmigen Sie den Upload, prüfen Sie die Herkunft des Archivs und entfernen Sie vorher sensible Daten. Klassifizierungsergebnisse sind keine gesicherten Fakten, verwenden Sie sie daher nicht für Autorisierungs- oder Sicherheitsentscheidungen.
Um eine Authentifizierungs-URL im Browser zu öffnen, verwenden Sie runtime()->openBrowser().
Um die Warnung zur Sandbox-Pfadfreigabe abzurufen, verwenden Sie sandbox()->getPathGrantWarning().

sessions connect und Remote Control (TCP-Modus)

Um den CLI-Server mit einer bestehenden Remote-Session zu verbinden, verwenden Sie sessions()->connect(). Übergeben Sie die sessionId der Remote-Session. Das Ergebnis enthält die SDK-seitige sessionId und die Metadaten der Remote-Session.
Im TCP-Modus können Sie mit sessions() außerdem eine einzige Remote Control für die gesamte Runtime verwalten. Anders als mit dem sessionbezogenen remote()->enable() können Sie mit diesen Methoden Remote Control starten, stoppen, zwischen Sessions übertragen und den aktuellen Status lesen.
Details finden Sie unter Remote Sessions.
Zuletzt geändert am 19. November 2026