GitHub Code ScanningのAgentic Autofixとは?CopilotへAssignして修正PRを作る要件・課金・従来版との違い

Code scanning alertを開いても従来のGenerate fixが見つからない場合、最初に疑うべきなのは障害ではなく、Agentic Autofixへの切り替えです。2026年7月にパブリックプレビューが始まった新しい仕組みでは、対象リポジトリの個別アラート画面でGenerate fixAssign to Copilotに置き換わり、Copilotがコード調査、修正、検証、修正PRの作成まで進めます。

利用には、対象リポジトリで有効なGitHub Code SecurityまたはGitHub Advanced Security、Copilotの有料ライセンス、Copilot cloud agentの有効化が必要です。実行後は通常2~4分程度でドラフトPRが作成されますが、AI creditsとGitHub Actions minutesを消費します。(The GitHub Blog)

Assign to Copilotも表示されない場合は、ライセンス、Copilot Autofixポリシー、cloud agentの利用可否、ユーザー権限を確認します。UIを使えない場合には、code scanning alertのassigneeをcopilot-swe-agent[bot]へ変更するREST APIも、GitHub公式の実行経路として用意されています。

目次

まず確認したい「ボタン表示別」の結論

アラート画面の表示状態取るべき操作
Assign to Copilotが表示されるAgentic Autofixを利用可能Copilotへ割り当ててドラフトPRを作成する
Generate fixが表示されるclassic Autofixを利用可能修正案を生成し、内容を確認してPRを作成する
どちらも表示されないライセンス、ポリシー、権限、アラートの対応状況に問題がある可能性Code Security、Copilot Autofix、cloud agent、write権限を順番に確認する
UIから操作できないAPIによる割り当てを検討assigneeにcopilot-swe-agent[bot]を設定する

Agentic Autofixを利用できるリポジトリでは、従来の無料のGenerate fixAssign to Copilotに置き換わるため、ボタンが消えたこと自体は不具合とは限りません。一方、Copilot cloud agentを利用できないリポジトリでは、従来型のCopilot Autofixが引き続き利用できる場合があります。(The GitHub Blog)

GitHub code scanningのAgentic Autofixとは

Agentic Autofixは、code scanning alertをCopilotへ割り当てることで、修正作業をエージェントセッションとして実行する機能です。

Copilotは単に警告箇所の数行を書き換えるだけではありません。関連するファイルや処理を調査し、修正を作成したうえで、必要に応じて検証と修正を繰り返し、レビュー用のドラフトPRを作成します。

基本的な処理の流れは次のとおりです。

  1. アラートと関連コードを調査する
  2. リポジトリ内の関連ファイルを確認する
  3. 修正案を実装する
  4. CodeQLなどによる検証を試みる
  5. 必要に応じて修正を繰り返す
  6. 修正内容と検証結果を記載したドラフトPRを作成する

PRが作成された後は、PRコメントやリポジトリのAgentsタブから、Copilotへ追加修正を依頼できます。通常の所要時間は2~4分程度ですが、これは目安であり、リポジトリの規模、ビルド時間、依存関係、検証内容によって長くなることがあります。(The GitHub Blog)

Copilot coding agentの現在の名称はCopilot cloud agent

従来「Copilot coding agent」と呼ばれていた機能は、2026年に「Copilot cloud agent」へ名称変更されています。

管理画面や新しいGitHub Docsではcloud agentと記載されるため、設定を探すときは「coding agent」だけでなく「cloud agent」という名称も確認してください。(The GitHub Blog)

CodeQL以外のアラートにも割り当てられる

Agentic Autofixのパブリックプレビューは、CodeQLだけでなく、SARIFなどを通じて登録されたサードパーティ製スキャンツールのcode scanning alertも対象とされています。(The GitHub Blog)

ただし、割り当て可能であることと、同じ精度で検証できることは別です

GitHub Docsでは、Copilotによる検証はCodeQLの標準的なcode-scanning query suiteを利用したベストエフォートであり、次のアラートでは修正完了を十分に確認できない可能性があると説明されています。

  • カスタムCodeQLクエリによるアラート
  • security-extendedクエリスイート固有のアラート
  • サードパーティ製スキャンツールのアラート
  • ビルドやテストに特殊な外部環境が必要なリポジトリ

サードパーティ製ツールのアラートを修正した場合は、CopilotのPRだけで完了と判断せず、元のスキャンツールを再実行してください。(GitHub Docs)

Agentic Autofixとclassic Autofixの違い

GitHubのcode scanningには、現在、Agentic Autofixと従来型のCopilot Autofixという2つの修正経路があります。

