> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot SDK for Laravel

> Comprendi cosa offre Laravel Copilot SDK e passa alle guide principali su setup, sessioni, strumenti e configurazione a runtime.

GitHub Copilot SDK for Laravel è un SDK della community che rende utilizzabili nelle applicazioni Laravel i workflow dell'[SDK ufficiale GitHub Copilot](https://github.com/github/copilot-sdk).

Puoi invocare Copilot da vari contesti di esecuzione di Laravel: comandi Artisan, controller, job e altro.

## Aspetti specifici per Laravel

Questo pacchetto aggiunge un'esperienza d'uso nativa Laravel sopra il layer di compatibilità dell'SDK.

* API basata su Facade centrata su `Copilot::run()` e `Copilot::start()`
* Configurazione in stile Laravel tramite `config/copilot.php` e `.env`
* Punti di integrazione con Laravel Prompts, queue e UX di console
* Utilità di test come `Copilot::fake()` e assertion sui prompt

## Esempi d'uso

### Eseguire un singolo prompt

```php theme={null}
use Revolution\Copilot\Facades\Copilot;

$response = Copilot::run(prompt: 'Tell me something about Laravel.');
dump($response->content());
```

### Eseguire più prompt in una sola sessione

```php theme={null}
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Facades\Copilot;

$content = Copilot::start(function (CopilotSession $session) {
    dump('Starting Copilot session: '.$session->id());

    $response = $session->sendAndWait(prompt: 'Tell me something about PHP.');
    dump($response->content());

    $response = $session->sendAndWait(prompt: 'Tell me something about Laravel.');
    dump($response->content());

    return $response->content();
});

dump($content);
```

### Helper `copilot()`

```php theme={null}
use Revolution\Copilot\Contracts\CopilotSession;
use function Revolution\Copilot\copilot;

// Se passi un prompt, equivale a Copilot::run()
$response = copilot('Tell me something about Laravel.');

// Se passi una closure, equivale a Copilot::start()
copilot(function (CopilotSession $session) {
    $response = $session->sendAndWait(prompt: 'Tell me something about PHP.');
});

// Se non passi nulla, equivale al Facade
dump(copilot()->client()->ping());
```

## Da dove iniziare

<Columns cols={2}>
  <Card title="Introduzione" href="/it/packages/laravel-copilot-sdk/getting-started">
    Compi i primi passi con un'app Laravel che usa Copilot.
  </Card>

  <Card title="Autenticazione" href="/it/packages/laravel-copilot-sdk/auth">
    Configura login GitHub, autenticazione via token e flussi BYOK.
  </Card>

  <Card title="SessionConfig" href="/it/packages/laravel-copilot-sdk/session-config">
    Controlla strumenti, modelli, server MCP e comportamento della sessione.
  </Card>

  <Card title="SessionEvent" href="/it/packages/laravel-copilot-sdk/session-event">
    Comprendi gli helper eventi specifici di Laravel e la gestione del ciclo di vita.
  </Card>

  <Card title="Richieste di permesso" href="/it/packages/laravel-copilot-sdk/permission-request">
    Verifica il flusso di autorizzazione per eseguire strumenti con approvazione esplicita.
  </Card>

  <Card title="Strumenti" href="/it/packages/laravel-copilot-sdk/tools">
    Definisci strumenti personalizzati richiamabili da Copilot.
  </Card>

  <Card title="Streaming" href="/it/packages/laravel-copilot-sdk/streaming">
    Impara a gestire output incrementale e risposte live.
  </Card>

  <Card title="MCP" href="/it/packages/laravel-copilot-sdk/mcp">
    Collega server MCP per estendere le funzionalità.
  </Card>

  <Card title="Laravel Cloud" href="/it/packages/laravel-copilot-sdk/laravel-cloud">
    Esegui l'SDK in un ambiente Laravel Cloud.
  </Card>

  <Card title="Layer di compatibilità con l'SDK ufficiale" href="/it/packages/laravel-copilot-sdk/bare-usage">
    Verifica come usare da Laravel la stessa bare API dell'SDK ufficiale.
  </Card>
</Columns>

## Repository ufficiali

* Pacchetto Laravel: [invokable/laravel-copilot-sdk](https://github.com/invokable/laravel-copilot-sdk)
* SDK ufficiale: [github/copilot-sdk](https://github.com/github/copilot-sdk)


## Related topics

- [GitHub Copilot SDK for Laravel](/en/packages/laravel-copilot-sdk/index.md)