Remote sessions

Als je remote sessions inschakelt, kun je via Mission Control van GitHub vanaf web en mobiel toegang krijgen tot dezelfde session. Bij inschakeling wordt de session verbonden met Mission Control en wordt er een URL uitgegeven die je als link of QR-code kunt delen. Wil je de session zelf niet lokaal of op je eigen server, maar in een door GitHub gehoste omgeving uitvoeren, gebruik dan Cloud sessions.

Vereisten

De gebruiker is geauthenticeerd (GitHub-token of ingelogde gebruiker)
workingDirectory is een GitHub-repository

Verwijderde configuratieopties

De officiële SDK 1.0.26 heeft de client-optie remote, de session-optie remoteSession en de CLI-startvlag --remote verwijderd. Om een session te delen, schakel je dit on demand in met $session->rpc()->remote()->enable(). De bestaande RPC’s voor remote sessions blijven werken.

Per session inschakelen (on demand)

Om een session te delen, schakel je remote toegang om via RPC. Dit komt overeen met de CLI-commando’s /remote on en /remote off.

use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;

Copilot::start(function (CopilotSession $session): void {
    $result = $session->rpc()->remote()->enable();

    if ($result->url !== null) {
        echo 'Remote URL: '.$result->url.PHP_EOL;
    }

    // Delen stoppen
    $session->rpc()->remote()->disable();
});

Verbinden met een bestaande remote session (serverniveau)

Om de CLI-server te verbinden met een bestaande remote session, roep je $client->rpc()->sessions()->connect() aan. Geef de remote sessionId mee in ConnectRemoteSessionParams. Het resultaat bevat de sessionId aan SDK-zijde en de metadata van de remote session.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\ConnectRemoteSessionParams;

$client = Copilot::useTcp(url: 'tcp://127.0.0.1:12345')->client();

$connected = $client->rpc()->sessions()->connect(
    new ConnectRemoteSessionParams(sessionId: 'remote-session-id'),
);

echo $connected->sessionId;
// $connected->metadata - ConnectedRemoteSessionMetadata-object

Remote Control voor de hele runtime (TCP-modus)

De eigenschap remote van RemoteControlConfig configureert Remote Control voor de hele runtime. Deze staat los van de verwijderde startoptie remote van de client. Gebruik in TCP-modus $client->rpc()->sessions() om één Remote Control voor de hele runtime te beheren. Anders dan de per-session remote()->enable() kun je hiermee Remote Control starten, stoppen en tussen sessions overdragen, en de huidige status opvragen.

use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\RemoteControlConfig;
use Revolution\Copilot\Types\Rpc\SessionsStartRemoteControlRequest;

$client = Copilot::useTcp(url: 'tcp://127.0.0.1:12345')->client();

$result = $client->rpc()->sessions()->startRemoteControl(
    new SessionsStartRemoteControlRequest(
        sessionId: $sessionId,
        config: new RemoteControlConfig(
            remote: true,
            steerable: true,
            explicit: true,
            silent: false,
        ),
    ),
);

if ($result->status->frontendUrl !== null) {
    echo 'Remote URL: '.$result->status->frontendUrl.PHP_EOL;
}

De status is off, connecting, active of error. Wanneer de status active is, kun je ook frontendUrl en isSteerable uitlezen.

$status = $client->rpc()->sessions()->getRemoteControlStatus();

$client->rpc()->sessions()->setRemoteControlSteering(['enabled' => true]);
$client->rpc()->sessions()->transferRemoteControl([
    'toSessionId' => $nextSessionId,
    'expectedFromSessionId' => $sessionId,
]);
$client->rpc()->sessions()->stopRemoteControl([
    'expectedSessionId' => $nextSessionId,
]);

Gebruik de session-scoped RPC om de runtime te laten weten dat de bestuurbaarheid op afstand van een session is gewijzigd.

$session->rpc()->remote()->notifySteerableChanged(['remoteSteerable' => true]);

QR-code genereren

De verkregen remote URL kun je als QR-code doorgeven aan mobiel. Je kunt BaconQrCode gebruiken, dat ook in Laravel Fortify wordt gebruikt.

use BaconQrCode\Renderer\Image\SvgImageBackEnd;
use BaconQrCode\Renderer\ImageRenderer;
use BaconQrCode\Renderer\RendererStyle\RendererStyle;
use BaconQrCode\Writer;

$writer = new Writer(
    new ImageRenderer(
        new RendererStyle(256),
        new SvgImageBackEnd(),
    ),
);

$svg = $writer->writeString($result->url ?? '');

Aandachtspunten

Als workingDirectory geen GitHub-repository is, kan remote()->enable() een fout opleveren.
Zorg dat de authenticatiegegevens (github_token of use_logged_in_user) correct zijn ingesteld.

Zie ook

Raadpleeg de GitHub-repository voor de meest actuele informatie.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Remote sessions

Remote sessions

Vereisten

Verwijderde configuratieopties

Per session inschakelen (on demand)

Verbinden met een bestaande remote session (serverniveau)

Remote Control voor de hele runtime (TCP-modus)

QR-code genereren

Aandachtspunten

Zie ook

​Remote sessions

​Vereisten

​Verwijderde configuratieopties

​Per session inschakelen (on demand)

​Verbinden met een bestaande remote session (serverniveau)

​Remote Control voor de hele runtime (TCP-modus)

​QR-code genereren

​Aandachtspunten

​Zie ook

Remote sessions

Vereisten

Verwijderde configuratieopties

Per session inschakelen (on demand)

Verbinden met een bestaande remote session (serverniveau)

Remote Control voor de hele runtime (TCP-modus)

QR-code genereren

Aandachtspunten

Zie ook