GitHub Copilot からのコンテンツの除外

Copilot のコンテンツ除外について

内容の除外を使用すると、特定のファイルを無視するように Copilot を構成できます。 Copilot からコンテンツを除外する場合:

• コード完成は、影響を受けるファイルでは使用できません。
• 影響を受けるファイル内のコンテンツは、その他のファイルのコード完成候補を通知しません。
• 影響を受けるファイル内のコンテンツは、GitHub Copilot Chat の応答を通知しません。

コンテンツ除外を構成できる人

リポジトリの管理者 、組織のオーナー、エンタープライズのオーナー が、コンテンツ除外を構成できます。

• リポジトリ管理者 は独自のリポジトリのコンテンツのみを除外できます。 これは、これらの特定のリポジトリ内で作業している Copilot ユーザーに影響します。
• 組織の所有者 は、組織を通じて Copilot シートを割り当てられたユーザーのコンテンツを除外できます。

• エンタープライズ所有者 は、エンタープライズ内のすべての Copilot ユーザーに除外ルールを適用できます。

コンテンツ除外の可用性

コンテンツ除外の制限

• Visual Studio Code および Visual Studio の Copilot Chat では、質問の @github チャット参加者を使用する場合、コンテンツの除外は適用されません。
• 除外されていないファイルで IDE から情報が提供されている場合、Copilot が除外されたファイルのセマンティック情報を使用する可能性があります。 このようなコンテンツの例としては、コードで使用されるシンボルの型情報やカーソル定義などがあります。

GitHub に送信されたデータ

コンテンツ除外を構成すると、クライアント (例: VS Code の Copilot 拡張子) は、現在のリポジトリ URL を GitHub サーバーに送信し、サーバーが正しいポリシーをクライアントに返すようにします。 これらの URL はいずれにあるログにも記録されません。

リポジトリのコンテンツ除外の構成

リポジトリ設定を使用して、GitHub Copilot で無視するようにするリポジトリ内のコンテンツを指定できます。

1. GitHub で、リポジトリのメイン ページに移動します。