比較項目Agentic Autofixclassic Copilot Autofix
主な操作Assign to CopilotGenerate fix
修正方法エージェントが関連ファイルを調査して実装個別アラートに対する1回の修正案を生成
対応範囲複数ファイルをまたぐ修正に対応しやすいアラート周辺を中心とした限定的な修正
成果物CopilotがドラフトPRを自動作成修正案を確認後、利用者がPR作成を指示
再修正PRコメントやAgentsタブから依頼可能基本的には生成された差分を人が編集
検証CodeQL再実行などを試み、必要に応じて反復生成された修正案を利用者が確認
複数アラート1~25件をまとめて1つのPRにできる基本的に個別アラート単位
Copilotライセンス有料Copilotライセンスが必要Copilotライセンスは不要
AI credits消費する消費しない
Actions minutescloud agentの処理で消費するAutofix生成自体とは別に、PRのCI実行で通常のActions minutesが発生する場合がある
提供状態パブリックプレビューcloud agentを利用できない場合などに利用可能
ポリシーCopilot Autofixの共通設定に従うCopilot Autofixの共通設定に従う

classic Copilot Autofixは、Copilotのサブスクリプションがなくても利用でき、AI creditsも消費しません。GitHub.com上のパブリックリポジトリ、およびGitHub Code Securityが有効な組織所有リポジトリで利用できます。ただし、すべてのアラートで必ず修正案が生成されるわけではありません。(GitHub Docs)

Agentic Autofixの利用要件

組織のリポジトリでAgentic Autofixを利用する場合は、次の条件を確認します。

要件確認内容
Code SecurityまたはGHAS対象リポジトリでGitHub Code SecurityまたはGitHub Advanced Securityが有効になっている
code scanningCodeQLまたはサードパーティ製ツールから、対象のcode scanning alertが登録されている
Copilotライセンス操作するユーザーに有料のGitHub Copilotライセンスが割り当てられている
Copilot cloud agent組織・Enterpriseのポリシーで有効になっている
リポジトリの利用許可対象リポジトリがcloud agentの利用対象から除外されていない
Copilot AutofixEnterprise、Organization、Repositoryの各階層で無効化されていない
ユーザー権限操作するユーザーがリポジトリにwrite権限を持っている
利用枠AI creditsとGitHub Actions minutesを利用できる状態になっている

Copilot cloud agentはすべての有料Copilotプランで提供されています。ただし、Copilot BusinessとCopilot Enterpriseでは初期状態で無効となる場合があり、管理者によるポリシーの有効化が必要です。個人向けのCopilot Pro、Pro+、Maxでは、cloud agentが標準で有効とされています。(GitHub Docs)

また、code scanning alertの修正操作にはwrite権限が必要です。アラートを閲覧できても、read権限しかなければ割り当てや修正PR作成を実行できません。(GitHub Docs)

Code scanning alertをCopilotへAssignする手順

個別アラートから修正PRを作る

  1. GitHubで対象リポジトリを開きます。
  2. Security and qualityタブを開きます。
  3. 左側のメニューからCode scanningを選択します。
  4. 修正したいアラートを開きます。
  5. 画面上部のAssign to Copilotをクリックします。
  6. Copilotのエージェントセッションが開始されたことを確認します。
  7. 作成されたドラフトPRを開きます。
  8. 修正差分、説明、検証結果をレビューします。

通常は数分でドラフトPRが作成されます。PRには、修正内容、アラートが解消される理由、Copilotが実施した検証内容が記載されます。(The GitHub Blog)

複数アラートを1つのPRで修正する

code scanning alertの一覧画面またはsecurity campaignから、1~25件のアラートを選択し、まとめてCopilotへ割り当てることもできます。

ただし、単に件数を減らす目的で無関係なアラートをまとめるのは避けるべきです。次のような、修正箇所や原因が共通するアラートをまとめるとレビューしやすくなります。

  • 同じ入力検証処理に起因する複数のアラート
  • 同じ共通ライブラリから発生しているアラート
  • 同一の認証・認可処理に関連するアラート
  • 同じ修正でまとめて解消できる重複アラート

認証不備、SQLインジェクション、パストラバーサルなど、原因や影響範囲が異なる問題は別々のPRに分けた方が、安全にレビューできます。複数アラートをまとめた場合、Copilotは選択されたアラートを1つのPRで解決しようとします。(GitHub Docs)

UIが使えない場合はREST APIで割り当てる

GitHub公式は、code scanning alertのassigneeにcopilot-swe-agent[bot]を設定するREST API経路を案内しています。

GitHub CLIを利用する例は次のとおりです。

OWNER="your-organization"
REPO="your-repository"
ALERT_NUMBER="123"

gh api \
  --method PATCH \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  "/repos/$OWNER/$REPO/code-scanning/alerts/$ALERT_NUMBER" \
  -f 'assignees[]=copilot-swe-agent[bot]'

