270 lines
22 KiB
Markdown
270 lines
22 KiB
Markdown
---
|
||
title: Using GitHub Copilot code review
|
||
shortTitle: Using code review
|
||
intro: "Learn how to request a code review from {% data variables.product.prodname_copilot %}."
|
||
allowTitleToDifferFromFilename: true
|
||
versions:
|
||
feature: copilot
|
||
topics:
|
||
- Copilot
|
||
redirect_from:
|
||
- /early-access/copilot/code-review/using-copilot-code-review
|
||
- /early-access/copilot/code-reviews/using-copilot-code-review
|
||
- /early-access/copilot/code-reviews/using-copilot-code-reviews
|
||
---
|
||
|
||
## About {% data variables.copilot.copilot_code-review_short %}
|
||
|
||
{% data variables.product.prodname_copilot %} can review your code and provide feedback. Where possible, {% data variables.product.prodname_copilot_short %}'s feedback includes suggested changes which you can apply with a couple of clicks.
|
||
|
||
{% vscode %}
|
||
|
||
{% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vscode %} supports two types of review:
|
||
|
||
* **Review selection:** Highlight code and ask for an initial review
|
||
* **Review changes:** Request a deeper review of all your changes
|
||
|
||
The current functionality and availability of the two types of review is summarized in the following table:
|
||
|
||
{% rowheaders %}
|
||
|
||
| | Review selection | Review changes |
|
||
|------------------|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||
| Available in | {% data variables.product.prodname_vscode %} | {% data variables.product.prodname_vscode %} and the {% data variables.product.github %} website |
|
||
| Premium/standard feature | Standard feature available to all {% data variables.product.prodname_copilot_short %} subscribers | Premium feature. Available with the {% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_pro_plus_short %}, {% data variables.product.prodname_copilot_business_short %}, and {% data variables.product.prodname_copilot_enterprise_short %} plans. Per-person monthly quota applies. |
|
||
| Description | Initial review of a highlighted section of code with feedback and suggestions | Deeper review of all changes |
|
||
| Language support | All | C, C#, C++, Go, Java, JavaScript, Kotlin, Markdown, Python, Ruby, Swift, TypeScript <br><br> {% data variables.release-phases.public_preview_caps %} support for HTML and Text. |
|
||
| Custom coding guidelines support | No | Yes, see [Customizing {% data variables.product.prodname_copilot_short %}'s reviews with coding guidelines](#customizing-copilots-reviews-with-coding-guidelines) |
|
||
|
||
{% endrowheaders %}
|
||
|
||
### Code review monthly quota
|
||
|
||
The **review changes** type of {% data variables.copilot.copilot_code-review_short %} is a premium feature with a per-person monthly quota.
|
||
|
||
<!-- expires 2025-06-04 -->
|
||
> [!NOTE]
|
||
> The per-person quota for {% data variables.copilot.copilot_code-review_short %} will commence on June 4, 2025.
|
||
<!-- end expires 2025-06-04 -->
|
||
|
||
When you assign {% data variables.product.prodname_copilot_short %} as a reviewer for a pull request, one premium request is deducted from your monthly quota each time {% data variables.product.prodname_copilot_short %} posts comments to the pull request. See [AUTOTITLE](/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests).
|
||
|
||
If a repository is configured to automatically request a code review from {% data variables.product.prodname_copilot_short %} for all new pull requests, the premium request usage is applied to the quota of the pull request author. If a pull request is created by {% data variables.product.prodname_actions %} or by a bot, the usage will apply to the user who triggered the workflow (if identifiable), or to a designated billing owner.
|
||
|
||
When you reach your monthly quota you will not be able to get a code review from {% data variables.product.prodname_copilot_short %} until your quota resets—unless you upgrade your {% data variables.product.prodname_copilot_short %} plan or enable additional premium requests.
|
||
|
||
{% endvscode %}
|
||
|
||
{% webui %}
|
||
|
||
Two types of {% data variables.copilot.copilot_code-review_short %} are available:
|
||
|
||
* **Review selection:** Highlight code and ask for an initial review _(only available in {% data variables.product.prodname_vscode_shortname %})_
|
||
* **Review changes:** Request a deeper review of all your changes _(available in {% data variables.product.prodname_vscode_shortname %} and the {% data variables.product.github %} website)_
|
||
|
||
This version of the article relates to {% data variables.copilot.copilot_code-review_short %} on the {% data variables.product.github %} website. To see information about the review selection type of {% data variables.copilot.copilot_code-review_short %}, click the "{% data variables.product.prodname_vscode %}" tool switcher at the top of the page.
|
||
|
||
### Availability
|
||
|
||
{% data variables.copilot.copilot_code-review_short %} on the {% data variables.product.github %} website is a premium feature, available with the {% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_pro_plus_short %}, {% data variables.product.prodname_copilot_business_short %}, and {% data variables.product.prodname_copilot_enterprise_short %} plans.
|
||
|
||
### Code review monthly quota
|
||
|
||
The **review changes** type of {% data variables.copilot.copilot_code-review_short %} is a premium feature with a per-person monthly quota.
|
||
|
||
<!-- expires 2025-06-04 -->
|
||
> [!NOTE]
|
||
> The per-person quota for {% data variables.copilot.copilot_code-review_short %} will commence on June 4, 2025.
|
||
<!-- end expires 2025-06-04 -->
|
||
|
||
When you assign {% data variables.product.prodname_copilot_short %} as a reviewer for a pull request, one premium request is deducted from your monthly quota each time {% data variables.product.prodname_copilot_short %} posts comments to the pull request. See [AUTOTITLE](/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests).
|
||
|
||
If a repository is configured to automatically request a code review from {% data variables.product.prodname_copilot_short %} for all new pull requests, the premium request usage is applied to the quota of the pull request author. If a pull request is created by {% data variables.product.prodname_actions %} or by a bot, the usage will apply to the user who triggered the workflow (if identifiable), or to a designated billing owner.
|
||
|
||
When you reach your monthly quota you will not be able to get a code review from {% data variables.product.prodname_copilot_short %} until your quota resets—unless you upgrade your {% data variables.product.prodname_copilot_short %} plan or enable additional premium requests.
|
||
|
||
### Language support
|
||
|
||
{% data variables.copilot.copilot_code-review_short %} on the {% data variables.product.github %} website supports all languages.
|
||
|
||
The following languages have general availability support:
|
||
|
||
* C
|
||
* C#
|
||
* C++
|
||
* Go
|
||
* Java
|
||
* JavaScript
|
||
* Kotlin
|
||
* Markdown
|
||
* Python
|
||
* Ruby
|
||
* Swift
|
||
* TypeScript
|
||
|
||
All other languages are supported as a {% data variables.release-phases.public_preview %}.
|
||
|
||
{% endwebui %}
|
||
|
||
### Validating {% data variables.product.prodname_copilot_short %} code reviews
|
||
|
||
> [!WARNING] {% data variables.product.prodname_copilot_short %} isn't guaranteed to spot all problems or issues in a pull request, and sometimes it will make mistakes. Always validate {% data variables.product.prodname_copilot_short %}'s feedback carefully, and supplement {% data variables.product.prodname_copilot_short %}'s feedback with a human review.
|
||
|
||
For more information, see [AUTOTITLE](/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-code-review).
|
||
|
||
## Requesting a review from {% data variables.product.prodname_copilot_short %}
|
||
|
||
{% webui %}
|
||
|
||
These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in the {% data variables.product.github %} website. To see instructions for other popular coding environments, use the tool switcher at the top of the page.
|
||
|
||
### Requesting a pull request review from {% data variables.product.prodname_copilot_short %}
|
||
|
||
1. On {% data variables.product.prodname_dotcom_the_website %}, create a pull request or navigate to an existing pull request.
|
||
1. Open the **Reviewers** menu, then select **{% data variables.product.prodname_copilot_short %}**.
|
||
|
||
|
||
|
||
1. Wait for {% data variables.product.prodname_copilot_short %} to review your pull request. This usually takes less than 30 seconds.
|
||
|
||
1. Scroll down and read through {% data variables.product.prodname_copilot_short %}'s comments.
|
||
|
||
|
||
|
||
{% data variables.product.prodname_copilot_short %} always leaves a "Comment" review, not an "Approve" review or a "Request changes" review. This means that {% data variables.product.prodname_copilot_short %}'s reviews do not count toward required reviews for the pull request, and {% data variables.product.prodname_copilot_short %}'s reviews will not block merging changes. For more details, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/approving-a-pull-request-with-required-reviews).
|
||
|
||
1. {% data variables.product.prodname_copilot_short %}'s review comments behave like review comments from humans. You can add reactions to them, comment on them, resolve them and hide them.
|
||
|
||
Any comments you add to {% data variables.product.prodname_copilot_short %}'s review comments will be visible to humans, but they won't be visible to {% data variables.product.prodname_copilot_short %}, and {% data variables.product.prodname_copilot_short %} won't reply.
|
||
|
||
## Working with suggested changes provided by {% data variables.product.prodname_copilot_short %}
|
||
|
||
Where possible, {% data variables.product.prodname_copilot_short %}'s feedback includes suggested changes which you can apply with a couple of clicks.
|
||
|
||
If you're happy with the changes, you can accept a single suggestion from {% data variables.product.prodname_copilot_short %} and commit it, or accept a group of suggestions together in a single commit. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request).
|
||
|
||
If you want to validate {% data variables.product.prodname_copilot_short %}'s suggested changes (for example by running automated tests or your linter), or if you want to make modifications before committing the suggested changes, click the **Open in Workspace** button. For more information, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request).
|
||
|
||
## Providing feedback on {% data variables.product.prodname_copilot_short %}'s reviews
|
||
|
||
You can provide feedback on {% data variables.product.prodname_copilot_short %}'s comments directly within each comment. We use this information to improve the product and the quality of {% data variables.product.prodname_copilot_short %}'s suggestions.
|
||
|
||
1. On a pull request review comment from {% data variables.product.prodname_copilot_short %}, click the thumbs up (:+1:) or thumbs down (:-1:) button.
|
||
|
||
|
||
|
||
1. If you click the thumbs down button, you're asked to provide additional information. You can, optionally, pick the reason for your negative feedback and leave a comment before clicking **Submit feedback**.
|
||
|
||
|
||
|
||
## Requesting a re-review from {% data variables.product.prodname_copilot_short %}
|
||
|
||
When you push changes to a pull request that {% data variables.product.prodname_copilot_short %} has reviewed, it won't automatically re-review your changes.
|
||
|
||
To request a re-review from {% data variables.product.prodname_copilot_short %}, click the {% octicon "sync" aria-label="Re-request review" %} button next to {% data variables.product.prodname_copilot_short %}'s name in the **Reviewers** menu. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review).
|
||
|
||
> [!NOTE] When re-reviewing a pull request, {% data variables.product.prodname_copilot_short %} may repeat the same comments again, even if they have been dismissed with the "Resolve conversation" button or downvoted with the thumbs down (:-1:) button.
|
||
|
||
## Enabling automatic reviews
|
||
|
||
By default, you manually request a review from {% data variables.product.prodname_copilot_short %} on each pull request, in the same way you would request a review from a human. However, you can set up {% data variables.product.prodname_copilot_short %} to automatically review all pull requests in a repository, or for all repositories in an organization. See [AUTOTITLE](/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot).
|
||
|
||
## Customizing {% data variables.product.prodname_copilot_short %}'s reviews with coding guidelines
|
||
|
||
{% data reusables.copilot.code-review.custom-coding-guidelines %}
|
||
|
||
{% endwebui %}
|
||
|
||
{% vscode %}
|
||
|
||
These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vscode %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page.
|
||
|
||
> [!NOTE] {% data variables.copilot.copilot_code-review_short %} is only available in {% data variables.product.prodname_vscode %} with version 0.22 or later of the {% data variables.product.prodname_copilot_chat %} extension.
|
||
|
||
### Reviewing a selection of code
|
||
|
||
You can request an initial review of a highlighted selection of code in {% data variables.product.prodname_vscode %}.
|
||
|
||
1. In {% data variables.product.prodname_vscode %}, select the code you want to review.
|
||
1. Open the {% data variables.product.prodname_vscode_command_palette_shortname %}
|
||
* For Mac:
|
||
* Use: <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd>
|
||
* For Windows or Linux:
|
||
* Use <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>
|
||
1. In the command palette, search for and select **{% data variables.product.prodname_copilot %}: Review and Comment**.
|
||
|
||
|
||
|
||
1. Wait for {% data variables.product.prodname_copilot_short %} to review your changes. This usually takes less than 30 seconds.
|
||
|
||
|
||
|
||
1. If {% data variables.product.prodname_copilot_short %} has any comments, they will be shown inline in your file, and in the **Problems** tab.
|
||
|
||
|
||
|
||
### Reviewing changes
|
||
|
||
You can request a review for your staged or unstaged changes in {% data variables.product.prodname_vscode %}.
|
||
|
||
1. In {% data variables.product.prodname_vscode_shortname %}, switch to the **Source Control** tab.
|
||
1. To request a review on your unstaged changes, hover over **Changes** in the sidebar, and then click the {% data reusables.copilot.code-review.staging-icon-vscode %} **{% data variables.copilot.copilot_code-review_short %} - Changes** button.
|
||
|
||
|
||
|
||
1. To request a review on your staged changes, hover over **Staged Changes** in the sidebar, and then click the {% data reusables.copilot.code-review.staging-icon-vscode %} **{% data variables.copilot.copilot_code-review_short %} - Staged Changes** button.
|
||
|
||
1. Wait for {% data variables.product.prodname_copilot_short %} to review your changes. This usually takes less than 30 seconds.
|
||
|
||
|
||
|
||
1. If {% data variables.product.prodname_copilot_short %} has any comments, they will be shown inline in your file(s), and in the **Problems** tab.
|
||
|
||
|
||
|
||
## Working with suggested changes provided by {% data variables.product.prodname_copilot_short %}
|
||
|
||
Where possible, {% data variables.product.prodname_copilot_short %}'s feedback includes suggested changes which you can apply with a single click.
|
||
|
||
|
||
|
||
If you're happy with the change, you can accept a suggestion from {% data variables.product.prodname_copilot_short %} by clicking the **Apply and Go To Next** button. Any changes you apply will not be automatically committed.
|
||
|
||
If you don't want to apply {% data variables.product.prodname_copilot_short %}'s suggested change, click the **Discard and Go to Next** button.
|
||
|
||
## Providing feedback on {% data variables.product.prodname_copilot_short %}'s reviews
|
||
|
||
You can provide feedback on {% data variables.product.prodname_copilot_short %}'s comments directly within each comment. We use this information to improve the product and the quality of {% data variables.product.prodname_copilot_short %}'s suggestions.
|
||
|
||
To provide feedback, hover over the comment and click the thumbs up or thumbs down button.
|
||
|
||
|
||
|
||
## Customizing {% data variables.product.prodname_copilot_short %}'s reviews with coding guidelines
|
||
|
||
{% data reusables.copilot.code-review.custom-coding-guidelines %}
|
||
|
||
{% endvscode %}
|
||
|
||
{% visualstudio %}
|
||
|
||
These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vs %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page.
|
||
|
||
To use {% data variables.copilot.copilot_code-review_short %}, you must use {% data variables.product.prodname_vs %} version 17.14 or later. See the [{% data variables.product.prodname_vs %} downloads page](https://visualstudio.microsoft.com/downloads/).
|
||
|
||
1. In the Git Changes window, click **Review changes with {% data variables.product.prodname_copilot_short %}**.
|
||
This button appears as a comment icon with a sparkle.
|
||
1. {% data variables.product.prodname_copilot_short %} will begin reviewing your changes. After a few moments, a link showing the number of code review comments appears in the Git Changes window.
|
||
1. Click the link to view and navigate the comments. If no issues are found, you’ll see the message:
|
||
{% data variables.product.prodname_copilot_short %} did not comment on any files.
|
||
1. {% data variables.product.prodname_copilot_short %} displays comments in your code with a summary of each potential issue. You can:
|
||
|
||
* Review and make changes based on the suggestions.
|
||
* Dismiss a comment using the downward arrow in the top-right corner of the comment box.
|
||
|
||
1. To remove all review comments, click {% octicon "x" aria-label="The X icon" %} next to the code review link in the Git Changes window.
|
||
|
||
For more information on enabling and configuring {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vs %}, see [Review local changes with {% data variables.product.prodname_copilot_chat_short %}](https://learn.microsoft.com/en-us/visualstudio/version-control/git-make-commit?view=vs-2022#review-local-changes-with-copilot-chat) in the {% data variables.product.prodname_vs %} documentation.
|
||
|
||
{% endvisualstudio %}
|