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

GitHub Copilot のコンテンツ除外が機能する仕組みについて説明します。

この機能を使用できるユーザーについて

リポジトリ管理者と組織の所有者は、コンテンツの除外設定を管理できます。

リポジトリの "保持" ロールを持つユーザーは、そのリポジトリのコンテンツ除外設定を表示できますが、編集することはできません。

GitHub Copilot Business または GitHub Copilot Enterprise にサブスクリプションしている組織

この記事の内容

Note

GitHub Command Palette からのコンテンツの除外は現在パブリック ベータ版であり、変更される可能性があります。

リポジトリまたは organization の設定で、GitHub Copilot を、[コンテンツへの特定のパスを除外することで特定のファイルを無視する] に設定できます。

コンテンツ除外を指定すると、IDE のサポート レベルに応じて最大 3 つの効果があります。

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

コンテンツの除外を追加または変更し、設定が既に読み込まれている IDE で有効になるまでに最大で 30 分かかることがあります。 独自の IDE に変更を適用して、コンテンツの除外設定を強制的に再読み込みすることができます。 の詳細については、「IDE でコンテンツ除外の変更をテストする」を参照してください。

コンテンツ除外の可用性

ツールコード完成のサポートCopilot Chat のサポート
Visual Studio
Visual Studio Code
JetBrains IDE
Vim/Neovim適用なし
Azure Data Studio適用なし
GitHub.com適用なし

コンテンツ除外の制限

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

何を除外することができますか?

リポジトリの設定でコンテンツの除外を指定するには、そのリポジトリ内のファイルのみを除外できます。

Organization の設定でコンテンツ除外を指定すると、GitHub.com でホストされている Git ベースのリポジトリ、または次の構文のいずれかを使用してアクセスできる任意の場所にあるファイルを除外できます。

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/

コンテンツの除外設定の影響を受ける対象者

コンテンツの除外設定は、次の各条件を満たすユーザーにのみ適用されます:

  • GitHub Copilot Business または GitHub Copilot Enterprise サブスクリプションの一部としてシートが与えられています
  • これらは、コンテンツの除外が設定されているのと同じ enterprise のメンバーです

指定したファイルにアクセスできる他のユーザーには、指定されたファイルを参照するコード補完候補と GitHub Copilot Chat 応答が表示されます。

Enterprise の設定でコンテンツの除外を指定することはできません。 ただし、Organization またはリポジトリ設定で定義されたコンテンツ除外はすべて、Copilot Business または Copilot Enterprise サブスクリプションの一部として Copilot シートを付与された Enterprise のすべてのメンバーに適用されます。

つまり、たとえば、Enterprise X に属する Organization の管理者の場合、GitHub または他の場所でホストされている Git ベースのリポジトリ内のファイルの除外を設定でき、その除外は Enterprise X の任意の Organization から Copilot Business または Copilot Enterprise ライセンスを取得したすべてのユーザーに適用されます。

Tip

コンテンツ除外をより簡単に追跡するには、影響を受けるファイルを含むリポジトリの設定、またはリポジトリを所有する organization の設定で、除外を作成します。

GitHub に送信されたデータ

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

次のステップ

リポジトリまたは organization でコンテンツ除外を設定するには、「GitHub Copilot のコンテンツ除外の構成」を参照してください。