OWNERREPOALERT_NUMBERを対象の値へ置き換えて実行します。アラート番号は、code scanning alertのURL末尾やREST APIのnumberフィールドで確認できます。

Fine-grained personal access tokenやGitHub Appを利用する場合は、対象リポジトリに対するCode scanning alerts: write権限が必要です。(GitHub Docs)

Agentic Autofixとclassic AutofixではAPIが異なる

ここは間違えやすいポイントです。

  • Agentic Autofix
    code scanning alertのassigneeをcopilot-swe-agent[bot]へ変更する
  • classic Autofix
    /code-scanning/alerts/{alert_number}/autofixなどの従来のAutofix APIを使用する

従来のCreate an autofixエンドポイントを呼び出しても、Agentic Autofixのエージェントセッションを開始する操作とは同じになりません。Copilotに調査、反復修正、PR作成まで行わせる場合は、alertのassigneeを変更します。(GitHub Docs)

なお、APIはポリシーを回避する仕組みではありません。EnterpriseやOrganizationでCopilot Autofixまたはcloud agentが禁止されている場合、APIから割り当てても利用できません。

作成された修正PRで確認すべきポイント

Agentic Autofixは修正PRまで作成しますが、自動生成されたPRをそのままマージする運用は避けるべきです。GitHubも、検証をベストエフォートとして位置付けています。(GitHub Docs)

アラートの原因が本当に解消されているか

単にCodeQLの警告が消えただけでなく、脆弱なデータフローそのものが遮断されているかを確認します。

例えばSQLインジェクションの場合、文字列を独自にエスケープする修正よりも、プレースホルダーを使ったパラメーター化クエリへ変更する方が適切です。

セキュリティ機能が弱くなっていないか

警告を消すために、入力チェックや認可処理を削除していないか確認します。

特に次の修正には注意が必要です。

  • エラーを握りつぶす
  • セキュリティチェックを条件分岐から外す
  • 危険な値を固定値へ置き換えるだけ
  • テストを削除してCIを通す
  • 権限チェックの範囲を狭める
  • 検証処理をコメントアウトする

元のスキャナーで再検査したか

サードパーティ製スキャンツールやカスタムCodeQLクエリのアラートでは、Copilotの検証だけでは不十分なことがあります。

PRブランチに対して元の解析処理を再実行し、対象アラートが実際に閉じることを確認します。

既存機能を壊していないか

最低限、次のテストを実施します。

  • 変更箇所の単体テスト
  • 脆弱性を再現する回帰テスト
  • 正常系と異常系の統合テスト
  • 認証・認可に関するテスト
  • ビルドと静的解析
  • 依存関係やAPI互換性の確認

リポジトリのカスタム指示に、ビルド方法、テストコマンド、コーディング規約、変更禁止領域を記載しておくと、Agentic Autofixがプロジェクトに沿った修正を作りやすくなります。(GitHub Docs)

Agentic Autofixの課金と利用量

Agentic Autofixは、classic Autofixとは異なり、Copilot cloud agentの利用として課金・計測されます。

利用項目Agentic Autofixの扱い
AI credits修正セッションを実行したときに消費
GitHub Actions minutes調査、ビルド、テスト、検証などの処理で消費
1件あたりの固定料金なし。モデルや処理トークン、実行内容によって変動
追加料金契約に含まれる利用枠を超え、追加利用が許可されている場合に発生
プレビュー中の明細他のCopilot利用と分離して表示されない場合がある

GitHubの発表では、パブリックプレビュー中のAgentic Autofixは、実際に修正処理を実行したアラートについてAI creditsを消費します。また、Agentic Autofixの利用量は、プレビュー期間中、ほかのCopilotアクティビティと個別に分離されないと説明されています。(The GitHub Blog)

AI creditsの消費量は「アラート1件につき一定」ではありません。使用モデル、入力コード量、関連ファイル数、生成量、修正の反復回数などで変わります。契約に含まれるAI creditsとActions minutesの範囲内であれば、直ちに追加料金が発生するとは限りません。(GitHub Docs)

一方、classic Copilot AutofixはCopilotライセンスを必要とせず、修正案の生成でAI creditsを消費しません。ただし、classic Autofixから作成したPRで通常のGitHub Actionsワークフローが起動すれば、そのCI処理については通常どおりActions minutesが計上される可能性があります。(GitHub Docs)

Assign to CopilotやGenerate fixが表示されない原因

