> ## 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

> Comprende qué ofrece Laravel Copilot SDK y navega a las guías principales sobre configuración, sesiones, herramientas y configuración en tiempo de ejecución.

GitHub Copilot SDK for Laravel es un SDK comunitario que permite usar los flujos de trabajo del [GitHub Copilot SDK](https://github.com/github/copilot-sdk) oficial dentro de aplicaciones Laravel.

Puedes invocar Copilot desde varios contextos de ejecución de Laravel, como comandos Artisan, controladores o jobs.

## Puntos específicos de Laravel

Este paquete añade una experiencia nativa de Laravel sobre la capa de compatibilidad del SDK.

* API basada en Facade centrada en `Copilot::run()` y `Copilot::start()`
* Configuración al estilo Laravel mediante `config/copilot.php` y `.env`
* Puntos de integración con Laravel Prompts, colas y la UX de consola
* Utilidades de pruebas como `Copilot::fake()` y aserciones sobre prompts

## Ejemplos de uso

### Ejecutar un único prompt

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

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

### Ejecutar varios prompts en una sola sesión

```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;

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

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

// Sin argumentos, equivale al Facade
dump(copilot()->client()->ping());
```

## Empieza por aquí

<Columns cols={2}>
  <Card title="Primeros pasos" href="/es/packages/laravel-copilot-sdk/getting-started">
    Da los primeros pasos con una app Laravel que usa Copilot.
  </Card>

  <Card title="Autenticación" href="/es/packages/laravel-copilot-sdk/auth">
    Configura el login con GitHub, la autenticación por token y los flujos BYOK.
  </Card>

  <Card title="SessionConfig" href="/es/packages/laravel-copilot-sdk/session-config">
    Controla herramientas, modelos, servidores MCP y el comportamiento de la sesión.
  </Card>

  <Card title="SessionEvent" href="/es/packages/laravel-copilot-sdk/session-event">
    Comprende los helpers de eventos específicos de Laravel y el manejo del ciclo de vida.
  </Card>

  <Card title="Solicitudes de permiso" href="/es/packages/laravel-copilot-sdk/permission-request">
    Revisa el flujo de permisos para ejecutar herramientas con aprobación explícita.
  </Card>

  <Card title="Herramientas" href="/es/packages/laravel-copilot-sdk/tools">
    Define herramientas personalizadas que Copilot pueda invocar.
  </Card>

  <Card title="Streaming" href="/es/packages/laravel-copilot-sdk/streaming">
    Aprende a gestionar salida incremental y respuestas en vivo.
  </Card>

  <Card title="MCP" href="/es/packages/laravel-copilot-sdk/mcp">
    Conecta servidores MCP para ampliar las capacidades.
  </Card>

  <Card title="Laravel Cloud" href="/es/packages/laravel-copilot-sdk/laravel-cloud">
    Ejecuta el SDK en entornos Laravel Cloud.
  </Card>

  <Card title="Capa de compatibilidad con el SDK oficial" href="/es/packages/laravel-copilot-sdk/bare-usage">
    Descubre cómo usar desde Laravel la misma API bare del SDK oficial.
  </Card>
</Columns>

## Repositorios oficiales

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


## Related topics

- [GitHub Actions - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/github-actions.md)
- [Tests - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/fake.md)
- [Autenticación - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/auth.md)
- [Laravel Cloud - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/laravel-cloud.md)
- [Primeros pasos - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/getting-started.md)