エージェント用のカスタム環境の作成

GitHub または GitHub Actions によって管理されるクラウドサンドボックスを使用する代わりに、GitHub Copilot セッション用のカスタム環境を提供できます。カスタム環境は、Copilot ホスト（copilotd）を実行する Linux マシンまたはコードスペースです。

ホストを作成し、ご利用のGitHubアカウントに登録します。その後、カスタム環境をサポートするクライアントの環境として選択できます。登録により、既存のホストがクライアントが使用できるようになります。

Copilotライセンスとカスタム環境へのアクセスが必要です。マシン、そのワークスペース、ツールを担当し、ホストを稼働させたまま最新の状態に保つ必要があります。クライアント接続を閉じても、ホストまたはマシンは停止しません。

Linux マシンの使用

Copilot CLIを使用して、Linux マシン上でホストを実行し、登録します。

1. ホストを準備する

Copilot CLIのプレリリースバージョンをインストールするには、Linux マシンと npm または Homebrew が必要です。インストール要件とその他のインストール方法については、 GitHub Copilot CLI のインストールを参照してください。

使用するマシンで、ワークスペースを準備し、エージェントセッションに必要なツールと依存関係をインストールします。
npm を使用して Copilot CLI のプレリリースバージョンをインストール:
```
npm install -g @github/copilot@prerelease
```
または、Homebrew を使用してインストールしてください:
```
brew install copilot-cli@prerelease
```

2. ホストを登録する

ホストは、認証に使用するアカウントが所有する環境として登録されます。

GitHub.comにサインインし、認証プロンプトに従います。
```
copilot login
```
アカウント設定と機能フラグが読み込まれるように Copilot CLI を開始し、その後、対話型セッションを終了してください。
```
copilot
```
環境ホストを起動します。 HOST-NAMEを、環境セレクターで認識できる名前に置き換えてください。
```
copilot --environment-host "HOST-NAME"
```
このコマンドはホストを起動し、選択した名前でマシンを登録します。クライアントがホストに接続できるように、ホストを実行したままにします。

3. 環境を選択する

登録済み環境の選択をサポートするクライアントから接続します。

ホストの登録に使用したのと同じ GitHub アカウントでクライアントにサインインします。
環境を開き、登録した名前のホストを選択してください。

クライアントは、エージェントセッションがそこで実行される実行中のホストに接続します。

GitHub Codespaces の使用

開発コンテナー機能を使用して、コードスペースの起動時にホストを自動的に起動および登録してください。 GitHub Codespacesへのアクセスが必要です。次のコマンドを使用するには、GitHub CLIの認証済みのインストール環境も必要です。

1. Codespace を設定する

開発コンテナーの構成によって、ホストのインストール方法が決まります。

リポジトリで、ホスト機能を追加するために .devcontainer/devcontainer.json を作成または編集します。例:

{
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/github/copilot-host/copilotd:0": {}
  }
}

必要に応じて、ご使用の環境向けにその機能を構成します。プレリリースチャネルには、:prerelease の代わりに :0 を使用します。追加のリポジトリを複製するには、機能の構成オブジェクト内に repositories オプションを追加してください。
```
"ghcr.io/github/copilot-host/copilotd:0": {
  "repositories": "OWNER/REPOSITORY-1,OWNER/REPOSITORY-2"
}
```

OWNER/REPOSITORY-1とOWNER/REPOSITORY-2を、複製するリポジトリの所有者と名前に置き換えます。

2. ホストを起動して登録する

この機能は copilotd で開始し、コンテナーの起動時にコードスペースを自動的に登録します。

新しいコードスペースを作成するには、開発コンテナー構成をコミットしてプッシュしてください。その後、そのブランチにコードスペースを作成します。リポジトリの所有者と名前でOWNER/REPOSITORYを置き換え、構成を含むブランチでBRANCHを置き換えます。
```
gh codespace create -r OWNER/REPOSITORY -b BRANCH
```
既存のコードスペースの場合は、代わりにそのコンテナーを再構築してください。 CODESPACE-NAMEをコードスペースの名前に置き換えます。
```
gh codespace rebuild -c CODESPACE-NAME
```
コンテナーが起動し、ホストが登録されるまで待ちます。

3. コードスペース環境を選択する

登録済み環境を選択できるクライアントを使用します。クライアントへのサインインに使用するトークンには、 codespace スコープが含まれている必要があります。

コードスペースを所有する GitHub アカウントを使用してクライアントにサインインします。
Environments を開き、コードスペースを選択します。

コードスペースが停止している場合、接続するとウェイクアップして copilotd が自動的に開始されます。

ホストログを検査するには、codespace で次のコマンドを実行します。

tail -F /workspaces/.copilotd/logs/copilotd.log