Autenticazione

Copilot SDK supporta più metodi di autenticazione. Scegli quello adatto al tuo caso d’uso.

Metodi di autenticazione

Metodo	Uso principale	Abbonamento Copilot	Note
Login GitHub (CLI)	Sviluppo · esecuzione manuale	Richiesto	Usa le credenziali di login del CLI `copilot`
OAuth GitHub App / PAT	Token per singolo utente	Richiesto	Specificato tramite `github_token`
Variabili d’ambiente	CI/CD · uso lato server	Richiesto	`COPILOT_GITHUB_TOKEN` ecc.
BYOK (Bring Your Own Key)	Provider di modelli proprio	Non richiesto	Configurazione di un provider personalizzato

Per BYOK consulta Custom providers. Se sei già loggato con il CLI copilot o gh e non specifichi nulla, vengono usate le credenziali salvate.

use Revolution\Copilot\Facades\Copilot;

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

OAuth GitHub App / PAT

Passa a github_token il token di accesso utente ottenuto tramite flusso OAuth oppure un PAT fine-grained.

Sono attesi gho_ / ghu_ / github_pat_
ghp_ (Classic PAT) è deprecato

use Revolution\Copilot\Facades\Copilot;

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

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

Specificando github_token, use_logged_in_user viene impostato automaticamente a false. Se vuoi cambiarlo esplicitamente, procedi così.

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

Per i dettagli consulta GitHub token. github_token e use_logged_in_user sono disponibili solo in modalità stdio. In modalità TCP la Copilot CLI deve essere già autenticata.

Variabili d’ambiente

Se passi il token tramite variabili d’ambiente, la CLI lo rileva automaticamente. L’ordine di priorità è dal primo all’ultimo.

COPILOT_GITHUB_TOKEN
GH_TOKEN
GITHUB_TOKEN

COPILOT_GITHUB_TOKEN=github_pat_xxx

use Revolution\Copilot\Facades\Copilot;

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

In modalità TCP imposta le variabili d’ambiente sul server CLI.

Priorità dell’autenticazione

L’SDK risolve le credenziali nel seguente ordine.

github_token (specificato esplicitamente)
Token da variabile d’ambiente (COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN)
Credenziali OAuth salvate dalla CLI
Credenziali del CLI gh

Se non vuoi usare le credenziali salvate, imposta use_logged_in_user a false.

use Revolution\Copilot\Facades\Copilot;

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

Come github_token, è supportato solo in modalità stdio. In modalità TCP la Copilot CLI deve essere già autenticata.

Verifica dello stato di autenticazione

Puoi verificarlo ottenendo il risultato di auth.getStatus.

use Revolution\Copilot\Facades\Copilot;

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

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

Per le informazioni più recenti fai riferimento al repository GitHub.

​Autenticazione

​Metodi di autenticazione

​Login GitHub (CLI)

​OAuth GitHub App / PAT

​Variabili d’ambiente

​Priorità dell’autenticazione

​Disabilitare il login automatico

​Verifica dello stato di autenticazione

Autenticazione

Metodi di autenticazione

Login GitHub (CLI)

OAuth GitHub App / PAT

Variabili d’ambiente

Priorità dell’autenticazione

Disabilitare il login automatico

Verifica dello stato di autenticazione