2. リポジトリ名の下にある [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

   

3. サイドバーの [コードと自動化] セクションで、[ Copilot] をクリックします。

   リポジトリが同じエンタープライズ内の組織から除外を継承している場合、これらの除外の詳細を含むページの上部に 1 つまたは複数のグレー ボックスが表示されます。 これらの設定は編集できません。

4. [このリポジトリで除外するパス] のボックスに、Copilot を除外するファイルへのパスを入力します。

   各パスを別々の行にして、形式 - "/PATH/TO/DIRECTORY/OR/FILE" を使用します。 行頭を # にすることで、コメントを追加できます。

   Tip

   fnmatch パターン マッチング表記を使用して、ファイル パスを指定できます。 パターンでは大文字と小文字が区別されません。 ruby-doc.org ドキュメントの「File」(ファイル) を参照してください。

リポジトリ設定で指定されたパスの例

# Ignore the `/src/some-dir/kernel.rs` file in this repository.
- "/src/some-dir/kernel.rs"

# Ignore files called `secrets.json` anywhere in this repository.
- "secrets.json"

# Ignore all files whose names begin with `secret` anywhere in this repository.
- "secret*"

# Ignore files whose names end with `.cfg` anywhere in this repository.
- "*.cfg"

# Ignore all files in or below the `/scripts` directory of this repository.
- "/scripts/**"

- "/src/some-dir/kernel.rs"

- "secrets.json"

- "secret*"

- "*.cfg"

- "/scripts/**"

# Ignore the `/src/some-dir/kernel.rs` file in this repository.
- "/src/some-dir/kernel.rs"

# Ignore files called `secrets.json` anywhere in this repository.
- "secrets.json"

# Ignore all files whose names begin with `secret` anywhere in this repository.
- "secret*"

# Ignore files whose names end with `.cfg` anywhere in this repository.
- "*.cfg"

# Ignore all files in or below the `/scripts` directory of this repository.
- "/scripts/**"

組織のコンテンツ除外の構成

組織設定を使用して、GitHub Copilot を無視するようにするファイルを指定できます。 ファイルは、Git リポジトリ内、または Git の管理下にないファイル システム上の任意の場所に配置できます。

1. GitHub の右上隅で、プロフィール写真を選択し、 あなたの組織をクリックします。

2. 組織の隣の [設定] をクリックします。

3. 左側のサイドバーで、[ Copilot] をクリックし、[コンテンツの除外] をクリックします。

4. [除外するリポジトリとパス] のボックスに、Copilot を除外するファイルの詳細を入力します。

   任意の場所 (Git リポジトリ内または他の場所) にあるファイルを除外するには、 "*": を入力し、その後に除外するファイル (複数可) へのパスを入力します。 複数のファイル パス パターンを指定する場合は、各パターンを個別の行に一覧表示します。

   Git リポジトリのファイルを Copilot から除外するには、リポジトリへの参照を 1 行に入力し、その後にリポジトリ内の場所へのパスを各パスが別々の行になるように入力します。 次の形式を使用して、REPOSITORY-REFERENCE を、除外するファイルを含むリポジトリへの参照に置き換えます。

   REPOSITORY-REFERENCE:
     - "/PATH/TO/DIRECTORY/OR/FILE"
     - "/PATH/TO/DIRECTORY/OR/FILE"
     - ...
   

   リポジトリは、さまざまなプロトコルを使用して参照できます。 REPOSITORY-REFERENCE には、次のいずれかの構文を使用できます。また、リポジトリのローカルでの複製方法に関係なく、Copilot はこれらの構文と一致します。

   http[s]://host.xz[:port]/path/to/repo.git/
   
   git://host.xz[:port]/path/to/repo.git/
   
   [user@]host.xz:path/to/repo.git/
   
   ssh://[user@]host.xz[:port]/path/to/repo.git/
   

   リポジトリに対して無視するパスの計算では、REPOSITORY-REFERENCE の user@ 部分と :port 部分は無視されます。

   Azure DevOps では、REPOSITORY-REFERENCE を指定するときに新しい (dev.azure.com) または古い (visualstudio.com) ホスト形式を使用でき、どのホストを使用してリポジトリをローカルにクローンしたかに関係なく、Copilot はそれらに一致します。

   Tip

   fnmatch パターン マッチング表記を使用して、ファイル パスを指定できます。 パターンでは大文字と小文字が区別されません。 ruby-doc.org ドキュメントの「File」(ファイル) を参照してください。

組織設定のリポジトリとパスの例

# Ignore all `.env` files from all file system roots (Git and non-Git).
# For example, this excludes `REPOSITORY-PATH/.env` and also `/.env`.
# This could also have been written on a single line as:
#
# "*": ["**/.env"]
"*":
  - "**/.env"

# In the `octo-repo` repository in this organization:
octo-repo:
  # Ignore the `/src/some-dir/kernel.rs` file.
  - "/src/some-dir/kernel.rs"

# In the `primer/react` repository on GitHub:
https://github.com/primer/react.git:
  # Ignore files called `secrets.json` anywhere in this repository.
  - "secrets.json"
  # Ignore files called `temp.rb` in or below the `/src` directory.
  - "/src/**/temp.rb"

# In the `copilot` repository of any GitHub organization:
git@github.com:*/copilot:
  # Ignore any files in or below the `/__tests__` directory.
  - "/__tests__/**"
  # Ignore any files in the `/scripts` directory.
  - "/scripts/*"

# In the `gitlab-org/gitlab-runner` repository on GitLab:
git@gitlab.com:gitlab-org/gitlab-runner.git:
  # Ignore the `/main_test.go` file.
  - "/main_test.go"
  # Ignore any files with names beginning with `server` or `session` anywhere in this repository.
  - "{server,session}*"
  # Ignore any files with names ending with `.md` or `.mk` anywhere in this repository.
  - "*.m[dk]"
  # Ignore files directly within directories such as `packages` or `packaged` anywhere in this repository.
  - "**/package?/*"
  # Ignore files in or below any `security` directories, anywhere in this repository.
  - "**/security/**"

"*":
  - "**/.env"

octo-repo:

  - "/src/some-dir/kernel.rs"

https://github.com/primer/react.git:

  - "secrets.json"

  - "/src/**/temp.rb"

git@github.com:*/copilot:

  - "/__tests__/**"

  - "/scripts/*"

git@gitlab.com:gitlab-org/gitlab-runner.git:

  - "/main_test.go"

  - "{server,session}*"

  - "*.m[dk]"

  - "**/package?/*"

  - "**/security/**"

# Ignore all `.env` files from all file system roots (Git and non-Git).
# For example, this excludes `REPOSITORY-PATH/.env` and also `/.env`.
# This could also have been written on a single line as:
#
# "*": ["**/.env"]
"*":
  - "**/.env"

# In the `octo-repo` repository in this organization:
octo-repo:
  # Ignore the `/src/some-dir/kernel.rs` file.
  - "/src/some-dir/kernel.rs"

# In the `primer/react` repository on GitHub:
https://github.com/primer/react.git:
  # Ignore files called `secrets.json` anywhere in this repository.
  - "secrets.json"
  # Ignore files called `temp.rb` in or below the `/src` directory.
  - "/src/**/temp.rb"

# In the `copilot` repository of any GitHub organization:
git@github.com:*/copilot:
  # Ignore any files in or below the `/__tests__` directory.
  - "/__tests__/**"
  # Ignore any files in the `/scripts` directory.
  - "/scripts/*"

# In the `gitlab-org/gitlab-runner` repository on GitLab:
git@gitlab.com:gitlab-org/gitlab-runner.git:
  # Ignore the `/main_test.go` file.
  - "/main_test.go"
  # Ignore any files with names beginning with `server` or `session` anywhere in this repository.
  - "{server,session}*"
  # Ignore any files with names ending with `.md` or `.mk` anywhere in this repository.
  - "*.m[dk]"
  # Ignore files directly within directories such as `packages` or `packaged` anywhere in this repository.
  - "**/package?/*"
  # Ignore files in or below any `security` directories, anywhere in this repository.
  - "**/security/**"

エンタープライズのコンテンツ除外の構成

エンタープライズのオーナーは、エンタープライズ設定を使用して、GitHub Copilot で無視するファイルを指定できます。 ファイルは、Git リポジトリ内、または Git の管理下にないファイル システム上の任意の場所に配置できます。

1. GitHub の右上の自分のプロフィール写真をクリックし、[自分の Enterprise] をクリックします。

2. Enterpriseのリストで、表示したいEnterpriseをクリックしてください。

3. ページの左側にある Enterprise アカウントのサイドバーで、 [ポリシー] をクリックします。

4. " [ポリシー]" セクションで [Copilot] をクリックします。

5. [Content の除外] タブをクリックします。

6. パスを使用して、除外するコンテンツを指定します。 前セクションの「組織のコンテンツ除外の構成」を参照してください。

コンテンツ除外の変更をテストする

IDE を使用して、コンテンツ除外の変更が想定どおりに動作していることを確認できます。

IDE にコンテンツ除外の変更を伝達する

コンテンツの除外を追加または変更し、設定が既に読み込まれている IDE で有効になるまでに最大で 30 分かかることがあります。 待機しない場合は、次の手順を使用して、コンテンツの除外設定を手動で再読み込みできます。

• JetBrains IDE と Visual Studio の場合は、アプリケーションを閉じて再度開くことで、コンテンツの除外設定を再読み込みします。
• Visual Studio Code の場合は、次の手順に従ってコンテンツの除外設定を再読み込みします。
  1. コマンド パレットにアクセスします。 たとえば、Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux) を押します。
  2. 次のコマンドを入力します: reload
  3. [開発者: ウィンドウをリロードする] を選択します。
