Agentic code review partial GA (including self-hosted runner support) (#59470)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Jenni C <97056108+dihydroJenoxide@users.noreply.github.com>
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>

Author: 4 people

content/copilot/concepts/agents/code-review.md

@@ -82,29 +82,37 @@ If you include these file types in a pull request, {% data variables.copilot.cop
 
 For more information, see [AUTOTITLE](/copilot/reference/review-excluded-files).
 
-## {% data variables.copilot.copilot_code-review-tools-preview_cap %}
+## {% data variables.copilot.copilot_code-review-tools_cap_short %}
 
 > [!NOTE]
 >
-> * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply to your use of this product.
+> * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply to your use of preview features.
 > * {% data variables.copilot.copilot_code-review_short %} has several new tools that are in {% data variables.release-phases.public_preview %} and subject to change.
 
-If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you can only participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled using preview features. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
+{% data variables.copilot.copilot_code-review_short %} uses full project context gathering to provide more specific, accurate, and contextually aware code reviews. This capability analyzes your entire repository to better understand the context of code changes. Full project context gathering is generally available and enabled automatically for {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plans.
 
-These new tools are enabled automatically for {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plans.
+{% data variables.copilot.copilot_code-review_short %} includes additional new tools that are in {% data variables.release-phases.public_preview %}:
 
-* **Full project context gathering**. This provides more specific, accurate, and contextually aware code reviews.
+* **Support for static analysis tools like {% data variables.product.prodname_codeql %}, ESLint, and PMD**. This delivers more high-signal, consistent findings for security and quality.
 * **The ability to pass suggestions to {% data variables.copilot.copilot_coding_agent %}**. This automates creation of a new pull request against your branch with the suggested fixes applied.
 
+These tools are also enabled automatically for {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plans.
+
+If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you can only participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled using preview features. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
+
 You do not need to have {% data variables.product.prodname_code_scanning %} and {% data variables.product.prodname_actions %} enabled in your organization or enterprise to use the {% data variables.copilot.copilot_code-review-tools_short %}.
 
 If {% data variables.product.prodname_actions %} is unavailable or if Actions workflows used by {% data variables.copilot.copilot_code-review_short %} fail, reviews will still be generated. However, they will not include the additional features provided by the {% data variables.copilot.copilot_code-review-tools_short %}.
 
 > [!NOTE]
 >
-> The {% data variables.release-phases.public_preview %} includes free actions minutes for the {% data variables.copilot.copilot_code-review-tools_short %}.
->
-> Usage charges will apply when the feature becomes generally available.
+> The {% data variables.release-phases.public_preview %} includes free actions minutes for the new {% data variables.copilot.copilot_code-review-tools_short %}.
+
+## Usage of {% data variables.product.prodname_actions %} runners for tools in code review
+
+{% data reusables.copilot.code-review.code-review-actions-usage %}
+
+Organizations in this situation can use self-hosted runners. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/request-a-code-review/configure-self-hosted-runners).
 
 ## Code review monthly quota
 

content/copilot/get-started/features.md

@@ -45,7 +45,7 @@ A command line interface that lets you use {% data variables.product.prodname_co
 
 AI-generated code review suggestions to help you write better code. See [AUTOTITLE](/copilot/using-github-copilot/code-review/using-copilot-code-review).
 
-{% data variables.copilot.copilot_code-review-tools_cap_short %} is in {% data variables.release-phases.public_preview %} and subject to change. See [AUTOTITLE](/copilot/concepts/agents/code-review).
+Several {% data variables.copilot.copilot_code-review-tools_short %} are in {% data variables.release-phases.public_preview %} and subject to change. See [AUTOTITLE](/copilot/concepts/agents/code-review).
 
 ### {% data variables.copilot.copilot_for_prs %}
 

content/copilot/how-tos/use-copilot-agents/request-a-code-review/configure-self-hosted-runners.md

@@ -0,0 +1,47 @@
+---
+title: Configuring self-hosted runners for GitHub Copilot code review
+shortTitle: Configure self-hosted runners
+intro: 'Learn how to configure self-hosted runners for {% data variables.copilot.copilot_code-review_short %}.'
+allowTitleToDifferFromFilename: true
+versions:
+  feature: copilot
+topics:
+  - Copilot
+contentType: how-tos
+category:
+  - Author and optimize with Copilot
+---
+
+## About {% data variables.product.prodname_actions %} usage for code review tools
+
+{% data reusables.copilot.code-review.code-review-actions-usage %} Organizations in this situation can use self-hosted runners.
+
+## Configuring self-hosted runners for code review
+
+You can run {% data variables.copilot.copilot_code-review_short %} using self-hosted {% data variables.product.prodname_actions %} runners with ARC (Actions Runner Controller). You must first set up ARC-managed scale sets in your environment. For more information on ARC, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller).
+
+> [!WARNING]
+> ARC is the only officially supported solution for self-hosting {% data variables.copilot.copilot_code-review_short %}. For security reasons, we do not recommend using non-ARC self-hosted runners.
+
+> [!NOTE]
+> {% data variables.copilot.copilot_code-review_short %} is only compatible with Ubuntu x64 Linux runners. Runners with Windows, macOS or other operating systems are not supported.
+
+To configure self-hosted runners for {% data variables.copilot.copilot_code-review_short %}:
+
+1. Configure network security controls for your {% data variables.product.prodname_actions %} runners to ensure that {% data variables.copilot.copilot_code-review_short %} does not have open access to your network or the public internet.
+
+    You must configure your firewall to allow connections to the [standard hosts required for {% data variables.product.prodname_actions %} self-hosted runners](/actions/reference/runners/self-hosted-runners#accessible-domains-by-function), plus the following hosts:
+
+    * `api.githubcopilot.com`
+    * `uploads.github.com`
+    * `user-images.githubusercontent.com`
+1. In your `copilot-setup-steps.yml` file, set the `runs-on` attribute to your ARC-managed scale set name. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment#preinstalling-tools-or-dependencies-in-copilots-environment).
+
+   ```yaml
+   # ...
+
+   jobs:
+     copilot-setup-steps:
+       runs-on: arc-scale-set-name
+       # ...
+   ```

content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md

@@ -9,6 +9,7 @@ topics:
 children:
   - /use-code-review
   - /configure-automatic-review
+  - /configure-self-hosted-runners
 redirect_from:
   - /copilot/using-github-copilot/code-review
   - /copilot/how-tos/agents/copilot-code-review

data/reusables/copilot/code-review/code-review-actions-usage.md

@@ -0,0 +1,3 @@
+{% data variables.copilot.copilot_code-review_short %} uses {% data variables.product.prodname_actions %} to run the {% data variables.copilot.copilot_code-review-tools_short %}, including full project context gathering and the additional tools in {% data variables.release-phases.public_preview %}. By default, {% data variables.copilot.copilot_code-review_short %} uses {% data variables.product.prodname_dotcom %}-hosted runners.
+
+If your organization has disabled {% data variables.product.prodname_dotcom %}-hosted runners, the new {% data variables.copilot.copilot_code-review-tools_short %} will not be available. In this case, code reviews will fall back to a more limited review.

data/reusables/copilot/code-review/preview-note.md

@@ -1,2 +1,2 @@
-* {% data variables.copilot.copilot_code-review-tools_cap_short %} are in {% data variables.release-phases.public_preview %} and subject to change.
+* Several {% data variables.copilot.copilot_code-review-tools_short %} are in {% data variables.release-phases.public_preview %} and subject to change.
 * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply to your use of this product.

data/variables/copilot.yml

@@ -43,8 +43,8 @@ chat_completions_api: 'https://api.githubcopilot.com/chat/completions'
 copilot_code-review: 'GitHub Copilot code review'
 copilot_code-review_short: 'Copilot code review'
 copilot_code-review-tools-preview_cap: 'New tools (public preview) in GitHub Copilot code review'
-copilot_code-review-tools_short: 'new tools in Copilot code review'
-copilot_code-review-tools_cap_short: 'New tools in Copilot code review'
+copilot_code-review-tools_short: 'tools in Copilot code review'
+copilot_code-review-tools_cap_short: 'Tools in Copilot code review'
 
 ## Copilot coding agent (previously Padawan) -> {% data variables.copilot.copilot_coding_agent %}
 copilot_coding_agent: 'Copilot coding agent'