GitHub Copilotのenterprise managed settingsに、設定ミスを画面上で検出するin-product validatorが追加されました。2026年9月25日のGitHub公式Changelogでは、malformed JSON、unsupported configurations、invalid team mappingsなど、ポリシー適用を止めるエラーをenterprise AI controls内の「Copilot settings validation」で確認できると説明されています。対象はcopilot/managed-settings.json、copilot/team-mappings.json、そしてteam-mappings.jsonから参照されるteam settings filesです。
この記事では、Copilot Business/Enterpriseの管理者が30日以内に確認したい3つのJSON検証観点を整理します。既存のenterprise managed settings記事が「何を配るか」に寄っているのに対し、今回は「設定が本当に効いているか」を検証する運用チェックリストとして扱います。
概要：何が新しいのか
新機能の要点は、設定ファイルをコミットしたあとに、GitHub側がリポジトリベースのserver-managed settingsを自動検証し、管理画面で問題箇所を示すことです。公式ドキュメントでは、対象ファイル、JSON path、errors/warningsをAI controlsのAgentsタブで確認し、修正後にdefault branchへcommitしてから画面を再読み込みする流れが示されています。
これまでの運用では、JSONの構文は通っていても、サポート外キー、チーム名の不一致、参照先ファイルの抜け、overridable指定の誤解が現場で起きやすい課題でした。validatorは、設定配布そのものよりも、管理者が「効いているつもり」の状態を減らすための機能です。
仕様表：検証対象と確認できること
検証対象1：copilot/managed-settings.json。全体の既定値、model:auto、sandboxやagent pluginsなどのenterprise managed settingsを置く中心ファイルです。validatorでは、malformed JSONやunsupported configurationsなど、設定として解釈できない問題を確認します。
検証対象2：copilot/team-mappings.json。チームごとに別設定を割り当てる対応表です。GitHub公式ドキュメントの例では、no-auto.jsonをspecial-teamに割り当てる形が紹介されています。ここでteam slugの誤り、参照ファイル名の不一致、配列形式の誤りがあると、特定チームだけポリシーが外れるリスクがあります。
検証対象3：copilot/teams/配下の参照ファイル。team-mappings.jsonから参照されるteam settings filesも検証対象です。全社既定値は厳しく、研究開発チームだけmodelをunmanagedにする、といった例外運用では、この層の検証が重要になります。
30日PoCでは、1つの.github-private repository、2つのteam settings file、3種類のエラー分類という小さな範囲から始めるのが現実的です。HelloCraftAIでは、Copilot管理設定の棚卸し、AI開発ツールの権限設計、PoC設計まで支援しています。 相談する
設定方法：AI controlsで3段階確認する
ステップ1は、.github-private repositoryの構造を固定することです。copilot/managed-settings.jsonを中心に置き、チーム別例外が必要な場合だけcopilot/team-mappings.jsonとcopilot/teams/*.jsonを追加します。最初から全チームを分けるのではなく、管理者チームと検証チームの2グループで始めると、エラーの原因を切り分けやすくなります。
ステップ2は、default branchにcommitしたあと、enterpriseのAI controlsに移動し、AgentsタブのCopilot settings validationを見ることです。GitHub公式発表では、各issueがaffected fileとJSON pathを示すとされています。つまり、管理者はエラー一覧を見て、どのファイルのどの階層を修正すべきか判断できます。
ステップ3は、修正後に再commitし、Agents pageをreloadしてvalid状態を確認することです。ここで重要なのは、ローカルのJSON lintだけで完了にしないことです。Copilot clientごとの対応キー、server-managed deploymentとしての参照関係、team mappingの実在性は、GitHub側のvalidator結果まで見る必要があります。
運用チェックリスト：3つのJSONミスを先に潰す
チェック1：構文エラー。末尾カンマ、引用符漏れ、オブジェクトと配列の取り違えをCIでも検出します。validatorが画面で出るとはいえ、default branchへ壊れた設定を入れ続けると、管理画面確認がボトルネックになります。Pull Request上でjsonlintを走らせ、AI managerがレビューしてからmergeする流れにします。
チェック2：サポート外設定。enterprise managed settingsは、Copilot CLI、VS Code、GitHub Copilot app、Copilot cloud agent、JetBrains IDEsなど複数clientを対象にしますが、すべてのclientがすべてのpropertyを支えるわけではありません。設定表では、キー名、対象client、必須度、例外可否の4列を持たせると運用しやすくなります。
チェック3：team mappingのズレ。team-mappings.jsonの値はenterprise team slugに依存します。組織再編でチーム名が変わると、特定チーム向けの制御が効かない可能性があります。月1回、enterprise teams一覧とteam-mappings.jsonの差分を確認し、削除済みteamや未使用settings fileを棚卸しします。
判断支援：管理者が見るべきKPI
KPIは3つに絞ります。1つ目はvalidatorの未解決issue数です。初回はerrorsとwarningsを分け、errorsは48時間以内、warningsは次回定例までに処理します。2つ目は設定変更からvalid確認までのリードタイムです。30分以内に収まらない場合、レビュー担当や承認手順が多すぎる可能性があります。
3つ目は例外設定の割合です。全ユーザーのうちteam-specific overrideが20%を超える場合、全社既定値が現場に合っていないサインです。例外を増やすより、全社既定、開発者既定、研究開発既定の3段階に整理し直す方が、監査と説明が楽になります。
FAQ
Q. validatorだけで本番適用確認は完了できますか？ A. いいえ。validatorは設定ファイルと参照関係の問題を検出する入口です。実際にVS Code、Copilot CLI、GitHub Copilot app、cloud agentなどのsupported clientsで期待どおりの挙動になっているか、代表ユーザーで確認する必要があります。
Q. 既存のmanaged settings記事と何が違いますか？ A. 既存記事は既定モデル固定やteam-mappingsの設計が中心でした。この記事は、2026年9月25日に追加されたin-product validatorを前提に、エラー検知、修正、再確認、KPI化までの運用に絞っています。
Q. まず何から始めるべきですか？ A. managed-settings.json、team-mappings.json、copilot/teams/配下の参照ファイルを一覧化し、AI controlsのCopilot settings validationでerrorsを0にすることです。その後、2チームだけでoverrideの挙動を確認し、30日PoCに広げます。
まとめ：設定配布から検証運用へ
Copilot設定バリデータは、enterprise managed settingsを大規模に配る企業にとって、設定ファイルの品質ゲートになります。重要なのは、画面にvalidatorが増えたこと自体ではなく、managed-settings.json、team-mappings.json、team settings filesの3層を、変更管理と監査のプロセスに組み込むことです。
2026年9月時点では、GitHub Copilotの管理はモデル選択、agent権限、sandbox、plugin、OpenTelemetryまで広がっています。設定が増えるほど、誤ったJSONや古いteam mappingは見えにくくなります。まずはerrors 0、48時間以内修正、月1回棚卸しの3ルールから始めると、現場の自由度と統制を両立しやすくなります。導入設計や社内PoCの整理が必要な場合は、 HelloCraftAIにご相談ください 。