• Vim/Neovim については、ファイルを開くたびに GitHub からコンテンツ除外が自動的にフェッチされます。

コンテンツの除外をテストする

使用している IDE に応じて、コンテンツの除外をテストする方法はいくつかあります。

1. コンテンツ除外の影響を受けると予想されるファイルを開きます。
2. コンテンツが除外されているかどうかをテストするには、次の 1 つ以上の手法を使用します。
   • JetBrains IDEs、Visual Studio、および Visual Studio Code においては、ステータスバーの Copilot を確認してください。 Copilot コンテンツ除外がこのファイルに適用される場合、Copilot アイコンには斜線が表示されます。 アイコンをホバーすると、組織または親リポジトリがこのファイルに対して Copilot を無効にしたかどうかを表示します。
   • JetBrains IDE、Visual Studio、および Visual Studio Code では、Copilot Chat でコンテンツの除外をテストすることもできます。 Copilot Chat ウィンドウを開き、除外されたファイルについて Copilot Chat に質問します。 コンテンツが正常に除外された場合、Copilot は質問に答えることができません。また、コンテンツの除外ルールにより、一部のファイルが会話から除外されたことを説明します。
   • Vim/Neovim でファイルの入力を開始します。 入力時に GitHub Copilot がインライン検索候補を提供しなくなった場合、ファイルは除外されています。

参考資料

• 「GitHub Copilot のコンテンツ除外の変更の確認」
• Microsoft Learn ドキュメントで Visual Studio のコンテンツ除外を設定する