エンタープライズ管理設定を使い始める

エンタープライズ管理設定を使用すると、 GitHub Copilot の構成設定を一元的に定義し、サポートされているクライアントに配布できます。 これにより、全員が定義したガードレールの範囲内で作業しつつ、チームごとに設定を個別化できるようになります。 たとえば、エージェントが機密性の高い操作を実行するのをブロックしたり、承認済みのエージェント プラグインをインストールしたり、セッションがサンドボックスで実行されるようにしたりできます。

このガイドでは、managed-settings.jsonでのGitHub ファイルの作成、ユーザーへの設定のロールアウト、エンタープライズ チームの特定の設定のオーバーライドについて説明します。 低摩擦の例として、ほとんどのユーザーに対して新しい会話が自動モデル モードで開始されるようにし、特定のエンタープライズ チームに対してこの設定をオーバーライドします。 この例では、ユーザーを中断させることなく、マネージド設定の展開をテストできます。

サポートされているクライアント

次のクライアントはサポートされていますが、すべてのクライアントがすべてのプロパティをサポートしているわけではありません。

• Copilot CLI

• VS Code

• GitHub Copilot app

• Copilot cloud agent

• JetBrains IDEs

サポートされているキーの完全なリファレンスについては、 エンタープライズ管理設定 を参照してください。

1. .github-private リポジトリを作成する

managed-settings.json ファイルは、企業内の指定された組織が所有する.github-private リポジトリでホストできます。 これにより、企業のメンバーが表示できる場所で、カスタム エージェント プロファイルの横にマネージド設定を保持できます。

リポジトリを作成し、それを企業のクライアント ガバナンスのソースとして選択する手順については、.github-private リポジトリの作成 を参照してください。

このリポジトリのガバナンス設定は、ユーザーがCopilotリポジトリまたはそのリポジトリを所有する組織にアクセスできるかどうかにかかわらず、お客様のエンタープライズまたはそのいずれかの組織から.github-privateライセンスを付与されたすべてのユーザーに適用されます。 エンタープライズ メンバーがガバナンス設定を表示できるように、リポジトリの内部可視性を付与し、 managed-settings.json ファイルの編集を管理者と AI マネージャーに制限することをお勧めします。

2. managed-settings.json ファイルを作成する

この例では、ユーザーの会話が自動モードで開始されるように、非常に単純な構成を使用しています。 つまり、 Copilot は、企業の許可されたモデルからユーザーのタスクに最適なモデルを自動的に選択します。これにより、ユーザーのレート制限の問題が軽減されます。

1. .github-private リポジトリで、copilot/managed-settings.jsonにファイルを作成します。

2. ファイルに構成を追加します。 例えば次が挙げられます。

   JSON

   {
     "model": "auto"
   }
   

3. 変更を既定のブランチにコミットします。

実際のロールアウトについては、 サポートされているキーとクライアント全体の対象範囲を確認します。 「エンタープライズ管理設定」を参照してください。

3. 特定のチームの設定をオーバーライドする

エンタープライズ チームの managed-settings.json ファイルでサポートされているプロパティをオーバーライドできます。 この例では、特殊な作業のために特定のモデルに対応する必要があるチームの自動モデルの既定値を無効にします。

このセクションを完了すると、 .github-private リポジトリの構造は次のようになります。

• .github-private/
  • copilot/

    ---

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

Steps

1. 自動モードの既定値を受け取らないユーザーを含むエンタープライズ チームを作成します。 この例では、 special-teamと呼びます。 「Enterprise チームの作成」を参照してください。

2. copilot/managed-settings.json ファイルで、{ "overridable": VALUE }構文を使用して、キーをオーバーライドの対象としてマークします。 VALUEは、teams ファイルが特定のキーに対して異なる値を宣言しない場合の既定値です。

   たとえば、エンタープライズ チーム向けに model をオーバーライド可能にし、一方で auto は他のすべてのユーザーには既定のままにします。

   JSON

   {
     "model": { "overridable": "auto" }
   }
   

3. .github-private リポジトリで、copilot/teams/下にエンタープライズ チーム専用の設定ファイルを作成します。 たとえば、 copilot/teams/no-auto.jsonと指定します。

   このファイルで、オーバーライド可能なプロパティの値を提供する構成を追加します。

   次の例では、自動モデル モードのコントロールを削除します。 それ以外はすべて、 managed-settings.json ファイルによって管理されます。

   JSON

   {
     "model": "unmanaged"
   }
   

4. .github-private リポジトリで、copilot/team-mappings.jsonを作成します。 このファイルでは、エンタープライズ チームの名前を特殊な構成ファイルにマップします。 キーは設定ファイル名であり、値はチーム スラッグの配列であるため、複数のチームに 1 つのファイルを適用できます。

   JSON

   {
     "no-auto.json": ["special-team"]
   }
   

5. 変更をコミットして既定のブランチにプッシュします。

後で、他のキーや他のチームに対して異なるオーバーライドを追加できます。 より完全な例については、 チームに対するエンタープライズ管理設定の上書き を参照してください。

4. 設定がアクティブであることを確認する

定義した設定がユーザーに対してアクティブであり、特定のチームに対してオーバーライドされていることを確認します。 この例では、企業の Copilot ユーザーのほとんどは、クライアントの新しい会話が自動モードで開始されることを確認する必要があります。 special-teamエンタープライズ チームは、このエクスペリエンスを持つべきではありません。

サーバーで管理される展開の場合、サポートされているクライアントのユーザーには、指定された設定が約 1 時間以内に表示されます。 これには、copilot/managed-settings.json内のcopilot/team-mappings.json、copilot/teams/、ファイルが含まれます。 クライアントを再起動するか、もう一度サインインすると、即時更新がトリガーされます。

ユーザーにこれらの設定が表示されない場合は、企業またはその組織のいずれかを通じて Copilot へのアクセス権をユーザーが受け取っていることを確認します。 ユーザーが複数の課金エンティティからライセンスを受け取った場合は、 個人の Copilot 設定の [使用量の請求先] ドロップダウンで企業を選択していることを確認します。

MDM で管理される展開の場合、クライアントは 1 時間ごとに更新されたポリシーを確認します。 ファイル ベースの展開の場合は、クライアントを再起動して更新されたファイルを読み込みます。 これらの展開方法は、 Copilot ライセンスの取得元に関係なく、コンピューターにインストールされている設定を持つすべてのユーザーに適用されます。

次のステップ

これで、簡単な管理設定のセットアップが作成されました。次のことができます。

• ファイルにガバナンス プロパティを追加します。 「エンタープライズ管理設定」を参照してください。
• 他の方法でユーザーに設定を展開するかどうかを決定します。 「エンタープライズ管理の設定をユーザーに展開する方法の選択」を参照してください。