From 216df31b2634e407719c6d17491be58398a0b2c6 Mon Sep 17 00:00:00 2001 From: Felix Guntrip Date: Thu, 20 Nov 2025 18:37:03 +0000 Subject: [PATCH 1/3] Bring your own key for Copilot (Public preview) (#58549) Co-authored-by: Jaryl Co-authored-by: Sarah Vessels <82317+cheshire137@users.noreply.github.com> Co-authored-by: Melanie Yarbrough <11952755+myarb@users.noreply.github.com> --- .../images/help/copilot/byok-add-foundry.png | Bin 0 -> 97361 bytes assets/images/help/copilot/byok-add.png | Bin 0 -> 71871 bytes .../manage-for-enterprise/index.md | 1 + .../use-your-own-api-keys.md | 54 ++++++++++++++++++ .../manage-for-organization/index.md | 1 + .../use-your-own-api-keys.md | 36 ++++++++++++ .../configure-access-to-ai-models.md | 8 ++- .../copilot/responsible-use/chat-in-github.md | 2 + .../responsible-use/chat-in-your-ide.md | 8 +++ data/features/copilot-byok.yml | 5 ++ data/reusables/copilot/byok-add.md | 17 ++++++ data/reusables/copilot/byok-intro.md | 15 +++++ data/reusables/copilot/byok-preview-note.md | 1 + data/reusables/copilot/byok-why.md | 4 ++ .../rai/copilot/byok-transparency-note.md | 25 ++++++++ data/variables/copilot.yml | 3 + 16 files changed, 179 insertions(+), 1 deletion(-) create mode 100644 assets/images/help/copilot/byok-add-foundry.png create mode 100644 assets/images/help/copilot/byok-add.png create mode 100644 content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md create mode 100644 content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md create mode 100644 data/features/copilot-byok.yml create mode 100644 data/reusables/copilot/byok-add.md create mode 100644 data/reusables/copilot/byok-intro.md create mode 100644 data/reusables/copilot/byok-preview-note.md create mode 100644 data/reusables/copilot/byok-why.md create mode 100644 data/reusables/rai/copilot/byok-transparency-note.md diff --git a/assets/images/help/copilot/byok-add-foundry.png b/assets/images/help/copilot/byok-add-foundry.png new file mode 100644 index 0000000000000000000000000000000000000000..3a5a66852d0ead79210ec5c3858f6acc2bd6d8a4 GIT binary patch literal 97361 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%0DARLgNFs+3fBkDuQ!&tffkRHEqu+2WPa#Wi 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 z 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 z»)h#A5UT5U=!{d!CyydXz+fS4srmWmWcx4wHt@4$D6b3YhslJ~)P|*CBzc;sB z+0C))wu7t0Pl2Vi0CaL-E+}i*wj51Q?T%Q>-dbjxgH!>n7z1|AD(!41SIyn7>|Vg3 zEb02?34^MO&st4GfwyrI#263r3Tx+p9>{$+1?u0}{d*-px=dHMca|)>p^R)+=A?eo z80?-sQ*>vm>|yRhGYP29+p?(u9XRaAD5&@yRt(o8^J<|8smaf@EyPLcgMY}p0HA-` zNmypo;Z_h^u38|Z*5YF!P<^MDd&PG6x;~m-$;#7(=5o8Nv%qhX z&U~${BgGxNy=UhB-~gmtJ8OaMO&t=9yS(|@=+cN#gED_10J!j9N@zdQBy~t9O0fg!F%?RI+xjqsKoq?1y3c1(HPyE3|l-Jh( z)pz>#tr2!5?E=Rn#S<2lv72bWSl}hmQik-05b*z=?N@%Wt0+e)b9MnG>@fevQpwy7 zn#Ln-ilS8W%0=Kln)Sy$&~0_^ z{CR}Uy=D)jVi!&&{5QIE=%XC|`Wh|H)H*0g7W9s2s2T!95vvF2I>per53A`X5ywRsCD;{vP*m@V^cU zY$hiEJfGs2p97Grb9iv=&mQ25?-hYDXxSM4TVMl32mZ7Zf9JV>iwGbz%D@;g8|DA4 o|49IHZV4Bg{xg>smp6RA-P5qUQut2$81SPgr~0tqfywLt2f)UWXaE2J literal 0 HcmV?d00001 diff --git a/assets/images/help/copilot/byok-add.png b/assets/images/help/copilot/byok-add.png new file mode 100644 index 0000000000000000000000000000000000000000..eb929d72b3246627f26dc92ca525b2b5c10cc21d GIT binary patch literal 71871 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 literal 0 HcmV?d00001 diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md index 80bea6325307..efbd4201b626 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md @@ -13,6 +13,7 @@ children: - /manage-agents - /manage-spark - /view-usage-and-adoption + - /use-your-own-api-keys redirect_from: - /copilot/managing-copilot/managing-copilot-for-your-enterprise - /copilot/how-tos/administer/enterprises diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md new file mode 100644 index 000000000000..512389803d8d --- /dev/null +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md @@ -0,0 +1,54 @@ +--- +title: Using your LLM provider API keys with Copilot +shortTitle: Use your own API keys +intro: 'Learn how to integrate your preferred custom models with {% data variables.product.prodname_copilot %} by using your own LLM API keys, and make them available for organizations in your enterprise account.' +versions: + feature: copilot-byok +topics: + - Copilot +contentType: how-tos +allowTitleToDifferFromFilename: true +--- + +{% data reusables.copilot.byok-intro %} + +## Why bring your own API keys? + +As an enterprise owner, you may have specific requirements for governance, data security, and compliance. Setting up your own API keys allows you to address: + +{% data reusables.copilot.byok-why %} + +## Adding your key to an enterprise account + +> [!IMPORTANT] We highly recommend adhering to the principle of least privilege by assigning only the minimum necessary scopes to your API keys. + +After you've added your key and selected one or more models, you and members of your organizations will be able to use them with {% data variables.copilot.copilot_byok_supported_features %}. Your models will appear at the bottom of the model picker, under the enterprise name. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.ai-controls-tab %} +1. In the sidebar, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**. +1. Click **Configure allowed models**. +{% data reusables.copilot.byok-add %} + +## Managing availability of custom models in your organizations + +You can choose whether the models you have added are available to organizations in your enterprise account. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.ai-controls-tab %} +1. In the sidebar, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**. +1. Click **Configure allowed models**. +1. Click the **Custom models** tab. +1. Above the list of API keys, click the **Added models** tab. +1. Next to a model, click **Configure**. If any organizations already have access to the model, instead of "Configure", you will need to click **All organizations** or **X organizations**. +1. In the modal that opens, click the **Access** tab. + >[!NOTE] The model must be set to 'Enabled' before the "Access" tab will be available. +1. Choose how the model should be made available to organizations: + * To make the model available to all organizations in your enterprise account, select **Allow for all organizations**. + * To only make the model available for specific organizations, select **Choose per organization**, and check or uncheck the organizations listed below. +1. Click **Save**. + +## Further reading + +* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys) in our documentation for organizations. +* [AUTOTITLE](/copilot/concepts/chat) \ No newline at end of file diff --git a/content/copilot/how-tos/administer-copilot/manage-for-organization/index.md b/content/copilot/how-tos/administer-copilot/manage-for-organization/index.md index cf12c72d3ea9..0f9a5da09b2d 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-organization/index.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-organization/index.md @@ -19,5 +19,6 @@ children: - /add-copilot-coding-agent - /prepare-for-custom-agents - /review-activity + - /use-your-own-api-keys contentType: how-tos --- diff --git a/content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md b/content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md new file mode 100644 index 000000000000..02dbed0d6bd4 --- /dev/null +++ b/content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md @@ -0,0 +1,36 @@ +--- +title: Using your LLM provider API keys with Copilot +shortTitle: Use your own API keys +intro: 'Learn how to integrate your preferred custom models with {% data variables.product.prodname_copilot %} by using your own LLM API keys, and make them available to your organization members.' +versions: + feature: copilot-byok +topics: + - Copilot +contentType: how-tos +allowTitleToDifferFromFilename: true +--- + +{% data reusables.copilot.byok-intro %} + +## Why bring your own API keys? + +As an organization owner, you may have specific requirements for governance, data security, and compliance. Setting up your own API keys allows you to address: + +{% data reusables.copilot.byok-why %} + +## Adding your key to an organization account + +> [!IMPORTANT] We highly recommend adhering to the principle of least privilege by assigning only the minimum necessary scopes to your API keys. + +After you've added your key and selected one or more models, you and your organization members will be able to use them with {% data variables.copilot.copilot_byok_supported_features %}. Your models will appear at the bottom of the model picker, under the organization name. + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +1. In the sidebar, under "Code, planning, and automation", click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**. +1. Under "Copilot", click **Models**. +{% data reusables.copilot.byok-add %} + +## Further reading + +* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) in our documentation for enterprise accounts. +* [AUTOTITLE](/copilot/concepts/chat) \ No newline at end of file diff --git a/content/copilot/how-tos/use-ai-models/configure-access-to-ai-models.md b/content/copilot/how-tos/use-ai-models/configure-access-to-ai-models.md index f9dee02012e6..68e694d5ef41 100644 --- a/content/copilot/how-tos/use-ai-models/configure-access-to-ai-models.md +++ b/content/copilot/how-tos/use-ai-models/configure-access-to-ai-models.md @@ -12,7 +12,7 @@ redirect_from: - /copilot/how-tos/ai-models/configure-access-to-ai-models - /github-models/use-github-models/integrating-ai-models-into-your-development-workflow contentType: how-tos -category: +category: - Configure Copilot --- @@ -47,3 +47,9 @@ You can enable access in two ways: As an enterprise or organization owner, you can enable or disable access to AI models for everyone who has been assigned a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} seat through your enterprise or organization. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization) and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). > [!NOTE] Models available in {% data variables.copilot.copilot_auto_model_selection %} will follow the policies set for an organization or enterprise. See [AUTOTITLE](/copilot/concepts/auto-model-selection). + +{% ifversion copilot-byok %} + +You can also integrate your preferred custom models from supported LLM providers by bringing your own API keys. Organization owners can make custom models available for members of their organization and enterprise owners can add custom models and choose which organizations can make use of them. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys) for organizations and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) for enterprise accounts. + +{% endif %} diff --git a/content/copilot/responsible-use/chat-in-github.md b/content/copilot/responsible-use/chat-in-github.md index 9e4c42033d38..4c31bc55a6df 100644 --- a/content/copilot/responsible-use/chat-in-github.md +++ b/content/copilot/responsible-use/chat-in-github.md @@ -149,6 +149,8 @@ Depending on the question you ask, {% data variables.copilot.copilot_chat %} can When leveraging Bing, {% data variables.product.prodname_copilot_short %} will use the content of your prompt, as well as additional available context, to generate a Bing search query on your behalf that is sent to the Bing Search API. {% data variables.product.prodname_copilot_short %} will provide a link to the search results with its response. The search query sent to Bing is governed by [Microsoft's Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement). +{% data reusables.rai.copilot.byok-transparency-note %} + ## Next steps For details of how to use {% data variables.copilot.copilot_chat_dotcom %}, see: diff --git a/content/copilot/responsible-use/chat-in-your-ide.md b/content/copilot/responsible-use/chat-in-your-ide.md index b125694149a7..0c15e3d13625 100644 --- a/content/copilot/responsible-use/chat-in-your-ide.md +++ b/content/copilot/responsible-use/chat-in-your-ide.md @@ -39,6 +39,8 @@ When you use the `@github` chat participant, {% data variables.copilot.copilot_c {% data reusables.rai.copilot.copilot-chat-ide-leveraging-web-search %} +{% data reusables.rai.copilot.byok-transparency-note %} + {% data reusables.rai.copilot.copilot-chat-ide-use-cases %} ### Answering coding questions @@ -81,6 +83,8 @@ When you use the `@github` chat participant, {% data variables.copilot.copilot_c {% data reusables.rai.copilot.copilot-chat-ide-leveraging-web-search %} +{% data reusables.rai.copilot.byok-transparency-note %} + {% data reusables.rai.copilot.copilot-chat-ide-use-cases %} ### Answering coding questions @@ -115,6 +119,8 @@ This can be a useful tool for programmers, as it can provide guidance and suppor {% data reusables.rai.copilot.copilot-chat-ide-output-formatting %} +{% data reusables.rai.copilot.byok-transparency-note %} + {% data reusables.rai.copilot.copilot-chat-ide-use-cases %} ### Answering coding questions @@ -149,6 +155,8 @@ This can be a useful tool for programmers, as it can provide guidance and suppor {% data reusables.rai.copilot.copilot-chat-ide-output-formatting %} +{% data reusables.rai.copilot.byok-transparency-note %} + ## Use cases for {% data variables.copilot.copilot_chat %} {% data variables.copilot.copilot_chat %} can provide coding assistance in a variety of scenarios. diff --git a/data/features/copilot-byok.yml b/data/features/copilot-byok.yml new file mode 100644 index 000000000000..ca84b51f7ca2 --- /dev/null +++ b/data/features/copilot-byok.yml @@ -0,0 +1,5 @@ +# BYOK for Copilot (not Copilot Models) #18486 + +versions: + fpt: '*' + ghec: '*' diff --git a/data/reusables/copilot/byok-add.md b/data/reusables/copilot/byok-add.md new file mode 100644 index 000000000000..e4f5d61f9f88 --- /dev/null +++ b/data/reusables/copilot/byok-add.md @@ -0,0 +1,17 @@ +1. Click the **Custom models** tab. +1. Above the list of API keys, click **Add API key**. +1. Under "Provider", select the LLM provider you want to use. +1. Under "Name", type a name for this key. This will be shown in the model picker. +1. Under "API key", type or paste your key. +1. Depending on which provider you are using, select or add models. + * If you're using OpenAI, Anthropic, or xAI, click {% octicon "sync" aria-label="Fetch new models" %} in the API key text field to fetch the models associated with your key. Next, under "Available models", select the models you want to use. + + ![Screenshot of the "Add API key" form. The "Fetch new models" button is highlighted with an orange outline.](/assets/images/help/copilot/byok-add.png) + + * If you're using Microsoft Foundry, type your deployment URL in the field under "Deployment URL". Next, in the field under "Available models", type a Model ID and click {% octicon "check" aria-label="Add model" %} to add it. + + If your models have different deployment URLs, they cannot be added to the same API key. Create a separate API key for each deployment URL. + + ![Screenshot of the "Add API key" form. The model text field and "Add model" button is highlighted with an orange outline.](/assets/images/help/copilot/byok-add-foundry.png) + +1. After you select or add the models you want to make available, click **Save**. \ No newline at end of file diff --git a/data/reusables/copilot/byok-intro.md b/data/reusables/copilot/byok-intro.md new file mode 100644 index 000000000000..74fc03a47743 --- /dev/null +++ b/data/reusables/copilot/byok-intro.md @@ -0,0 +1,15 @@ +>[!NOTE] +>{% data reusables.copilot.byok-preview-note %} +> +>Some models require the Responses API which is not currently supported. + +You can bring your own API keys to {% data variables.product.prodname_copilot %}, and enable teams to use your preferred large language model (LLM) providers with {% data variables.copilot.copilot_byok_supported_features %}. + +API keys from the following providers are supported: + +* Anthropic +* Microsoft Foundry +* OpenAI +* xAI + +Fine-tuned models are also supported, but functionality and quality of results can vary depending on the fine-tuning setup. You should test your model and review its outputs carefully before using it in production. \ No newline at end of file diff --git a/data/reusables/copilot/byok-preview-note.md b/data/reusables/copilot/byok-preview-note.md new file mode 100644 index 000000000000..89581d936885 --- /dev/null +++ b/data/reusables/copilot/byok-preview-note.md @@ -0,0 +1 @@ +The ability to bring your own API keys to {% data variables.product.prodname_copilot %} is in {% data variables.release-phases.public_preview %} and subject to change. \ No newline at end of file diff --git a/data/reusables/copilot/byok-why.md b/data/reusables/copilot/byok-why.md new file mode 100644 index 000000000000..36d2e245185e --- /dev/null +++ b/data/reusables/copilot/byok-why.md @@ -0,0 +1,4 @@ +* **Governance and compliance:** Choose LLM providers that comply with your organization's policies and regulatory requirements. +* **Cost management:** Align with your existing payment methods, contracts, credits, or negotiated rates, and avoid usage overages. +* **Visibility and control:** Manage which models your team can access, and monitor usage through your provider's existing dashboards and billing. +* **Flexibility:** Support custom or specialized models that your organization already uses. \ No newline at end of file diff --git a/data/reusables/rai/copilot/byok-transparency-note.md b/data/reusables/rai/copilot/byok-transparency-note.md new file mode 100644 index 000000000000..63efeae5d983 --- /dev/null +++ b/data/reusables/rai/copilot/byok-transparency-note.md @@ -0,0 +1,25 @@ +# Using Bring Your Own Key (BYOK) with {% data variables.product.prodname_copilot %} + +When you use Bring Your Own Key with {% data variables.copilot.copilot_chat %}, you can connect the chat experience to large language models from supported providers beyond the default {% data variables.product.prodname_copilot_short %} model. Examples of supported providers include Anthropic, Azure AI, OpenAI, and xAI. You add your API key for the chosen provider directly in your {% data variables.product.prodname_copilot_short %} settings. + +When BYOK is active: + +* **Feature scope**: Your chosen model is used within {% data variables.copilot.copilot_chat %}. In Agent mode, BYOK powers the main conversation, but certain actions such as code application or other tool calls may still use {% data variables.product.github %}-hosted models optimized for those tasks. These built-in models do not run through your BYOK provider. +* **Safety processes**: Regardless of which provider is active, responses still pass through {% data variables.product.github %}'s safety systems, including content filtering, before results are shown to you. +* **Quality considerations**: Suggestions may vary depending on the strengths and training coverage of your chosen provider. +* **Data handling**: When using BYOK, your prompts and responses are transmitted to your selected provider and may be subject to that provider's data retention and privacy policies. {% data variables.product.github %} temporarily processes this data for safety filtering but does not retain BYOK conversation content beyond session duration. +* **Your responsibilities**: You are responsible for the following: + * Provider API key security + * Usage costs or quotas + * Output validation + * Evaluating whether your chosen model meets your safety and quality requirements + * Compliance with your selected provider's terms + * Determining whether your chosen model complies with applicable laws + * Ensuring that a human reviews any output before using it to make decisions that affect people +* **Export restrictions**: Certain AI models may be subject to export controls. Verify your selected provider and model are authorized for use in your jurisdiction. + +BYOK empowers your organization to choose the language model that best fits your needs while benefiting from {% data variables.product.github %}'s safety infrastructure. Note that model performance and safety characteristics are provider-dependent. + + + + diff --git a/data/variables/copilot.yml b/data/variables/copilot.yml index 67e7d27e5d7d..07fd47e4c8f5 100644 --- a/data/variables/copilot.yml +++ b/data/variables/copilot.yml @@ -179,3 +179,6 @@ copilot_workspace_pr: 'GitHub Copilot Workspace for pull requests' copilot_workspace_pr_short: 'Copilot Workspace for PRs' copilot_workspace: 'Copilot Workspace' copilot_workspace_short: 'Workspace' + +# BYOK +copilot_byok_supported_features: '{% data variables.copilot.copilot_chat %}' From 62aa85d468fb7fa243e8412b73a911b0e31f1751 Mon Sep 17 00:00:00 2001 From: docs-bot <77750099+docs-bot@users.noreply.github.com> Date: Thu, 20 Nov 2025 11:37:32 -0800 Subject: [PATCH 2/3] Sync secret scanning data (#58573) Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> --- src/secret-scanning/data/public-docs.yml | 13 ------------- src/secret-scanning/lib/config.json | 4 ++-- 2 files changed, 2 insertions(+), 15 deletions(-) diff --git a/src/secret-scanning/data/public-docs.yml b/src/secret-scanning/data/public-docs.yml index 3d78e20d3879..83d1cde65b25 100644 --- a/src/secret-scanning/data/public-docs.yml +++ b/src/secret-scanning/data/public-docs.yml @@ -2791,19 +2791,6 @@ hasValidityCheck: false base64Supported: false isduplicate: false -- provider: GitHub Secret Scanning - supportedSecret: GitHub Secret Scanning - secretType: secret_scanning_sample_token - versions: - fpt: '*' - ghec: '*' - ghes: '>=3.14' - isPublic: true - isPrivateWithGhas: true - hasPushProtection: true - hasValidityCheck: false - base64Supported: true - isduplicate: true - provider: GitLab supportedSecret: GitLab Access Token secretType: gitlab_access_token diff --git a/src/secret-scanning/lib/config.json b/src/secret-scanning/lib/config.json index 1dd20a337ad4..82d92b7ca79e 100644 --- a/src/secret-scanning/lib/config.json +++ b/src/secret-scanning/lib/config.json @@ -1,5 +1,5 @@ { - "sha": "51d07334c302c781667c4fcd78effd1eeb721ee8", - "blob-sha": "ce46df4a1ed48ec1ada2618f08cfff7fc57fee7c", + "sha": "adaa3af5a5deefe30a539464281d20e9a3966fac", + "blob-sha": "6d5cc12453861b6ea6cf56bf5fcca94760de5d70", "targetFilename": "code-security/secret-scanning/introduction/supported-secret-scanning-patterns" } \ No newline at end of file From 6fb62450110a459a6e803f81b678f7bedbc2027e Mon Sep 17 00:00:00 2001 From: Sam Browning <106113886+sabrowning1@users.noreply.github.com> Date: Thu, 20 Nov 2025 14:48:04 -0500 Subject: [PATCH 3/3] Add content for static analysis tools in Copilot code review (#58514) Co-authored-by: Ria Gopu Co-authored-by: hubwriter Co-authored-by: Siara <108543037+SiaraMist@users.noreply.github.com> --- .../copilot/concepts/agents/code-review.md | 11 ++++++- .../request-a-code-review/index.md | 3 +- .../request-a-code-review/manage-tools.md | 32 +++++++++++++++++++ .../manage-static-analysis-tools.md | 6 ++++ 4 files changed, 50 insertions(+), 2 deletions(-) create mode 100644 content/copilot/how-tos/use-copilot-agents/request-a-code-review/manage-tools.md create mode 100644 data/reusables/copilot/code-review/manage-static-analysis-tools.md diff --git a/content/copilot/concepts/agents/code-review.md b/content/copilot/concepts/agents/code-review.md index 568bf047e589..1580e239df44 100644 --- a/content/copilot/concepts/agents/code-review.md +++ b/content/copilot/concepts/agents/code-review.md @@ -37,7 +37,7 @@ This article provides an overview of {% data variables.copilot.copilot_code-revi {% data variables.copilot.copilot_code-review_short %} has several new tools that are in {% data variables.release-phases.public_preview %} and subject to change. * **Full project context gathering** to provide more specific, accurate, and contextually aware code reviews. -* **Support for deterministic detections with {% data variables.product.prodname_codeql %}**, to deliver more high-signal, consistent findings for quality. +* **Support for static analysis tools like {% data variables.product.prodname_codeql %}, ESLint, and PMD** to deliver more high-signal, consistent findings for security and quality. * **The ability to pass suggestions to {% data variables.copilot.copilot_coding_agent %}**, for automated creation of a new pull request against your branch with the suggested fixes applied. You are not required 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 %}. @@ -120,6 +120,15 @@ The triggers for automatic code review depend on the configuration settings: For details of how to configure {% data variables.product.prodname_copilot_short %} to automatically review new pull requests, see [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/configuring-automatic-code-review-by-copilot). +## About static analysis tools + +You can enable static analysis tools in {% data variables.copilot.copilot_code-review_short %} to enhance its ability to identify and fix issues. Available tools include: +* **{% data variables.product.prodname_codeql %}**: A code analysis engine that identifies security vulnerabilities. For more information, see [About {% data variables.product.prodname_codeql %}](/code-security/code-scanning/introduction-to-code-scanning/about-code-scanning-with-codeql#about-codeql). +* **ESLint**: A linter designed specifically for JavaScript. For more information, see [Core Concepts](https://eslint.org/docs/latest/use/core-concepts/) in the the ESLint documentation. +* **PMD**: A static code analyzer that focuses on Java and Apex, but also supports many other languages. For more information, see the [PMD documentation](https://docs.pmd-code.org/latest/). + +If you have access to {% data variables.copilot.copilot_code-review-tools_short %}, {% data variables.product.prodname_codeql %} is enabled by default, while ESLint and PMD are disabled. Additionally, if you have access to rulesets, you can change your selected tools. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/request-a-code-review/manage-tools). + ## Getting detailed code quality feedback for your whole repository {% data variables.copilot.copilot_code-review %} reviews your code in pull requests and provides feedback. If you want to surface actionable feedback on the reliability and maintainability of your whole repository, enable {% data variables.product.prodname_code_quality %}. See [AUTOTITLE](/code-security/code-quality/concepts/about-code-quality). diff --git a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md index 9312a5278a1b..5bbf1d272746 100644 --- a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md +++ b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md @@ -1,7 +1,7 @@ --- title: Code review shortTitle: Request a code review -intro: 'Learn how to request a code review from {% data variables.product.prodname_copilot %}.' +intro: 'Learn how you can request and configure reviews from {% data variables.product.prodname_copilot_short %}.' versions: feature: copilot topics: @@ -9,6 +9,7 @@ topics: children: - /use-code-review - /configure-automatic-review + - /manage-tools redirect_from: - /copilot/using-github-copilot/code-review - /copilot/how-tos/agents/copilot-code-review diff --git a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/manage-tools.md b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/manage-tools.md new file mode 100644 index 000000000000..b306eae71650 --- /dev/null +++ b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/manage-tools.md @@ -0,0 +1,32 @@ +--- +title: Managing static analysis tools in Copilot code review +shortTitle: Manage tools +intro: 'Improve your code security and linting configuration with static analysis tools in {% data variables.copilot.copilot_code-review_short %}.' +versions: + feature: copilot +permissions: Repository administrators and organization owners +product: 'Rulesets are available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_ghe_cloud %}.' +topics: + - Copilot +contentType: how-tos +category: + - Author and optimize with Copilot +--- + +## Prerequisites + +If you get access to {% data variables.product.prodname_copilot_short %} through an organization or enterprise, your organization or enterprise owner needs to enable preview features for {% data variables.copilot.copilot_code-review_short %}. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies). + +## Managing static analysis tools for your repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.repo-rulesets-settings %} +{% data reusables.copilot.code-review.manage-static-analysis-tools %} + +## Configuring static analysis tools for your organization + +{% data reusables.organizations.navigate-to-org %} +{% data reusables.organizations.org_settings %} +{% data reusables.organizations.access-ruleset-settings %} +{% data reusables.copilot.code-review.manage-static-analysis-tools %} diff --git a/data/reusables/copilot/code-review/manage-static-analysis-tools.md b/data/reusables/copilot/code-review/manage-static-analysis-tools.md new file mode 100644 index 000000000000..1be4a58a1556 --- /dev/null +++ b/data/reusables/copilot/code-review/manage-static-analysis-tools.md @@ -0,0 +1,6 @@ +1. Edit or create a ruleset for {% data variables.copilot.copilot_code-review_short %}: + * If you have **configured a ruleset for automatic reviews** from {% data variables.copilot.copilot_code-review_short %}, click the name of that ruleset. + * If you **do not have an existing ruleset** for {% data variables.copilot.copilot_code-review_short %}, select the **New ruleset** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle" %} dropdown menu, then click **New branch ruleset** and give your ruleset a name. +1. In the "Rules" section, select **Manage static analysis tools in {% data variables.copilot.copilot_code-review_short %}**. +1. To update the tools that {% data variables.copilot.copilot_code-review_short %} will use, select the **Select tools** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %} dropdown menu, then select or deselect the available tools. +1. To apply your selections, at the bottom of the page, click **Create** or **Save changes**.