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

> Laravel Copilot SDK가 제공하는 내용을 이해하고 설정, 세션, 도구, 런타임 설정에 대한 주요 가이드로 이동합니다.

GitHub Copilot SDK for Laravel는 공식 [GitHub Copilot SDK](https://github.com/github/copilot-sdk)의 워크플로를 Laravel 애플리케이션에서 사용할 수 있도록 해주는 커뮤니티 SDK입니다.

Artisan 명령어, 컨트롤러, 잡 등 Laravel의 다양한 실행 컨텍스트에서 Copilot을 호출할 수 있습니다.

## Laravel 고유의 특징

이 패키지는 SDK 호환 레이어 위에 Laravel 네이티브한 사용성을 추가합니다.

* `Copilot::run()`과 `Copilot::start()`를 중심으로 한 Facade 기반 API
* `config/copilot.php`와 `.env`를 사용하는 Laravel 스타일의 설정
* Laravel Prompts, 큐, 콘솔 UX와의 통합 지점
* `Copilot::fake()`와 프롬프트 어서션 같은 테스트 유틸리티

## 사용 예시

### 단일 프롬프트 실행

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

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

### 하나의 세션에서 여러 프롬프트 실행

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

### `copilot()` 헬퍼

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

// 프롬프트를 지정한 경우 Copilot::run()과 동일
$response = copilot('Tell me something about Laravel.');

// 클로저를 지정한 경우 Copilot::start()와 동일
copilot(function (CopilotSession $session) {
    $response = $session->sendAndWait(prompt: 'Tell me something about PHP.');
});

// 아무것도 전달하지 않으면 Facade와 동일
dump(copilot()->client()->ping());
```

## 여기서 시작하기

<Columns cols={2}>
  <Card title="시작하기" href="/ko/packages/laravel-copilot-sdk/getting-started">
    Copilot을 사용하는 Laravel 앱의 첫 걸음을 진행합니다.
  </Card>

  <Card title="인증" href="/ko/packages/laravel-copilot-sdk/auth">
    GitHub 로그인, 토큰 인증, BYOK 워크플로를 설정합니다.
  </Card>

  <Card title="SessionConfig" href="/ko/packages/laravel-copilot-sdk/session-config">
    도구, 모델, MCP 서버, 세션 동작을 제어합니다.
  </Card>

  <Card title="SessionEvent" href="/ko/packages/laravel-copilot-sdk/session-event">
    Laravel 고유의 이벤트 헬퍼와 라이프사이클 처리를 이해합니다.
  </Card>

  <Card title="권한 요청" href="/ko/packages/laravel-copilot-sdk/permission-request">
    명시적인 승인으로 도구를 실행하는 권한 흐름을 확인합니다.
  </Card>

  <Card title="도구" href="/ko/packages/laravel-copilot-sdk/tools">
    Copilot에서 호출할 수 있는 커스텀 도구를 정의합니다.
  </Card>

  <Card title="스트리밍" href="/ko/packages/laravel-copilot-sdk/streaming">
    순차 출력과 라이브 응답을 다루는 방법을 배웁니다.
  </Card>

  <Card title="MCP" href="/ko/packages/laravel-copilot-sdk/mcp">
    MCP 서버를 연결하여 기능을 확장합니다.
  </Card>

  <Card title="Laravel Cloud" href="/ko/packages/laravel-copilot-sdk/laravel-cloud">
    Laravel Cloud 환경에서 SDK를 실행합니다.
  </Card>

  <Card title="공식 SDK 호환 레이어" href="/ko/packages/laravel-copilot-sdk/bare-usage">
    공식 SDK와 동일한 bare API를 Laravel에서 사용하는 방법을 확인합니다.
  </Card>
</Columns>

## 공식 저장소

* Laravel 패키지: [invokable/laravel-copilot-sdk](https://github.com/invokable/laravel-copilot-sdk)
* 공식 SDK: [github/copilot-sdk](https://github.com/github/copilot-sdk)


## Related topics

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