症状主な原因対処
Generate fixがなく、Assign to CopilotがあるAgentic Autofixへ切り替わっているAssign to Copilotを使用する
Assign to Copilotがなく、Generate fixがあるcloud agentを利用できない、またはclassic Autofixが選択されているclassicを利用するか、Copilotライセンスとcloud agentポリシーを確認する
どちらのボタンもないCopilot Autofixが無効、権限不足、対象外アラート、ライセンス不足Enterprise、Organization、Repositoryの設定とwrite権限を確認する
Copilotへ割り当てても開始されないcloud agentの無効化、リポジトリ除外、AI creditsの利用制限cloud agentポリシーと利用予算を確認する
APIが403になるAPI権限不足、リポジトリがアーカイブ済み、Code SecurityやGHASが無効Code scanning alerts: writeとリポジトリ状態を確認する
数分待ってもPRができないビルド失敗、検証不能、処理長期化、アラートが誤検知の可能性Agentsタブやセッションログを確認する
PRはできたがアラートが閉じない修正不足、別ブランチの状態、複数解析設定、第三者ツールの再解析未実施元の解析を再実行し、対象ブランチと解析設定を確認する

2~4分という時間は一般的な目安であり、完了保証時間ではありません。処理が長引いている場合は、同じ操作を何度も実行する前に、Agentsタブ、ドラフトPR、セッションログ、Actionsの実行状況を確認してください。(The GitHub Blog)

Copilot Autofixの無効化ポリシーはclassicとagenticの両方に影響する

Agentic Autofixには独立した完全別設定があるわけではありません。基盤となるCopilot Autofixが無効化されると、classic AutofixだけでなくAgentic Autofixもブロックされます。

設定の確認場所は管理階層によって異なります。

Enterprise

Policiesからcode security関連のポリシーを開き、Copilot AutofixがNot allowedになっていないか確認します。

Organization

OrganizationのSettingsから、Advanced SecurityGlobal settingsへ進み、Code scanningセクションのCopilot Autofixを確認します。

Repository

リポジトリのSettingsからAdvanced Securityを開き、Code SecurityセクションのCopilot Autofixを確認します。

Agentic Autofixだけを停止したい場合は、Copilot Autofix全体を無効にする方法のほか、対象リポジトリをCopilot cloud agentの利用対象から除外する方法があります。前者はclassicとagenticの両方を止め、後者はcloud agentを利用するAgentic Autofixを止めます。(GitHub Docs)

なお、code security向けのCopilot Autofixを無効にしても、GitHub Code Qualityの結果に対するAutofixは別の扱いとなる場合があります。code scanningとCode Qualityの設定を混同しないようにしてください。(GitHub Docs)

安全に導入するための運用例

最初から多数のアラートをCopilotへ割り当てるのではなく、次の順序で導入すると問題を切り分けやすくなります。

  1. テスト環境が整った小規模リポジトリを選ぶ
  2. 原因が明確なCodeQLアラートを1件選ぶ
  3. Assign to CopilotでドラフトPRを作成する
  4. セッションログとActions利用量を確認する
  5. 人によるセキュリティレビューを実施する
  6. 元のCodeQL解析を再実行する
  7. 問題がなければ、関連する複数アラートへ対象を広げる
  8. AI creditsとActions minutesの予算・利用量を継続的に監視する

ブランチ保護、必須レビュー、CI、CodeQL解析を維持したまま使うことが重要です。Agentic Autofixは修正担当者を置き換える機能ではなく、修正案の調査と実装を高速化し、人がレビューできるPRへ変換する機能として扱うのが適切です。

まとめ

Generate fixが見つからない場合は、まず同じ場所にAssign to Copilotが表示されていないか確認してください。Agentic Autofixを利用可能なリポジトリでは、これが従来のclassic Autofixに代わる主要な操作になります。

利用に必要なのは、対象リポジトリのGitHub Code SecurityまたはGitHub Advanced Security、有料Copilotライセンス、Copilot cloud agent、Copilot Autofixの許可、ユーザーのwrite権限です。実行すると通常2~4分程度でドラフトPRが作成され、AI creditsとGitHub Actions minutesを消費します。

UIから操作できない場合は、alertのassigneeをcopilot-swe-agent[bot]へ変更するREST APIを利用できます。ただし、APIでEnterpriseやOrganizationの禁止ポリシーを回避することはできません。

まずは対象アラートを1件開き、Assign to CopilotGenerate fix、どちらもない、の3状態を確認してください。その結果に応じて、cloud agent、Copilot Autofix、Code Security、権限、利用枠の順に切り分けると、修正PRを作れない原因を効率よく特定できます。

この記事を書いた人

実務の現場で詰まりがちなポイントを地図にするITブログ「IT trip」を運営。Windows/Office(Teams・Excel)からSQL、サーバ運用、ガジェットまで、再現性のある手順と“なぜそうなるか”を丁寧に解説します。読んだらすぐ試せること、そして迷った人の次の一歩が見えることを大切にしています。

コメント

コメントする

目次