Authentification

Copilot SDK prend en charge plusieurs méthodes d’authentification. Choisissez celle adaptée à votre cas d’usage.

Méthodes d’authentification

Méthode	Usage principal	Abonnement Copilot	Remarques
Connexion GitHub (CLI)	Développement / exécution manuelle	Requis	Utilise les identifiants de connexion du CLI `copilot`
GitHub App OAuth / PAT	Token par utilisateur	Requis	Spécifié via `github_token`
Variables d’environnement	CI/CD, exploitation serveur	Requis	`COPILOT_GITHUB_TOKEN`, etc.
BYOK (Bring Your Own Key)	Fournisseur de modèle personnel	Non requis	Configuration de fournisseur personnalisé

Pour BYOK, voir Custom providers.

Connexion GitHub (CLI)

Si vous êtes déjà connecté au CLI copilot ou gh, les identifiants enregistrés sont utilisés lorsque rien n’est spécifié.

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Hello');

GitHub App OAuth / PAT

Passez à github_token un token d’accès utilisateur obtenu via le flux OAuth ou un PAT à granularité fine.

Formats attendus : gho_ / ghu_ / github_pat_
ghp_ (PAT classique) est déconseillé

use Revolution\Copilot\Facades\Copilot;

$config = array_merge(config('copilot'), [
    'github_token' => $user->github_token,
]);

$response = Copilot::useStdio($config)->run(prompt: '...');
Copilot::stop();

En spécifiant github_token, use_logged_in_user bascule automatiquement à false. Pour l’activer explicitement :

$config = [
    'github_token' => $user->github_token,
    'use_logged_in_user' => true,
];

Voir GitHub token pour plus de détails. github_token et use_logged_in_user ne sont utilisables qu’en mode stdio. En mode TCP, l’authentification doit être effectuée côté Copilot CLI.

Variables d’environnement

Si vous transmettez le token via une variable d’environnement, le CLI le détecte automatiquement. L’ordre de priorité est le suivant, du plus prioritaire au moins prioritaire :

COPILOT_GITHUB_TOKEN
GH_TOKEN
GITHUB_TOKEN

COPILOT_GITHUB_TOKEN=github_pat_xxx

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Hello');

En mode TCP, configurez les variables d’environnement côté serveur CLI.

Priorité de l’authentification

Le SDK résout les identifiants dans l’ordre suivant :

github_token (spécifié explicitement)
Tokens de variables d’environnement (COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN)
Identifiants OAuth enregistrés dans le CLI
Identifiants du CLI gh

Désactiver l’auto-connexion

Pour ne pas utiliser les identifiants enregistrés, mettez use_logged_in_user à false.

use Revolution\Copilot\Facades\Copilot;

$response = Copilot::useStdio([
    'use_logged_in_user' => false,
])->run(prompt: 'Hello');

Comme pour github_token, cela ne fonctionne qu’en mode stdio. En mode TCP, l’authentification doit être faite côté Copilot CLI.

Vérifier l’état d’authentification

Vous pouvez récupérer et inspecter le résultat de auth.getStatus.

use Revolution\Copilot\Facades\Copilot;

$status = Copilot::client()->getAuthStatus();

if (! $status->isAuthenticated) {
    // Non authentifié
}

Sélectionner un compte pour la connexion interactive

Énumérez loginAccounts via le RPC de session pour obtenir les identités enregistrées que vous pouvez réutiliser avec un fournisseur donné. Le label de chaque élément sert à l’affichage, et active indique si l’identité correspond au compte actif de la session courante. accountId est un identifiant opaque appartenant au fournisseur. Transmettez-le tel quel à la requête de connexion, sans l’analyser ni le modifier.

use Revolution\Copilot\Enums\AuthLoginMode;
use Revolution\Copilot\Enums\LoginProviderKind;
use Revolution\Copilot\Types\Rpc\AuthLoginBeginRequest;

$accounts = $session->rpc()->accounts();
$identities = $accounts->enumerate(
    'loginAccounts',
    provider: LoginProviderKind::ENTRA,
);

if (isset($identities[0])) {
    $accounts->begin(new AuthLoginBeginRequest(
        kind: LoginProviderKind::ENTRA,
        mode: AuthLoginMode::Default,
        accountId: $identities[0]->accountId,
    ));
}

Utilisez mode: 'default' pour réutiliser une identité enregistrée avec le comportement normal du fournisseur. Utilisez mode: 'selectAccount' pour afficher explicitement le sélecteur de compte du fournisseur. Dans ce cas, ne passez pas accountId. Les appels existants comme begin(LoginProviderKind::ENTRA) continuent de fonctionner.

Pour les dernières informations, consultez le dépôt GitHub.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Kits de démarrage

Flux et RSS

Middleware

Authentification - GitHub Copilot SDK pour Laravel