diff --git a/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/using-your-github-profile-to-enhance-your-resume.md b/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/using-your-github-profile-to-enhance-your-resume.md index 7b298fdfb5..2ac023012f 100644 --- a/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/using-your-github-profile-to-enhance-your-resume.md +++ b/content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/using-your-github-profile-to-enhance-your-resume.md @@ -55,7 +55,7 @@ Hiring managers usually consider many applicants for each role. Expect that they ### Write a helpful README -The README for your project's repository is a perfect space to give a concise project overview. Use [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot) to help write your README, with a prompt like this: +The README for your project's repository is a perfect space to give a concise project overview. Use [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot) to help write your README, with a prompt like this: >Write a README for my lottery-number-generator repository. diff --git a/content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/using-copilot-to-troubleshoot-workflows.md b/content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/using-copilot-to-troubleshoot-workflows.md index 22ab262fa8..7d611e550a 100644 --- a/content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/using-copilot-to-troubleshoot-workflows.md +++ b/content/actions/monitoring-and-troubleshooting-workflows/troubleshooting-workflows/using-copilot-to-troubleshoot-workflows.md @@ -16,4 +16,4 @@ To open a chat about a failed workflow run, you can either: This opens a chat window with {% data variables.product.prodname_copilot %}, where it will provide instructions to resolve the issue. ->[!NOTE] If you are on a {% data variables.product.prodname_copilot_free %} subscription, this will count towards your monthly chat message limit. +>[!NOTE] If you are on a {% data variables.copilot.copilot_free %} subscription, this will count towards your monthly chat message limit. diff --git a/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md b/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md index 3a26c55004..f6fd7c90cc 100644 --- a/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md +++ b/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md @@ -1,6 +1,6 @@ --- title: About enterprise accounts for Copilot Business -intro: 'Learn about the options for creating an enterprise account to manage {% data variables.product.prodname_copilot_business_short %} licenses, without adopting {% data variables.product.prodname_enterprise %}.' +intro: 'Learn about the options for creating an enterprise account to manage {% data variables.copilot.copilot_business_short %} licenses, without adopting {% data variables.product.prodname_enterprise %}.' versions: ghec: '*' topics: @@ -12,15 +12,15 @@ redirect_from: - /early-access/copilot/managing-copilot-business-licenses-with-an-enterprise-account --- -You can use an enterprise account to manage licenses for {% data variables.product.prodname_copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. +You can use an enterprise account to manage licenses for {% data variables.copilot.copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. >[!NOTE] Access to this feature is currently managed by {% data variables.contact.contact_enterprise_sales %}. -## What is an enterprise account for {% data variables.product.prodname_copilot_business_short %}? +## What is an enterprise account for {% data variables.copilot.copilot_business_short %}? -To use {% data variables.product.prodname_copilot %}, a user must authenticate to an account on {% data variables.product.prodname_dotcom %} that has a license for {% data variables.product.prodname_copilot_short %}. Organizations and enterprises on {% data variables.product.prodname_dotcom %} can manage members' access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} subscription. +To use {% data variables.product.prodname_copilot %}, a user must authenticate to an account on {% data variables.product.prodname_dotcom %} that has a license for {% data variables.product.prodname_copilot_short %}. Organizations and enterprises on {% data variables.product.prodname_dotcom %} can manage members' access to {% data variables.product.prodname_copilot_short %} through a {% data variables.copilot.copilot_business_short %} subscription. -If you don't already manage users through an organization or enterprise, you can create an enterprise account specifically for allocating {% data variables.product.prodname_copilot_business_short %} licenses. +If you don't already manage users through an organization or enterprise, you can create an enterprise account specifically for allocating {% data variables.copilot.copilot_business_short %} licenses. * You'll only pay for the {% data variables.product.prodname_copilot_short %} licenses you assign. For pricing, see [AUTOTITLE](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#pricing-for-github-copilot-business). * You won't pay for {% data variables.product.prodname_enterprise %} seats. @@ -37,7 +37,7 @@ How you will add users to your enterprise and manage license assignment depends If you request an enterprise with personal accounts: * You'll **add users** to the enterprise by sending an invitation to their personal {% data variables.product.prodname_dotcom %} account. -* You'll **create teams** in the enterprise to manage which users receive {% data variables.product.prodname_copilot_business_short %} licenses. You can manage membership of the teams on {% data variables.product.prodname_dotcom %} or with the REST API. +* You'll **create teams** in the enterprise to manage which users receive {% data variables.copilot.copilot_business_short %} licenses. You can manage membership of the teams on {% data variables.product.prodname_dotcom %} or with the REST API. * When users receive a license, they can authenticate to {% data variables.product.prodname_dotcom %} from their development environment and **gain access** to {% data variables.product.prodname_copilot_short %}. * Optionally, you can configure **SAML single sign-on** (SSO), so that users must authenticate to an external identity system in addition to their personal account. @@ -46,7 +46,7 @@ If you request an enterprise with personal accounts: If you request an {% data variables.enterprise.prodname_emu_enterprise %}: * You'll **add users** to the enterprise by provisioning {% data variables.enterprise.prodname_managed_users %} from an identity provider (IdP), using SCIM. -* You'll **create teams** in the enterprise to manage which users receive {% data variables.product.prodname_copilot_business_short %} licenses. You can manage membership of the teams from your IdP, on {% data variables.product.prodname_dotcom %}, or with the REST API. +* You'll **create teams** in the enterprise to manage which users receive {% data variables.copilot.copilot_business_short %} licenses. You can manage membership of the teams from your IdP, on {% data variables.product.prodname_dotcom %}, or with the REST API. * When users receive a license, they can use single sign-on to authenticate to their {% data variables.product.prodname_dotcom %} account from their development environment and **gain access** to {% data variables.product.prodname_copilot_short %}. ## Limitations @@ -60,7 +60,7 @@ If you request an {% data variables.enterprise.prodname_emu_enterprise %}: ## Getting started -To get started, you will work with {% data variables.contact.contact_enterprise_sales %} to create an enterprise account, then add users to your enterprise and assign {% data variables.product.prodname_copilot_business_short %} licenses. +To get started, you will work with {% data variables.contact.contact_enterprise_sales %} to create an enterprise account, then add users to your enterprise and assign {% data variables.copilot.copilot_business_short %} licenses. See the setup guide for your chosen type of enterprise. diff --git a/content/admin/copilot-business-only/index.md b/content/admin/copilot-business-only/index.md index 477a6cdfff..780caba490 100644 --- a/content/admin/copilot-business-only/index.md +++ b/content/admin/copilot-business-only/index.md @@ -1,6 +1,6 @@ --- title: Using a dedicated enterprise account for Copilot Business -intro: Get started with an enterprise account for managing {% data variables.product.prodname_copilot_business_short %} licenses. +intro: Get started with an enterprise account for managing {% data variables.copilot.copilot_business_short %} licenses. versions: ghec: '*' children: diff --git a/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md index 5254c1afd3..2614c7ed60 100644 --- a/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md +++ b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md @@ -14,7 +14,7 @@ redirect_from: --- -You can use an enterprise account to manage licenses for {% data variables.product.prodname_copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. +You can use an enterprise account to manage licenses for {% data variables.copilot.copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. This article describes the setup for an **enterprise with managed users**. If you haven't chosen an enterprise type, see [AUTOTITLE](/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business). diff --git a/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md index 4dcc17547b..a9ffd3c5d2 100644 --- a/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md +++ b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md @@ -12,7 +12,7 @@ redirect_from: - /early-access/copilot/using-copilot-business-without-github-enterprise-personal-accounts --- -You can use an enterprise account to manage licenses for {% data variables.product.prodname_copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. +You can use an enterprise account to manage licenses for {% data variables.copilot.copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. This article describes the setup for an **enterprise with personal accounts**. If you haven't chosen an enterprise type, see [AUTOTITLE](/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business). diff --git a/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md b/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md index 45a2a74957..c1cf763dcc 100644 --- a/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md +++ b/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md @@ -92,7 +92,7 @@ Rate limits apply for requests to the REST API. See [AUTOTITLE](/rest/overview/r ### {% data variables.product.prodname_copilot %} -Your developers can access {% data variables.product.prodname_copilot %} if you grant them access to a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription. {% data variables.enterprise.prodname_managed_users_caps %} cannot sign up for {% data variables.product.prodname_copilot_individuals_short %}. +Your developers can access {% data variables.product.prodname_copilot %} if you grant them access to a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription. {% data variables.enterprise.prodname_managed_users_caps %} cannot sign up for {% data variables.copilot.copilot_individuals_short %}. * Users must perform some additional setup to authenticate to their account from their development environment. See [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/using-github-copilot-with-an-account-on-ghecom). * Certain {% data variables.product.prodname_copilot %} features are currently unavailable on {% data variables.enterprise.data_residency_site %}. See [AUTOTITLE](/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency#currently-unavailable-features). diff --git a/content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md b/content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md index 12bc267fa4..4c9e432a1c 100644 --- a/content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md +++ b/content/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency.md @@ -26,9 +26,9 @@ The following features are currently unavailable on {% data variables.enterprise | Maven and Gradle support for {% data variables.product.prodname_registry %} | Currently unavailable. | [AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry) | | {% data variables.product.prodname_importer %} (the "Import repository" button on {% data variables.product.prodname_dotcom_the_website %}) | Instead, the **{% data variables.product.prodname_importer_proper_name %}** is available to migrate data. See [AUTOTITLE](/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer). | [AUTOTITLE](/migrations/importing-source-code/using-github-importer/about-github-importer) | | {% data variables.product.prodname_copilot %} Workspaces | Currently unavailable | N/A | -| {% data variables.product.prodname_copilot_extensions %} | Currently unavailable | [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat) | +| {% data variables.copilot.copilot_extensions %} | Currently unavailable | [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat) | | {% data variables.product.prodname_copilot_short %} Metrics API | Currently unavailable | [AUTOTITLE](/rest/copilot/copilot-metrics) | -| {% data variables.product.prodname_copilot_agent %} | Currently unavailable | [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot) | +| {% data variables.copilot.copilot_coding_agent %} | Currently unavailable | [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot) | | Restricting {% data variables.product.prodname_actions %} policies to verified creators | Currently unavailable | [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#allow-enterprise-and-select-non-enterprise-actions-and-reusable-workflows) | | Some features currently in {% data variables.release-phases.public_preview %} or {% data variables.release-phases.private_preview %} | Certain features that are in a preview phase on {% data variables.product.prodname_dotcom_the_website %} may not be available on {% data variables.enterprise.data_residency_site %} | | diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md index 17a7d063f1..eb8e3ca594 100644 --- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md +++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise.md @@ -128,13 +128,13 @@ Across all of your enterprise's organizations, you can allow or disallow people {% ifversion code-scanning-autofix %} -## Enforcing a policy to manage the use of {% data variables.product.prodname_copilot_autofix_short %} in your enterprise's repositories +## Enforcing a policy to manage the use of {% data variables.copilot.copilot_autofix_short %} in your enterprise's repositories -Across all of your enterprise's organizations, you can allow or disallow people with admin access to repositories to manage where {% data variables.product.prodname_copilot_autofix_short %} is enabled. {% data variables.product.prodname_GH_code_security %} must be enabled for the organization for this policy to take effect. +Across all of your enterprise's organizations, you can allow or disallow people with admin access to repositories to manage where {% data variables.copilot.copilot_autofix_short %} is enabled. {% data variables.product.prodname_GH_code_security %} must be enabled for the organization for this policy to take effect. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.code-security-and-analysis-policies %} -1. In the "Policies" section, under "{% data variables.product.prodname_copilot_autofix_short %}", select the dropdown menu and click a policy. +1. In the "Policies" section, under "{% data variables.copilot.copilot_autofix_short %}", select the dropdown menu and click a policy. {% endif %} diff --git a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business-from-organizations-in-your-enterprise.md b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business-from-organizations-in-your-enterprise.md index 2c41c09dc8..f4c92ad9cf 100644 --- a/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business-from-organizations-in-your-enterprise.md +++ b/content/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business-from-organizations-in-your-enterprise.md @@ -2,7 +2,7 @@ title: Managing requests for Copilot Business from organizations in your enterprise intro: Learn how to view and satisfy requests to access Copilot from organizations owned by your enterprise. permissions: Enterprise owners -product: Enterprise accounts with a subscription to {% data variables.product.prodname_copilot_for_business %}. +product: Enterprise accounts with a subscription to {% data variables.copilot.copilot_for_business %}. versions: ghec: '*' type: how_to @@ -13,13 +13,13 @@ topics: shortTitle: Manage requests for Copilot --- -Organization owners might not have the necessary permissions to satisfy requests from members. For example, if an organization owner is not an enterprise owner, and {% data variables.product.prodname_copilot_for_business %} is not enabled for that organization, they will not have the permissions to approve requests for {% data variables.product.prodname_copilot_for_business %}. +Organization owners might not have the necessary permissions to satisfy requests from members. For example, if an organization owner is not an enterprise owner, and {% data variables.copilot.copilot_for_business %} is not enabled for that organization, they will not have the permissions to approve requests for {% data variables.copilot.copilot_for_business %}. -In these cases, when an organization member requests access to {% data variables.product.prodname_copilot_for_business %}, the organization owner will be prompted to ask the enterprise owners to enable {% data variables.product.prodname_copilot_short %} for the organization. +In these cases, when an organization member requests access to {% data variables.copilot.copilot_for_business %}, the organization owner will be prompted to ask the enterprise owners to enable {% data variables.product.prodname_copilot_short %} for the organization. As an enterprise owner, you can view or dismiss these requests from your notifications page. You can approve the request by enabling {% data variables.product.prodname_copilot_short %} for the organization. -## Approving requests for {% data variables.product.prodname_copilot_for_business %} +## Approving requests for {% data variables.copilot.copilot_for_business %} {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} diff --git a/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md b/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md index fc2e1b5601..45d391eafc 100644 --- a/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md +++ b/content/admin/managing-iam/understanding-iam-for-enterprises/abilities-and-restrictions-of-managed-user-accounts.md @@ -50,7 +50,7 @@ With {% data variables.product.prodname_emus %}, you can control the user accoun ## {% data variables.product.prodname_copilot %} -* {% data variables.enterprise.prodname_managed_users_caps %} cannot sign up for {% data variables.product.prodname_copilot_pro %} or {% data variables.product.prodname_copilot_free %}. To allow a managed user to use {% data variables.product.prodname_copilot_short %}, you must grant the user access to a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription. See [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). +* {% data variables.enterprise.prodname_managed_users_caps %} cannot sign up for {% data variables.copilot.copilot_pro %} or {% data variables.copilot.copilot_free %}. To allow a managed user to use {% data variables.product.prodname_copilot_short %}, you must grant the user access to a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription. See [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). ## {% data variables.product.prodname_pages %} diff --git a/content/admin/managing-your-enterprise-account/about-enterprise-accounts.md b/content/admin/managing-your-enterprise-account/about-enterprise-accounts.md index 5d5a0e2ece..04b6e31d29 100644 --- a/content/admin/managing-your-enterprise-account/about-enterprise-accounts.md +++ b/content/admin/managing-your-enterprise-account/about-enterprise-accounts.md @@ -41,7 +41,7 @@ Administrators for the enterprise account can: * Configure security, such as single sign-on, IP allow lists, SSH certificate authorities, and two-factor authentication * Stream audit and Git events data * Use internal repositories -* Access features like {% data variables.product.prodname_copilot_enterprise %} and {% data variables.product.prodname_AS %}{% ifversion ghas-products %} products{% endif %} +* Access features like {% data variables.copilot.copilot_enterprise %} and {% data variables.product.prodname_AS %}{% ifversion ghas-products %} products{% endif %} * Enforce policies. See [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/about-enterprise-policies). {% ifversion ghec %} diff --git a/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md b/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md index 4c27569ae3..707c021012 100644 --- a/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md +++ b/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md @@ -38,7 +38,7 @@ You'll **need help** creating an enterprise account if you require: * {% data variables.product.prodname_ghe_server %} * {% data variables.enterprise.data_residency %} * Invoicing -* A dedicated enterprise for managing {% data variables.product.prodname_copilot_for_business %} licenses without adopting {% data variables.product.prodname_enterprise %} +* A dedicated enterprise for managing {% data variables.copilot.copilot_for_business %} licenses without adopting {% data variables.product.prodname_enterprise %} In these cases, contact {% data variables.contact.contact_enterprise_sales %}. diff --git a/content/admin/overview/about-github-for-enterprises.md b/content/admin/overview/about-github-for-enterprises.md index 136c9f99d5..44d1ed7cf4 100644 --- a/content/admin/overview/about-github-for-enterprises.md +++ b/content/admin/overview/about-github-for-enterprises.md @@ -64,7 +64,7 @@ Your business can: * Additional features such as SAML authentication and internal repositories. For a detailed list, see {% data variables.product.pricing_link %}. * Extra allowances for usage-based products such as {% data variables.product.prodname_actions %}. * An enterprise account, which provides a single place to manage billing and settings, enforce policies, and audit the people with access to your enterprise. -* The option to add {% ifversion ghas-products %}{% else %}{% data variables.product.prodname_GHAS %}, {% endif %}{% data variables.contact.premium_support %}, and {% data variables.product.prodname_copilot_enterprise %}. +* The option to add {% ifversion ghas-products %}{% else %}{% data variables.product.prodname_GHAS %}, {% endif %}{% data variables.contact.premium_support %}, and {% data variables.copilot.copilot_enterprise %}. When businesses adopt {% data variables.product.prodname_enterprise %}, their return on investment (ROI) is high. For example, their developers **save 45 minutes per day**, and onboarding and **training time is reduced by 40%**. See [The Total Economic Impact of {% data variables.product.prodname_enterprise %}](https://resources.github.com/forrester/). diff --git a/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md b/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md index ca88446a57..fe7c77e6bb 100644 --- a/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md +++ b/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md @@ -29,7 +29,7 @@ To set up a trial, you must be signed in to a personal account. If you don't hav The trial lasts for **{% data reusables.enterprise.ghec-trial-length %} days** and includes the following features. * Access to **most** {% data variables.product.prodname_ghe_cloud %} features. -* {% data variables.product.prodname_copilot_for_business %} ({% data variables.product.prodname_dotcom_the_website %} trials only) +* {% data variables.copilot.copilot_for_business %} ({% data variables.product.prodname_dotcom_the_website %} trials only) * {% data variables.product.prodname_GH_cs_and_sp %} ({% data variables.product.prodname_dotcom_the_website %} trials only) * Access to the **new billing platform**.{% ifversion enhanced-billing-platform %} See [AUTOTITLE](/billing/using-the-new-billing-platform/about-the-new-billing-platform-for-enterprises).{% endif %} * An **enterprise account**, which allows you to manage multiple organizations. See [AUTOTITLE](/enterprise-cloud@latest/get-started/learning-about-github/types-of-github-accounts). @@ -40,7 +40,7 @@ Your trial **won't** include access to {% data variables.product.prodname_ghe_se ## Features not included in the trial * {% data variables.product.prodname_github_codespaces %} -* {% data variables.product.prodname_copilot_enterprise %} +* {% data variables.copilot.copilot_enterprise %} * {% data variables.product.prodname_sponsors %} * Paid {% data variables.product.prodname_marketplace %} apps * {% data variables.product.prodname_github_connect %} @@ -51,7 +51,7 @@ If you invite an existing organization into your trial enterprise, **all of thes ## Do I need to provide a payment method? -You do not need to provide a payment method to start a trial. If you want to use {% data variables.product.prodname_copilot_business_short %} during the trial, you need to provide a credit card. You **won't** be charged for using {% data variables.product.prodname_copilot_business_short %} during the trial. +You do not need to provide a payment method to start a trial. If you want to use {% data variables.copilot.copilot_business_short %} during the trial, you need to provide a credit card. You **won't** be charged for using {% data variables.copilot.copilot_business_short %} during the trial. ## During the trial diff --git a/content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md b/content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md index 39e1246bf1..39aec31338 100644 --- a/content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md +++ b/content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md @@ -38,7 +38,7 @@ All listings should meet the following requirements, regardless of whether they * Listings must have a relevant description of the application. * Listings must specify a pricing plan. * Apps must provide value to customers and integrate with the platform in some way beyond authentication. -* Apps must be publicly available in {% data variables.product.prodname_marketplace %} and cannot be in {% data variables.release-phases.public_preview %} or available by invite only, with the exception of {% data variables.product.prodname_copilot_extensions_short %}. +* Apps must be publicly available in {% data variables.product.prodname_marketplace %} and cannot be in {% data variables.release-phases.public_preview %} or available by invite only, with the exception of {% data variables.copilot.copilot_extensions_short %}. * Apps must have webhook events set up to notify the publisher of any plan changes or cancellations using the {% data variables.product.prodname_marketplace %} API. For more information, see [AUTOTITLE](/apps/github-marketplace/using-the-github-marketplace-api-in-your-app). For more information on providing a good customer experience, see [AUTOTITLE](/apps/github-marketplace/creating-apps-for-github-marketplace/customer-experience-best-practices-for-apps). @@ -55,13 +55,13 @@ To protect your customers, we recommend that you also follow security best pract {% data reusables.marketplace.free-apps-encouraged %} -## Requirements for {% data variables.product.prodname_copilot_extensions %} +## Requirements for {% data variables.copilot.copilot_extensions %} -{% data variables.product.prodname_copilot_extensions_short %} are essentially {% data variables.product.prodname_github_apps %} with additional read access to {% data variables.product.prodname_copilot_chat_short %}, integration with the {% data variables.product.prodname_copilot_short %} API, and optional integration into other LLMs. +{% data variables.copilot.copilot_extensions_short %} are essentially {% data variables.product.prodname_github_apps %} with additional read access to {% data variables.copilot.copilot_chat_short %}, integration with the {% data variables.product.prodname_copilot_short %} API, and optional integration into other LLMs. To publish an extension, it must be owned by an organization account with Verified Creator status. For more information about the verification process or transferring ownership of your app, see [AUTOTITLE](/apps/github-marketplace/github-marketplace-overview/applying-for-publisher-verification-for-your-organization). -The requirements to publish a {% data variables.product.prodname_copilot_extension_short %} are the same as the requirements for free apps, with the following exceptions: +The requirements to publish a {% data variables.copilot.copilot_extension_short %} are the same as the requirements for free apps, with the following exceptions: * Your extension must provide a clear and descriptive response to a prompt like "What can you do?" or "List your capabilities". * Your extension can be in {% data variables.release-phases.public_preview %} as long as that is clearly communicated in the listing description. If you are using a waitlist, you must also include a link to sign up at the top of the description. Someone from the {% data variables.product.github %} review team will join the waitlist and email your technical lead requesting access for testing. * You must include links to two videos that demonstrate the following: diff --git a/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md b/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md index 280fe18f4c..b7e5d8e98b 100644 --- a/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md +++ b/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md @@ -44,11 +44,11 @@ If you're interested in creating an app for {% data variables.product.prodname_m {% data reusables.marketplace.github_apps_preferred %}, although you can list both OAuth and {% data variables.product.prodname_github_apps %} in {% data variables.product.prodname_marketplace %}. For more information, see [AUTOTITLE](/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps) and [AUTOTITLE](/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps). -### {% data variables.product.prodname_copilot_extensions %} +### {% data variables.copilot.copilot_extensions %} {% data reusables.copilot.copilot-extensions.copilot-extensions-intro %} -To learn more about {% data variables.product.prodname_copilot_extensions_short %}, see [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). +To learn more about {% data variables.copilot.copilot_extensions_short %}, see [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). ## Publishing an app to {% data variables.product.prodname_marketplace %} overview diff --git a/content/authentication/keeping-your-account-and-data-secure/reviewing-your-security-log.md b/content/authentication/keeping-your-account-and-data-secure/reviewing-your-security-log.md index 54201e0823..68339793e3 100644 --- a/content/authentication/keeping-your-account-and-data-secure/reviewing-your-security-log.md +++ b/content/authentication/keeping-your-account-and-data-secure/reviewing-your-security-log.md @@ -35,7 +35,7 @@ The events listed in your security log are triggered by your actions. Actions ar | {% ifversion fpt or ghec %} | | `billing` | Contains all activities related to your billing information. | | `codespaces` | Contains all activities related to {% data variables.product.prodname_github_codespaces %}. For more information, see [AUTOTITLE](/codespaces/quickstart). | -| `copilot` | Contains all activities related to {% data variables.product.prodname_copilot_business_short %}. For more information, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). | +| `copilot` | Contains all activities related to {% data variables.copilot.copilot_business_short %}. For more information, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). | | `marketplace_agreement_signature` | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement. | | `marketplace_listing`| Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}. | | {% endif %} | diff --git a/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/about-billing-for-github-copilot.md b/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/about-billing-for-github-copilot.md index 100cbcd47a..e29307a94a 100644 --- a/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/about-billing-for-github-copilot.md +++ b/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/about-billing-for-github-copilot.md @@ -12,24 +12,24 @@ redirect_from: ## {% data variables.product.prodname_copilot %} in your enterprise -Enterprises on {% data variables.product.prodname_ghe_cloud %} can subscribe to either {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}, or a mixture of both across different organizations within an enterprise. Both plans are available on a monthly cycle, and pricing varies. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise). +Enterprises on {% data variables.product.prodname_ghe_cloud %} can subscribe to either {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %}, or a mixture of both across different organizations within an enterprise. Both plans are available on a monthly cycle, and pricing varies. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise). ## {% data variables.product.prodname_copilot %} in your organization -{% data variables.product.github %} bills {% data variables.product.prodname_copilot_business_short %} on a monthly cycle, for {% data variables.copilot.cfb_price_per_month %} per user per month. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-subscription-for-your-organization/about-billing-for-github-copilot-in-your-organization). +{% data variables.product.github %} bills {% data variables.copilot.copilot_business_short %} on a monthly cycle, for {% data variables.copilot.cfb_price_per_month %} per user per month. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-subscription-for-your-organization/about-billing-for-github-copilot-in-your-organization). ## {% data variables.product.prodname_copilot %} as an individual -{% data variables.product.prodname_copilot_pro %} and {% data variables.product.prodname_copilot_pro_plus %} plans are available on a monthly or yearly cycle: +{% data variables.copilot.copilot_pro %} and {% data variables.copilot.copilot_pro_plus %} plans are available on a monthly or yearly cycle: -* **{% data variables.product.prodname_copilot_pro_short %}**: {% data variables.copilot.cfi_price_per_month %} per calendar month or {% data variables.copilot.cfi_price_per_year %} per year. -* **{% data variables.product.prodname_copilot_pro_plus_short %}**: {% data variables.copilot.cpp_price_per_month %} per calendar month or {% data variables.copilot.cpp_price_per_year %} per year. +* **{% data variables.copilot.copilot_pro_short %}**: {% data variables.copilot.cfi_price_per_month %} per calendar month or {% data variables.copilot.cfi_price_per_year %} per year. +* **{% data variables.copilot.copilot_pro_plus_short %}**: {% data variables.copilot.cpp_price_per_month %} per calendar month or {% data variables.copilot.cpp_price_per_year %} per year. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-subscription/about-billing-for-github-copilot-individual). > [!NOTE] {% data reusables.copilot.copilot-one-account %} -If you want to try {% data variables.product.prodname_copilot_short %} before subscribing, you can use {% data variables.product.prodname_copilot_free %} for a limited experience. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free). +If you want to try {% data variables.product.prodname_copilot_short %} before subscribing, you can use {% data variables.copilot.copilot_free %} for a limited experience. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free). ## Migrating between {% data variables.product.prodname_copilot_short %} plans @@ -45,7 +45,7 @@ Some migrations cannot be completed through self-service options. * **Non-enterprise to enterprise environment migrations**: When moving from standalone {% data variables.product.prodname_copilot_short %} plans to a {% data variables.product.prodname_enterprise %} environment, contact {% data variables.contact.contact_support_page %} or your account manager for assistance to avoid service interruption. -* **Changing between {% data variables.product.prodname_copilot_business_short %} and {% data variables.product.prodname_copilot_enterprise_short %}**: If you need to migrate between these plans within your enterprise and the option isn't available in your "Billing & Licensing" settings, contact {% data variables.contact.contact_support_page %} or your account manager for assistance. +* **Changing between {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %}**: If you need to migrate between these plans within your enterprise and the option isn't available in your "Billing & Licensing" settings, contact {% data variables.contact.contact_support_page %} or your account manager for assistance. ## Allowance usage for {% data variables.copilot.copilot_coding_agent %} @@ -63,7 +63,7 @@ When {% data variables.product.prodname_copilot_short %} works on coding tasks, * **Premium requests** from your account's monthly allowance of premium {% data variables.product.prodname_copilot_short %} requests. - This allowance of free premium requests is shared with other {% data variables.product.prodname_copilot_short %} features, such as {% data variables.product.prodname_copilot_chat_short %}. + This allowance of free premium requests is shared with other {% data variables.product.prodname_copilot_short %} features, such as {% data variables.copilot.copilot_chat_short %}. When you use {% data variables.copilot.copilot_coding_agent %}, {% data variables.product.prodname_copilot_short %} may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions {% data variables.product.prodname_copilot_short %} takes on your behalf. The total premium requests used will depend on the complexity of the task and the number of steps involved. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/monitoring-usage-and-entitlements/avoiding-unexpected-copilot-costs). diff --git a/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/index.md b/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/index.md index c0b32c8cdb..06ba20cf14 100644 --- a/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/index.md +++ b/content/billing/managing-billing-for-your-products/managing-billing-for-github-copilot/index.md @@ -1,7 +1,7 @@ --- title: Managing billing for GitHub Copilot shortTitle: GitHub Copilot -intro: '{% ifversion fpt %}You can set up a {% data variables.product.prodname_copilot %} subscription through your personal or organization account. You can modify or cancel your subscription at any time.{% endif %}{% ifversion ghec %}You can view your usage of {% data variables.product.prodname_copilot_for_business %}, and learn about how the costs are calculated.{% endif %}' +intro: '{% ifversion fpt %}You can set up a {% data variables.product.prodname_copilot %} subscription through your personal or organization account. You can modify or cancel your subscription at any time.{% endif %}{% ifversion ghec %}You can view your usage of {% data variables.copilot.copilot_for_business %}, and learn about how the costs are calculated.{% endif %}' versions: feature: copilot redirect_from: diff --git a/content/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription.md b/content/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription.md index 0f0ce6411c..1700ee7bd1 100644 --- a/content/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription.md +++ b/content/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription.md @@ -40,7 +40,7 @@ If you use {% data variables.product.prodname_ghe_cloud %} through a Microsoft E | {% data variables.product.prodname_github_codespaces %} usage | [AUTOTITLE](/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces) | [AUTOTITLE](/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces) | | {% data variables.product.prodname_actions %} usage beyond the amounts included with your plan | [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions) | [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#about-spending-limits) | | {% data variables.product.prodname_registry %} usage beyond the amounts included with your plan | [AUTOTITLE](/billing/managing-billing-for-github-packages/about-billing-for-github-packages) | [AUTOTITLE](/billing/managing-billing-for-github-packages/about-billing-for-github-packages#about-spending-limits) | -| {% data variables.product.prodname_copilot_business_short %} usage | [AUTOTITLE](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#about-billing-for-github-copilot-business-and-github-copilot-enterprise) | N/A | +| {% data variables.copilot.copilot_business_short %} usage | [AUTOTITLE](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#about-billing-for-github-copilot-business-and-github-copilot-enterprise) | N/A | | {% data variables.product.prodname_AS %} usage (only available with a trial of {% data variables.product.prodname_ghe_cloud %}) | [AUTOTITLE](/billing/managing-billing-for-github-advanced-security/about-billing-for-github-advanced-security#usage-based-billing-for-github-advanced-security) | N/A | | {% data variables.product.prodname_enterprise %} usage | [AUTOTITLE](/billing/managing-your-billing/about-billing-for-your-enterprise) | N/A | @@ -50,7 +50,7 @@ If you use {% data variables.product.prodname_ghe_cloud %} through a Microsoft E If you link your {% data variables.product.company_short %} account to Azure, any usage-based costs starting from that point will be billed through Azure and charged on the 1st of each month. However, remaining {% data variables.product.company_short %} charges, for example charges for your {% data variables.product.prodname_dotcom %} plan, will still be billed on your usual billing date. -For example, you link your Azure subscription to your organization {% ifversion ghec %}or enterprise{% endif %} account on June 16th and you also have a {% data variables.product.prodname_copilot_for_business %} subscription. From that date onwards, any usage costs for {% data variables.product.prodname_copilot_business_short %} will be included in your Azure bill and charged on July 1st. However, any charges incurred before June 16th for {% data variables.product.prodname_copilot_business_short %} will be billed separately through {% data variables.product.company_short %} on your account's usual billing date. +For example, you link your Azure subscription to your organization {% ifversion ghec %}or enterprise{% endif %} account on June 16th and you also have a {% data variables.copilot.copilot_for_business %} subscription. From that date onwards, any usage costs for {% data variables.copilot.copilot_business_short %} will be included in your Azure bill and charged on July 1st. However, any charges incurred before June 16th for {% data variables.copilot.copilot_business_short %} will be billed separately through {% data variables.product.company_short %} on your account's usual billing date. ## Prerequisites diff --git a/content/code-security/adopting-github-advanced-security-at-scale/phase-5-rollout-and-scale-code-scanning.md b/content/code-security/adopting-github-advanced-security-at-scale/phase-5-rollout-and-scale-code-scanning.md index a1cfc704c8..befbe3610d 100644 --- a/content/code-security/adopting-github-advanced-security-at-scale/phase-5-rollout-and-scale-code-scanning.md +++ b/content/code-security/adopting-github-advanced-security-at-scale/phase-5-rollout-and-scale-code-scanning.md @@ -43,7 +43,7 @@ For {% data variables.product.prodname_code_scanning %} alerts from {% data vari {% ifversion copilot-chat-ghas-alerts %} -With a {% data variables.product.prodname_copilot_enterprise %} license, you can also ask {% data variables.product.prodname_copilot_chat %} for help to better understand {% data variables.product.prodname_code_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can also ask {% data variables.copilot.copilot_chat %} for help to better understand {% data variables.product.prodname_code_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/adopting-github-advanced-security-at-scale/phase-6-rollout-and-scale-secret-scanning.md b/content/code-security/adopting-github-advanced-security-at-scale/phase-6-rollout-and-scale-secret-scanning.md index fbee9ebdb0..29aa4e4a94 100644 --- a/content/code-security/adopting-github-advanced-security-at-scale/phase-6-rollout-and-scale-secret-scanning.md +++ b/content/code-security/adopting-github-advanced-security-at-scale/phase-6-rollout-and-scale-secret-scanning.md @@ -27,7 +27,7 @@ This article explains a high-level process focusing on enabling {% data variable {% ifversion copilot-chat-ghas-alerts %} -With a {% data variables.product.prodname_copilot_enterprise %} license, you can also ask {% data variables.product.prodname_copilot_chat %} for help to better understand {% data variables.product.prodname_secret_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can also ask {% data variables.copilot.copilot_chat %} for help to better understand {% data variables.product.prodname_secret_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/code-scanning/introduction-to-code-scanning/about-code-scanning.md b/content/code-security/code-scanning/introduction-to-code-scanning/about-code-scanning.md index 19926ac090..c4eb619b26 100644 --- a/content/code-security/code-scanning/introduction-to-code-scanning/about-code-scanning.md +++ b/content/code-security/code-scanning/introduction-to-code-scanning/about-code-scanning.md @@ -29,7 +29,7 @@ If {% data variables.product.prodname_code_scanning %} finds a potential vulnera {% ifversion code-scanning-autofix %} -{% data variables.product.prodname_copilot_autofix %} will suggest fixes for alerts from {% data variables.product.prodname_code_scanning %} analysis in private repositories, allowing developers to prevent and reduce vulnerabilities with less effort. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +{% data variables.copilot.copilot_autofix %} will suggest fixes for alerts from {% data variables.product.prodname_code_scanning %} analysis in private repositories, allowing developers to prevent and reduce vulnerabilities with less effort. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). {% endif %} diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts.md b/content/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts.md index 93f68bbea2..e6a73f9567 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts.md @@ -26,13 +26,13 @@ By default, {% data variables.product.prodname_code_scanning %} analyzes your co {% ifversion code-scanning-autofix %} -You can use {% data variables.product.prodname_copilot_autofix %} to generate fixes automatically for {% data variables.product.prodname_code_scanning %} alerts, including {% data variables.product.prodname_codeql %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/resolving-code-scanning-alerts#generating-suggested-fixes-for-code-scanning-alerts). +You can use {% data variables.copilot.copilot_autofix %} to generate fixes automatically for {% data variables.product.prodname_code_scanning %} alerts, including {% data variables.product.prodname_codeql %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/resolving-code-scanning-alerts#generating-suggested-fixes-for-code-scanning-alerts). {% endif %} {% ifversion copilot-chat-ghas-alerts %} -With a {% data variables.product.prodname_copilot_enterprise %} license, you can also ask {% data variables.product.prodname_copilot_chat %} for help to better understand {% data variables.product.prodname_code_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can also ask {% data variables.copilot.copilot_chat %} for help to better understand {% data variables.product.prodname_code_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/assessing-code-scanning-alerts-for-your-repository.md b/content/code-security/code-scanning/managing-code-scanning-alerts/assessing-code-scanning-alerts-for-your-repository.md index 56c7ad9af9..96530eec19 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/assessing-code-scanning-alerts-for-your-repository.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/assessing-code-scanning-alerts-for-your-repository.md @@ -45,9 +45,9 @@ For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code {% ifversion copilot-chat-ghas-alerts %} -## Asking {% data variables.product.prodname_copilot_chat %} about {% data variables.product.prodname_code_scanning %} alerts +## Asking {% data variables.copilot.copilot_chat %} about {% data variables.product.prodname_code_scanning %} alerts -With a {% data variables.product.prodname_copilot_enterprise %} license, you can ask {% data variables.product.prodname_copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_code_scanning %} alerts, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can ask {% data variables.copilot.copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_code_scanning %} alerts, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/best-practices-for-participating-in-a-security-campaign.md b/content/code-security/code-scanning/managing-code-scanning-alerts/best-practices-for-participating-in-a-security-campaign.md index f4feb16f1a..4d51908d69 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/best-practices-for-participating-in-a-security-campaign.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/best-practices-for-participating-in-a-security-campaign.md @@ -28,8 +28,8 @@ In addition to the benefit of removing an important security problem from your o * You have a campaign manager on the security team to collaborate with and a specific contact link for discussing campaign activities. * You know that you are fixing a security alert that is important to the company. * Potentially, you may have access to targeted training materials.{% ifversion security-campaigns-autofix %} -* You don't need to request a {% data variables.product.prodname_copilot_autofix %} suggestion, it is already available as a starting point.{% endif %}{% ifversion copilot %} -* If you have access to {% data variables.product.prodname_copilot_chat %}, you can ask questions about the alert and the suggested fix.{% endif %} +* You don't need to request a {% data variables.copilot.copilot_autofix %} suggestion, it is already available as a starting point.{% endif %}{% ifversion copilot %} +* If you have access to {% data variables.copilot.copilot_chat %}, you can ask questions about the alert and the suggested fix.{% endif %} * You are improving and demonstrating your knowledge of secure coding. Adopting a few key best practices can help you participate successfully in a campaign. @@ -82,17 +82,17 @@ When fixing security alerts as part of a campaign, it may be helpful to group an {% ifversion code-scanning-autofix %} -### {% data variables.product.prodname_copilot_autofix_short %} +### {% data variables.copilot.copilot_autofix_short %} -{% data variables.product.prodname_copilot_autofix_short %} is automatically triggered for alerts that are included in a campaign, meaning that where possible, fixes are automatically generated for you. You can commit the suggested fix to resolve the alert and then verify that continuous integration testing (CI) for the codebase is still passing. See [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign). +{% data variables.copilot.copilot_autofix_short %} is automatically triggered for alerts that are included in a campaign, meaning that where possible, fixes are automatically generated for you. You can commit the suggested fix to resolve the alert and then verify that continuous integration testing (CI) for the codebase is still passing. See [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign). -### {% data variables.product.prodname_copilot_chat_short %} +### {% data variables.copilot.copilot_chat_short %} {% endif %} -You can ask {% data variables.product.prodname_copilot_chat_short %} for help in understanding the vulnerability, the suggested fix, and how to test that the fix is comprehensive. To access {% data variables.product.prodname_copilot_chat_short %}, navigate to https://github.com/copilot. +You can ask {% data variables.copilot.copilot_chat_short %} for help in understanding the vulnerability, the suggested fix, and how to test that the fix is comprehensive. To access {% data variables.copilot.copilot_chat_short %}, navigate to https://github.com/copilot. -Alternatively, when viewing a specific alert, in the top right corner of the page, click the {% data variables.product.prodname_copilot_chat_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) to open a chat window, and ask {% data variables.product.prodname_copilot_short %} questions about the alert. +Alternatively, when viewing a specific alert, in the top right corner of the page, click the {% data variables.copilot.copilot_chat_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) to open a chat window, and ask {% data variables.product.prodname_copilot_short %} questions about the alert. For example: @@ -102,7 +102,7 @@ For example: ``` -If you don't already have access to {% data variables.product.prodname_copilot_chat_short %} through your organization{% ifversion ghec %} or enterprise{% endif %}, you can sign up to {% data variables.product.prodname_copilot_free %}. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-free/accessing-github-copilot-free). +If you don't already have access to {% data variables.copilot.copilot_chat_short %} through your organization{% ifversion ghec %} or enterprise{% endif %}, you can sign up to {% data variables.copilot.copilot_free %}. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-free/accessing-github-copilot-free). {% endif %} diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/disabling-autofix-for-code-scanning.md b/content/code-security/code-scanning/managing-code-scanning-alerts/disabling-autofix-for-code-scanning.md index bd64bba0d4..42b083c02c 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/disabling-autofix-for-code-scanning.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/disabling-autofix-for-code-scanning.md @@ -2,7 +2,7 @@ title: Disabling Copilot Autofix for code scanning shortTitle: Disable Copilot Autofix allowTitleToDifferFromFilename: true -intro: You can choose to disallow {% data variables.product.prodname_copilot_autofix %} for an enterprise or disable {% data variables.product.prodname_copilot_autofix %} at the organization and repository level. +intro: You can choose to disallow {% data variables.copilot.copilot_autofix %} for an enterprise or disable {% data variables.copilot.copilot_autofix %} at the organization and repository level. product: '{% data reusables.rai.code-scanning.gated-feature-autofix %}' versions: feature: code-scanning-autofix @@ -14,47 +14,47 @@ topics: - AI --- -## About disabling {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %} +## About disabling {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %} -{% data variables.product.prodname_copilot_autofix %} is a {% data variables.product.prodname_copilot %}-powered expansion of {% data variables.product.prodname_code_scanning %}. It provides users with targeted recommendations to help them fix {% data variables.product.prodname_code_scanning %} alerts (including {% data variables.product.prodname_codeql %} alerts) so they can avoid introducing new security vulnerabilities. To learn more about {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %}, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +{% data variables.copilot.copilot_autofix %} is a {% data variables.product.prodname_copilot %}-powered expansion of {% data variables.product.prodname_code_scanning %}. It provides users with targeted recommendations to help them fix {% data variables.product.prodname_code_scanning %} alerts (including {% data variables.product.prodname_codeql %} alerts) so they can avoid introducing new security vulnerabilities. To learn more about {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %}, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). {% data reusables.rai.code-scanning.copilot-autofix-note %} -{% data variables.product.prodname_copilot_autofix_short %} is allowed by default and enabled for every repository that uses {% data variables.product.prodname_codeql %}, regardless of whether it uses default or advanced setup for {% data variables.product.prodname_code_scanning %}. Administrators at the enterprise, organization and repository levels can choose to opt out and disable {% data variables.product.prodname_copilot_autofix_short %}. +{% data variables.copilot.copilot_autofix_short %} is allowed by default and enabled for every repository that uses {% data variables.product.prodname_codeql %}, regardless of whether it uses default or advanced setup for {% data variables.product.prodname_code_scanning %}. Administrators at the enterprise, organization and repository levels can choose to opt out and disable {% data variables.copilot.copilot_autofix_short %}. -Note that disabling {% data variables.product.prodname_copilot_autofix_short %} at any level will close all open {% data variables.product.prodname_copilot_autofix_short %} comments. If {% data variables.product.prodname_copilot_autofix_short %} is disabled and then subsequently enabled, {% data variables.product.prodname_copilot_autofix_short %} won't automatically suggest fixes for any pull requests that are already open. The suggestions will only be generated for any pull requests that are opened after {% data variables.product.prodname_copilot_autofix_short %} is enabled, or after re-running {% data variables.product.prodname_code_scanning %} analysis on existing pull requests. +Note that disabling {% data variables.copilot.copilot_autofix_short %} at any level will close all open {% data variables.copilot.copilot_autofix_short %} comments. If {% data variables.copilot.copilot_autofix_short %} is disabled and then subsequently enabled, {% data variables.copilot.copilot_autofix_short %} won't automatically suggest fixes for any pull requests that are already open. The suggestions will only be generated for any pull requests that are opened after {% data variables.copilot.copilot_autofix_short %} is enabled, or after re-running {% data variables.product.prodname_code_scanning %} analysis on existing pull requests. -## Blocking use of {% data variables.product.prodname_copilot_autofix_short %} for an enterprise +## Blocking use of {% data variables.copilot.copilot_autofix_short %} for an enterprise -Enterprise administrators can disallow {% data variables.product.prodname_copilot_autofix_short %} for their enterprise. If you disallow {% data variables.product.prodname_copilot_autofix_short %} for an enterprise, {% data variables.product.prodname_copilot_autofix_short %} cannot be enabled for any organizations or repositories within the enterprise. +Enterprise administrators can disallow {% data variables.copilot.copilot_autofix_short %} for their enterprise. If you disallow {% data variables.copilot.copilot_autofix_short %} for an enterprise, {% data variables.copilot.copilot_autofix_short %} cannot be enabled for any organizations or repositories within the enterprise. -Note that allowing {% data variables.product.prodname_copilot_autofix_short %} for an enterprise does not enforce enablement of {% data variables.product.prodname_copilot_autofix_short %}, but means that organization and repository administrators will have the option to enable or disable {% data variables.product.prodname_copilot_autofix_short %}. +Note that allowing {% data variables.copilot.copilot_autofix_short %} for an enterprise does not enforce enablement of {% data variables.copilot.copilot_autofix_short %}, but means that organization and repository administrators will have the option to enable or disable {% data variables.copilot.copilot_autofix_short %}. -Disallowing {% data variables.product.prodname_copilot_autofix_short %} at the enterprise level will remove all open {% data variables.product.prodname_copilot_autofix_short %} comments across all repositories of all organizations within the enterprise. +Disallowing {% data variables.copilot.copilot_autofix_short %} at the enterprise level will remove all open {% data variables.copilot.copilot_autofix_short %} comments across all repositories of all organizations within the enterprise. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.code-security-and-analysis-policies %} -1. Under "{% data variables.product.prodname_copilot_autofix_short %}", use the dropdown menu to choose "Not allowed." +1. Under "{% data variables.copilot.copilot_autofix_short %}", use the dropdown menu to choose "Not allowed." -## Disabling {% data variables.product.prodname_copilot_autofix_short %} for an organization +## Disabling {% data variables.copilot.copilot_autofix_short %} for an organization -If {% data variables.product.prodname_copilot_autofix_short %} is allowed at the enterprise level, organization administrators have the option to disable {% data variables.product.prodname_copilot_autofix_short %} for an organization. If you disable {% data variables.product.prodname_copilot_autofix_short %} for an organization, {% data variables.product.prodname_copilot_autofix_short %} cannot be enabled for any repositories within the organization. +If {% data variables.copilot.copilot_autofix_short %} is allowed at the enterprise level, organization administrators have the option to disable {% data variables.copilot.copilot_autofix_short %} for an organization. If you disable {% data variables.copilot.copilot_autofix_short %} for an organization, {% data variables.copilot.copilot_autofix_short %} cannot be enabled for any repositories within the organization. -Note that disabling {% data variables.product.prodname_copilot_autofix_short %} at the organization level will remove all open {% data variables.product.prodname_copilot_autofix_short %} comments across all repositories in the organization. +Note that disabling {% data variables.copilot.copilot_autofix_short %} at the organization level will remove all open {% data variables.copilot.copilot_autofix_short %} comments across all repositories in the organization. {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.security-configurations.display-global-settings %} -1. Under the "{% data variables.product.prodname_code_scanning_caps %}" section, deselect **{% data variables.product.prodname_copilot_autofix_short %}** or **{% data variables.product.prodname_copilot_autofix_short %} for third-party tools**. +1. Under the "{% data variables.product.prodname_code_scanning_caps %}" section, deselect **{% data variables.copilot.copilot_autofix_short %}** or **{% data variables.copilot.copilot_autofix_short %} for third-party tools**. For more information about configuring global {% data variables.product.prodname_code_scanning %} settings, see [AUTOTITLE](/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization#configuring-global-code-scanning-settings). -## Disabling {% data variables.product.prodname_copilot_autofix_short %} for a repository +## Disabling {% data variables.copilot.copilot_autofix_short %} for a repository -If {% data variables.product.prodname_copilot_autofix_short %} is allowed at the enterprise level and enabled at the organization level, repository administrators have the option to disable {% data variables.product.prodname_copilot_autofix_short %} for a repository. Disabling {% data variables.product.prodname_copilot_autofix_short %} at the repository level will remove all open {% data variables.product.prodname_copilot_autofix_short %} comments across the repository. +If {% data variables.copilot.copilot_autofix_short %} is allowed at the enterprise level and enabled at the organization level, repository administrators have the option to disable {% data variables.copilot.copilot_autofix_short %} for a repository. Disabling {% data variables.copilot.copilot_autofix_short %} at the repository level will remove all open {% data variables.copilot.copilot_autofix_short %} comments across the repository. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.navigate-to-code-security-and-analysis %} -1. In the "{% data variables.product.UI_code_security_scanning %}" section, deselect **{% data variables.product.prodname_copilot_autofix_short %}** or **{% data variables.product.prodname_copilot_autofix_short %} for third-party tools**. +1. In the "{% data variables.product.UI_code_security_scanning %}" section, deselect **{% data variables.copilot.copilot_autofix_short %}** or **{% data variables.copilot.copilot_autofix_short %} for third-party tools**. diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign.md b/content/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign.md index be0e02afa9..25366c89a6 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/fixing-alerts-in-security-campaign.md @@ -47,9 +47,9 @@ If you want to see the code that triggered the security alert and the suggested {% ifversion copilot %} -## Using {% data variables.product.prodname_copilot_chat %} for secure coding +## Using {% data variables.copilot.copilot_chat %} for secure coding -If you have access to {% data variables.product.prodname_copilot_chat_short %} then you can ask the AI questions about the vulnerability, the suggested fix, and how to test that the fix is comprehensive. +If you have access to {% data variables.copilot.copilot_chat_short %} then you can ask the AI questions about the vulnerability, the suggested fix, and how to test that the fix is comprehensive. > [!TIP] > {% data reusables.copilot.semantic-index-info %} diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/resolving-code-scanning-alerts.md b/content/code-security/code-scanning/managing-code-scanning-alerts/resolving-code-scanning-alerts.md index 20d8cbe394..a79088e5c1 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/resolving-code-scanning-alerts.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/resolving-code-scanning-alerts.md @@ -26,9 +26,9 @@ topics: {% ifversion copilot-chat-ghas-alerts %} -## Asking {% data variables.product.prodname_copilot_chat %} about {% data variables.product.prodname_code_scanning %} alerts +## Asking {% data variables.copilot.copilot_chat %} about {% data variables.product.prodname_code_scanning %} alerts -With a {% data variables.product.prodname_copilot_enterprise %} license, you can ask {% data variables.product.prodname_copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_code_scanning %} alerts, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can ask {% data variables.copilot.copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_code_scanning %} alerts, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} @@ -36,7 +36,7 @@ With a {% data variables.product.prodname_copilot_enterprise %} license, you can ## Generating suggested fixes for {% data variables.product.prodname_code_scanning %} alerts -{% data variables.product.prodname_copilot_autofix %} can generate fixes for alerts identified by {% data variables.product.prodname_code_scanning %} analysis. Most {% data variables.product.prodname_codeql %} alert types are supported and also some alerts from third-party tools. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +{% data variables.copilot.copilot_autofix %} can generate fixes for alerts identified by {% data variables.product.prodname_code_scanning %} analysis. Most {% data variables.product.prodname_codeql %} alert types are supported and also some alerts from third-party tools. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). {% data reusables.rai.code-scanning.copilot-autofix-note %} @@ -44,7 +44,7 @@ With a {% data variables.product.prodname_copilot_enterprise %} license, you can {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-code-scanning-alerts %} 1. Click the name of an alert. -1. If {% data variables.product.prodname_copilot_autofix_short %} can suggest a fix, at the top of the page, click **{% octicon "shield-check" aria-hidden="true" aria-label="shield-check" %} Generate fix**. +1. If {% data variables.copilot.copilot_autofix_short %} can suggest a fix, at the top of the page, click **{% octicon "shield-check" aria-hidden="true" aria-label="shield-check" %} Generate fix**. 1. Once the suggested fix has been generated, at the bottom of the page, you can click **Create PR with fix** to automatically generate a pull request with the suggested fix. A new branch is created from the default branch, the generated fix is committed and a draft pull request is created. You can test and edit the suggested fix as you would with any other fix. diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning.md b/content/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning.md index 663e2cce56..48670d7f7b 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning.md @@ -16,15 +16,15 @@ redirect_from: - /code-security/code-scanning/managing-code-scanning-alerts/about-autofix-for-codeql-code-scanning --- -## About {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %} +## About {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %} -{% data variables.product.prodname_copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides users with targeted recommendations to help them fix {% data variables.product.prodname_code_scanning %} alerts so they can avoid introducing new security vulnerabilities. The potential fixes are generated automatically by large language models (LLMs) using data from the codebase and from {% data variables.product.prodname_code_scanning %} analysis. {% data variables.product.prodname_copilot_autofix %} is available for {% data variables.product.prodname_codeql %} analysis, and supports the third-party tool ESLint (third-party support is in {% data variables.release-phases.public_preview %} and subject to change). +{% data variables.copilot.copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides users with targeted recommendations to help them fix {% data variables.product.prodname_code_scanning %} alerts so they can avoid introducing new security vulnerabilities. The potential fixes are generated automatically by large language models (LLMs) using data from the codebase and from {% data variables.product.prodname_code_scanning %} analysis. {% data variables.copilot.copilot_autofix %} is available for {% data variables.product.prodname_codeql %} analysis, and supports the third-party tool ESLint (third-party support is in {% data variables.release-phases.public_preview %} and subject to change). {% data reusables.rai.code-scanning.copilot-autofix-note %} -{% data variables.product.prodname_copilot_autofix_short %} generates potential fixes that are relevant to the existing source code and translates the description and location of an alert into code changes that may fix the alert. {% data variables.product.prodname_copilot_autofix_short %} uses internal {% data variables.product.prodname_copilot %} APIs interfacing with the large language model {% data variables.copilot.copilot_gpt_4o %} from OpenAI, which has sufficient generative capabilities to produce both suggested fixes in code and explanatory text for those fixes. +{% data variables.copilot.copilot_autofix_short %} generates potential fixes that are relevant to the existing source code and translates the description and location of an alert into code changes that may fix the alert. {% data variables.copilot.copilot_autofix_short %} uses internal {% data variables.product.prodname_copilot %} APIs interfacing with the large language model {% data variables.copilot.copilot_gpt_4o %} from OpenAI, which has sufficient generative capabilities to produce both suggested fixes in code and explanatory text for those fixes. -{% data variables.product.prodname_copilot_autofix_short %} is allowed by default and enabled for every repository using {% data variables.product.prodname_codeql %}, but you can choose to opt out and disable {% data variables.product.prodname_copilot_autofix_short %}. To learn how to disable {% data variables.product.prodname_copilot_autofix_short %} at the enterprise, organization and repository levels, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/disabling-autofix-for-code-scanning). +{% data variables.copilot.copilot_autofix_short %} is allowed by default and enabled for every repository using {% data variables.product.prodname_codeql %}, but you can choose to opt out and disable {% data variables.copilot.copilot_autofix_short %}. To learn how to disable {% data variables.copilot.copilot_autofix_short %} at the enterprise, organization and repository levels, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/disabling-autofix-for-code-scanning). In an organization's security overview dashboard, you can view the total number of code suggestions generated on open and closed pull requests in the organization for a given time period. For more information, see [AUTOTITLE](/code-security/security-overview/viewing-security-insights#autofix-suggestions). @@ -32,17 +32,17 @@ In an organization's security overview dashboard, you can view the total number {% data variables.product.prodname_code_scanning_caps %} users can already see security alerts to analyze their pull requests. However, developers often have little training in secure coding so fixing these alerts requires substantial effort. They must first read and understand the alert location and description, and then use that understanding to edit the source code to fix the vulnerability. -{% data variables.product.prodname_copilot_autofix_short %} lowers the barrier of entry to developers by combining information on best practices with details of the codebase and alert to suggest a potential fix to the developer. Instead of starting with a search for information about the vulnerability, the developer starts with a code suggestion that demonstrates a potential solution for their codebase. The developer evaluates the potential fix to determine whether it is the best solution for their codebase and to ensure that it maintains the intended behavior. +{% data variables.copilot.copilot_autofix_short %} lowers the barrier of entry to developers by combining information on best practices with details of the codebase and alert to suggest a potential fix to the developer. Instead of starting with a search for information about the vulnerability, the developer starts with a code suggestion that demonstrates a potential solution for their codebase. The developer evaluates the potential fix to determine whether it is the best solution for their codebase and to ensure that it maintains the intended behavior. After committing a suggested fix or modified fix, the developer should always verify that continuous integration testing (CI) for the codebase continues to pass and that the alert is shown as resolved before they merge their pull request. ## Supported languages for {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} -{% data variables.product.prodname_copilot_autofix_short %} supports fix generation for a subset of queries included in the default and security-extended {% data variables.product.prodname_codeql %} query suites for {% data variables.code-scanning.codeql_autofix_languages %}. For more information on these query suites, see [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites#built-in-codeql-query-suites). +{% data variables.copilot.copilot_autofix_short %} supports fix generation for a subset of queries included in the default and security-extended {% data variables.product.prodname_codeql %} query suites for {% data variables.code-scanning.codeql_autofix_languages %}. For more information on these query suites, see [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites#built-in-codeql-query-suites). ## Suggestion generation process -When {% data variables.product.prodname_copilot_autofix_short %} is enabled for a repository, {% data variables.product.prodname_code_scanning %} alerts that are identified send input to the LLM. If the LLM can generate a potential fix, the fix is shown as a suggestion. +When {% data variables.copilot.copilot_autofix_short %} is enabled for a repository, {% data variables.product.prodname_code_scanning %} alerts that are identified send input to the LLM. If the LLM can generate a potential fix, the fix is shown as a suggestion. {% data variables.product.prodname_dotcom %} sends the LLM a variety of data from the {% data variables.product.prodname_code_scanning %} analysis. For example: @@ -52,13 +52,13 @@ When {% data variables.product.prodname_copilot_autofix_short %} is enabled for * First ~10 lines from each file involved in any of those locations. * Help text for the {% data variables.product.prodname_codeql %} query that identified the problem. For examples, see “[{% data variables.product.prodname_codeql %} query help](https://codeql.github.com/codeql-query-help/).” -Any {% data variables.product.prodname_copilot_autofix_short %} suggestions are generated and stored within the {% data variables.product.prodname_code_scanning %} backend. They are displayed as suggestions. No user interaction is needed beyond enabling {% data variables.product.prodname_code_scanning %} on the codebase and creating a pull request. +Any {% data variables.copilot.copilot_autofix_short %} suggestions are generated and stored within the {% data variables.product.prodname_code_scanning %} backend. They are displayed as suggestions. No user interaction is needed beyond enabling {% data variables.product.prodname_code_scanning %} on the codebase and creating a pull request. -The process of generating fixes does not gather or utilize any customer data beyond the scope outlined above. Therefore, the use of this feature is governed by the existing terms and conditions associated with {% data variables.product.prodname_AS %}. Moreover, data handled by {% data variables.product.prodname_copilot_autofix_short %} is strictly not employed for LLM training purposes. For more information on {% data variables.product.prodname_AS %} terms and conditions, see [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#advanced-security){% ifversion fpt %}.{% else %} in the Free, Pro, & Team documentation.{% endif %} +The process of generating fixes does not gather or utilize any customer data beyond the scope outlined above. Therefore, the use of this feature is governed by the existing terms and conditions associated with {% data variables.product.prodname_AS %}. Moreover, data handled by {% data variables.copilot.copilot_autofix_short %} is strictly not employed for LLM training purposes. For more information on {% data variables.product.prodname_AS %} terms and conditions, see [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#advanced-security){% ifversion fpt %}.{% else %} in the Free, Pro, & Team documentation.{% endif %} ## Quality of suggestions -{% data variables.product.prodname_dotcom %} uses an automated test harness to continuously monitor the quality of suggestions from {% data variables.product.prodname_copilot_autofix_short %}. This allows us to understand how the suggestions generated by the LLM change as the model develops. +{% data variables.product.prodname_dotcom %} uses an automated test harness to continuously monitor the quality of suggestions from {% data variables.copilot.copilot_autofix_short %}. This allows us to understand how the suggestions generated by the LLM change as the model develops. The test harness includes a set of over 2,300 alerts from a diverse set of public repositories where the highlighted code has test coverage. Suggestions for these alerts are tested to see how good they are, that is, how much a developer would need to edit them before committing them to the codebase. For many of the test alerts, suggestions generated by the LLM could be committed as-is to fix the alert while continuing to successfully pass all the existing CI tests. @@ -77,20 +77,20 @@ In addition, we spot check many of the successful suggestions and verify that th ### Effectiveness on other projects -The test set contains a broad range of different types of projects and alerts. We predict that suggestions for other projects using languages supported by {% data variables.product.prodname_copilot_autofix_short %} should follow a similar pattern. +The test set contains a broad range of different types of projects and alerts. We predict that suggestions for other projects using languages supported by {% data variables.copilot.copilot_autofix_short %} should follow a similar pattern. -* {% data variables.product.prodname_copilot_autofix_short %} is likely to add a code suggestion to the majority of alerts. +* {% data variables.copilot.copilot_autofix_short %} is likely to add a code suggestion to the majority of alerts. * When developers evaluate the suggestions we expect that the majority of fixes can be committed without editing or with minor updates to reflect the wider context of the code. * A small percentage of suggested fixes will reflect a significant misunderstanding of the codebase or the vulnerability. -However, each project and codebase is unique, so developers may need to edit a larger percentage of suggested fixes before committing them. {% data variables.product.prodname_copilot_autofix_short %} provides valuable information to help you resolve {% data variables.product.prodname_code_scanning %} alerts, but ultimately it remains your responsibility to evaluate the proposed change and ensure the security and accuracy of your code. +However, each project and codebase is unique, so developers may need to edit a larger percentage of suggested fixes before committing them. {% data variables.copilot.copilot_autofix_short %} provides valuable information to help you resolve {% data variables.product.prodname_code_scanning %} alerts, but ultimately it remains your responsibility to evaluate the proposed change and ensure the security and accuracy of your code. > [!NOTE] > Fix generation for supported languages is subject to LLM operational capacity. In addition, each suggested fix is tested before it is added to a pull request. If no suggestion is available, or if the suggested fix fails internal testing, then no suggestion is displayed. ## Limitations of suggestions -When you review a suggestion from {% data variables.product.prodname_copilot_autofix_short %}, you must always consider the limitations of AI and edit the changes as needed before you accept the changes. You should also consider updating the CI testing and dependency management for a repository before enabling {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %}. For more information, see [Mitigating the limitations of suggestions](#mitigating-the-limitations-of-suggestions). +When you review a suggestion from {% data variables.copilot.copilot_autofix_short %}, you must always consider the limitations of AI and edit the changes as needed before you accept the changes. You should also consider updating the CI testing and dependency management for a repository before enabling {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %}. For more information, see [Mitigating the limitations of suggestions](#mitigating-the-limitations-of-suggestions). ### Limitations of code suggestions @@ -111,7 +111,7 @@ Sometimes a suggested fix includes a change in the dependencies of the codebase. ## Mitigating the limitations of suggestions -The best way to mitigate the limitations of suggestions from {% data variables.product.prodname_copilot_autofix_short %} is to follow best practices. For example, using CI testing of pull requests to verify functional requirements are unaffected and using dependency management solutions, such as the dependency review API and action. For more information, see “[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review).” +The best way to mitigate the limitations of suggestions from {% data variables.copilot.copilot_autofix_short %} is to follow best practices. For example, using CI testing of pull requests to verify functional requirements are unaffected and using dependency management solutions, such as the dependency review API and action. For more information, see “[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review).” It is important to remember that the author of a pull request retains responsibility for how they respond to review comments and suggested code changes, whether proposed by colleagues or automated tools. Developers should always look at suggestions for code changes critically. If needed, they should edit the suggested changes to ensure that the resulting code and application are correct, secure, meet performance criteria, and satisfy all other functional and non-functional requirements for the application. diff --git a/content/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests.md b/content/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests.md index 73836a2f8d..f7ef03ccc6 100644 --- a/content/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests.md +++ b/content/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests.md @@ -38,7 +38,7 @@ If the lines of code changed in the pull request generate {% data variables.prod {% ifversion code-scanning-autofix %} -{% data variables.product.prodname_copilot_autofix %} will suggest fixes for alerts from {% data variables.product.prodname_code_scanning %} analysis (including {% data variables.product.prodname_codeql %} analysis) in private repositories. For more information on working with suggestions from {% data variables.product.prodname_copilot_autofix_short %} in pull requests, see [Working with {% data variables.product.prodname_copilot_autofix_short %} suggestions for alerts on a pull request](#working-with-copilot-autofix-suggestions-for-alerts-on-a-pull-request). +{% data variables.copilot.copilot_autofix %} will suggest fixes for alerts from {% data variables.product.prodname_code_scanning %} analysis (including {% data variables.product.prodname_codeql %} analysis) in private repositories. For more information on working with suggestions from {% data variables.copilot.copilot_autofix_short %} in pull requests, see [Working with {% data variables.copilot.copilot_autofix_short %} suggestions for alerts on a pull request](#working-with-copilot-autofix-suggestions-for-alerts-on-a-pull-request). {% endif %} @@ -50,7 +50,7 @@ If your pull request targets a protected branch that uses {% data variables.prod {% ifversion copilot-chat-ghas-alerts %} -With a {% data variables.product.prodname_copilot_enterprise %} license, you can also ask {% data variables.product.prodname_copilot_chat %} for help to better understand {% data variables.product.prodname_code_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can also ask {% data variables.copilot.copilot_chat %} for help to better understand {% data variables.product.prodname_code_scanning %} alerts in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} @@ -114,30 +114,30 @@ Anyone with push access to a pull request can fix a {% data variables.product.pr {% ifversion code-scanning-autofix %} -## Working with {% data variables.product.prodname_copilot_autofix_short %} suggestions for alerts on a pull request +## Working with {% data variables.copilot.copilot_autofix_short %} suggestions for alerts on a pull request -{% data variables.product.prodname_copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides you with targeted recommendations to help you fix {% data variables.product.prodname_code_scanning %} alerts (including {% data variables.product.prodname_codeql %} alerts) in pull requests. The potential fixes are generated automatically by large language models (LLMs) using data from the codebase, the pull request, and from {% data variables.product.prodname_code_scanning %} analysis. +{% data variables.copilot.copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides you with targeted recommendations to help you fix {% data variables.product.prodname_code_scanning %} alerts (including {% data variables.product.prodname_codeql %} alerts) in pull requests. The potential fixes are generated automatically by large language models (LLMs) using data from the codebase, the pull request, and from {% data variables.product.prodname_code_scanning %} analysis. {% data reusables.rai.code-scanning.copilot-autofix-note %} ![Screenshot of the check failure for a {% data variables.product.prodname_code_scanning %} alert in a pull request. Part of the "autofix" suggestion is outlined in dark orange.](/assets/images/help/code-scanning/alert+autofix.png) -### Generating {% data variables.product.prodname_copilot_autofix_short %} suggestions and publishing to a pull request +### Generating {% data variables.copilot.copilot_autofix_short %} suggestions and publishing to a pull request -When {% data variables.product.prodname_copilot_autofix_short %} is enabled for a repository, alerts are displayed in pull requests as normal and information from any alerts found by {% data variables.product.prodname_code_scanning %} is automatically sent to the LLM for processing. When LLM analysis is complete, any results are published as comments on relevant alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +When {% data variables.copilot.copilot_autofix_short %} is enabled for a repository, alerts are displayed in pull requests as normal and information from any alerts found by {% data variables.product.prodname_code_scanning %} is automatically sent to the LLM for processing. When LLM analysis is complete, any results are published as comments on relevant alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). > [!NOTE] -> * {% data variables.product.prodname_copilot_autofix_short %} supports a subset of {% data variables.product.prodname_codeql %} queries. For information about the availability of {% data variables.product.prodname_copilot_autofix_short %}, see the query tables linked from [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites#query-lists-for-the-default-query-suites). -> * When analysis is complete, all relevant results are published to the pull request at once. If at least one alert in your pull request has an {% data variables.product.prodname_copilot_autofix_short %} suggestion, you should assume that the LLM has finished identifying potential fixes for your code. -> * On alerts generated from queries that are not supported by {% data variables.product.prodname_copilot_autofix_short %}, you will see a note telling you that the query is not supported. If a suggestion for a supported query fails to generate, you will see a note on the alert prompting you to try pushing another commit or to contact support. +> * {% data variables.copilot.copilot_autofix_short %} supports a subset of {% data variables.product.prodname_codeql %} queries. For information about the availability of {% data variables.copilot.copilot_autofix_short %}, see the query tables linked from [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites#query-lists-for-the-default-query-suites). +> * When analysis is complete, all relevant results are published to the pull request at once. If at least one alert in your pull request has an {% data variables.copilot.copilot_autofix_short %} suggestion, you should assume that the LLM has finished identifying potential fixes for your code. +> * On alerts generated from queries that are not supported by {% data variables.copilot.copilot_autofix_short %}, you will see a note telling you that the query is not supported. If a suggestion for a supported query fails to generate, you will see a note on the alert prompting you to try pushing another commit or to contact support. -Usually, when you suggest changes to a pull request, your comment contains changes for a single file that is changed in the pull request. The following screenshot shows an {% data variables.product.prodname_copilot_autofix_short %} comment that suggests changes to the `index.js` file where the alert is displayed. Since the potential fix requires a new dependency on `escape-html`, the comment also suggests adding this dependency to the `package.json` file, even though the original pull request makes no changes to this file. +Usually, when you suggest changes to a pull request, your comment contains changes for a single file that is changed in the pull request. The following screenshot shows an {% data variables.copilot.copilot_autofix_short %} comment that suggests changes to the `index.js` file where the alert is displayed. Since the potential fix requires a new dependency on `escape-html`, the comment also suggests adding this dependency to the `package.json` file, even though the original pull request makes no changes to this file. -![Screenshot of {% data variables.product.prodname_copilot_autofix_short %} suggestion to edit the current file. A suggested change in "package.json" is outlined in dark orange.](/assets/images/help/code-scanning/autofix-example.png) +![Screenshot of {% data variables.copilot.copilot_autofix_short %} suggestion to edit the current file. A suggested change in "package.json" is outlined in dark orange.](/assets/images/help/code-scanning/autofix-example.png) -### Assessing and committing an {% data variables.product.prodname_copilot_autofix_short %} suggestion +### Assessing and committing an {% data variables.copilot.copilot_autofix_short %} suggestion -Each {% data variables.product.prodname_copilot_autofix_short %} suggestion demonstrates a potential solution for a {% data variables.product.prodname_code_scanning %} alert in your codebase. You must assess the suggested changes to determine whether they are a good solution for your codebase and to ensure that they maintain the intended behavior. For information about the limitations of {% data variables.product.prodname_copilot_autofix_short %} suggestions, see [Limitations of suggestions](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning#limitations-of-suggestions) and [Mitigating the limitations of suggestions](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning#mitigating-the-limitations-of-suggestions) in "Responsible use of {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %}." +Each {% data variables.copilot.copilot_autofix_short %} suggestion demonstrates a potential solution for a {% data variables.product.prodname_code_scanning %} alert in your codebase. You must assess the suggested changes to determine whether they are a good solution for your codebase and to ensure that they maintain the intended behavior. For information about the limitations of {% data variables.copilot.copilot_autofix_short %} suggestions, see [Limitations of suggestions](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning#limitations-of-suggestions) and [Mitigating the limitations of suggestions](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning#mitigating-the-limitations-of-suggestions) in "Responsible use of {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_code_scanning %}." 1. Click **Edit** to display the editing options and select your preferred method. * Under **Edit with {% data variables.product.prodname_cli %}**, follow the instructions for checking out the pull request locally and applying the suggested fix. @@ -152,9 +152,9 @@ Each {% data variables.product.prodname_copilot_autofix_short %} suggestion demo 1. When you have finished testing your changes, commit the changes, and push them to your branch. 1. Pushing the changes to your branch will trigger all the usual tests for your pull request. Confirm that your unit tests still pass and that the {% data variables.product.prodname_code_scanning %} alert is now fixed. -### Dismissing a {% data variables.product.prodname_copilot_autofix_short %} suggestion +### Dismissing a {% data variables.copilot.copilot_autofix_short %} suggestion -If you decide to reject a {% data variables.product.prodname_copilot_autofix_short %} suggestion, click **Dismiss suggestion** in the comment to dismiss the suggested fix. +If you decide to reject a {% data variables.copilot.copilot_autofix_short %} suggestion, click **Dismiss suggestion** in the comment to dismiss the suggested fix. {% endif %} diff --git a/content/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites.md b/content/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites.md index 51b941e26e..427ff2877f 100644 --- a/content/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites.md +++ b/content/code-security/code-scanning/managing-your-code-scanning-configuration/codeql-query-suites.md @@ -45,7 +45,7 @@ The built-in {% data variables.product.prodname_codeql %} query suites, `default ## Query lists for the default query suites -For each language, the following article lists which queries are included in the `default` and the `security-extended` suites. {% ifversion code-scanning-autofix %}Where {% data variables.product.prodname_copilot_autofix_short %} is available for a language, details of which queries are supported are also included.{% endif %} +For each language, the following article lists which queries are included in the `default` and the `security-extended` suites. {% ifversion code-scanning-autofix %}Where {% data variables.copilot.copilot_autofix_short %} is available for a language, details of which queries are supported are also included.{% endif %} {% data reusables.code-scanning.codeql-query-tables.links-to-all-tables %} diff --git a/content/code-security/dependabot/dependabot-alerts/about-dependabot-alerts.md b/content/code-security/dependabot/dependabot-alerts/about-dependabot-alerts.md index f8e24d5397..af2783255d 100644 --- a/content/code-security/dependabot/dependabot-alerts/about-dependabot-alerts.md +++ b/content/code-security/dependabot/dependabot-alerts/about-dependabot-alerts.md @@ -93,9 +93,9 @@ You can also see all the {% data variables.product.prodname_dependabot_alerts %} {% ifversion copilot-chat-ghas-alerts %} -## Asking {% data variables.product.prodname_copilot_chat %} about {% data variables.product.prodname_dependabot_alerts %} +## Asking {% data variables.copilot.copilot_chat %} about {% data variables.product.prodname_dependabot_alerts %} -With a {% data variables.product.prodname_copilot_enterprise %} license, you can ask {% data variables.product.prodname_copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_dependabot_alerts %}, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can ask {% data variables.copilot.copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_dependabot_alerts %}, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md b/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md index 70b1b7923d..774d464fec 100644 --- a/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md +++ b/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md @@ -94,7 +94,7 @@ In cases where a patched version is not available, or you can’t update to the {% ifversion copilot-chat-ghas-alerts %} -With a {% data variables.product.prodname_copilot_enterprise %} license, you can also ask {% data variables.product.prodname_copilot_chat %} for help to better understand {% data variables.product.prodname_dependabot_alerts %} in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can also ask {% data variables.copilot.copilot_chat %} for help to better understand {% data variables.product.prodname_dependabot_alerts %} in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/getting-started/github-security-features.md b/content/code-security/getting-started/github-security-features.md index 9ceed55dc8..4b900a1f8f 100644 --- a/content/code-security/getting-started/github-security-features.md +++ b/content/code-security/getting-started/github-security-features.md @@ -210,7 +210,7 @@ Run {% data variables.product.prodname_codeql %} processes locally on software p {% ifversion code-scanning-autofix %} -### {% data variables.product.prodname_copilot_autofix_short %} +### {% data variables.copilot.copilot_autofix_short %} Get automatically generated fixes for {% data variables.product.prodname_code_scanning %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). @@ -242,9 +242,9 @@ Security overview allows you to review the overall security landscape of your or {% ifversion copilot-chat-ghas-alerts %} -## Leveraging {% data variables.product.prodname_copilot_chat %} to understand security alerts +## Leveraging {% data variables.copilot.copilot_chat %} to understand security alerts -With a {% data variables.product.prodname_copilot_enterprise %} license, you can also ask {% data variables.product.prodname_copilot_chat %} for help to better understand security alerts in repositories in your organization from {% data variables.product.prodname_GHAS %} features ({% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_secret_scanning %}, and {% data variables.product.prodname_dependabot_alerts %}). For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can also ask {% data variables.copilot.copilot_chat %} for help to better understand security alerts in repositories in your organization from {% data variables.product.prodname_GHAS %} features ({% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_secret_scanning %}, and {% data variables.product.prodname_dependabot_alerts %}). For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/getting-started/quickstart-for-securing-your-repository.md b/content/code-security/getting-started/quickstart-for-securing-your-repository.md index 6ce362b87c..14c65cf448 100644 --- a/content/code-security/getting-started/quickstart-for-securing-your-repository.md +++ b/content/code-security/getting-started/quickstart-for-securing-your-repository.md @@ -116,7 +116,7 @@ To enable {% data variables.product.prodname_dependabot_version_updates %}, you > {% data variables.product.prodname_code_security %} features are available for all public repositories, and for private repositories owned by organizations that are part of a team or an enterprise that uses {% data variables.product.prodname_GH_code_security %} or {% data variables.product.prodname_GHAS %}. {% endif %} -{% ifversion ghas-products %}{% data variables.product.prodname_GH_code_security %} includes {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_codeql_cli %} and {% data variables.product.prodname_copilot_autofix_short %}, as well as other features that find and fix vulnerabilities in your codebase.{% endif %} +{% ifversion ghas-products %}{% data variables.product.prodname_GH_code_security %} includes {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_codeql_cli %} and {% data variables.copilot.copilot_autofix_short %}, as well as other features that find and fix vulnerabilities in your codebase.{% endif %} You can configure {% data variables.product.prodname_code_scanning %} to automatically identify vulnerabilities and errors in the code stored in your repository by using a {% data variables.code-scanning.codeql_workflow %} or third-party tool. Depending on the programming languages in your repository, you can configure {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %} using default setup, in which {% data variables.product.github %} automatically determines the languages to scan, query suites to run, and events that will trigger a new scan. For more information, see [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning). @@ -126,7 +126,7 @@ You can configure {% data variables.product.prodname_code_scanning %} to automat 1. To the right of "CodeQL analysis", select **Set up** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %}, then click **Default**.{% else %} 1. In the "{% data variables.product.prodname_code_scanning_caps %}" section, select **Set up** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %}, then click **Default**.{% endif %} 1. In the pop-up window that appears, review the default configuration settings for your repository, then click **Enable {% data variables.product.prodname_codeql %}**.{% ifversion code-scanning-autofix %} -1. Choose whether you want to enable addition features, such as {% data variables.product.prodname_copilot_autofix_short %}.{% endif %} +1. Choose whether you want to enable addition features, such as {% data variables.copilot.copilot_autofix_short %}.{% endif %} As an alternative to default setup, you can use advanced setup, which generates a workflow file you can edit to customize your {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}. For more information, see [AUTOTITLE](/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/configuring-advanced-setup-for-code-scanning#configuring-advanced-setup-for-code-scanning-with-codeql). diff --git a/content/code-security/secret-scanning/managing-alerts-from-secret-scanning/evaluating-alerts.md b/content/code-security/secret-scanning/managing-alerts-from-secret-scanning/evaluating-alerts.md index 3c7b927184..5a0b220d5f 100644 --- a/content/code-security/secret-scanning/managing-alerts-from-secret-scanning/evaluating-alerts.md +++ b/content/code-security/secret-scanning/managing-alerts-from-secret-scanning/evaluating-alerts.md @@ -47,9 +47,9 @@ You can use the REST API to retrieve a list of the most recent validation status {% ifversion copilot-chat-ghas-alerts %} -## Asking {% data variables.product.prodname_copilot_chat %} about {% data variables.product.prodname_secret_scanning %} alerts +## Asking {% data variables.copilot.copilot_chat %} about {% data variables.product.prodname_secret_scanning %} alerts -With a {% data variables.product.prodname_copilot_enterprise %} license, you can ask {% data variables.product.prodname_copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_secret_scanning %} alerts, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +With a {% data variables.copilot.copilot_enterprise %} license, you can ask {% data variables.copilot.copilot_chat_short %} for help to better understand security alerts, including {% data variables.product.prodname_secret_scanning %} alerts, in repositories in your organization. For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} diff --git a/content/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization.md b/content/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization.md index beec079c62..6f488832b6 100644 --- a/content/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization.md +++ b/content/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization.md @@ -75,8 +75,8 @@ To update private dependencies of repositories in your organization, {% data var You can customize several {% data variables.product.prodname_global_settings %} for {% data variables.product.prodname_code_scanning %}: {% ifversion code-scanning-autofix %} -* [Enabling {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_codeql %}](#enabling-copilot-autofix-for-codeql) -* [Enabling {% data variables.product.prodname_copilot_autofix_short %} for third-party {% data variables.product.prodname_code_scanning %} tools](#enabling-copilot-autofix-for-third-party-code-scanning-tools) {% endif %} +* [Enabling {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_codeql %}](#enabling-copilot-autofix-for-codeql) +* [Enabling {% data variables.copilot.copilot_autofix_short %} for third-party {% data variables.product.prodname_code_scanning %} tools](#enabling-copilot-autofix-for-third-party-code-scanning-tools) {% endif %} * [Recommending the extended query suite for default setup](#recommending-the-extended-query-suite-for-default-setup){% ifversion ghes < 3.17 %} * [Setting a failure threshold for {% data variables.product.prodname_code_scanning %} checks in pull requests](#setting-a-failure-threshold-for-code-scanning-checks-in-pull-requests){% endif %} @@ -88,16 +88,16 @@ You can customize several {% data variables.product.prodname_global_settings %} {% ifversion code-scanning-autofix %} -### Enabling {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_codeql %} +### Enabling {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_codeql %} -You can select **{% data variables.product.prodname_copilot_autofix_short %}** to enable {% data variables.product.prodname_copilot_autofix_short %} for all the repositories in your organization that use {% data variables.product.prodname_codeql %} default setup or {% data variables.product.prodname_codeql %} advanced setup. {% data variables.product.prodname_copilot_autofix_short %} is an expansion of {% data variables.product.prodname_code_scanning %} that suggests fixes for {% data variables.product.prodname_code_scanning %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +You can select **{% data variables.copilot.copilot_autofix_short %}** to enable {% data variables.copilot.copilot_autofix_short %} for all the repositories in your organization that use {% data variables.product.prodname_codeql %} default setup or {% data variables.product.prodname_codeql %} advanced setup. {% data variables.copilot.copilot_autofix_short %} is an expansion of {% data variables.product.prodname_code_scanning %} that suggests fixes for {% data variables.product.prodname_code_scanning %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). -### Enabling {% data variables.product.prodname_copilot_autofix_short %} for third-party {% data variables.product.prodname_code_scanning %} tools +### Enabling {% data variables.copilot.copilot_autofix_short %} for third-party {% data variables.product.prodname_code_scanning %} tools >[!NOTE] > Third-party {% data variables.product.prodname_code_scanning %} tool support is in {% data variables.release-phases.public_preview %}, and subject to change. Currently, the third-party tool ESLint is supported. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). -You can select **{% data variables.product.prodname_copilot_autofix_short %} for third-party tools** to enable {% data variables.product.prodname_copilot_autofix_short %} for all the repositories in your organization that use third-party tools. {% data variables.product.prodname_copilot_autofix_short %} is an expansion of {% data variables.product.prodname_code_scanning %} that suggests fixes for {% data variables.product.prodname_code_scanning %} alerts. +You can select **{% data variables.copilot.copilot_autofix_short %} for third-party tools** to enable {% data variables.copilot.copilot_autofix_short %} for all the repositories in your organization that use third-party tools. {% data variables.copilot.copilot_autofix_short %} is an expansion of {% data variables.product.prodname_code_scanning %} that suggests fixes for {% data variables.product.prodname_code_scanning %} alerts. {% endif %} diff --git a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/about-security-campaigns.md b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/about-security-campaigns.md index 155323ff34..b818de4098 100644 --- a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/about-security-campaigns.md +++ b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/about-security-campaigns.md @@ -31,7 +31,7 @@ A security campaign has many benefits over other ways of encouraging developers * Developers are notified about any security campaigns taking place in repositories they work in or subscribe to by email. * Developers can see the alerts you've highlighted for remediation without leaving their normal workflows. * Each campaign has a named point of contact for questions, reviews, and collaboration. {% ifversion security-campaigns-autofix %} -* {% data variables.product.prodname_copilot_autofix %} is automatically triggered to suggest a resolution for each security alert. {% endif %} +* {% data variables.copilot.copilot_autofix %} is automatically triggered to suggest a resolution for each security alert. {% endif %} You can use one of the templates to select a group of closely related alerts for a campaign. This allows developers to build on the knowledge gained by resolving one alert and use it to fix several more, providing them with an incentive to fix multiple alerts. diff --git a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/best-practice-fix-alerts-at-scale.md b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/best-practice-fix-alerts-at-scale.md index ecb99765c6..98a829db7b 100644 --- a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/best-practice-fix-alerts-at-scale.md +++ b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/best-practice-fix-alerts-at-scale.md @@ -18,10 +18,10 @@ topics: Successful security campaigns to fix alerts at scale have many features in common, including: * Selecting a related group of security alerts for remediation. -* Using {% data variables.product.prodname_copilot_autofix_short %} suggestions where possible to help developers remediate alerts faster and more effectively. +* Using {% data variables.copilot.copilot_autofix_short %} suggestions where possible to help developers remediate alerts faster and more effectively. * Making sure that the campaign managers are available for collaboration, reviews, and questions about fixes. * Providing access to educational information about the type of alerts included in the campaign.{% ifversion ghec %} -* Making {% data variables.product.prodname_copilot_chat %} available for developers to use to learn about the vulnerabilities highlighted by the security alerts in the campaign. {% endif %} +* Making {% data variables.copilot.copilot_chat %} available for developers to use to learn about the vulnerabilities highlighted by the security alerts in the campaign. {% endif %} * Defining a realistic deadline for campaign, bearing in mind the number of alerts you aim to fix. * Publicizing the collaboration to developer teams and identifying the best way to engage them for your organization. @@ -38,9 +38,9 @@ For example, if you have many alerts for cross-site scripting vulnerabilities, y * Hold a training session or other event to highlight this opportunity to gain confidence in secure coding while fixing real bugs. * Make sure that the security team members assigned to manage the campaign are available to review the pull requests created to fix the campaign alerts, collaborating as needed. -### Using {% data variables.product.prodname_copilot_autofix_short %} to help remediate security alerts +### Using {% data variables.copilot.copilot_autofix_short %} to help remediate security alerts -{% data variables.product.prodname_copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides users with targeted recommendations to help fix {% data variables.product.prodname_code_scanning %} alerts. When you select alerts to include in a security campaign, you can preferentially include alerts that are eligible to be fixed with the help of {% data variables.product.prodname_copilot_autofix %} using the `autofix:supported` filter. +{% data variables.copilot.copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides users with targeted recommendations to help fix {% data variables.product.prodname_code_scanning %} alerts. When you select alerts to include in a security campaign, you can preferentially include alerts that are eligible to be fixed with the help of {% data variables.copilot.copilot_autofix %} using the `autofix:supported` filter. ### Campaign filter templates @@ -85,7 +85,7 @@ The OWASP Foundation provides many resources for learning about the most common ## Providing AI support for learning about security vulnerabilities -{% data variables.product.prodname_copilot_autofix %} is automatically triggered to suggest a resolution for each security alert. However, developers will often want more information about why the original code is insecure and how to test that the fix is correct and doesn't break other components. +{% data variables.copilot.copilot_autofix %} is automatically triggered to suggest a resolution for each security alert. However, developers will often want more information about why the original code is insecure and how to test that the fix is correct and doesn't break other components. {% data variables.product.prodname_copilot %} is an important tool for developers who have questions about secure coding, how to fix security alerts, and test their fix. Check that all developers in your organization have access to {% data variables.product.prodname_copilot_short %} in both their IDE and {% data variables.product.github %}, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization). diff --git a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/creating-managing-security-campaigns.md b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/creating-managing-security-campaigns.md index c158c04519..970e00a180 100644 --- a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/creating-managing-security-campaigns.md +++ b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/creating-managing-security-campaigns.md @@ -22,7 +22,7 @@ Security campaigns are created and managed from the **Security** tab for your or You choose the alerts that you want to include in the campaign by using either: - * **Campaign templates**: Campaign templates contain filters for the most common alert selections. {% ifversion security-campaigns-autofix %}They also all include the requirement that {% data variables.product.prodname_copilot_autofix %} is supported for all the alert types included (that is, `autofix:supported`).{% endif %} + * **Campaign templates**: Campaign templates contain filters for the most common alert selections. {% ifversion security-campaigns-autofix %}They also all include the requirement that {% data variables.copilot.copilot_autofix %} is supported for all the alert types included (that is, `autofix:supported`).{% endif %} * **Custom filters**: Creating a campaign using custom filters lets you define your own criteria for selecting alerts for the campaign, and lets you tailor your campaign to your organization's specific needs. {% data reusables.code-scanning.campaigns-api %} @@ -70,7 +70,7 @@ All the template filters include the following useful filters: * `is:open` includes only alerts that are open in the default branch. * `autofilter:true` includes only alerts that appear to be in application code. {% ifversion security-campaigns-autofix %} -* `autofix:supported` includes only alerts that are for rules that are supported for {% data variables.product.prodname_copilot_autofix %}.{% endif %} +* `autofix:supported` includes only alerts that are for rules that are supported for {% data variables.copilot.copilot_autofix %}.{% endif %} Once you include these core filters, you will usually want to add a filter to limit results to a specific rule name, severity, or tag. For example: @@ -88,7 +88,7 @@ For more information about filtering alerts, see [AUTOTITLE](/code-security/secu {% ifversion security-campaigns-autofix %} -When you create a campaign, all the alerts are automatically submitted to {% data variables.product.prodname_copilot_autofix %} to be processed as capacity allows. This ensures that suggestions for alerts found in pull requests aren't delayed by a new campaign. In most cases, you should find that all suggestions that can be created are ready within an hour. At busy times of day, or for particularly complex alerts, it will take longer. +When you create a campaign, all the alerts are automatically submitted to {% data variables.copilot.copilot_autofix %} to be processed as capacity allows. This ensures that suggestions for alerts found in pull requests aren't delayed by a new campaign. In most cases, you should find that all suggestions that can be created are ready within an hour. At busy times of day, or for particularly complex alerts, it will take longer. {% endif %} diff --git a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/tracking-security-campaigns.md b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/tracking-security-campaigns.md index 53660c174e..796633c68d 100644 --- a/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/tracking-security-campaigns.md +++ b/content/code-security/securing-your-organization/fixing-security-alerts-at-scale/tracking-security-campaigns.md @@ -46,7 +46,7 @@ The tracking view shows you a summary of: * **Campaign progress**: how many alerts are closed (fixed or dismissed), in progress, or still left to review. * **Status**: how the campaign is progressing towards its due date. -* **{% data variables.product.prodname_copilot_autofix_short %}**: number of alerts where {% data variables.product.prodname_copilot_autofix_short %} can generate a fix to resolve the alert. +* **{% data variables.copilot.copilot_autofix_short %}**: number of alerts where {% data variables.copilot.copilot_autofix_short %} can generate a fix to resolve the alert. You can also explore the campaign repositories and alerts to see where teams are engaging in the campaign, and where teams might need some extra encouragement to take part. diff --git a/content/code-security/security-overview/viewing-metrics-for-pull-request-alerts.md b/content/code-security/security-overview/viewing-metrics-for-pull-request-alerts.md index 8855ab467d..9e274abc13 100644 --- a/content/code-security/security-overview/viewing-metrics-for-pull-request-alerts.md +++ b/content/code-security/security-overview/viewing-metrics-for-pull-request-alerts.md @@ -23,7 +23,7 @@ The metrics overview for {% data variables.product.prodname_codeql %} pull reque The overview shows you a summary of how many vulnerabilities prevented by {% data variables.product.prodname_codeql %} have been caught in pull requests. The metrics are only tracked for pull requests that have been merged into the default branches of repositories in your organizations. -You can also find more granular metrics, such as how many alerts were fixed{% ifversion code-scanning-autofix %} with and without {% data variables.product.prodname_copilot_autofix_short %} suggestions{% endif %}, how many were unresolved and merged, and how many were dismissed as false positive or as risk accepted. +You can also find more granular metrics, such as how many alerts were fixed{% ifversion code-scanning-autofix %} with and without {% data variables.copilot.copilot_autofix_short %} suggestions{% endif %}, how many were unresolved and merged, and how many were dismissed as false positive or as risk accepted. You can also view: @@ -32,17 +32,17 @@ You can also view: * The number of alerts that were merged into the default branch without resolution, and the number of alerts dismissed as an acceptable risk. {% ifversion code-scanning-autofix %} -* The number of alerts that were fixed with an accepted {% data variables.product.prodname_copilot_autofix_short %} suggestion, displayed as a fraction of how many total {% data variables.product.prodname_copilot_autofix_short %} suggestions were available. +* The number of alerts that were fixed with an accepted {% data variables.copilot.copilot_autofix_short %} suggestion, displayed as a fraction of how many total {% data variables.copilot.copilot_autofix_short %} suggestions were available. -* Remediation rates, in a graph showing the percentage of alerts that were remediated with an available {% data variables.product.prodname_copilot_autofix_short %} suggestion, and the percentage of alerts that were remediated without a {% data variables.product.prodname_copilot_autofix_short %} suggestion. +* Remediation rates, in a graph showing the percentage of alerts that were remediated with an available {% data variables.copilot.copilot_autofix_short %} suggestion, and the percentage of alerts that were remediated without a {% data variables.copilot.copilot_autofix_short %} suggestion. {% endif %} You can apply filters to the data. The metrics are based on activity from the default period or your selected period. {% ifversion code-scanning-autofix %} -> [!NOTE] Metrics for {% data variables.product.prodname_copilot_autofix_short %} will be shown only for repositories where {% data variables.product.prodname_copilot_autofix_short %} is enabled. +> [!NOTE] Metrics for {% data variables.copilot.copilot_autofix_short %} will be shown only for repositories where {% data variables.copilot.copilot_autofix_short %} is enabled. {% else %} -> [!NOTE] Metrics for {% data variables.product.prodname_copilot_autofix_short %} are omitted because {% data variables.product.prodname_copilot_autofix_short %} is available only on {% data variables.product.github %} cloud platforms. +> [!NOTE] Metrics for {% data variables.copilot.copilot_autofix_short %} are omitted because {% data variables.copilot.copilot_autofix_short %} is available only on {% data variables.product.github %} cloud platforms. {% endif %} ## Viewing {% data variables.product.prodname_codeql %} pull request alerts metrics for an organization diff --git a/content/code-security/security-overview/viewing-security-insights.md b/content/code-security/security-overview/viewing-security-insights.md index fce6d06d2f..59e95840d5 100644 --- a/content/code-security/security-overview/viewing-security-insights.md +++ b/content/code-security/security-overview/viewing-security-insights.md @@ -198,7 +198,7 @@ Green bars represent the number of new alerts created during the segmented time * [Introduced versus prevented](#introduced-versus-prevented) * [Vulnerabilities fixed in pull requests](#vulnerabilities-fixed-in-pull-requests){% ifversion code-scanning-autofix %} -* [{% data variables.product.prodname_copilot_autofix_short %} suggestions](##pull-request-alerts-fixed-with-copilot-autofix-suggestions){% endif %} +* [{% data variables.copilot.copilot_autofix_short %} suggestions](##pull-request-alerts-fixed-with-copilot-autofix-suggestions){% endif %} #### Introduced versus prevented @@ -212,11 +212,11 @@ The "Vulnerabilities fixed in pull requests" metric shows the count of pull requ {% ifversion code-scanning-autofix %} -#### Pull request alerts fixed with {% data variables.product.prodname_copilot_autofix_short %} suggestions +#### Pull request alerts fixed with {% data variables.copilot.copilot_autofix_short %} suggestions -{% data variables.product.prodname_copilot_autofix %} for {% data variables.product.prodname_code_scanning %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides you with targeted recommendations to help you fix {% data variables.product.prodname_code_scanning %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +{% data variables.copilot.copilot_autofix %} for {% data variables.product.prodname_code_scanning %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides you with targeted recommendations to help you fix {% data variables.product.prodname_code_scanning %} alerts. For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). -The "Pull request alerts fixed with autofix suggestions" metric shows the ratio of accepted {% data variables.product.prodname_copilot_autofix_short %} suggestions to the total number of {% data variables.product.prodname_copilot_autofix_short %} suggestions on pull request alerts detected by {% data variables.product.prodname_code_scanning %}. +The "Pull request alerts fixed with autofix suggestions" metric shows the ratio of accepted {% data variables.copilot.copilot_autofix_short %} suggestions to the total number of {% data variables.copilot.copilot_autofix_short %} suggestions on pull request alerts detected by {% data variables.product.prodname_code_scanning %}. {% endif %} @@ -287,11 +287,11 @@ Alerts that are reopened and re-closed during the chosen time period are ignored {% ifversion code-scanning-autofix %} -### {% data variables.product.prodname_copilot_autofix_short %} suggestions +### {% data variables.copilot.copilot_autofix_short %} suggestions -{% data variables.product.prodname_copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides you with targeted recommendations to help you fix {% data variables.product.prodname_code_scanning %} alerts (including {% data variables.product.prodname_codeql %} alerts). For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). +{% data variables.copilot.copilot_autofix %} is an expansion of {% data variables.product.prodname_code_scanning %} that provides you with targeted recommendations to help you fix {% data variables.product.prodname_code_scanning %} alerts (including {% data variables.product.prodname_codeql %} alerts). For more information, see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). -The "{% data variables.product.prodname_copilot_autofix_short %} suggestions" metric is the total number of {% data variables.product.prodname_copilot_autofix_short %} suggestions generated in open and closed pull requests during the chosen time period. +The "{% data variables.copilot.copilot_autofix_short %} suggestions" metric is the total number of {% data variables.copilot.copilot_autofix_short %} suggestions generated in open and closed pull requests during the chosen time period. {% endif %} diff --git a/content/code-security/trialing-github-advanced-security/explore-trial-code-scanning.md b/content/code-security/trialing-github-advanced-security/explore-trial-code-scanning.md index 7f6a5de7e1..2e9a4c810f 100644 --- a/content/code-security/trialing-github-advanced-security/explore-trial-code-scanning.md +++ b/content/code-security/trialing-github-advanced-security/explore-trial-code-scanning.md @@ -49,14 +49,14 @@ If the extended suite still fails to find the results you expect, you may need t There are three different types of automated analysis of pull requests built into {% data variables.product.github %}: -* **{% data variables.product.prodname_code_scanning_caps %} analysis** uses queries to highlight known bad coding patterns and security vulnerabilities. {% data variables.product.prodname_copilot_autofix_short %} suggests fixes to problems identified by {% data variables.product.prodname_code_scanning %}. +* **{% data variables.product.prodname_code_scanning_caps %} analysis** uses queries to highlight known bad coding patterns and security vulnerabilities. {% data variables.copilot.copilot_autofix_short %} suggests fixes to problems identified by {% data variables.product.prodname_code_scanning %}. * **Dependency review** summarizes the dependency changes made by the pull request and highlights any dependencies with known vulnerabilities or that do not meet your development standards. * **{% data variables.product.prodname_copilot_short %} code review** uses AI to provide feedback on your changes with suggested fixes where possible. These automated reviews are a valuable extension to self-review and make it easier for developers to present a more complete and secure pull request for peer review. In addition, {% data variables.product.prodname_code_scanning %} and dependency reviews can be enforced to protect the security and compliance of your code. > [!NOTE] -> {% data variables.product.prodname_copilot_autofix %} is included in the license for {% data variables.product.prodname_GH_code_security %}. {% data variables.product.prodname_copilot_short %} code review requires a paid {% data variables.product.prodname_copilot_short %} plan. +> {% data variables.copilot.copilot_autofix %} is included in the license for {% data variables.product.prodname_GH_code_security %}. {% data variables.product.prodname_copilot_short %} code review requires a paid {% data variables.product.prodname_copilot_short %} plan. ### {% data variables.product.prodname_code_scanning_caps %} analysis @@ -92,14 +92,14 @@ By default, users request a review from {% data variables.product.prodname_copil {% data variables.product.prodname_copilot_short %} leaves a review comment on each pull request it reviews, without approving the pull request or requesting changes. This ensures that its review is advisory and will not block development work. Similarly, you should not enforce the resolution of suggestions made by {% data variables.product.prodname_copilot_short %} because AI suggestions have known limitations, see [AUTOTITLE](/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-code-review#limitations-of-github-copilot-code-review). -## Define where {% data variables.product.prodname_copilot_autofix_short %} is allowed and enabled +## Define where {% data variables.copilot.copilot_autofix_short %} is allowed and enabled -{% data variables.product.prodname_copilot_autofix_short %} helps developers understand and fix {% data variables.product.prodname_code_scanning %} alerts found in their pull requests. We recommend that you enable this feature for all repositories with {% data variables.product.prodname_code_security %} enabled to help developers resolve alerts efficiently and increase their understanding of secure coding. +{% data variables.copilot.copilot_autofix_short %} helps developers understand and fix {% data variables.product.prodname_code_scanning %} alerts found in their pull requests. We recommend that you enable this feature for all repositories with {% data variables.product.prodname_code_security %} enabled to help developers resolve alerts efficiently and increase their understanding of secure coding. There are two levels of control: -* Enterprises can allow or block use of {% data variables.product.prodname_copilot_autofix_short %} throughout the enterprise using an "{% ifversion ghas-products %}{% data variables.product.prodname_AS %}{% else %}Code security{% endif %}" policy, see: [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise). -* Organizations can enable or disable {% data variables.product.prodname_copilot_autofix_short %} for all organization-owned repositories in the "Global settings" for the organization, see [AUTOTITLE](/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization). +* Enterprises can allow or block use of {% data variables.copilot.copilot_autofix_short %} throughout the enterprise using an "{% ifversion ghas-products %}{% data variables.product.prodname_AS %}{% else %}Code security{% endif %}" policy, see: [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise). +* Organizations can enable or disable {% data variables.copilot.copilot_autofix_short %} for all organization-owned repositories in the "Global settings" for the organization, see [AUTOTITLE](/code-security/securing-your-organization/enabling-security-features-in-your-organization/configuring-global-security-settings-for-your-organization). ## Engage developers in security remediation diff --git a/content/contributing/style-guide-and-content-model/style-guide.md b/content/contributing/style-guide-and-content-model/style-guide.md index 8e7586a699..eb60d0f496 100644 --- a/content/contributing/style-guide-and-content-model/style-guide.md +++ b/content/contributing/style-guide-and-content-model/style-guide.md @@ -788,7 +788,7 @@ When introducing a list, avoid short, nonspecific sentences using terms like “ Use permission statements and product callouts to communicate tasks that require specific roles or products to complete. * [**Permissions statements**](/contributing/style-guide-and-content-model/contents-of-a-github-docs-article#permissions-statements): The role required to take an action or do a task described in the article. Example: "Enterprise owners." -* [**Product callout**](/contributing/style-guide-and-content-model/contents-of-a-github-docs-article#product-callout): The product or products required to take an action or do a task described in the article. Example: "Organization and enterprise accounts with a subscription to {% data variables.product.prodname_copilot_business_short %}." +* [**Product callout**](/contributing/style-guide-and-content-model/contents-of-a-github-docs-article#product-callout): The product or products required to take an action or do a task described in the article. Example: "Organization and enterprise accounts with a subscription to {% data variables.copilot.copilot_business_short %}." Together, permission statements and product callouts tell readers who can use the feature being described in an article. diff --git a/content/copilot/about-github-copilot/github-copilot-features.md b/content/copilot/about-github-copilot/github-copilot-features.md index e03ae4e300..4ccfccfbc5 100644 --- a/content/copilot/about-github-copilot/github-copilot-features.md +++ b/content/copilot/about-github-copilot/github-copilot-features.md @@ -20,15 +20,15 @@ Autocomplete-style suggestions from {% data variables.product.prodname_copilot_s If you use {% data variables.product.prodname_vscode_shortname %}, you can also use {% data variables.copilot.next_edit_suggestions %}, which will predict the location of the next edit you are likely to make and suggest a completion for it. -### {% data variables.product.prodname_copilot_chat_short %} +### {% data variables.copilot.copilot_chat_short %} -A chat interface that lets you ask coding-related questions. {% data variables.product.prodname_copilot_chat %} is available on the {% data variables.product.github %} website, in {% data variables.product.prodname_mobile %}, in supported IDEs _({% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, Eclipse IDE, and Xcode)_, and in {% data variables.product.prodname_windows_terminal %}. Users can also use skills with {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-github) and [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). +A chat interface that lets you ask coding-related questions. {% data variables.copilot.copilot_chat %} is available on the {% data variables.product.github %} website, in {% data variables.product.prodname_mobile %}, in supported IDEs _({% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, Eclipse IDE, and Xcode)_, and in {% data variables.product.prodname_windows_terminal %}. Users can also use skills with {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-github) and [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). ### {% data variables.copilot.copilot_coding_agent %} ({% data variables.release-phases.public_preview %}) -An autonomous AI agent that can make code changes for you. You can assign a {% data variables.product.github %} issue to {% data variables.product.prodname_copilot_short %} and the agent will work on making the required changes, and will create a pull request for you to review. You can also ask {% data variables.product.prodname_copilot_short %} to create a pull request from {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent). +An autonomous AI agent that can make code changes for you. You can assign a {% data variables.product.github %} issue to {% data variables.product.prodname_copilot_short %} and the agent will work on making the required changes, and will create a pull request for you to review. You can also ask {% data variables.product.prodname_copilot_short %} to create a pull request from {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent). -### {% data variables.product.prodname_copilot_cli_short %} +### {% data variables.copilot.copilot_cli_short %} A chat-like interface in the terminal, where you can ask questions about the command line. You can ask {% data variables.product.prodname_copilot_short %} to provide command suggestions or explanations of commands. Users can also integrate {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_windows_terminal %} Canary. See [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-in-the-command-line). @@ -36,19 +36,19 @@ A chat-like interface in the terminal, where you can ask questions about the com 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.product.prodname_copilot_for_prs %} +### {% data variables.copilot.copilot_for_prs %} AI-generated summaries of the changes that were made in a pull request, which files they impact, and what a reviewer should focus on when they conduct their review. See [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/creating-a-pull-request-summary-with-github-copilot). -### {% data variables.product.prodname_copilot_workspace %} ({% data variables.release-phases.public_preview %}) +### {% data variables.copilot.copilot_workspace %} ({% data variables.release-phases.public_preview %}) A {% data variables.product.prodname_copilot_short %}-enabled environment for refining your pull requests, validating changes, and integrating suggestions from reviewers. See [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). -### {% data variables.product.prodname_copilot_autocomplete_pr %} ({% data variables.release-phases.public_preview %}) +### {% data variables.copilot.copilot_autocomplete_pr %} ({% data variables.release-phases.public_preview %}) AI-generated text completion to help you write pull request descriptions quickly and accurately. See [AUTOTITLE](/copilot/using-github-copilot/using-copilot-text-completion). -### {% data variables.product.prodname_copilot_extensions %} +### {% data variables.copilot.copilot_extensions %} {% data reusables.copilot.copilot-extensions.copilot-extensions-intro %} See [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). @@ -56,29 +56,29 @@ AI-generated text completion to help you write pull request descriptions quickly Bringing the power of industry leading large and small language models to users directly on {% data variables.product.github %}. See [AUTOTITLE](/github-models). -### {% data variables.product.prodname_copilot_edits_short %} +### {% data variables.copilot.copilot_edits_short %} -{% data variables.product.prodname_copilot_edits_short %} is available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and JetBrains IDEs. {% data reusables.copilot.copilot-edits.about-copilot-edits %} +{% data variables.copilot.copilot_edits_short %} is available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and JetBrains IDEs. {% data reusables.copilot.copilot-edits.about-copilot-edits %} ### {% data variables.product.prodname_copilot_short %} custom instructions -Enhance {% data variables.product.prodname_copilot_chat_short %} responses by providing contextual details on your preferences, tools, and requirements. See [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses). +Enhance {% data variables.copilot.copilot_chat_short %} responses by providing contextual details on your preferences, tools, and requirements. See [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses). -### {% data variables.product.prodname_copilot_desktop_short %} ({% data variables.release-phases.public_preview %}) +### {% data variables.copilot.copilot_desktop_short %} ({% data variables.release-phases.public_preview %}) -Automatically generate commit messages and descriptions with {% data variables.product.prodname_copilot_desktop_short %} based on the changes you make to your project. +Automatically generate commit messages and descriptions with {% data variables.copilot.copilot_desktop_short %} based on the changes you make to your project. -### {% data variables.product.prodname_copilot_spaces %} ({% data variables.release-phases.public_preview %}) +### {% data variables.copilot.copilot_spaces %} ({% data variables.release-phases.public_preview %}) -Organize and centralize relevant content—like code, docs, specs, and more—into {% data variables.product.prodname_copilot_spaces_short %} that ground {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). +Organize and centralize relevant content—like code, docs, specs, and more—into {% data variables.copilot.copilot_spaces_short %} that ground {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). -### {% data variables.product.prodname_copilot_short %} knowledge bases _({% data variables.product.prodname_copilot_enterprise_short %} only)_ +### {% data variables.product.prodname_copilot_short %} knowledge bases _({% data variables.copilot.copilot_enterprise_short %} only)_ -Create and manage collections of documentation to use as context for chatting with {% data variables.product.prodname_copilot_short %}. When you ask a question in {% data variables.product.prodname_copilot_chat_dotcom_short %} or in {% data variables.product.prodname_vscode_shortname %}, you can specify a knowledge base as the context for your question. See [AUTOTITLE](/copilot/customizing-copilot/managing-copilot-knowledge-bases). +Create and manage collections of documentation to use as context for chatting with {% data variables.product.prodname_copilot_short %}. When you ask a question in {% data variables.copilot.copilot_chat_dotcom_short %} or in {% data variables.product.prodname_vscode_shortname %}, you can specify a knowledge base as the context for your question. See [AUTOTITLE](/copilot/customizing-copilot/managing-copilot-knowledge-bases). ## {% data variables.product.prodname_copilot %} features for administrators -The following features are available to organization and enterprise owners with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan. +The following features are available to organization and enterprise owners with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan. ### Policy management diff --git a/content/copilot/about-github-copilot/plans-for-github-copilot.md b/content/copilot/about-github-copilot/plans-for-github-copilot.md index d36bf3a42e..e015a78d1a 100644 --- a/content/copilot/about-github-copilot/plans-for-github-copilot.md +++ b/content/copilot/about-github-copilot/plans-for-github-copilot.md @@ -16,15 +16,15 @@ redirect_from: {% data variables.product.company_short %} offers several plans for {% data variables.product.prodname_copilot %}, depending on your needs and whether you're using {% data variables.product.prodname_copilot_short %} as an individual or as part of an organization or enterprise. -* **{% data variables.product.prodname_copilot_free %}** is available to individual developers who don't have access to {% data variables.product.prodname_copilot_short %} through an organization or enterprise. This free plan includes limited access to select {% data variables.product.prodname_copilot_short %} features, allowing you to try AI-powered coding assistance at no cost. +* **{% data variables.copilot.copilot_free %}** is available to individual developers who don't have access to {% data variables.product.prodname_copilot_short %} through an organization or enterprise. This free plan includes limited access to select {% data variables.product.prodname_copilot_short %} features, allowing you to try AI-powered coding assistance at no cost. -* **{% data variables.product.prodname_copilot_pro %}** is designed for individuals who want more flexibility. This paid plan includes unlimited completions, access to premium models in {% data variables.product.prodname_copilot_chat_short %}, and a monthly allowance of premium requests. Verified students, teachers, and maintainers of popular open source projects may be eligible for free access. +* **{% data variables.copilot.copilot_pro %}** is designed for individuals who want more flexibility. This paid plan includes unlimited completions, access to premium models in {% data variables.copilot.copilot_chat_short %}, and a monthly allowance of premium requests. Verified students, teachers, and maintainers of popular open source projects may be eligible for free access. -* **{% data variables.product.prodname_copilot_pro_plus %}** offers the highest level of access for individual developers. In addition to everything in {% data variables.product.prodname_copilot_pro_short %}, this plan includes {% data variables.copilot.copilot_coding_agent %}, a larger allowance of premium requests, and full access to all available models in {% data variables.product.prodname_copilot_chat_short %}. Ideal for AI power users who want access to the most advanced capabilities. +* **{% data variables.copilot.copilot_pro_plus %}** offers the highest level of access for individual developers. In addition to everything in {% data variables.copilot.copilot_pro_short %}, this plan includes {% data variables.copilot.copilot_coding_agent %}, a larger allowance of premium requests, and full access to all available models in {% data variables.copilot.copilot_chat_short %}. Ideal for AI power users who want access to the most advanced capabilities. -* **{% data variables.product.prodname_copilot_for_business %}** is for organizations on {% data variables.product.prodname_free_team %} or {% data variables.product.prodname_team %} plan, or enterprises on {% data variables.product.prodname_ghe_cloud %}. This plan enables centralized management and {% data variables.product.prodname_copilot_short %} policy control for organization members. +* **{% data variables.copilot.copilot_for_business %}** is for organizations on {% data variables.product.prodname_free_team %} or {% data variables.product.prodname_team %} plan, or enterprises on {% data variables.product.prodname_ghe_cloud %}. This plan enables centralized management and {% data variables.product.prodname_copilot_short %} policy control for organization members. -* **{% data variables.product.prodname_copilot_enterprise %}** is for enterprises using {% data variables.product.prodname_ghe_cloud %}. It includes all the features of {% data variables.product.prodname_copilot_business_short %}, plus {% data variables.copilot.copilot_coding_agent %} and additional enterprise-grade capabilities. Enterprise owners can assign either {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} to individual organizations. +* **{% data variables.copilot.copilot_enterprise %}** is for enterprises using {% data variables.product.prodname_ghe_cloud %}. It includes all the features of {% data variables.copilot.copilot_business_short %}, plus {% data variables.copilot.copilot_coding_agent %} and additional enterprise-grade capabilities. Enterprise owners can assign either {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} to individual organizations. {% data variables.product.prodname_copilot_short %} is not currently available for {% data variables.product.prodname_ghe_server %}. @@ -40,12 +40,12 @@ For more information, see [AUTOTITLE](/copilot/about-github-copilot/github-copil Start using {% data variables.product.prodname_copilot_short %} by signing up for the plan that best fits your needs. -* **{% data variables.product.prodname_copilot_free_short %}** — Try {% data variables.product.prodname_copilot_short %} with limited features and requests. [Start using {% data variables.product.prodname_copilot_free_short %}](https://github.com/copilot). +* **{% data variables.copilot.copilot_free_short %}** — Try {% data variables.product.prodname_copilot_short %} with limited features and requests. [Start using {% data variables.copilot.copilot_free_short %}](https://github.com/copilot). -* **{% data variables.product.prodname_copilot_pro_short %}** — Get unlimited completions and access to premium models. Includes a free 30-day trial for eligible users. [Try {% data variables.product.prodname_copilot_pro_short %} for free](https://github.com/github-copilot/signup?ref_cta=Copilot+trial&ref_loc=about+github+copilot&ref_page=docs). +* **{% data variables.copilot.copilot_pro_short %}** — Get unlimited completions and access to premium models. Includes a free 30-day trial for eligible users. [Try {% data variables.copilot.copilot_pro_short %} for free](https://github.com/github-copilot/signup?ref_cta=Copilot+trial&ref_loc=about+github+copilot&ref_page=docs). -* **{% data variables.product.prodname_copilot_pro_plus_short %}** — Unlock advanced AI models, extended request limits, and extra capabilities. [Subscribe to {% data variables.product.prodname_copilot_pro_plus_short %}](https://github.com/github-copilot/signup?ref_cta=Copilot+Pro%2B&ref_loc=subscriptions+page&ref_page=docs). +* **{% data variables.copilot.copilot_pro_plus_short %}** — Unlock advanced AI models, extended request limits, and extra capabilities. [Subscribe to {% data variables.copilot.copilot_pro_plus_short %}](https://github.com/github-copilot/signup?ref_cta=Copilot+Pro%2B&ref_loc=subscriptions+page&ref_page=docs). -* **{% data variables.product.prodname_copilot_business_short %}** — For teams and organizations. [Subscribe to {% data variables.product.prodname_copilot_business_short %}](https://github.com/github-copilot/purchase?priority=business&cft=copilot_li.copilot_plans.cfb). +* **{% data variables.copilot.copilot_business_short %}** — For teams and organizations. [Subscribe to {% data variables.copilot.copilot_business_short %}](https://github.com/github-copilot/purchase?priority=business&cft=copilot_li.copilot_plans.cfb). -* **{% data variables.product.prodname_copilot_enterprise_short %}** — For enterprises that need advanced features and centralized management. [Subscribe to {% data variables.product.prodname_copilot_enterprise_short %}](https://github.com/github-copilot/purchase?priority=enterprise&cft=copilot_li.copilot_plans.ce). +* **{% data variables.copilot.copilot_enterprise_short %}** — For enterprises that need advanced features and centralized management. [Subscribe to {% data variables.copilot.copilot_enterprise_short %}](https://github.com/github-copilot/purchase?priority=enterprise&cft=copilot_li.copilot_plans.ce). diff --git a/content/copilot/about-github-copilot/what-is-github-copilot.md b/content/copilot/about-github-copilot/what-is-github-copilot.md index 00085534e4..9cb1c7ee03 100644 --- a/content/copilot/about-github-copilot/what-is-github-copilot.md +++ b/content/copilot/about-github-copilot/what-is-github-copilot.md @@ -36,10 +36,10 @@ redirect_from: * Get code suggestions as you type in your IDE * Chat with {% data variables.product.prodname_copilot_short %} to ask for help with your code * Ask {% data variables.product.prodname_copilot_short %} for help using the command line -* Organize and share task-specific context with {% data variables.product.prodname_copilot_spaces %} to get more relevant answers -* Generate a description of the changes in a pull request _({% data variables.product.prodname_copilot_enterprise_short %} only)_ -* Create and manage collections of documentation, called knowledge bases, to use as a context for chatting with {% data variables.product.prodname_copilot_short %} _({% data variables.product.prodname_copilot_enterprise_short %} only)_ -* Work on code changes and create a pull request for you to review _({% data variables.product.prodname_copilot_pro_plus_short %} and {% data variables.product.prodname_copilot_enterprise_short %} only)_ +* Organize and share task-specific context with {% data variables.copilot.copilot_spaces %} to get more relevant answers +* Generate a description of the changes in a pull request _({% data variables.copilot.copilot_enterprise_short %} only)_ +* Create and manage collections of documentation, called knowledge bases, to use as a context for chatting with {% data variables.product.prodname_copilot_short %} _({% data variables.copilot.copilot_enterprise_short %} only)_ +* Work on code changes and create a pull request for you to review _({% data variables.copilot.copilot_pro_plus_short %} and {% data variables.copilot.copilot_enterprise_short %} only)_ {% data variables.product.prodname_copilot_short %} is available: @@ -57,19 +57,19 @@ There are a few ways you can start using {% data variables.product.prodname_copi ### For individuals -* **Try {% data variables.product.prodname_copilot_short %} for free**: Use {% data variables.product.prodname_copilot_free_short %} to explore core {% data variables.product.prodname_copilot_short %} features with no paid plan required. -* **Subscribe to a paid plan**: Upgrade to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} for full access to premium features and more generous usage limits. You can try {% data variables.product.prodname_copilot_pro_short %} for free with a one-time 30-day trial. -* **Eligible for free {% data variables.product.prodname_copilot_pro_short %} access?** Students, teachers, and open source maintainers may qualify for {% data variables.product.prodname_copilot_pro_short %} at no cost. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-free-access-to-copilot-as-a-student-teacher-or-maintainer). +* **Try {% data variables.product.prodname_copilot_short %} for free**: Use {% data variables.copilot.copilot_free_short %} to explore core {% data variables.product.prodname_copilot_short %} features with no paid plan required. +* **Subscribe to a paid plan**: Upgrade to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} for full access to premium features and more generous usage limits. You can try {% data variables.copilot.copilot_pro_short %} for free with a one-time 30-day trial. +* **Eligible for free {% data variables.copilot.copilot_pro_short %} access?** Students, teachers, and open source maintainers may qualify for {% data variables.copilot.copilot_pro_short %} at no cost. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-free-access-to-copilot-as-a-student-teacher-or-maintainer). * **Organization members**: If your organization or enterprise has a {% data variables.product.prodname_copilot %} plan, you can request access to {% data variables.product.prodname_copilot_short %} by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get {% data variables.product.prodname_copilot_short %} from an organization." See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-started-with-a-copilot-plan) for more information. ### For organizations and enterprises -* **Organization owners**: Purchase {% data variables.product.prodname_copilot_business_short %} for your team. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/subscribing-to-copilot-for-your-organization). If your organization is owned by an enterprise that has a {% data variables.product.prodname_copilot_short %} subscription, you can ask your enterprise owner to enable {% data variables.product.prodname_copilot_short %} for your organization by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get {% data variables.product.prodname_copilot_short %} from an organization." -* **Enterprise owners**: Purchase {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} for your enterprise. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/subscribing-to-copilot-for-your-enterprise). +* **Organization owners**: Purchase {% data variables.copilot.copilot_business_short %} for your team. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/subscribing-to-copilot-for-your-organization). If your organization is owned by an enterprise that has a {% data variables.product.prodname_copilot_short %} subscription, you can ask your enterprise owner to enable {% data variables.product.prodname_copilot_short %} for your organization by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get {% data variables.product.prodname_copilot_short %} from an organization." +* **Enterprise owners**: Purchase {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} for your enterprise. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/subscribing-to-copilot-for-your-enterprise). -If you **don't need other {% data variables.product.github %} features**, you can request an enterprise account specifically for managing {% data variables.product.prodname_copilot_business_short %} licenses. These accounts don't include repository or organization creation and don’t incur {% data variables.product.prodname_enterprise %} seat charges. See [AUTOTITLE](/enterprise-cloud@latest/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business). +If you **don't need other {% data variables.product.github %} features**, you can request an enterprise account specifically for managing {% data variables.copilot.copilot_business_short %} licenses. These accounts don't include repository or organization creation and don’t incur {% data variables.product.prodname_enterprise %} seat charges. See [AUTOTITLE](/enterprise-cloud@latest/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business). ## Next steps diff --git a/content/copilot/building-copilot-extensions/about-building-copilot-extensions.md b/content/copilot/building-copilot-extensions/about-building-copilot-extensions.md index cc566fc5ed..f1e127aa8d 100644 --- a/content/copilot/building-copilot-extensions/about-building-copilot-extensions.md +++ b/content/copilot/building-copilot-extensions/about-building-copilot-extensions.md @@ -1,6 +1,6 @@ --- title: About building Copilot Extensions -intro: 'Learn about the development process for {% data variables.product.prodname_copilot_extensions_short %}.' +intro: 'Learn about the development process for {% data variables.copilot.copilot_extensions_short %}.' product: '{% data reusables.gated-features.copilot-extensions %}' versions: feature: copilot-extensions @@ -10,26 +10,26 @@ shortTitle: About building Extensions type: overview --- -## About {% data variables.product.prodname_copilot_extensions_short %} +## About {% data variables.copilot.copilot_extensions_short %} -{% data variables.product.prodname_copilot_extensions_short %} are integrations that expand the functionality of {% data variables.product.prodname_copilot_chat_short %}, allowing developers to bring external tools, services, and custom behaviors into the Chat experience. You can use {% data variables.product.prodname_copilot_extensions_short %} to extend the capabilities of {% data variables.product.prodname_copilot_chat_short %} in a variety of ways, including: +{% data variables.copilot.copilot_extensions_short %} are integrations that expand the functionality of {% data variables.copilot.copilot_chat_short %}, allowing developers to bring external tools, services, and custom behaviors into the Chat experience. You can use {% data variables.copilot.copilot_extensions_short %} to extend the capabilities of {% data variables.copilot.copilot_chat_short %} in a variety of ways, including: -* **Querying documentation:** A {% data variables.product.prodname_copilot_extension_short %} can allow {% data variables.product.prodname_copilot_chat_short %} to query a third-party documentation service to find information about a specific topic. -* **AI-assisted coding:** A {% data variables.product.prodname_copilot_extension_short %} can use a third-party AI model to provide code suggestions. -* **Data retrieval:** A {% data variables.product.prodname_copilot_extension_short %} can allow {% data variables.product.prodname_copilot_chat_short %} to query a third-party data service to retrieve information about a specific topic. -* **Action execution:** A {% data variables.product.prodname_copilot_extension_short %} can allow {% data variables.product.prodname_copilot_chat_short %} to execute a specific action, such as posting to a message board or updating a tracking item in an external system. +* **Querying documentation:** A {% data variables.copilot.copilot_extension_short %} can allow {% data variables.copilot.copilot_chat_short %} to query a third-party documentation service to find information about a specific topic. +* **AI-assisted coding:** A {% data variables.copilot.copilot_extension_short %} can use a third-party AI model to provide code suggestions. +* **Data retrieval:** A {% data variables.copilot.copilot_extension_short %} can allow {% data variables.copilot.copilot_chat_short %} to query a third-party data service to retrieve information about a specific topic. +* **Action execution:** A {% data variables.copilot.copilot_extension_short %} can allow {% data variables.copilot.copilot_chat_short %} to execute a specific action, such as posting to a message board or updating a tracking item in an external system. -## About building {% data variables.product.prodname_copilot_extensions %} +## About building {% data variables.copilot.copilot_extensions %} -{% data variables.product.prodname_copilot_extensions %} are a type of {% data variables.product.prodname_copilot_extension_short %} built with {% data variables.product.prodname_github_apps %}. {% data variables.product.prodname_copilot_extensions %} are best suited for developers who want cross-platform compatibility and app management and support from {% data variables.product.github %}. +{% data variables.copilot.copilot_extensions %} are a type of {% data variables.copilot.copilot_extension_short %} built with {% data variables.product.prodname_github_apps %}. {% data variables.copilot.copilot_extensions %} are best suited for developers who want cross-platform compatibility and app management and support from {% data variables.product.github %}. ### Supported clients and IDEs {% data reusables.copilot.copilot-extensions.supported-clients-and-ides-table %} -### About visibility of {% data variables.product.prodname_copilot_extensions %} +### About visibility of {% data variables.copilot.copilot_extensions %} -{% data variables.product.prodname_copilot_extensions %} can be private, public and shareable, or public and listed on the {% data variables.product.prodname_marketplace %}. Which visibility option you choose will depend on your use case and the audience you are targeting. +{% data variables.copilot.copilot_extensions %} can be private, public and shareable, or public and listed on the {% data variables.product.prodname_marketplace %}. Which visibility option you choose will depend on your use case and the audience you are targeting. * Private extensions are often preferred by large enterprises or companies that: * Want more customization and controls over data access @@ -44,13 +44,13 @@ type: overview * Integrate their tool into the developer workflow on {% data variables.product.company_short %} and the IDE * Leverage the {% data variables.product.company_short %} ecosystem to raise awareness for their product -### About {% data variables.product.prodname_copilot_extensions %} permissions +### About {% data variables.copilot.copilot_extensions %} permissions {% data reusables.copilot.copilot-extensions.about-extensions-permissions %} #### Granting permissions to access organization resources -Only organization admins can grant permissions for {% data variables.product.prodname_copilot_extensions_short %} to access organization resources. +Only organization admins can grant permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources. To grant organization members access: * The organization admin must install the extension. * The organization admin must grant the extension permission to access specific repositories. @@ -64,9 +64,9 @@ For more information about skillsets, see [AUTOTITLE](/copilot/building-copilot- ### About context passing -You can allow your {% data variables.product.prodname_copilot_extension_short %} to receive context from the editor, such as the currently opened file, by enabling the **Read-only** access level for the "{% data variables.product.prodname_copilot_short %} Editor Context" permission in your {% data variables.product.prodname_github_app %} settings. See step 10 of [Configuring your {% data variables.product.prodname_github_app %}](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension#configuring-your-github-app). +You can allow your {% data variables.copilot.copilot_extension_short %} to receive context from the editor, such as the currently opened file, by enabling the **Read-only** access level for the "{% data variables.product.prodname_copilot_short %} Editor Context" permission in your {% data variables.product.prodname_github_app %} settings. See step 10 of [Configuring your {% data variables.product.prodname_github_app %}](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension#configuring-your-github-app). -The {% data variables.product.prodname_copilot_extensibility_platform %} automatically handles messaging when implicit and explicit context is unavailable or unauthorized. To enable context passing, you are required to request permissions from users. To enable context passing, you are required to: +The {% data variables.copilot.copilot_extensibility_platform %} automatically handles messaging when implicit and explicit context is unavailable or unauthorized. To enable context passing, you are required to request permissions from users. To enable context passing, you are required to: * Update your APIs to handle new reference types. * Request permissions from users. When requesting permissions, follow these best practices: @@ -79,39 +79,39 @@ Context passing respects content exclusions, which refers to any files listed in For more information about context passing, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/context-passing-for-your-agent). -### Using APIs in {% data variables.product.prodname_copilot_extensions %} +### Using APIs in {% data variables.copilot.copilot_extensions %} -Building {% data variables.product.prodname_copilot_extensions %} requires using the {% data variables.product.github %} API. Optionally, the {% data variables.product.prodname_copilot_short %} API can be used for additional capabilities. For details on request and response formatting, see the [OpenAI API documentation](https://platform.openai.com/docs/api-reference/chat). +Building {% data variables.copilot.copilot_extensions %} requires using the {% data variables.product.github %} API. Optionally, the {% data variables.product.prodname_copilot_short %} API can be used for additional capabilities. For details on request and response formatting, see the [OpenAI API documentation](https://platform.openai.com/docs/api-reference/chat). -> [!NOTE] The {% data variables.product.prodname_copilot_short %} API is available for {% data variables.product.prodname_copilot_extension_short %} builders, but only {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_vscode_shortname %} Chat extensions can be used to access these endpoints. +> [!NOTE] The {% data variables.product.prodname_copilot_short %} API is available for {% data variables.copilot.copilot_extension_short %} builders, but only {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_vscode_shortname %} Chat extensions can be used to access these endpoints. -## Resources for building {% data variables.product.prodname_copilot_extensions %} +## Resources for building {% data variables.copilot.copilot_extensions %} {% data variables.product.company_short %} provides a comprehensive toolkit for extension builders, with code samples, a CLI debugging tool, quickstart SDKs, and a user feedback repository. For more information, see the [copilot-extensions](https://github.com/orgs/copilot-extensions/) organization on {% data variables.product.company_short %}. -Before creating your own {% data variables.product.prodname_copilot_extension %} from scratch, you may want to explore an existing {% data variables.product.prodname_copilot_agent_short %}, then integrate it with a {% data variables.product.prodname_github_app %} to see how it works. {% data variables.product.company_short %} provides a few example {% data variables.product.prodname_copilot_agents_short %} that you can clone and use as the basis for your own {% data variables.product.prodname_copilot_extension %}: +Before creating your own {% data variables.copilot.copilot_extension %} from scratch, you may want to explore an existing {% data variables.copilot.copilot_agent_short %}, then integrate it with a {% data variables.product.prodname_github_app %} to see how it works. {% data variables.product.company_short %} provides a few example {% data variables.copilot.copilot_agents_short %} that you can clone and use as the basis for your own {% data variables.copilot.copilot_extension %}: -* **Blackbeard:** A simple {% data variables.product.prodname_copilot_agent_short %} that responds to requests like a pirate, using {% data variables.product.prodname_copilot_short %}'s LLM API and special system prompts. It is a good starting point for learning how to build a {% data variables.product.prodname_copilot_extension %}. For more information, see the [Blackbeard {% data variables.product.prodname_copilot_extension_short %}](https://github.com/copilot-extensions/blackbeard-extension). -* **{% data variables.product.prodname_github_models %}:** A more complex {% data variables.product.prodname_copilot_agent_short %} that lets you ask about and interact with various LLMs listed on the {% data variables.product.prodname_marketplace %} from within {% data variables.product.prodname_copilot_chat_short %}. For more information, see the [{% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %}](https://github.com/copilot-extensions/github-models-extension). +* **Blackbeard:** A simple {% data variables.copilot.copilot_agent_short %} that responds to requests like a pirate, using {% data variables.product.prodname_copilot_short %}'s LLM API and special system prompts. It is a good starting point for learning how to build a {% data variables.copilot.copilot_extension %}. For more information, see the [Blackbeard {% data variables.copilot.copilot_extension_short %}](https://github.com/copilot-extensions/blackbeard-extension). +* **{% data variables.product.prodname_github_models %}:** A more complex {% data variables.copilot.copilot_agent_short %} that lets you ask about and interact with various LLMs listed on the {% data variables.product.prodname_marketplace %} from within {% data variables.copilot.copilot_chat_short %}. For more information, see the [{% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %}](https://github.com/copilot-extensions/github-models-extension). > [!NOTE] {% data variables.product.prodname_github_models %} are in {% data variables.release-phases.public_preview %} and subject to change. To request access, join the [waitlist](https://github.com/marketplace/models/waitlist). * **Function calling:** an example agent written in Go that demonstrates function calling and confirmation dialogues. For more information, see the [Function calling extension](https://github.com/copilot-extensions/function-calling-extension). * **RAG extension:** an example agent written in Go that demonstrates a simple implementation of retrieval augmented generation. For more information, see the [RAG extension](https://github.com/copilot-extensions/rag-extension). -* **Preview SDK:** An SDK that simplifies the process of building {% data variables.product.prodname_copilot_extensions %} by handling request verification, response formatting, and API interactions. It allows builders to focus on their extension's core functionality rather than boilerplate, by streamlining the integration of tools, APIs, and data sources into {% data variables.product.prodname_copilot_chat_short %}. For more information, see the [Preview SDK](https://github.com/copilot-extensions/preview-sdk.js). +* **Preview SDK:** An SDK that simplifies the process of building {% data variables.copilot.copilot_extensions %} by handling request verification, response formatting, and API interactions. It allows builders to focus on their extension's core functionality rather than boilerplate, by streamlining the integration of tools, APIs, and data sources into {% data variables.copilot.copilot_chat_short %}. For more information, see the [Preview SDK](https://github.com/copilot-extensions/preview-sdk.js). -## About building {% data variables.product.prodname_copilot_extensions_vsc %} +## About building {% data variables.copilot.copilot_extensions_vsc %} -> [!NOTE] The {% data variables.product.github %} documentation focuses on building {% data variables.product.prodname_copilot_extensions %}, not {% data variables.product.prodname_copilot_extensions_vsc %}. +> [!NOTE] The {% data variables.product.github %} documentation focuses on building {% data variables.copilot.copilot_extensions %}, not {% data variables.copilot.copilot_extensions_vsc %}. -You can build a {% data variables.product.prodname_copilot_extension_short %} that is exclusive and native to {% data variables.product.prodname_vscode %}, called a {% data variables.product.prodname_copilot_extensions_vsc %}. This option is best suited for developers who want to build extensions that use {% data variables.product.prodname_vscode_shortname %}-specific APIs and functionality, or extend existing {% data variables.product.prodname_vscode_shortname %} extensions. +You can build a {% data variables.copilot.copilot_extension_short %} that is exclusive and native to {% data variables.product.prodname_vscode %}, called a {% data variables.copilot.copilot_extensions_vsc %}. This option is best suited for developers who want to build extensions that use {% data variables.product.prodname_vscode_shortname %}-specific APIs and functionality, or extend existing {% data variables.product.prodname_vscode_shortname %} extensions. -Also known as {% data variables.product.prodname_vscode_shortname %} Chat extensions, {% data variables.product.prodname_copilot_extensions_vsc %} function similarly to {% data variables.product.prodname_copilot_extensions %} by extending the capabilities of {% data variables.product.prodname_copilot_chat_short %}, with a few notable differences: +Also known as {% data variables.product.prodname_vscode_shortname %} Chat extensions, {% data variables.copilot.copilot_extensions_vsc %} function similarly to {% data variables.copilot.copilot_extensions %} by extending the capabilities of {% data variables.copilot.copilot_chat_short %}, with a few notable differences: * {% data variables.product.prodname_vscode_shortname %} Chat extensions are only usable in {% data variables.product.prodname_vscode_shortname %}. * {% data variables.product.prodname_vscode_shortname %} Chat extensions have more access to {% data variables.product.prodname_vscode_shortname %}'s features and APIs, allowing more editor-specific interactions like accessing local workspace data, manipulating {% data variables.product.prodname_vscode %}'s interface, and read/write access to local files. * {% data variables.product.prodname_vscode_shortname %} Chat extensions are published to the {% data variables.product.prodname_vs_marketplace_shortname %}, not the {% data variables.product.prodname_marketplace %}. * {% data variables.product.prodname_vscode_shortname %} Chat extensions are local to the user's machine, and cannot be controlled by an organization{% ifversion ghec %} or enterprise's{% else %}'s{% endif %} policies. -For more information on {% data variables.product.prodname_copilot_extensions_vsc %}, see [Chat extensions](https://code.visualstudio.com/api/extension-guides/chat) in the {% data variables.product.prodname_vscode %} documentation. +For more information on {% data variables.copilot.copilot_extensions_vsc %}, see [Chat extensions](https://code.visualstudio.com/api/extension-guides/chat) in the {% data variables.product.prodname_vscode %} documentation. ## Further reading diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents.md b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents.md index 8c66d05dac..bb4251c40e 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents.md @@ -1,6 +1,6 @@ --- title: About Copilot agents -intro: 'Learn what {% data variables.product.prodname_copilot_agents %} are and how they can enhance your {% data variables.product.prodname_copilot_chat %} experience.' +intro: 'Learn what {% data variables.copilot.copilot_agents %} are and how they can enhance your {% data variables.copilot.copilot_chat %} experience.' versions: feature: copilot-extensions topics: @@ -9,11 +9,11 @@ shortTitle: About Copilot agents type: overview --- -{% data variables.product.prodname_copilot_agents_short %} are custom tools embedded in {% data variables.product.prodname_copilot_extensions_short %}. They integrate with {% data variables.product.prodname_copilot_chat_short %} to provide additional functionalities tailored to specific needs. {% data variables.product.prodname_copilot_agents_short %} can perform various tasks such as querying documentation, retrieving data, executing specific actions, or providing AI-assisted coding suggestions. They enhance the capabilities of {% data variables.product.prodname_copilot %} by allowing developers to build and integrate custom features directly into the {% data variables.product.prodname_copilot_chat_short %} interface. +{% data variables.copilot.copilot_agents_short %} are custom tools embedded in {% data variables.copilot.copilot_extensions_short %}. They integrate with {% data variables.copilot.copilot_chat_short %} to provide additional functionalities tailored to specific needs. {% data variables.copilot.copilot_agents_short %} can perform various tasks such as querying documentation, retrieving data, executing specific actions, or providing AI-assisted coding suggestions. They enhance the capabilities of {% data variables.product.prodname_copilot %} by allowing developers to build and integrate custom features directly into the {% data variables.copilot.copilot_chat_short %} interface. -To use a {% data variables.product.prodname_copilot_agent_short %} in {% data variables.product.prodname_copilot_chat_short %}, it must be associated with a {% data variables.product.prodname_github_app %}. This combination of a {% data variables.product.prodname_github_app %} and a {% data variables.product.prodname_copilot_agent_short %} is what we refer to as a {% data variables.product.prodname_copilot_extension %}. For more information on {% data variables.product.prodname_copilot_extensions_short %}, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). +To use a {% data variables.copilot.copilot_agent_short %} in {% data variables.copilot.copilot_chat_short %}, it must be associated with a {% data variables.product.prodname_github_app %}. This combination of a {% data variables.product.prodname_github_app %} and a {% data variables.copilot.copilot_agent_short %} is what we refer to as a {% data variables.copilot.copilot_extension %}. For more information on {% data variables.copilot.copilot_extensions_short %}, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). -Any {% data variables.product.company_short %} user can create a {% data variables.product.prodname_copilot_extension_short %} by building a {% data variables.product.prodname_copilot_agent_short %} and associating it with a {% data variables.product.prodname_github_app %}. For more information on creating a {% data variables.product.prodname_copilot_extension_short %}, see [AUTOTITLE](/copilot/building-copilot-extensions/setting-up-copilot-extensions). +Any {% data variables.product.company_short %} user can create a {% data variables.copilot.copilot_extension_short %} by building a {% data variables.copilot.copilot_agent_short %} and associating it with a {% data variables.product.prodname_github_app %}. For more information on creating a {% data variables.copilot.copilot_extension_short %}, see [AUTOTITLE](/copilot/building-copilot-extensions/setting-up-copilot-extensions). ## Further reading diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md index 5aed9d27cb..a65ce2906b 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md @@ -1,6 +1,6 @@ --- title: Configuring your Copilot agent to communicate with GitHub -intro: 'Learn how to verify payloads and get resources from {% data variables.product.github %} with your {% data variables.product.prodname_copilot_agent_short %}.' +intro: 'Learn how to verify payloads and get resources from {% data variables.product.github %} with your {% data variables.copilot.copilot_agent_short %}.' versions: feature: copilot-extensions topics: @@ -15,7 +15,7 @@ type: reference ## Verifying that payloads are coming from {% data variables.product.github %} -Before your {% data variables.product.prodname_copilot_agent_short %} begins processing a request, you should verify that the request came from {% data variables.product.github %}, and that it is intended for your agent. All agent requests contain the `X-GitHub-Public-Key-Identifier` and `X-GitHub-Public-Key-Signature` headers. To verify the signature for a particular request, compare the signature in the `X-GitHub-Public-Key-Signature` header with a signed copy of the request body using the current public key listed at https://api.github.com/meta/public_keys/copilot_api. +Before your {% data variables.copilot.copilot_agent_short %} begins processing a request, you should verify that the request came from {% data variables.product.github %}, and that it is intended for your agent. All agent requests contain the `X-GitHub-Public-Key-Identifier` and `X-GitHub-Public-Key-Signature` headers. To verify the signature for a particular request, compare the signature in the `X-GitHub-Public-Key-Signature` header with a signed copy of the request body using the current public key listed at https://api.github.com/meta/public_keys/copilot_api. For more details and examples of signature verification in specific languages, see the [`github-technology-partners/signature-verification`](https://github.com/github-technology-partners/signature-verification) repository. @@ -23,7 +23,7 @@ For more details and examples of signature verification in specific languages, s ## Fetching resources from the {% data variables.product.github %} API -Requests to your {% data variables.product.prodname_copilot_agent_short %} will receive an `X-GitHub-Token` header. This header contains an API token that can be used to fetch resources from the {% data variables.product.github %} API on behalf of the user interacting with your agent. The permissions of this token are the overlap of the user's own permissions and the permissions granted to your {% data variables.product.prodname_github_app %} installation. +Requests to your {% data variables.copilot.copilot_agent_short %} will receive an `X-GitHub-Token` header. This header contains an API token that can be used to fetch resources from the {% data variables.product.github %} API on behalf of the user interacting with your agent. The permissions of this token are the overlap of the user's own permissions and the permissions granted to your {% data variables.product.prodname_github_app %} installation. For an example of how you might use `X-GitHub-Token`, see the following code sample: diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform.md b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform.md index da40e32fe6..bfa1131b44 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform.md @@ -1,6 +1,6 @@ --- title: Configuring your Copilot agent to communicate with the Copilot platform -intro: 'Learn how to interact with the {% data variables.product.prodname_copilot_short %} platform by sending and receiving server-sent events with your {% data variables.product.prodname_copilot_agent_short %}.' +intro: 'Learn how to interact with the {% data variables.product.prodname_copilot_short %} platform by sending and receiving server-sent events with your {% data variables.copilot.copilot_agent_short %}.' versions: feature: copilot-extensions topics: @@ -10,7 +10,7 @@ type: reference layout: inline --- -{% data variables.product.prodname_copilot_agents_short %} communicate with the {% data variables.product.prodname_copilot_short %} platform in the form of server-sent events (SSEs). Rather than waiting for the {% data variables.product.prodname_copilot_short %} platform to request an update from your agent, or vice versa, you can use SSEs to send and receive updates to and from the platform in real time. +{% data variables.copilot.copilot_agents_short %} communicate with the {% data variables.product.prodname_copilot_short %} platform in the form of server-sent events (SSEs). Rather than waiting for the {% data variables.product.prodname_copilot_short %} platform to request an update from your agent, or vice versa, you can use SSEs to send and receive updates to and from the platform in real time. To learn more about SSEs, see [Server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events) in the mdn documentation. @@ -87,7 +87,7 @@ data: [{ ### `copilot_references` -> [!NOTE] Rendering references is currently unsupported for {% data variables.product.prodname_copilot_mobile_short %}. Extensions that depend on reference memory to generate responses will still work, but the references will not be displayed to the user. +> [!NOTE] Rendering references is currently unsupported for {% data variables.copilot.copilot_mobile_short %}. Extensions that depend on reference memory to generate responses will still work, but the references will not be displayed to the user. The `copilot_references` SSE sends the user a list of references used to generate a response. This SSE is sent through an event type and data field. See the following code for an example of a `copilot_references` SSE: @@ -149,4 +149,4 @@ curl --request POST \ ## Next steps -Now that you understand how your {% data variables.product.prodname_copilot_agent_short %} communicates with the {% data variables.product.prodname_copilot_short %} platform, you can learn how to integrate your agent with the {% data variables.product.github %} API. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github). +Now that you understand how your {% data variables.copilot.copilot_agent_short %} communicates with the {% data variables.product.prodname_copilot_short %} platform, you can learn how to integrate your agent with the {% data variables.product.github %} API. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github). diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/context-passing-for-your-agent.md b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/context-passing-for-your-agent.md index 2d298393f8..a623d22754 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/context-passing-for-your-agent.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/context-passing-for-your-agent.md @@ -1,6 +1,6 @@ --- title: Context passing for your agent -intro: 'Learn how to use context passing with your {% data variables.product.prodname_copilot_agent_short %}.' +intro: 'Learn how to use context passing with your {% data variables.copilot.copilot_agent_short %}.' versions: feature: copilot-extensions topics: @@ -11,12 +11,12 @@ type: how_to ## About context passing -{% data variables.product.prodname_copilot_extensions %} can access certain contextual information using context passing. +{% data variables.copilot.copilot_extensions %} can access certain contextual information using context passing. Context passing allows agents to receive relevant details about a user’s current file, selected text, and repository. It happens automatically when you interact with an extension, but requires your explicit authorization through {% data variables.product.prodname_github_app %} permissions for use in any organization-owned repositories. -Different clients, such as {% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and {% data variables.product.github %}, provide context through different reference types. -For example, IDEs send information such as file contents and selections, while {% data variables.product.prodname_copilot_chat_dotcom_short %} includes the current URL for the page being viewed. +Different clients, such as {% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and {% data variables.product.github %}, provide context through different reference types. +For example, IDEs send information such as file contents and selections, while {% data variables.copilot.copilot_chat_dotcom_short %} includes the current URL for the page being viewed. ## Prerequisites @@ -28,7 +28,7 @@ Context passing enables agents to receive information about the user’s active Your agent receives server-sent events (SSEs) that contain a list of messages from the user as well as references to the user’s current environment. Depending on the client, different types of context are provided. -The following table shows the reference types that are passed to {% data variables.product.prodname_copilot_extensions %} based on the client or IDE you are using. +The following table shows the reference types that are passed to {% data variables.copilot.copilot_extensions %} based on the client or IDE you are using. {% rowheaders %} @@ -41,14 +41,14 @@ The following table shows the reference types that are passed to {% data variabl {% endrowheaders %} -### Reference types for {% data variables.product.prodname_copilot_chat_short %} in IDEs +### Reference types for {% data variables.copilot.copilot_chat_short %} in IDEs The following reference types can be passed to your agent from an IDE: * `client.file`: Represents the full content of the currently active file in the IDE. * `client.selection`: Represents the selected portion of text the user highlighted in the active file. * `github.repository`: Provides information about the active repository. -### Reference types for {% data variables.product.prodname_copilot_chat_dotcom_short %} +### Reference types for {% data variables.copilot.copilot_chat_dotcom_short %} The following reference types can be passed to your agent from {% data variables.product.github %}: * `github.current-url`: Represents the URL of the current {% data variables.product.github %} page the user is viewing. diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/index.md b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/index.md index 251e5b0ebb..14dd988446 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/index.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/index.md @@ -1,7 +1,7 @@ --- title: Building a Copilot agent for your Copilot Extension shortTitle: Build a Copilot agent -intro: 'Learn how to build a custom {% data variables.product.prodname_copilot_agent_short %} that determines the functionality of your {% data variables.product.prodname_copilot_extension_short %}.' +intro: 'Learn how to build a custom {% data variables.copilot.copilot_agent_short %} that determines the functionality of your {% data variables.copilot.copilot_extension_short %}.' versions: feature: copilot topics: diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets.md b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets.md index 96d84ecae6..dd1a14b0e1 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets.md @@ -1,15 +1,15 @@ --- title: About Copilot skillsets -intro: 'Learn what {% data variables.product.prodname_copilot_skillsets %} are and how they simplify integrating third-party tools and functions into your {% data variables.product.prodname_copilot_short %} experience.' +intro: 'Learn what {% data variables.copilot.copilot_skillsets %} are and how they simplify integrating third-party tools and functions into your {% data variables.product.prodname_copilot_short %} experience.' versions: feature: copilot-extensions topics: - Copilot -shortTitle: About {% data variables.product.prodname_copilot_skillsets_short %} +shortTitle: About {% data variables.copilot.copilot_skillsets_short %} type: overview --- -A skill within {% data variables.product.prodname_copilot %} is a tool that the model calls to perform a specific task in response to a user query. A skillset is a collection of these skills (up to five per skillset). {% data variables.product.prodname_copilot_skillsets %} provide a streamlined way to extend {% data variables.product.prodname_copilot_short %}’s functionality, allowing builders to integrate external services or custom API endpoints into their {% data variables.product.prodname_copilot_short %} workflow. With skillsets, builders can enable {% data variables.product.prodname_copilot_short %} to perform tasks—such as retrieving data or executing actions in third-party services—without needing to manage complex workflows or architecture. +A skill within {% data variables.product.prodname_copilot %} is a tool that the model calls to perform a specific task in response to a user query. A skillset is a collection of these skills (up to five per skillset). {% data variables.copilot.copilot_skillsets %} provide a streamlined way to extend {% data variables.product.prodname_copilot_short %}’s functionality, allowing builders to integrate external services or custom API endpoints into their {% data variables.product.prodname_copilot_short %} workflow. With skillsets, builders can enable {% data variables.product.prodname_copilot_short %} to perform tasks—such as retrieving data or executing actions in third-party services—without needing to manage complex workflows or architecture. For a quickstart example of a skillset, see the [skillset-example](https://github.com/copilot-extensions/skillset-example) repository. For information on building a skillset, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets). @@ -20,14 +20,14 @@ For a quickstart example of a skillset, see the [skillset-example](https://githu ## The extensibility platform -Skillsets and agents both operate on the {% data variables.product.prodname_copilot_extensibility_platform %}, which manages the flow of user requests and function evaluations. With {% data variables.product.prodname_copilot_skillsets_short %}, the platform handles routing, prompt crafting, function calls and prompt generation. +Skillsets and agents both operate on the {% data variables.copilot.copilot_extensibility_platform %}, which manages the flow of user requests and function evaluations. With {% data variables.copilot.copilot_skillsets_short %}, the platform handles routing, prompt crafting, function calls and prompt generation. ### Workflow overview The extensibility platform follows a structured workflow to process user requests and generate responses: 1. **User request** -A user issues a request in the {% data variables.product.prodname_copilot_chat_short %} interface, such as asking for data or executing a specific action. +A user issues a request in the {% data variables.copilot.copilot_chat_short %} interface, such as asking for data or executing a specific action. 1. **Routing** The request is routed to the appropriate extension. For skillsets, this means the platform agent identifies and invokes the corresponding skillset based on the user’s intent. Each skill’s inference description helps the platform determine which skill to call. @@ -47,7 +47,7 @@ The language model (LLM) processes the prompt and determines: 1. **Function Evaluation** The extension invokes the selected function(s), which may involve: - * Gathering relevant context, such as {% data variables.product.prodname_copilot_skillsets_short %} repository or user metadata. + * Gathering relevant context, such as {% data variables.copilot.copilot_skillsets_short %} repository or user metadata. * Making an API call to an external service to retrieve data or execute an action. 1. **Response generation** diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md index 5ed1f5cad6..8286883b08 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md @@ -1,17 +1,17 @@ --- title: Building Copilot skillsets -intro: 'Learn the steps to build {% data variables.product.prodname_copilot_skillsets %} and integrate custom tools and functions into your Copilot environment.' +intro: 'Learn the steps to build {% data variables.copilot.copilot_skillsets %} and integrate custom tools and functions into your Copilot environment.' versions: feature: copilot-extensions topics: - Copilot -shortTitle: Build {% data variables.product.prodname_copilot_skillsets_short %} +shortTitle: Build {% data variables.copilot.copilot_skillsets_short %} type: how_to --- ## Introduction -{% data variables.product.prodname_copilot_skillsets %} are a streamlined way to extend {% data variables.product.prodname_copilot %}'s functionality by defining API endpoints that {% data variables.product.prodname_copilot_short %} can call. When you create a skillset, {% data variables.product.prodname_copilot_short %} handles all the AI interactions while your endpoints provide the data or functionality. This guide walks you through configuring and deploying a skillset within your {% data variables.product.prodname_github_app %}. +{% data variables.copilot.copilot_skillsets %} are a streamlined way to extend {% data variables.product.prodname_copilot %}'s functionality by defining API endpoints that {% data variables.product.prodname_copilot_short %} can call. When you create a skillset, {% data variables.product.prodname_copilot_short %} handles all the AI interactions while your endpoints provide the data or functionality. This guide walks you through configuring and deploying a skillset within your {% data variables.product.prodname_github_app %}. ## Prerequisites diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/index.md b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/index.md index 96fd3ea6a0..5a5ba9d0c3 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/index.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/index.md @@ -1,7 +1,7 @@ --- title: Building a Copilot skillset for your Copilot Extension shortTitle: Build a Copilot skillset -intro: 'Learn how to build a custom {% data variables.product.prodname_copilot_skillset_short %} to combine custom skills and extend the capabilities of {% data variables.product.prodname_copilot_short %}.' +intro: 'Learn how to build a custom {% data variables.copilot.copilot_skillset_short %} to combine custom skills and extend the capabilities of {% data variables.product.prodname_copilot_short %}.' versions: feature: copilot topics: diff --git a/content/copilot/building-copilot-extensions/copilot-extensions-faq.md b/content/copilot/building-copilot-extensions/copilot-extensions-faq.md index 349e2cafa4..d31f9a8302 100644 --- a/content/copilot/building-copilot-extensions/copilot-extensions-faq.md +++ b/content/copilot/building-copilot-extensions/copilot-extensions-faq.md @@ -1,6 +1,6 @@ --- title: Copilot Extensions FAQ -intro: 'Find answers to common questions about {% data variables.product.prodname_copilot_extensions %}.' +intro: 'Find answers to common questions about {% data variables.copilot.copilot_extensions %}.' versions: feature: copilot-extensions topics: @@ -11,79 +11,79 @@ type: reference ## General -This section answers common questions about {% data variables.product.prodname_copilot_extensions %}. +This section answers common questions about {% data variables.copilot.copilot_extensions %}. -* [What is the difference between a {% data variables.product.prodname_copilot_extension %} and a {% data variables.product.prodname_vscode %} chat participant?](#what-is-the-difference-between-a-github-copilot-extension-and-a-visual-studio-code-chat-participant) -* [Is indemnity provided for {% data variables.product.prodname_copilot_extensions_short %}?](#is-indemnity-provided-for-copilot-extensions) +* [What is the difference between a {% data variables.copilot.copilot_extension %} and a {% data variables.product.prodname_vscode %} chat participant?](#what-is-the-difference-between-a-github-copilot-extension-and-a-visual-studio-code-chat-participant) +* [Is indemnity provided for {% data variables.copilot.copilot_extensions_short %}?](#is-indemnity-provided-for-copilot-extensions) -### What is the difference between a {% data variables.product.prodname_copilot_extension %} and a {% data variables.product.prodname_vscode %} chat participant? +### What is the difference between a {% data variables.copilot.copilot_extension %} and a {% data variables.product.prodname_vscode %} chat participant? -{% data variables.product.prodname_copilot_extensions %} and {% data variables.product.prodname_vscode %} chat participants use the same backend platform to route requests to extensions. Both provide similar end-user experiences, integrate with {% data variables.product.prodname_copilot_chat_short %}, and can leverage the {% data variables.product.prodname_copilot_short %} API or other LLMs. +{% data variables.copilot.copilot_extensions %} and {% data variables.product.prodname_vscode %} chat participants use the same backend platform to route requests to extensions. Both provide similar end-user experiences, integrate with {% data variables.copilot.copilot_chat_short %}, and can leverage the {% data variables.product.prodname_copilot_short %} API or other LLMs. While they share similarities, below are several key differences: -* {% data variables.product.prodname_copilot_extensions %} and {% data variables.product.prodname_vscode %} chat participants are accessed through different marketplaces. -* {% data variables.product.prodname_copilot_extensions %} are server-side extensions, requiring server infrastructure to build. These extensions provide a built-in connection to your {% data variables.product.github %} workspaces, as set by your organization admin. +* {% data variables.copilot.copilot_extensions %} and {% data variables.product.prodname_vscode %} chat participants are accessed through different marketplaces. +* {% data variables.copilot.copilot_extensions %} are server-side extensions, requiring server infrastructure to build. These extensions provide a built-in connection to your {% data variables.product.github %} workspaces, as set by your organization admin. * {% data variables.product.prodname_vscode %} chat participants are client-side extensions that have read and write access to your local files. They do not require server infrastructure. -* {% data variables.product.prodname_copilot_extensions %} can be used in any editor where extensions are supported, while {% data variables.product.prodname_vscode %} Chat Participants are only available in {% data variables.product.prodname_vscode %}. +* {% data variables.copilot.copilot_extensions %} can be used in any editor where extensions are supported, while {% data variables.product.prodname_vscode %} Chat Participants are only available in {% data variables.product.prodname_vscode %}. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). -### Is indemnity provided for {% data variables.product.prodname_copilot_extensions_short %}? +### Is indemnity provided for {% data variables.copilot.copilot_extensions_short %}? -No, {% data variables.product.prodname_copilot_extensions_short %} are not covered by {% data variables.product.prodname_copilot %}’s indemnity policy. However, this exclusion applies only to issues that arise within extension chat threads. +No, {% data variables.copilot.copilot_extensions_short %} are not covered by {% data variables.product.prodname_copilot %}’s indemnity policy. However, this exclusion applies only to issues that arise within extension chat threads. Installing and using extensions does not affect indemnity coverage for any issues that occur while using other {% data variables.product.prodname_copilot_short %} features such as code completion and chat. ## Data and Permissions -This section explains what data is collected and shared when using {% data variables.product.prodname_copilot_extensions_short %}. +This section explains what data is collected and shared when using {% data variables.copilot.copilot_extensions_short %}. -* [What data is being collected and shared with {% data variables.product.prodname_copilot_extensions_short %}?](#what-data-is-being-collected-and-shared-with-copilot-extensions) -* [What permissions are required for {% data variables.product.prodname_copilot_extensions_short %}?](#what-permissions-are-required-for-copilot-extensions) -* [Who can provide permissions for {% data variables.product.prodname_copilot_extensions_short %} to access organization resources?](#who-can-provide-permissions-for-copilot-extensions-to-access-organization-resources) -* [Can a user use {% data variables.product.prodname_copilot_extensions_short %} that the organization has not provided permissions for?](#can-a-user-use-copilot-extensions-that-the-organization-has-not-provided-permissions-for) +* [What data is being collected and shared with {% data variables.copilot.copilot_extensions_short %}?](#what-data-is-being-collected-and-shared-with-copilot-extensions) +* [What permissions are required for {% data variables.copilot.copilot_extensions_short %}?](#what-permissions-are-required-for-copilot-extensions) +* [Who can provide permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources?](#who-can-provide-permissions-for-copilot-extensions-to-access-organization-resources) +* [Can a user use {% data variables.copilot.copilot_extensions_short %} that the organization has not provided permissions for?](#can-a-user-use-copilot-extensions-that-the-organization-has-not-provided-permissions-for) -### What data is being collected and shared with {% data variables.product.prodname_copilot_extensions_short %}? +### What data is being collected and shared with {% data variables.copilot.copilot_extensions_short %}? -The following data is shared when interacting with {% data variables.product.prodname_copilot_extensions_short %}: -* Data attached to your account and {% data variables.product.prodname_copilot_chat_short %} usage, such as {% data variables.product.github %} user ID, and timestamps of messages. +The following data is shared when interacting with {% data variables.copilot.copilot_extensions_short %}: +* Data attached to your account and {% data variables.copilot.copilot_chat_short %} usage, such as {% data variables.product.github %} user ID, and timestamps of messages. * Past messages within the chat thread where you are invoking an extension. Only one extension can be used per thread, preventing data sharing across extensions. The data retention period for thread context is 30 days. * Any additional organization and repository data that is authorized for the extension by your organization admin. Admins installing extensions must approve access to the required permissions prior to completing installation. -* For {% data variables.product.prodname_copilot_chat_dotcom_short %}, if your admin has approved the extension to access repository or organization metadata , that data will be shared as well. +* For {% data variables.copilot.copilot_chat_dotcom_short %}, if your admin has approved the extension to access repository or organization metadata , that data will be shared as well. -### What permissions are required for {% data variables.product.prodname_copilot_extensions_short %}? +### What permissions are required for {% data variables.copilot.copilot_extensions_short %}? {% data reusables.copilot.copilot-extensions.about-extensions-permissions %} -### Who can provide permissions for {% data variables.product.prodname_copilot_extensions_short %} to access organization resources? +### Who can provide permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources? -Only organization admins can grant permissions for {% data variables.product.prodname_copilot_extensions_short %} to access organization resources. +Only organization admins can grant permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources. Organization members may encounter cases where an extension cannot access a repository or query context. This typically happens because the organization admin has not yet provided permissions or authorized the extension. See [Granting permissions to access organization resources](/copilot/building-copilot-extensions/about-building-copilot-extensions#granting-permissions-to-access-organization-resources). -### Can a user use {% data variables.product.prodname_copilot_extensions_short %} that the organization has not provided permissions for? +### Can a user use {% data variables.copilot.copilot_extensions_short %} that the organization has not provided permissions for? -Yes, any user can install and use {% data variables.product.prodname_copilot_extensions_short %}. However, to query organization resources and repositories, an extension must be installed and authorized by an organization admin. See [Granting permissions to access organization resources](/copilot/building-copilot-extensions/about-building-copilot-extensions#granting-permissions-to-access-organization-resources). +Yes, any user can install and use {% data variables.copilot.copilot_extensions_short %}. However, to query organization resources and repositories, an extension must be installed and authorized by an organization admin. See [Granting permissions to access organization resources](/copilot/building-copilot-extensions/about-building-copilot-extensions#granting-permissions-to-access-organization-resources). Users should contact their organization admin to request installation and authorization. Company context cannot be accessed without admin permissions. ## Policies -This section covers administrative policies for {% data variables.product.prodname_copilot_extensions_short %} +This section covers administrative policies for {% data variables.copilot.copilot_extensions_short %} -* [How do I control which {% data variables.product.prodname_copilot_extensions_short %} can be used in my enterprise?](#how-do-i-control-which-copilot-extensions-can-be-used-in-my-enterprise) +* [How do I control which {% data variables.copilot.copilot_extensions_short %} can be used in my enterprise?](#how-do-i-control-which-copilot-extensions-can-be-used-in-my-enterprise) * [Is there an allowlist/blocklist at the enterprise level?](#is-there-an-allowlistblocklist-at-the-enterprise-level) -* [As a member of an organization, how can I get access to {% data variables.product.prodname_copilot_extensions_short %}?](#as-a-member-of-an-organization-how-can-i-get-access-to-copilot-extensions) +* [As a member of an organization, how can I get access to {% data variables.copilot.copilot_extensions_short %}?](#as-a-member-of-an-organization-how-can-i-get-access-to-copilot-extensions) -### How do I control which {% data variables.product.prodname_copilot_extensions_short %} can be used in my enterprise? +### How do I control which {% data variables.copilot.copilot_extensions_short %} can be used in my enterprise? -Enterprise admins can disable {% data variables.product.prodname_copilot_extensions_short %} across their enterprise by setting the **{% data variables.product.prodname_copilot_extensions_short %}** policy to "Disabled" or "No Policy". +Enterprise admins can disable {% data variables.copilot.copilot_extensions_short %} across their enterprise by setting the **{% data variables.copilot.copilot_extensions_short %}** policy to "Disabled" or "No Policy". ### Is there an allowlist/blocklist at the enterprise level? No, there is no allowlist or blocklist at the enterprise level. -### As a member of an organization, how can I get access to {% data variables.product.prodname_copilot_extensions_short %}? +### As a member of an organization, how can I get access to {% data variables.copilot.copilot_extensions_short %}? -To access {% data variables.product.prodname_copilot_extensions_short %} as a member of an organization, the organization that assigned you a {% data variables.product.github %} seat must enable the {% data variables.product.prodname_copilot_extensions_short %} policy. Additionally, the same organization must install and authorize the extension to access any organization owned repositories. +To access {% data variables.copilot.copilot_extensions_short %} as a member of an organization, the organization that assigned you a {% data variables.product.github %} seat must enable the {% data variables.copilot.copilot_extensions_short %} policy. Additionally, the same organization must install and authorize the extension to access any organization owned repositories. -For example, if you are a member of multiple organizations and Organization A has assigned you a {% data variables.product.github %} seat, you will only have access to extensions if Organization A has enabled the policy. If Organization B has enabled extensions but you do not have access, it is because Organization A has disabled the {% data variables.product.prodname_copilot_extensions_short %} policy. +For example, if you are a member of multiple organizations and Organization A has assigned you a {% data variables.product.github %} seat, you will only have access to extensions if Organization A has enabled the policy. If Organization B has enabled extensions but you do not have access, it is because Organization A has disabled the {% data variables.copilot.copilot_extensions_short %} policy. diff --git a/content/copilot/building-copilot-extensions/copilot-extensions-glossary.md b/content/copilot/building-copilot-extensions/copilot-extensions-glossary.md index 3578bb02bb..94f4157e66 100644 --- a/content/copilot/building-copilot-extensions/copilot-extensions-glossary.md +++ b/content/copilot/building-copilot-extensions/copilot-extensions-glossary.md @@ -1,6 +1,6 @@ --- title: Copilot Extensions Glossary -intro: 'Understand the terminology used in {% data variables.product.prodname_copilot_extensions_short %}.' +intro: 'Understand the terminology used in {% data variables.copilot.copilot_extensions_short %}.' versions: feature: copilot-extensions topics: @@ -9,39 +9,39 @@ shortTitle: Extensions Glossary type: reference --- -The following terms are used in the context of {% data variables.product.prodname_copilot_extensions_short %}, and are defined here for clarity. +The following terms are used in the context of {% data variables.copilot.copilot_extensions_short %}, and are defined here for clarity. #### Agent -A type of {% data variables.product.prodname_copilot_extension_short %} implementation that gives developers full control over handling user queries and response generation. This approach is ideal for builders who want complete customization and management of AI interactions. +A type of {% data variables.copilot.copilot_extension_short %} implementation that gives developers full control over handling user queries and response generation. This approach is ideal for builders who want complete customization and management of AI interactions. #### Context Passing -A capability in {% data variables.product.prodname_copilot_extensions_short %} that enables user context from editors to be sent to agents, allowing for more tailored responses. +A capability in {% data variables.copilot.copilot_extensions_short %} that enables user context from editors to be sent to agents, allowing for more tailored responses. -#### {% data variables.product.prodname_copilot_chat_short %} +#### {% data variables.copilot.copilot_chat_short %} The conversational interface within {% data variables.product.prodname_copilot %} where users can interact with the AI assistant and extensions. -#### {% data variables.product.prodname_copilot_extension_short %} +#### {% data variables.copilot.copilot_extension_short %} -A {% data variables.product.prodname_github_app %} with additional access to the {% data variables.product.prodname_copilot_chat_short %} window and Copilot API, allowing for extended functionality in {% data variables.product.company_short %}'s {% data variables.product.prodname_copilot_chat_short %}. This is how we will refer to extensions from the perspective of an extension user. +A {% data variables.product.prodname_github_app %} with additional access to the {% data variables.copilot.copilot_chat_short %} window and Copilot API, allowing for extended functionality in {% data variables.product.company_short %}'s {% data variables.copilot.copilot_chat_short %}. This is how we will refer to extensions from the perspective of an extension user. #### {% data variables.product.prodname_copilot_short %} Extensibility Platform The system that handles authentication and proxies requests between clients and agent plugins. -#### {% data variables.product.prodname_copilot_extension_vsc %} +#### {% data variables.copilot.copilot_extension_vsc %} -Also known as {% data variables.product.prodname_vscode %} Chat extensions, {% data variables.product.prodname_copilot_extensions_vsc %} are built as a {% data variables.product.prodname_vscode %} extension rather than a {% data variables.product.prodname_github_app %}. These extensions are exclusive to {% data variables.product.prodname_vscode_shortname %} and can be downloaded from the {% data variables.product.prodname_vscode_shortname %} Marketplace. +Also known as {% data variables.product.prodname_vscode %} Chat extensions, {% data variables.copilot.copilot_extensions_vsc %} are built as a {% data variables.product.prodname_vscode %} extension rather than a {% data variables.product.prodname_github_app %}. These extensions are exclusive to {% data variables.product.prodname_vscode_shortname %} and can be downloaded from the {% data variables.product.prodname_vscode_shortname %} Marketplace. #### {% data variables.product.prodname_github_app %} -The foundation for a {% data variables.product.prodname_copilot_extension_short %} that provides the necessary infrastructure, permissions, and context from {% data variables.product.company_short %}, such as user, repo and organization metadata. +The foundation for a {% data variables.copilot.copilot_extension_short %} that provides the necessary infrastructure, permissions, and context from {% data variables.product.company_short %}, such as user, repo and organization metadata. #### {% data variables.product.prodname_marketplace %} -The platform where {% data variables.product.company_short %} approved {% data variables.product.prodname_copilot_extensions %} can be listed publicly and discovered by users. +The platform where {% data variables.product.company_short %} approved {% data variables.copilot.copilot_extensions %} can be listed publicly and discovered by users. #### Listed/Published Extension @@ -61,7 +61,7 @@ A piece of code that retrieves context or executes an action in response to a us #### Skillset -A type of {% data variables.product.prodname_copilot_extension_short %} implementation that gives developers the ability to connect external services and custom API endpoints to {% data variables.product.prodname_copilot_short %} with minimal complexity. The {% data variables.product.prodname_copilot_extensibility_platform_short %} handles prompt crafting, function evaluation, and response generation. The builder only needs to handle API skill definitions. This approach is ideal for builders who want minimal complexity. +A type of {% data variables.copilot.copilot_extension_short %} implementation that gives developers the ability to connect external services and custom API endpoints to {% data variables.product.prodname_copilot_short %} with minimal complexity. The {% data variables.copilot.copilot_extensibility_platform_short %} handles prompt crafting, function evaluation, and response generation. The builder only needs to handle API skill definitions. This approach is ideal for builders who want minimal complexity. #### Tool/Function Calling diff --git a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension.md b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension.md index 79f64da75f..6dc1cb1a3e 100644 --- a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension.md +++ b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension.md @@ -1,6 +1,6 @@ --- title: Configuring your GitHub App for your Copilot extension -intro: 'Learn how to configure your {% data variables.product.prodname_github_app %} so that it is associated with your {% data variables.product.prodname_copilot_extension_short %}.' +intro: 'Learn how to configure your {% data variables.product.prodname_github_app %} so that it is associated with your {% data variables.copilot.copilot_extension_short %}.' defaultTool: agents versions: feature: copilot-extensions @@ -16,7 +16,7 @@ Once you have configured your server and created your {% data variables.product. ## Prerequisites -* You have configured your server to deploy your {% data variables.product.prodname_copilot_extension_short %}, and you have your hostname (aka forwarding endpoint). For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). +* You have configured your server to deploy your {% data variables.copilot.copilot_extension_short %}, and you have your hostname (aka forwarding endpoint). For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). * You have created a {% data variables.product.prodname_github_app %} for your {% data variables.product.prodname_copilot_short %} extension. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension). ## Configuring your {% data variables.product.prodname_github_app %} @@ -25,7 +25,7 @@ Once you have configured your server and created your {% data variables.product. {% data reusables.apps.settings-step %} {% data reusables.apps.enterprise-apps-steps %} -1. To the right of the {% data variables.product.prodname_github_app %} you want to configure for your {% data variables.product.prodname_copilot_extension_short %}, click **Edit**. +1. To the right of the {% data variables.product.prodname_github_app %} you want to configure for your {% data variables.copilot.copilot_extension_short %}, click **Edit**. 1. In the "Identifying and authorizing users" section, under "Callback URL", enter your callback endpoint URL, then click **Save changes**. > [!NOTE] Your server's hostname is the forwarding endpoint that you copied from your terminal when you configured your server. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). @@ -36,7 +36,7 @@ Once you have configured your server and created your {% data variables.product. 1. To expand the "Account permissions" section, click anywhere in the section. {% data reusables.copilot.copilot-extensions.account-permissions %} 1. In the left sidebar, click **{% data variables.product.prodname_copilot_short %}**. -1. Read the {% data variables.product.prodname_marketplace %} Developer Agreement and the {% data variables.product.github %} Pre-release License Terms, then accept the terms for creating a {% data variables.product.prodname_copilot_extension_short %}. +1. Read the {% data variables.product.prodname_marketplace %} Developer Agreement and the {% data variables.product.github %} Pre-release License Terms, then accept the terms for creating a {% data variables.copilot.copilot_extension_short %}. 1. In the "App type" section, select the dropdown menu, then click **Agent**. 1. Under "URL," enter your server's hostname (aka forwarding endpoint) that you copied from your terminal. @@ -57,7 +57,7 @@ Once you have configured your server and created your {% data variables.product. {% data reusables.apps.settings-step %} {% data reusables.apps.enterprise-apps-steps %} -1. To the right of the {% data variables.product.prodname_github_app %} you want to configure for your {% data variables.product.prodname_copilot_extension_short %}, click **Edit**. +1. To the right of the {% data variables.product.prodname_github_app %} you want to configure for your {% data variables.copilot.copilot_extension_short %}, click **Edit**. 1. In the "Identifying and authorizing users" section, under "Callback URL", enter your callback endpoint URL, then click **Save changes**. > [!NOTE] Your server's hostname is the forwarding endpoint that you copied from your terminal when you configured your server. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). @@ -68,7 +68,7 @@ Once you have configured your server and created your {% data variables.product. 1. To expand the "Account permissions" section, click anywhere in the section. {% data reusables.copilot.copilot-extensions.account-permissions %} 1. In the left sidebar, click **{% data variables.product.prodname_copilot_short %}**. -1. Read the {% data variables.product.prodname_marketplace %} Developer Agreement and the {% data variables.product.github %} Pre-release License Terms, then accept the terms for creating a {% data variables.product.prodname_copilot_extension_short %}. +1. Read the {% data variables.product.prodname_marketplace %} Developer Agreement and the {% data variables.product.github %} Pre-release License Terms, then accept the terms for creating a {% data variables.copilot.copilot_extension_short %}. 1. In the "App type" section, select the dropdown menu, then click **Skillset**. 1. Your pre-authorization URL is a link on your website that starts the authorization process for your extension. Users will be redirected to this URL when they decide to authorize your extension. If you are using a pre-authorization URL, under "Pre-authorization URL," enter the URL, then click **Save**. diff --git a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-host-your-copilot-extension.md b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-host-your-copilot-extension.md index befb28c0ce..6d345c9d1c 100644 --- a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-host-your-copilot-extension.md +++ b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-host-your-copilot-extension.md @@ -12,13 +12,13 @@ shortTitle: Host your extension type: how_to --- -Your {% data variables.product.prodname_copilot_extension_short %} must be hosted on a server that is accessible to the internet. In this guide, we will use [ngrok](https://ngrok.com/) to create a tunnel to your local server, but you could also use a service like [localtunnel](https://localtunnel.github.io/www/). +Your {% data variables.copilot.copilot_extension_short %} must be hosted on a server that is accessible to the internet. In this guide, we will use [ngrok](https://ngrok.com/) to create a tunnel to your local server, but you could also use a service like [localtunnel](https://localtunnel.github.io/www/). Alternatively, if you are a {% data variables.product.prodname_codespaces %} user, you can use the built-in {% data variables.product.prodname_codespaces %} port forwarding. For more information, see [AUTOTITLE](/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace). ## Prerequisites -* You have created a {% data variables.product.prodname_copilot_extension_short %}. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension) or [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension). +* You have created a {% data variables.copilot.copilot_extension_short %}. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension) or [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension). ## Configuring your server diff --git a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension.md b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension.md index 3676ebd757..cf0e37f9f3 100644 --- a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension.md +++ b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension.md @@ -1,6 +1,6 @@ --- title: Creating a GitHub App for your Copilot Extension -intro: 'Learn how to create a {% data variables.product.prodname_github_app %} for your {% data variables.product.prodname_copilot_extension_short %}.' +intro: 'Learn how to create a {% data variables.product.prodname_github_app %} for your {% data variables.copilot.copilot_extension_short %}.' versions: feature: copilot-extensions topics: @@ -9,12 +9,12 @@ shortTitle: Create GitHub App type: how_to --- -A {% data variables.product.prodname_copilot_extension_short %} is a {% data variables.product.prodname_github_app %} that is associated with a {% data variables.product.prodname_copilot_agent_short %}. The {% data variables.product.prodname_github_app %} you associate your {% data variables.product.prodname_copilot_agent_short %} with is used to authenticate the {% data variables.product.prodname_copilot_agent_short %} with {% data variables.product.prodname_dotcom %} and to authorize the {% data variables.product.prodname_copilot_agent_short %} to access the {% data variables.product.prodname_copilot_chat_short %} API. Each {% data variables.product.prodname_copilot_agent_short %} must be associated with a unique {% data variables.product.prodname_github_app %}. +A {% data variables.copilot.copilot_extension_short %} is a {% data variables.product.prodname_github_app %} that is associated with a {% data variables.copilot.copilot_agent_short %}. The {% data variables.product.prodname_github_app %} you associate your {% data variables.copilot.copilot_agent_short %} with is used to authenticate the {% data variables.copilot.copilot_agent_short %} with {% data variables.product.prodname_dotcom %} and to authorize the {% data variables.copilot.copilot_agent_short %} to access the {% data variables.copilot.copilot_chat_short %} API. Each {% data variables.copilot.copilot_agent_short %} must be associated with a unique {% data variables.product.prodname_github_app %}. ## Prerequisites -* You have created a {% data variables.product.prodname_copilot_agent_short %}. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension). -* You have configured your server to deploy your {% data variables.product.prodname_copilot_agent_short %}, and you have your hostname (aka forwarding endpoint). For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). +* You have created a {% data variables.copilot.copilot_agent_short %}. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension). +* You have configured your server to deploy your {% data variables.copilot.copilot_agent_short %}, and you have your hostname (aka forwarding endpoint). For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). ## Creating a {% data variables.product.prodname_github_app %} diff --git a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/index.md b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/index.md index eb49ebbc71..91eb74fc4a 100644 --- a/content/copilot/building-copilot-extensions/creating-a-copilot-extension/index.md +++ b/content/copilot/building-copilot-extensions/creating-a-copilot-extension/index.md @@ -1,7 +1,7 @@ --- title: Creating a Copilot Extension shortTitle: Create a Copilot Extension -intro: 'Learn how to integrate your {% data variables.product.prodname_copilot_agent_short %} with a {% data variables.product.prodname_github_app %} to create your {% data variables.product.prodname_copilot_extension_short %}.' +intro: 'Learn how to integrate your {% data variables.copilot.copilot_agent_short %} with a {% data variables.product.prodname_github_app %} to create your {% data variables.copilot.copilot_extension_short %}.' versions: feature: copilot topics: diff --git a/content/copilot/building-copilot-extensions/debugging-your-github-copilot-extension.md b/content/copilot/building-copilot-extensions/debugging-your-github-copilot-extension.md index 6d72e7f36b..10f0e06e0d 100644 --- a/content/copilot/building-copilot-extensions/debugging-your-github-copilot-extension.md +++ b/content/copilot/building-copilot-extensions/debugging-your-github-copilot-extension.md @@ -1,6 +1,6 @@ --- title: Debugging your GitHub Copilot Extension -intro: 'Learn how to debug your {% data variables.product.prodname_copilot_extension %} from the command line before you publish it.' +intro: 'Learn how to debug your {% data variables.copilot.copilot_extension %} from the command line before you publish it.' versions: feature: copilot-extensions topics: @@ -8,10 +8,10 @@ topics: shortTitle: Debug Copilot Extension --- -With the debug tool for {% data variables.product.prodname_copilot_extensions_short %}, you can chat with your {% data variables.product.prodname_copilot_agent_short %} from the command line, then view detailed logs as your agent generates a response. You can pass several flags to the tool, with the most important flags being: -* The `url` flag, which contains the URL to access your {% data variables.product.prodname_copilot_agent_short %}. This is the only required flag to start the tool. -* The `log-level` flag, which determines the level of visibility you have into your {% data variables.product.prodname_copilot_agent_short %}'s process for generating a response. The available log levels are `DEBUG`, `NONE`, and `TRACE`, and the tool uses `DEBUG` by default. -* The `token` flag, which must contain a {% data variables.product.pat_v2 %} with read access to {% data variables.product.prodname_copilot_chat_short %} if your {% data variables.product.prodname_copilot_agent_short %} calls the {% data variables.product.prodname_copilot_short %} LLM. If your agent calls a different LLM, you don't need to use this flag. +With the debug tool for {% data variables.copilot.copilot_extensions_short %}, you can chat with your {% data variables.copilot.copilot_agent_short %} from the command line, then view detailed logs as your agent generates a response. You can pass several flags to the tool, with the most important flags being: +* The `url` flag, which contains the URL to access your {% data variables.copilot.copilot_agent_short %}. This is the only required flag to start the tool. +* The `log-level` flag, which determines the level of visibility you have into your {% data variables.copilot.copilot_agent_short %}'s process for generating a response. The available log levels are `DEBUG`, `NONE`, and `TRACE`, and the tool uses `DEBUG` by default. +* The `token` flag, which must contain a {% data variables.product.pat_v2 %} with read access to {% data variables.copilot.copilot_chat_short %} if your {% data variables.copilot.copilot_agent_short %} calls the {% data variables.product.prodname_copilot_short %} LLM. If your agent calls a different LLM, you don't need to use this flag. ## Prerequisites @@ -24,13 +24,13 @@ To use the debug tool, you need to have the {% data variables.product.prodname_c * From the [{% data variables.product.prodname_cli %} releases page](https://github.com/cli/cli/releases/tag/v2.56.0) -## Debugging your {% data variables.product.prodname_copilot_extension_short %} with the CLI +## Debugging your {% data variables.copilot.copilot_extension_short %} with the CLI -1. Optionally, to prepare to debug a specific server-sent event (SSE), add some code to your {% data variables.product.prodname_copilot_agent_short %} that sends an SSE when a prompt contains a certain keyword. +1. Optionally, to prepare to debug a specific server-sent event (SSE), add some code to your {% data variables.copilot.copilot_agent_short %} that sends an SSE when a prompt contains a certain keyword. > [!NOTE] The debug tool does not handle the payload verification process. To validate your SSEs, you need to temporarily disable payload verification for local testing, then re-enable it after you have successfully tested your extension. -1. On the command line, start your {% data variables.product.prodname_copilot_agent_short %}. +1. On the command line, start your {% data variables.copilot.copilot_agent_short %}. 1. To authenticate with the {% data variables.product.prodname_cli %} {% data variables.product.prodname_oauth_app %}, in a new window of your command line application, paste the following command and follow the prompts: ```bash copy @@ -69,4 +69,4 @@ To use the debug tool, you need to have the {% data variables.product.prodname_c 1. To interact with your agent, enter a prompt on the command line. The output will vary based on the log level you chose in the previous step, with the `DEBUG` and `TRACE` log levels providing more detailed information. - > [!TIP] If you are debugging an SSE, send a prompt containing the keyword you specified in your {% data variables.product.prodname_copilot_agent_short %} to trigger the SSE, then analyze the output in your command line application. + > [!TIP] If you are debugging an SSE, send a prompt containing the keyword you specified in your {% data variables.copilot.copilot_agent_short %} to trigger the SSE, then analyze the output in your command line application. diff --git a/content/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension.md b/content/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension.md index d4556674f0..911b2b9de5 100644 --- a/content/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension.md +++ b/content/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension.md @@ -1,6 +1,6 @@ --- title: Managing the availability of your Copilot Extension -intro: 'After you build your {% data variables.product.prodname_copilot_extension_short %}, you can change it''s visibility or publish it on the {% data variables.product.prodname_marketplace %}.' +intro: 'After you build your {% data variables.copilot.copilot_extension_short %}, you can change it''s visibility or publish it on the {% data variables.product.prodname_marketplace %}.' versions: feature: copilot-extensions topics: @@ -9,38 +9,38 @@ shortTitle: Manage Extension availability type: how_to --- -When you build a {% data variables.product.prodname_copilot_extension_short %}, you have two options for the visibility of your {% data variables.product.prodname_github_app %}: +When you build a {% data variables.copilot.copilot_extension_short %}, you have two options for the visibility of your {% data variables.product.prodname_github_app %}: * **Public:** Any user or organization account with the link to your app's installation page can install it. Making your app public automatically creates a public installation page, but does not list the app on the {% data variables.product.prodname_marketplace %}. * **Private:** Any user, organization, or enterprise can create an extension. Any user or organization, and any organization in an enterprise can install an enterprise-created extension. Private extensions are not available to all users outside your organization or enterprise based on the level at which it was created. If you make your app public, you can choose to publish it on the {% data variables.product.prodname_marketplace %}. -## Changing the visibility of your {% data variables.product.prodname_copilot_extension_short %} +## Changing the visibility of your {% data variables.copilot.copilot_extension_short %} {% data reusables.profile.access_org %} {% data reusables.organizations.org-list %} 1. At the bottom of the sidebar, select **{% octicon "code" aria-hidden="true" aria-label="code" %} Developer settings**, then click **{% data variables.product.prodname_github_apps %}**. -1. In the "{% data variables.product.prodname_github_apps %}" section, next to the name of your {% data variables.product.prodname_copilot_extension_short %}, click **Edit**. +1. In the "{% data variables.product.prodname_github_apps %}" section, next to the name of your {% data variables.copilot.copilot_extension_short %}, click **Edit**. 1. In the sidebar, click **Advanced**. At the bottom of the "Danger Zone" section, you will see one of two options: * **Make public:** If you see the **Make public** option, your {% data variables.product.prodname_github_app %} is currently private, and can only be installed by the organization or user that created the app. You can click **Make public** to allow any other account with the link to your app's installation page to install your {% data variables.product.prodname_copilot_short %} extension. Leave the settings unchanged to keep your app private. * **Make private:** If you see the **Make private** option, your {% data variables.product.prodname_github_app %} is currently public, and can be installed by any account with the link to your app's installation page. You can click **Make private** to only allow installations by the organization or user that created the app, or organizations that are part of the enterprise that created the extension. Leave the settings unchanged to keep your app public. -1. Optionally, if your {% data variables.product.prodname_github_app %} is public, you can share the link to the installation page for your {% data variables.product.prodname_copilot_extension_short %}. In the sidebar, click **Public page** in the sidebar, then copy the link for your listing. +1. Optionally, if your {% data variables.product.prodname_github_app %} is public, you can share the link to the installation page for your {% data variables.copilot.copilot_extension_short %}. In the sidebar, click **Public page** in the sidebar, then copy the link for your listing. > [!NOTE] You can set a published marketplace extension to private, and it will remain accessible on the {% data variables.product.prodname_marketplace %}. However, it won't be accessible from the direct installation page. -## Listing your {% data variables.product.prodname_copilot_extension_short %} on the {% data variables.product.prodname_marketplace %} +## Listing your {% data variables.copilot.copilot_extension_short %} on the {% data variables.product.prodname_marketplace %} - To list your {% data variables.product.prodname_copilot_extension_short %} on the {% data variables.product.prodname_marketplace %}, you must meet the following requirements: + To list your {% data variables.copilot.copilot_extension_short %} on the {% data variables.product.prodname_marketplace %}, you must meet the following requirements: * You must publish your app from an organization that is a verified publisher on the {% data variables.product.prodname_marketplace %}. * If your organization is not yet verified, see [AUTOTITLE](/apps/github-marketplace/github-marketplace-overview/applying-for-publisher-verification-for-your-organization). * If you need to transfer ownership of your app from your personal account to your organization account, see [AUTOTITLE](/apps/maintaining-github-apps/transferring-ownership-of-a-github-app). -* Your app must meet the requirements for all {% data variables.product.prodname_copilot_extension_short %} listings on the {% data variables.product.prodname_marketplace %}. See [AUTOTITLE](/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app#requirements-for-github-copilot-extensions). +* Your app must meet the requirements for all {% data variables.copilot.copilot_extension_short %} listings on the {% data variables.product.prodname_marketplace %}. See [AUTOTITLE](/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app#requirements-for-github-copilot-extensions). App managers cannot create, edit, or publish extensions on the {% data variables.product.prodname_marketplace %}. To manage a listing, you should be an organization owner for the publishing organization. -> [!NOTE] Paid plans are not supported for {% data variables.product.prodname_copilot_extensions_short %} during {% data variables.release-phases.public_preview %}. Any requests to publish with a paid plan attached will not be approved. +> [!NOTE] Paid plans are not supported for {% data variables.copilot.copilot_extensions_short %} during {% data variables.release-phases.public_preview %}. Any requests to publish with a paid plan attached will not be approved. {% data reusables.profile.access_org %} {% data reusables.organizations.org-list %} @@ -52,10 +52,10 @@ App managers cannot create, edit, or publish extensions on the {% data variables * `YOUR-COMPANY-NAME` (example "{% data variables.product.github %}"): We recommend this convention if your extension spans multiple products. * `YOUR-COMPANY-PRODUCT-NAME` (example: "{% data variables.product.prodname_copilot %}"): We recommend this convention if your extension stays within the scope of one product, but there are other well-known products with the same name. - > [!NOTE] The listing name is not the same as your {% data variables.product.prodname_github_app %}'s name or your {% data variables.product.prodname_copilot_extension_short %}'s slug. Changing the listing name will not affect the app name or slug. + > [!NOTE] The listing name is not the same as your {% data variables.product.prodname_github_app %}'s name or your {% data variables.copilot.copilot_extension_short %}'s slug. Changing the listing name will not affect the app name or slug. 1. In the "Primary category" section, select the dropdown menu, then click a category. You can change your selection or add a secondary category later. -1. To create a draft listing for your {% data variables.product.prodname_copilot_extension_short %}, click **Save and add more details**. +1. To create a draft listing for your {% data variables.copilot.copilot_extension_short %}, click **Save and add more details**. 1. After you create a new draft listing, you'll see a view where you can manage your listing. Before you can submit your listing for review, you need to: * Fill out each of the required sections * Verify the organization account that owns the {% data variables.product.prodname_github_app %} diff --git a/content/copilot/building-copilot-extensions/quickstart-for-github-copilot-extensions-using-agents.md b/content/copilot/building-copilot-extensions/quickstart-for-github-copilot-extensions-using-agents.md index 34e5088b1d..7ae975162c 100644 --- a/content/copilot/building-copilot-extensions/quickstart-for-github-copilot-extensions-using-agents.md +++ b/content/copilot/building-copilot-extensions/quickstart-for-github-copilot-extensions-using-agents.md @@ -1,7 +1,7 @@ --- title: Quickstart for GitHub Copilot Extensions using agents defaultTool: vscode -intro: 'Build and try out {% data variables.product.github %}''s Blackbeard extension to learn about the development process for {% data variables.product.prodname_copilot_extensions %}.' +intro: 'Build and try out {% data variables.product.github %}''s Blackbeard extension to learn about the development process for {% data variables.copilot.copilot_extensions %}.' versions: feature: copilot-extensions redirect_from: @@ -12,11 +12,11 @@ topics: shortTitle: Extensions quickstart --- -The [Blackbeard extension](https://github.com/copilot-extensions/blackbeard-extension) is a {% data variables.product.prodname_copilot_extension %} that comprises a {% data variables.product.prodname_github_app %} and a {% data variables.product.prodname_copilot_short %} agent. The agent responds to chat requests in the style of a pirate, using {% data variables.product.prodname_copilot_short %}'s large language model (LLM) API and special system prompts. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents). +The [Blackbeard extension](https://github.com/copilot-extensions/blackbeard-extension) is a {% data variables.copilot.copilot_extension %} that comprises a {% data variables.product.prodname_github_app %} and a {% data variables.product.prodname_copilot_short %} agent. The agent responds to chat requests in the style of a pirate, using {% data variables.product.prodname_copilot_short %}'s large language model (LLM) API and special system prompts. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents). This guide uses a simple agent implementation, but the process is similar for skillsets. For information about the difference between agents and skillsets, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions#about-skillsets-and-agents). -This quickstart is designed to help you build and chat with the Blackbeard extension as quickly as possible, so you can develop and test your extension without deploying infrastructure. For production, you'll need to host the application for your agent or skillset's endpoints on a publicly accessible server. To instead learn how to create a new {% data variables.product.prodname_copilot_extension %}, see [AUTOTITLE](/copilot/building-copilot-extensions/setting-up-copilot-extensions). +This quickstart is designed to help you build and chat with the Blackbeard extension as quickly as possible, so you can develop and test your extension without deploying infrastructure. For production, you'll need to host the application for your agent or skillset's endpoints on a publicly accessible server. To instead learn how to create a new {% data variables.copilot.copilot_extension %}, see [AUTOTITLE](/copilot/building-copilot-extensions/setting-up-copilot-extensions). ## 1. Create and install a {% data variables.product.prodname_github_app %} @@ -44,10 +44,10 @@ Rather than deploying the Blackbeard agent as a web app, you can host your agent After you set up your {% data variables.product.prodname_github_app %} and Blackbeard agent, you can integrate the agent with your app and test the Blackbeard extension. You need to make the following changes to your {% data variables.product.prodname_github_app %} settings: * In the "General" settings, in the "Callback URL" field, paste the local address for your agent. -* In the "Permissions & events" settings, grant read-only permissions to {% data variables.product.prodname_copilot_chat_short %}. +* In the "Permissions & events" settings, grant read-only permissions to {% data variables.copilot.copilot_chat_short %}. * In the "{% data variables.product.prodname_copilot_short %}" settings, set your app type to "Agent," then fill out the remaining fields. -After you update your {% data variables.product.prodname_github_app %} settings, you can start chatting with your extension by typing `@YOUR-EXTENSION-NAME` in the {% data variables.product.prodname_copilot_chat_short %} window, then sending a prompt as normal. +After you update your {% data variables.product.prodname_github_app %} settings, you can start chatting with your extension by typing `@YOUR-EXTENSION-NAME` in the {% data variables.copilot.copilot_chat_short %} window, then sending a prompt as normal. For more detailed instructions, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent#configuring-your-github-app). @@ -69,12 +69,12 @@ Rather than deploying the Blackbeard agent as a web app, you can host your agent After you set up your {% data variables.product.prodname_github_app %} and Blackbeard agent, you can integrate the agent with your app and test the Blackbeard extension. You need to make the following changes to your {% data variables.product.prodname_github_app %} settings: * In the "General" settings, in the "Callback URL" field, paste the forwarded address for your agent. -* In the "Permissions & events" settings, grant read-only permissions to {% data variables.product.prodname_copilot_chat_short %}. +* In the "Permissions & events" settings, grant read-only permissions to {% data variables.copilot.copilot_chat_short %}. * In the "{% data variables.product.prodname_copilot_short %}" settings, set your app type to "Agent," then fill out the remaining fields. -After you update your {% data variables.product.prodname_github_app %} settings, you can start chatting with your extension by typing `@YOUR-EXTENSION-NAME` in the {% data variables.product.prodname_copilot_chat_short %} window of a supported client or IDE, then sending a prompt as normal. For a list of supported clients and IDEs, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions#supported-clients-and-ides). +After you update your {% data variables.product.prodname_github_app %} settings, you can start chatting with your extension by typing `@YOUR-EXTENSION-NAME` in the {% data variables.copilot.copilot_chat_short %} window of a supported client or IDE, then sending a prompt as normal. For a list of supported clients and IDEs, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions#supported-clients-and-ides). -> [!NOTE] Chatting with {% data variables.product.prodname_copilot_extensions %} in {% data variables.product.prodname_github_codespaces %} is not supported. +> [!NOTE] Chatting with {% data variables.copilot.copilot_extensions %} in {% data variables.product.prodname_github_codespaces %} is not supported. For more detailed instructions, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent#configuring-your-github-app). @@ -107,10 +107,10 @@ To make the Blackbeard agent accessible to the {% data variables.product.prodnam To integrate your {% data variables.product.prodname_github_app %} with the Blackbeard agent, you need to make the following changes to your app settings: * In the "General" settings, in the "Callback URL" field, paste the URL for your exposed server. -* In the "Permissions & events" settings, grant read-only permissions to {% data variables.product.prodname_copilot_chat_short %}. +* In the "Permissions & events" settings, grant read-only permissions to {% data variables.copilot.copilot_chat_short %}. * In the "{% data variables.product.prodname_copilot_short %}" settings, set your app type to "Agent," then fill out the remaining fields. -After you update your {% data variables.product.prodname_github_app %} settings, you can start chatting with your extension by typing `@YOUR-EXTENSION-NAME` in the {% data variables.product.prodname_copilot_chat_short %} window, then sending a prompt as normal. +After you update your {% data variables.product.prodname_github_app %} settings, you can start chatting with your extension by typing `@YOUR-EXTENSION-NAME` in the {% data variables.copilot.copilot_chat_short %} window, then sending a prompt as normal. For more detailed instructions, see [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent#configuring-your-github-app). @@ -118,11 +118,11 @@ For more detailed instructions, see [AUTOTITLE](/copilot/building-copilot-extens ## Next steps -Now that you have a working {% data variables.product.prodname_copilot_extension %}, you can try building on the Blackbeard agent to experiment with agent development. +Now that you have a working {% data variables.copilot.copilot_extension %}, you can try building on the Blackbeard agent to experiment with agent development. To learn about more complex agent implementations, you can also review the following example agents and software development kit (SDK), all of which are available in the [`copilot-extensions`](https://github.com/copilot-extensions) organization: -* [{% data variables.product.prodname_github_models %}](https://github.com/copilot-extensions/github-models-extension): A more complex agent that lets you ask about and interact with various LLMs listed on the {% data variables.product.prodname_marketplace %} through {% data variables.product.prodname_copilot_chat_short %}. The {% data variables.product.prodname_github_models %} agent makes use of function calling. +* [{% data variables.product.prodname_github_models %}](https://github.com/copilot-extensions/github-models-extension): A more complex agent that lets you ask about and interact with various LLMs listed on the {% data variables.product.prodname_marketplace %} through {% data variables.copilot.copilot_chat_short %}. The {% data variables.product.prodname_github_models %} agent makes use of function calling. * [Function Calling](https://github.com/copilot-extensions/function-calling-extension): An example agent written in Go that demonstrates function calling and confirmation dialogs. * [RAG Extension](https://github.com/copilot-extensions/rag-extension): An example agent written in Go that demonstrates a simple implementation of retrieval augmented generation. -* [Preview SDK](https://github.com/copilot-extensions/preview-sdk.js/tree/main): An SDK that streamlines the development of {% data variables.product.prodname_copilot_extensions_short %} by handling request verification, payload parsing, and response formatting automatically. This SDK allows extension builders to focus more on creating core functionality and less on boilerplate code. +* [Preview SDK](https://github.com/copilot-extensions/preview-sdk.js/tree/main): An SDK that streamlines the development of {% data variables.copilot.copilot_extensions_short %} by handling request verification, payload parsing, and response formatting automatically. This SDK allows extension builders to focus more on creating core functionality and less on boilerplate code. diff --git a/content/copilot/building-copilot-extensions/setting-up-copilot-extensions.md b/content/copilot/building-copilot-extensions/setting-up-copilot-extensions.md index 45e7ad3276..a059db9364 100644 --- a/content/copilot/building-copilot-extensions/setting-up-copilot-extensions.md +++ b/content/copilot/building-copilot-extensions/setting-up-copilot-extensions.md @@ -1,6 +1,6 @@ --- title: Setting up Copilot Extensions -intro: 'Follow these steps to start building {% data variables.product.prodname_copilot_extensions_short %}.' +intro: 'Follow these steps to start building {% data variables.copilot.copilot_extensions_short %}.' defaultTool: agents versions: feature: copilot-extensions @@ -9,7 +9,7 @@ topics: shortTitle: Set up Copilot Extensions --- -This article is designed to help you build an entirely new {% data variables.product.prodname_copilot_extension %}. To instead learn how to quickly build and test a demo {% data variables.product.prodname_copilot_extension_short %} created by {% data variables.product.github %}, see [AUTOTITLE](/copilot/building-copilot-extensions/quickstart-for-github-copilot-extensions). +This article is designed to help you build an entirely new {% data variables.copilot.copilot_extension %}. To instead learn how to quickly build and test a demo {% data variables.copilot.copilot_extension_short %} created by {% data variables.product.github %}, see [AUTOTITLE](/copilot/building-copilot-extensions/quickstart-for-github-copilot-extensions). {% data reusables.copilot.copilot-extensions.differences-between-agents-and-skillsets-1 %} For more information about skillsets, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets). @@ -17,90 +17,90 @@ For more information about skillsets, see [AUTOTITLE](/copilot/building-copilot- {% agents %} -## 1. Learn about {% data variables.product.prodname_copilot_agents_short %} +## 1. Learn about {% data variables.copilot.copilot_agents_short %} -{% data variables.product.prodname_copilot_agents_short %} contain the custom code for your {% data variables.product.prodname_copilot_extension_short %}, and integrate with a {% data variables.product.prodname_github_app %} to form the {% data variables.product.prodname_copilot_extension_short %} itself. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents). +{% data variables.copilot.copilot_agents_short %} contain the custom code for your {% data variables.copilot.copilot_extension_short %}, and integrate with a {% data variables.product.prodname_github_app %} to form the {% data variables.copilot.copilot_extension_short %} itself. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/about-copilot-agents). -To successfully build a {% data variables.product.prodname_copilot_agent_short %}, you need to understand how the agent communicates with: +To successfully build a {% data variables.copilot.copilot_agent_short %}, you need to understand how the agent communicates with: * The {% data variables.product.prodname_copilot_short %} platform using server-sent events. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform). * The {% data variables.product.github %} API. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github). -## 2. Review example {% data variables.product.prodname_copilot_agents_short %} and the {% data variables.product.prodname_copilot_extensions_short %} SDK +## 2. Review example {% data variables.copilot.copilot_agents_short %} and the {% data variables.copilot.copilot_extensions_short %} SDK To see the previous concepts in practice and learn about agent implementations, review the following example agents and software development kit (SDK), all of which are available in the [`copilot-extensions`](https://github.com/copilot-extensions) organization: * [Blackbeard](https://github.com/copilot-extensions/blackbeard-extension) (best starting point): A simple agent that responds to requests like a pirate using {% data variables.product.prodname_copilot_short %}'s large language model (LLM) API and special system prompts. -* [{% data variables.product.prodname_github_models %}](https://github.com/copilot-extensions/github-models-extension): A more complex agent that lets you ask about and interact with various LLMs listed on the {% data variables.product.prodname_marketplace %} through {% data variables.product.prodname_copilot_chat_short %}. The {% data variables.product.prodname_github_models %} agent makes use of function calling. +* [{% data variables.product.prodname_github_models %}](https://github.com/copilot-extensions/github-models-extension): A more complex agent that lets you ask about and interact with various LLMs listed on the {% data variables.product.prodname_marketplace %} through {% data variables.copilot.copilot_chat_short %}. The {% data variables.product.prodname_github_models %} agent makes use of function calling. * [Function Calling](https://github.com/copilot-extensions/function-calling-extension): An example agent written in Go that demonstrates function calling and confirmation dialogs. * [RAG Extension](https://github.com/copilot-extensions/rag-extension): An example agent written in Go that demonstrates a simple implementation of retrieval augmented generation. -* [Preview SDK](https://github.com/copilot-extensions/preview-sdk.js/tree/main): An SDK that streamlines the development of {% data variables.product.prodname_copilot_extensions_short %} by handling request verification, payload parsing, and response formatting automatically. This SDK allows extension builders to focus more on creating core functionality and less on boilerplate code. +* [Preview SDK](https://github.com/copilot-extensions/preview-sdk.js/tree/main): An SDK that streamlines the development of {% data variables.copilot.copilot_extensions_short %} by handling request verification, payload parsing, and response formatting automatically. This SDK allows extension builders to focus more on creating core functionality and less on boilerplate code. -## 3. Build a {% data variables.product.prodname_copilot_agent_short %} +## 3. Build a {% data variables.copilot.copilot_agent_short %} -Using the reference material from the previous steps, plan and build your {% data variables.product.prodname_copilot_agent_short %}. You can choose to implement any of the following options: +Using the reference material from the previous steps, plan and build your {% data variables.copilot.copilot_agent_short %}. You can choose to implement any of the following options: * To avoid building and managing your own LLM deployment, your agent can call the Copilot LLM deployment. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/using-copilots-llm-for-your-agent). * To quickly interpret user input and choose from a variety of predefined functions to execute, you can implement function calling in your agent. To learn more, see [How to use function calling with Azure OpenAI Service](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/function-calling) in the Azure OpenAI documentation and [Function calling](https://platform.openai.com/docs/guides/function-calling) in the OpenAI documentation. -## 4. Deploy your {% data variables.product.prodname_copilot_agent_short %} +## 4. Deploy your {% data variables.copilot.copilot_agent_short %} -To make your {% data variables.product.prodname_copilot_agent_short %} accessible to the {% data variables.product.prodname_copilot_short %} platform and {% data variables.product.github %}, you need to deploy it to a server that is reachable by HTTP request. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). +To make your {% data variables.copilot.copilot_agent_short %} accessible to the {% data variables.product.prodname_copilot_short %} platform and {% data variables.product.github %}, you need to deploy it to a server that is reachable by HTTP request. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). -## 5. Create a {% data variables.product.prodname_github_app %} and integrate it with your {% data variables.product.prodname_copilot_agent_short %} +## 5. Create a {% data variables.product.prodname_github_app %} and integrate it with your {% data variables.copilot.copilot_agent_short %} -To create a {% data variables.product.prodname_copilot_extension_short %}, you need to create and configure a {% data variables.product.prodname_github_app %}, then integrate it with your {% data variables.product.prodname_copilot_agent_short %}. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension) and [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent). +To create a {% data variables.copilot.copilot_extension_short %}, you need to create and configure a {% data variables.product.prodname_github_app %}, then integrate it with your {% data variables.copilot.copilot_agent_short %}. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension) and [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent). -## 6. Choose the availability of your {% data variables.product.prodname_copilot_extension_short %} +## 6. Choose the availability of your {% data variables.copilot.copilot_extension_short %} -Choose one of two visibility levels for your {% data variables.product.prodname_copilot_extension_short %}: +Choose one of two visibility levels for your {% data variables.copilot.copilot_extension_short %}: * **Public:** Any user or organization account with the installation page link for the extension can install it. * **Private:** Only the user or organization account that created the extension can install it. -If you make your {% data variables.product.prodname_copilot_extension_short %} public, you can then choose to list it on the {% data variables.product.prodname_marketplace %}. +If you make your {% data variables.copilot.copilot_extension_short %} public, you can then choose to list it on the {% data variables.product.prodname_marketplace %}. -To learn how to change the visibility of your {% data variables.product.prodname_copilot_extension_short %} and list it on the {% data variables.product.prodname_marketplace %}, see [AUTOTITLE](/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension). +To learn how to change the visibility of your {% data variables.copilot.copilot_extension_short %} and list it on the {% data variables.product.prodname_marketplace %}, see [AUTOTITLE](/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension). ## Next steps -To learn how to use your {% data variables.product.prodname_copilot_extension_short %}, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). +To learn how to use your {% data variables.copilot.copilot_extension_short %}, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). {% endagents %} {% skillsets %} -## 1. Learn about {% data variables.product.prodname_copilot_skillsets %} +## 1. Learn about {% data variables.copilot.copilot_skillsets %} -{% data variables.product.prodname_copilot_skillsets %} contain the custom code for your {% data variables.product.prodname_copilot_extension_short %}, and integrate with a {% data variables.product.prodname_github_app %} to form the {% data variables.product.prodname_copilot_extension_short %} itself. +{% data variables.copilot.copilot_skillsets %} contain the custom code for your {% data variables.copilot.copilot_extension_short %}, and integrate with a {% data variables.product.prodname_github_app %} to form the {% data variables.copilot.copilot_extension_short %} itself. -Unlike {% data variables.product.prodname_copilot_agents_short %}, {% data variables.product.prodname_copilot_skillsets_short %} handle the logic behind prompt crafting, function evaluation, and response generation, making them an ideal choice for developers seeking quick and effective integrations with minimal effort. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets). +Unlike {% data variables.copilot.copilot_agents_short %}, {% data variables.copilot.copilot_skillsets_short %} handle the logic behind prompt crafting, function evaluation, and response generation, making them an ideal choice for developers seeking quick and effective integrations with minimal effort. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/about-copilot-skillsets). -## 2. Build a {% data variables.product.prodname_copilot_skillset_short %} +## 2. Build a {% data variables.copilot.copilot_skillset_short %} To explore an example of a skillset implementation, see the [skillset-example](https://github.com/copilot-extensions/skillset-example) repository in the [`copilot-extensions`](https://github.com/copilot-extensions) organization. To build a skillset, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets). -## 3. Deploy your {% data variables.product.prodname_copilot_skillset_short %} +## 3. Deploy your {% data variables.copilot.copilot_skillset_short %} -To make your {% data variables.product.prodname_copilot_skillset_short %} accessible to the {% data variables.product.prodname_copilot_short %} platform and {% data variables.product.github %}, you need to deploy it to a server that is reachable by HTTP request. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). +To make your {% data variables.copilot.copilot_skillset_short %} accessible to the {% data variables.product.prodname_copilot_short %} platform and {% data variables.product.github %}, you need to deploy it to a server that is reachable by HTTP request. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-server-to-deploy-your-copilot-agent). -## 4. Create a {% data variables.product.prodname_github_app %} and integrate it with your {% data variables.product.prodname_copilot_skillset_short %} +## 4. Create a {% data variables.product.prodname_github_app %} and integrate it with your {% data variables.copilot.copilot_skillset_short %} -To create a {% data variables.product.prodname_copilot_extension_short %}, you need to create and configure a {% data variables.product.prodname_github_app %}, then integrate it with your {% data variables.product.prodname_copilot_skillset_short %}. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension) and [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent). +To create a {% data variables.copilot.copilot_extension_short %}, you need to create and configure a {% data variables.product.prodname_github_app %}, then integrate it with your {% data variables.copilot.copilot_skillset_short %}. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension) and [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-agent). -## 5. Choose the availability of your {% data variables.product.prodname_copilot_skillset_short %} +## 5. Choose the availability of your {% data variables.copilot.copilot_skillset_short %} -Choose one of two visibility levels for your {% data variables.product.prodname_copilot_extension_short %}: +Choose one of two visibility levels for your {% data variables.copilot.copilot_extension_short %}: * **Public:** Any user or organization account with the installation page link for the extension can install it. * **Private:** Only the user or organization account that created the extension can install it. -If you make your {% data variables.product.prodname_copilot_extension_short %} public, you can then choose to list it on the {% data variables.product.prodname_marketplace %}. +If you make your {% data variables.copilot.copilot_extension_short %} public, you can then choose to list it on the {% data variables.product.prodname_marketplace %}. -To learn how to change the visibility of your {% data variables.product.prodname_copilot_extension_short %} and list it on the {% data variables.product.prodname_marketplace %}, see [AUTOTITLE](/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension). +To learn how to change the visibility of your {% data variables.copilot.copilot_extension_short %} and list it on the {% data variables.product.prodname_marketplace %}, see [AUTOTITLE](/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension). ## Next steps -To learn how to use your {% data variables.product.prodname_copilot_extension_short %}, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). +To learn how to use your {% data variables.copilot.copilot_extension_short %}, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). {% endskillsets %} diff --git a/content/copilot/building-copilot-extensions/using-oidc-with-github-copilot-extensions.md b/content/copilot/building-copilot-extensions/using-oidc-with-github-copilot-extensions.md index 2c28950df4..6b54f5d714 100644 --- a/content/copilot/building-copilot-extensions/using-oidc-with-github-copilot-extensions.md +++ b/content/copilot/building-copilot-extensions/using-oidc-with-github-copilot-extensions.md @@ -2,7 +2,7 @@ title: Using OIDC with GitHub Copilot Extensions intro: >- Learn how to use OpenID Connect (OIDC) with your {% data - variables.product.prodname_copilot_extension_short %} to enhance security. + variables.copilot.copilot_extension_short %} to enhance security. versions: feature: copilot-extensions topics: @@ -13,13 +13,13 @@ redirect_from: - /copilot/building-copilot-extensions/using-oidc-with-copilot-extensions --- -## About OpenID Connect (OIDC) for {% data variables.product.prodname_copilot_extensions_short %} +## About OpenID Connect (OIDC) for {% data variables.copilot.copilot_extensions_short %} -OpenID Connect (OIDC) allows {% data variables.product.prodname_copilot_extensions_short %} to exchange short-lived tokens directly from their cloud provider instead of storing long-lived {% data variables.product.github %} credentials. This feature enables both Copilot agents and skillsets to more securely authenticate users and access cloud resources. +OpenID Connect (OIDC) allows {% data variables.copilot.copilot_extensions_short %} to exchange short-lived tokens directly from their cloud provider instead of storing long-lived {% data variables.product.github %} credentials. This feature enables both Copilot agents and skillsets to more securely authenticate users and access cloud resources. ## Overview of OIDC -{% data variables.product.prodname_copilot_extensions_short %} often need to access third-party resources or APIs on behalf of users. Traditionally, this required storing {% data variables.product.github %} tokens as secrets and making additional API calls to map these tokens to user identities in your system. With OIDC, your extension can request short-lived access tokens directly from your authentication service by exchanging {% data variables.product.github %} identity information. +{% data variables.copilot.copilot_extensions_short %} often need to access third-party resources or APIs on behalf of users. Traditionally, this required storing {% data variables.product.github %} tokens as secrets and making additional API calls to map these tokens to user identities in your system. With OIDC, your extension can request short-lived access tokens directly from your authentication service by exchanging {% data variables.product.github %} identity information. When enabled, {% data variables.product.github %}'s OIDC provider automatically generates a token containing claims about the user and the request context. Your authentication service can validate these claims and exchange them for an access token scoped specifically for your service. @@ -27,7 +27,7 @@ Using OIDC is especially valuable for {% data variables.product.prodname_copilot ## Benefits of using OIDC -By implementing OIDC token exchange in your {% data variables.product.prodname_copilot_extension_short %}, you can: +By implementing OIDC token exchange in your {% data variables.copilot.copilot_extension_short %}, you can: * Avoid storing long-lived {% data variables.product.github %} tokens or maintain a mapping between {% data variables.product.github %} and your service's identities. * Use short-lived tokens that automatically expire and can be scoped specifically to your service's needs. @@ -37,11 +37,11 @@ By implementing OIDC token exchange in your {% data variables.product.prodname_c ## Token exchange flow -The following outlines how the {% data variables.product.prodname_copilot_extensibility_platform_short %} exchanges an OIDC token for an access token to authenticate requests to your extension. +The following outlines how the {% data variables.copilot.copilot_extensibility_platform_short %} exchanges an OIDC token for an access token to authenticate requests to your extension. ### Initial request -1. The user sends a message to your {% data variables.product.prodname_copilot_extension_short %}. +1. The user sends a message to your {% data variables.copilot.copilot_extension_short %}. 1. GitHub generates an OIDC token containing user identity information. 1. GitHub calls your token exchange endpoint with the OIDC token. 1. Your service validates the token and returns an access token. @@ -117,13 +117,13 @@ This endpoint should: } ``` -### Enable OIDC in your {% data variables.product.prodname_copilot_extension_short %}'s settings +### Enable OIDC in your {% data variables.copilot.copilot_extension_short %}'s settings -In your {% data variables.product.prodname_copilot_extension_short %}'s configuration, enable OIDC: +In your {% data variables.copilot.copilot_extension_short %}'s configuration, enable OIDC: {% data reusables.apps.settings-step %} {% data reusables.apps.enterprise-apps-steps %} -1. To the right of the {% data variables.product.prodname_github_app %} you want to configure for your {% data variables.product.prodname_copilot_extension_short %}, click **Edit**. +1. To the right of the {% data variables.product.prodname_github_app %} you want to configure for your {% data variables.copilot.copilot_extension_short %}, click **Edit**. 1. In the left sidebar, click **{% data variables.product.prodname_copilot_short %}**. 1. Under **OpenID Connect Token Exchange**, check **Enabled**. 1. In the **Token exchange endpoint** field, input your token exchange URL. @@ -136,7 +136,7 @@ Your token exchange endpoint should validate the {% data variables.product.githu 1. Fetch the JSON Web Key Set (JWKS) from https://github.com/login/oauth/.well-known/openid-configuration. 1. Verify the token signature. 1. Validate required claims. - * `aud`: Audience. Your {% data variables.product.prodname_copilot_extension_short %}'s client ID. + * `aud`: Audience. Your {% data variables.copilot.copilot_extension_short %}'s client ID. * `sub`: Subject. The {% data variables.product.github %} user ID making the request. The response is limited to data that the user has permissions to access. If the user has no permissions `400 Bad Request` is shown. * `iat`: Issued At. The timestamp when the token was issued. It is typically a timestamp in the past but represents the exact moment the token was created. * `nbf`: Not Before. The timestamp before which the token is not valid. This should be a timestamp in the past. @@ -145,7 +145,7 @@ Your token exchange endpoint should validate the {% data variables.product.githu ## Troubleshooting -The following sections outline common problems and best practices for implementing OIDC for your {% data variables.product.prodname_copilot_extension_short %}. +The following sections outline common problems and best practices for implementing OIDC for your {% data variables.copilot.copilot_extension_short %}. ### Token validation errors diff --git a/content/copilot/copilot-chat-cookbook/debugging-errors/debugging-invalid-json.md b/content/copilot/copilot-chat-cookbook/debugging-errors/debugging-invalid-json.md index bc46ccee7b..86cdc9994c 100644 --- a/content/copilot/copilot-chat-cookbook/debugging-errors/debugging-invalid-json.md +++ b/content/copilot/copilot-chat-cookbook/debugging-errors/debugging-invalid-json.md @@ -1,7 +1,7 @@ --- title: Debugging invalid JSON shortTitle: Debug invalid JSON -intro: '{% data variables.product.prodname_copilot_chat_short %} can identify and resolve syntax errors or structural issues in JSON data.' +intro: '{% data variables.copilot.copilot_chat_short %} can identify and resolve syntax errors or structural issues in JSON data.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/debugging-errors/debugging-invalid-json versions: @@ -15,7 +15,7 @@ topics: - Copilot --- -When working with JSON data, you may encounter issues such as trailing commas, mismatched braces, or incorrect data types that make the JSON invalid. {% data variables.product.prodname_copilot_chat %} can help you debug and fix these errors by suggesting corrections to fix invalid JSON. +When working with JSON data, you may encounter issues such as trailing commas, mismatched braces, or incorrect data types that make the JSON invalid. {% data variables.copilot.copilot_chat %} can help you debug and fix these errors by suggesting corrections to fix invalid JSON. ## Example scenario diff --git a/content/copilot/copilot-chat-cookbook/debugging-errors/handling-api-rate-limits.md b/content/copilot/copilot-chat-cookbook/debugging-errors/handling-api-rate-limits.md index f351289ab7..31959c1ad6 100644 --- a/content/copilot/copilot-chat-cookbook/debugging-errors/handling-api-rate-limits.md +++ b/content/copilot/copilot-chat-cookbook/debugging-errors/handling-api-rate-limits.md @@ -1,7 +1,7 @@ --- title: Handling API rate limits shortTitle: Handle API rate limits -intro: '{% data variables.product.prodname_copilot_chat_short %} can help handle API rate limits by suggesting code that detects implements retry logic.' +intro: '{% data variables.copilot.copilot_chat_short %} can help handle API rate limits by suggesting code that detects implements retry logic.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/debugging-errors/handling-api-rate-limits versions: @@ -15,7 +15,7 @@ topics: - Copilot --- -When making requests to APIs, it's common to encounter rate limits that restrict the number of calls you can make within a certain time frame. {% data variables.product.prodname_copilot_chat %} can help you handle these limits by suggesting code to detect rate limit responses and automatically retry requests after a delay. +When making requests to APIs, it's common to encounter rate limits that restrict the number of calls you can make within a certain time frame. {% data variables.copilot.copilot_chat %} can help you handle these limits by suggesting code to detect rate limit responses and automatically retry requests after a delay. ## Example scenario diff --git a/content/copilot/copilot-chat-cookbook/documenting-code/documenting-legacy-code.md b/content/copilot/copilot-chat-cookbook/documenting-code/documenting-legacy-code.md index 98752cd69a..4cec358579 100644 --- a/content/copilot/copilot-chat-cookbook/documenting-code/documenting-legacy-code.md +++ b/content/copilot/copilot-chat-cookbook/documenting-code/documenting-legacy-code.md @@ -1,7 +1,7 @@ --- title: 'Documenting legacy code' shortTitle: Document legacy code -intro: '{% data variables.product.prodname_copilot_chat_short %} can help with documenting legacy code.' +intro: '{% data variables.copilot.copilot_chat_short %} can help with documenting legacy code.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/documenting-code/documenting-legacy-code versions: @@ -71,7 +71,7 @@ INSERT-AND-VALIDATE. ## Example prompt -We can use a simple prompt to ask {% data variables.product.prodname_copilot_chat_short %} to document the code. +We can use a simple prompt to ask {% data variables.copilot.copilot_chat_short %} to document the code. `Document this code` diff --git a/content/copilot/copilot-chat-cookbook/documenting-code/explaining-complex-algorithms-or-logic.md b/content/copilot/copilot-chat-cookbook/documenting-code/explaining-complex-algorithms-or-logic.md index 2ed0c08f8d..8c21104803 100644 --- a/content/copilot/copilot-chat-cookbook/documenting-code/explaining-complex-algorithms-or-logic.md +++ b/content/copilot/copilot-chat-cookbook/documenting-code/explaining-complex-algorithms-or-logic.md @@ -1,7 +1,7 @@ --- title: 'Explaining complex algorithms or logic' shortTitle: Explain complex logic -intro: '{% data variables.product.prodname_copilot_chat_short %} can help add clear and concise documentation on complex algorithms or logic.' +intro: '{% data variables.copilot.copilot_chat_short %} can help add clear and concise documentation on complex algorithms or logic.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/documenting-code/explaining-complex-algorithms-or-logic versions: @@ -15,7 +15,7 @@ topics: - Copilot --- -There may be times where you need to explain complex algorithms or logic in your code. This can be challenging, especially when you're trying to make it understandable to others. {% data variables.product.prodname_copilot_chat_short %} can help you with this task by providing you with suggestions on how to explain the algorithm or logic in a clear and concise manner. +There may be times where you need to explain complex algorithms or logic in your code. This can be challenging, especially when you're trying to make it understandable to others. {% data variables.copilot.copilot_chat_short %} can help you with this task by providing you with suggestions on how to explain the algorithm or logic in a clear and concise manner. ## Example scenario @@ -76,7 +76,7 @@ private void UpdateStatusLabel(string message, Label statusLabel) ## Example prompt -We can ask {% data variables.product.prodname_copilot_chat_short %} to make this code easier to understand using comments. +We can ask {% data variables.copilot.copilot_chat_short %} to make this code easier to understand using comments. `Add comments to this code to make it more understandable` diff --git a/content/copilot/copilot-chat-cookbook/documenting-code/explaining-legacy-code.md b/content/copilot/copilot-chat-cookbook/documenting-code/explaining-legacy-code.md index ff8c790051..8ffc9121b2 100644 --- a/content/copilot/copilot-chat-cookbook/documenting-code/explaining-legacy-code.md +++ b/content/copilot/copilot-chat-cookbook/documenting-code/explaining-legacy-code.md @@ -1,7 +1,7 @@ --- title: 'Explaining legacy code' shortTitle: Explain legacy code -intro: '{% data variables.product.prodname_copilot_chat_short %} can help with explaining unfamiliar code.' +intro: '{% data variables.copilot.copilot_chat_short %} can help with explaining unfamiliar code.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/documenting-code/explaining-legacy-code versions: @@ -15,11 +15,11 @@ topics: - Copilot --- -One of the biggest challenges with legacy code is helping developers understand it who aren't familiar with the languages or frameworks. With {% data variables.product.prodname_copilot_chat_short %}, you can explain the background you have and ask for an explanation. +One of the biggest challenges with legacy code is helping developers understand it who aren't familiar with the languages or frameworks. With {% data variables.copilot.copilot_chat_short %}, you can explain the background you have and ask for an explanation. ## Example scenario -Consider the following COBOL code. If you're a Python developer (as an example), you might not be familiar with COBOL, so you could ask {% data variables.product.prodname_copilot_chat_short %} to explain the code to you. +Consider the following COBOL code. If you're a Python developer (as an example), you might not be familiar with COBOL, so you could ask {% data variables.copilot.copilot_chat_short %} to explain the code to you. ```text IDENTIFICATION DIVISION. diff --git a/content/copilot/copilot-chat-cookbook/documenting-code/index.md b/content/copilot/copilot-chat-cookbook/documenting-code/index.md index 286045ffb2..70ec05d39a 100644 --- a/content/copilot/copilot-chat-cookbook/documenting-code/index.md +++ b/content/copilot/copilot-chat-cookbook/documenting-code/index.md @@ -1,6 +1,6 @@ --- title: Documenting code -intro: 'Discover ways that you can use {% data variables.product.prodname_copilot_chat %} to document your code.' +intro: 'Discover ways that you can use {% data variables.copilot.copilot_chat %} to document your code.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/documenting-code versions: diff --git a/content/copilot/copilot-chat-cookbook/documenting-code/syncing-documentation-with-code-changes.md b/content/copilot/copilot-chat-cookbook/documenting-code/syncing-documentation-with-code-changes.md index 0f4831efec..667e524d78 100644 --- a/content/copilot/copilot-chat-cookbook/documenting-code/syncing-documentation-with-code-changes.md +++ b/content/copilot/copilot-chat-cookbook/documenting-code/syncing-documentation-with-code-changes.md @@ -1,7 +1,7 @@ --- title: 'Syncing documentation with code changes' shortTitle: Sync documentation -intro: '{% data variables.product.prodname_copilot_chat_short %} can help with keeping code documentation up-to-date.' +intro: '{% data variables.copilot.copilot_chat_short %} can help with keeping code documentation up-to-date.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/documenting-code/syncing-documentation-with-code-changes versions: @@ -15,7 +15,7 @@ topics: - Copilot --- -It can be difficult to keep documentation up to date with changes to code. However, good documentation is essential for maintaining codebases and ensuring that developers can work effectively with the code. {% data variables.product.prodname_copilot_chat_short %} can assist in updating existing code documentation. +It can be difficult to keep documentation up to date with changes to code. However, good documentation is essential for maintaining codebases and ensuring that developers can work effectively with the code. {% data variables.copilot.copilot_chat_short %} can assist in updating existing code documentation. ## Example scenario @@ -52,7 +52,7 @@ async getByCategoryName(categoryId: number, page = 1, pageSize = 10): Promise[!TIP] You can include links to specific pull requests or issues in your prompts to give {% data variables.product.prodname_copilot_chat_short %} more context. If you're not getting the results you expect, try specifying the repository in your prompt to help {% data variables.product.prodname_copilot_chat_short %} focus on the right project. +>[!TIP] You can include links to specific pull requests or issues in your prompts to give {% data variables.copilot.copilot_chat_short %} more context. If you're not getting the results you expect, try specifying the repository in your prompt to help {% data variables.copilot.copilot_chat_short %} focus on the right project. ## Generating ideas -When you're working on a project, you may need to write a discussion or blog post to share your ideas, get feedback, or communicate with your team. {% data variables.product.prodname_copilot_chat_short %} can help you generate ideas. +When you're working on a project, you may need to write a discussion or blog post to share your ideas, get feedback, or communicate with your team. {% data variables.copilot.copilot_chat_short %} can help you generate ideas. ### Brainstorming topics from recent work -If you're looking for ideas for a discussion post, you can ask {% data variables.product.prodname_copilot_chat_short %} to suggest topics based on your recent work. +If you're looking for ideas for a discussion post, you can ask {% data variables.copilot.copilot_chat_short %} to suggest topics based on your recent work. #### Example prompts @@ -37,7 +37,7 @@ If you're looking for ideas for a discussion post, you can ask {% data variables ### Writing technical deep dives -When you're working on a complex feature or system, you may need to write a technical deep dive to share your work with your team or the broader community. {% data variables.product.prodname_copilot_chat_short %} can help you generate ideas for technical deep dives by suggesting topics based on your recent work. +When you're working on a complex feature or system, you may need to write a technical deep dive to share your work with your team or the broader community. {% data variables.copilot.copilot_chat_short %} can help you generate ideas for technical deep dives by suggesting topics based on your recent work. #### Example prompts @@ -49,7 +49,7 @@ When you're working on a complex feature or system, you may need to write a tech ### Sharing best practices -When you're working on a project, you may need to write a discussion post to share best practices or lessons learned. {% data variables.product.prodname_copilot_chat_short %} can help you generate ideas for discussion posts. +When you're working on a project, you may need to write a discussion post to share best practices or lessons learned. {% data variables.copilot.copilot_chat_short %} can help you generate ideas for discussion posts. #### Example prompt @@ -57,11 +57,11 @@ When you're working on a project, you may need to write a discussion post to sha ## Drafting content -Once you have an idea for a discussion or blog post, you can ask {% data variables.product.prodname_copilot_chat_short %} to help you draft the content. {% data variables.product.prodname_copilot_chat_short %} can provide you with a detailed outline, a rough draft, or a polished draft, depending on your needs. +Once you have an idea for a discussion or blog post, you can ask {% data variables.copilot.copilot_chat_short %} to help you draft the content. {% data variables.copilot.copilot_chat_short %} can provide you with a detailed outline, a rough draft, or a polished draft, depending on your needs. ### Outlining a blog post -If you're looking for help outlining a blog post, you can ask {% data variables.product.prodname_copilot_chat_short %} to suggest a detailed outline for your post. +If you're looking for help outlining a blog post, you can ask {% data variables.copilot.copilot_chat_short %} to suggest a detailed outline for your post. #### Example prompt @@ -69,7 +69,7 @@ If you're looking for help outlining a blog post, you can ask {% data variables. ### Drafting a blog post -If you're looking for help drafting a blog post, you can ask {% data variables.product.prodname_copilot_chat_short %} to suggest a rough draft for your post. +If you're looking for help drafting a blog post, you can ask {% data variables.copilot.copilot_chat_short %} to suggest a rough draft for your post. #### Example prompts @@ -81,11 +81,11 @@ If you're looking for help drafting a blog post, you can ask {% data variables.p ## Refining your draft -Once you have a draft, you can ask {% data variables.product.prodname_copilot_chat_short %} to help you refine it. {% data variables.product.prodname_copilot_chat_short %} can provide you with suggestions for improving your writing, making it more engaging, or clarifying complex concepts. +Once you have a draft, you can ask {% data variables.copilot.copilot_chat_short %} to help you refine it. {% data variables.copilot.copilot_chat_short %} can provide you with suggestions for improving your writing, making it more engaging, or clarifying complex concepts. ### Improving tone and style -If you're looking to improve the tone and style of your writing, you can ask {% data variables.product.prodname_copilot_chat_short %} to suggest ways to make your writing more engaging or accessible. +If you're looking to improve the tone and style of your writing, you can ask {% data variables.copilot.copilot_chat_short %} to suggest ways to make your writing more engaging or accessible. #### Example prompt @@ -93,7 +93,7 @@ If you're looking to improve the tone and style of your writing, you can ask {% ### Including next steps -If you're looking to include next steps in your blog post, you can ask {% data variables.product.prodname_copilot_chat_short %} to suggest ways to make your writing more actionable. +If you're looking to include next steps in your blog post, you can ask {% data variables.copilot.copilot_chat_short %} to suggest ways to make your writing more actionable. #### Example prompt diff --git a/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/analyzing-and-incorporating-user-feedback.md b/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/analyzing-and-incorporating-user-feedback.md index 33dcaff891..8ec1254641 100644 --- a/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/analyzing-and-incorporating-user-feedback.md +++ b/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/analyzing-and-incorporating-user-feedback.md @@ -1,7 +1,7 @@ --- title: 'Analyzing and incorporating user feedback' shortTitle: Incorporate feedback -intro: '{% data variables.product.prodname_copilot_chat_short %} can enhance the process of incorporating user feedback into your project.' +intro: '{% data variables.copilot.copilot_chat_short %} can enhance the process of incorporating user feedback into your project.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/functionality-analysis-and-feature-suggestions/analyzing-and-incorporating-user-feedback versions: @@ -70,7 +70,7 @@ In this scenario, you've chosen a piece of user feedback to address. Someone req ### Example prompt -This example assumes you are asking about an issue in the same repository where you are using {% data variables.product.prodname_copilot_chat_short %}. +This example assumes you are asking about an issue in the same repository where you are using {% data variables.copilot.copilot_chat_short %}. `Write a feature specification for Issue #426.` diff --git a/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/exploring-potential-feature-implementations.md b/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/exploring-potential-feature-implementations.md index 14d9ff8918..0460eb8b5f 100644 --- a/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/exploring-potential-feature-implementations.md +++ b/content/copilot/copilot-chat-cookbook/functionality-analysis-and-feature-suggestions/exploring-potential-feature-implementations.md @@ -2,7 +2,7 @@ title: Exploring potential feature implementations shortTitle: Explore feature implementations intro: >- - {% data variables.product.prodname_copilot_chat_short %} can help explore + {% data variables.copilot.copilot_chat_short %} can help explore different approaches for implementing a single feature. redirect_from: - /copilot/example-prompts-for-github-copilot-chat/functionality-analysis-and-feature-suggestions/exploring-potential-feature-implementations @@ -17,7 +17,7 @@ topics: - Copilot --- -When tasked with implementing new features or enhancing existing ones, developers often face decisions about the best approach to take. {% data variables.product.prodname_copilot_chat_short %} can assist by analyzing the problem and generating implementation options so that you can explore multiple solutions. +When tasked with implementing new features or enhancing existing ones, developers often face decisions about the best approach to take. {% data variables.copilot.copilot_chat_short %} can assist by analyzing the problem and generating implementation options so that you can explore multiple solutions. ## Example scenario @@ -43,7 +43,7 @@ Users have requested a "Recent Items" section on their dashboard to quickly acce ## Example prompt -You want to evaluate different approaches to this implementation to see whether they fit with your needs and constraints. Here we'll ask {% data variables.product.prodname_copilot_chat_short %} to suggest different approaches. +You want to evaluate different approaches to this implementation to see whether they fit with your needs and constraints. Here we'll ask {% data variables.copilot.copilot_chat_short %} to suggest different approaches. Navigate to the issue, then type: diff --git a/content/copilot/copilot-chat-cookbook/index.md b/content/copilot/copilot-chat-cookbook/index.md index 850f1e2bb1..cc209561d7 100644 --- a/content/copilot/copilot-chat-cookbook/index.md +++ b/content/copilot/copilot-chat-cookbook/index.md @@ -1,6 +1,6 @@ --- title: Copilot Chat Cookbook -intro: 'Find examples of prompts to use with {% data variables.product.prodname_copilot_chat %}.' +intro: 'Find examples of prompts to use with {% data variables.copilot.copilot_chat %}.' allowTitleToDifferFromFilename: true redirect_from: - /copilot/example-prompts-for-github-copilot-chat diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/decoupling-business-logic-from-ui-components.md b/content/copilot/copilot-chat-cookbook/refactoring-code/decoupling-business-logic-from-ui-components.md index fa297c30c3..7c481c7cc2 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/decoupling-business-logic-from-ui-components.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/decoupling-business-logic-from-ui-components.md @@ -1,7 +1,7 @@ --- title: Decoupling business logic from UI components shortTitle: Decoupling business logic -intro: '{% data variables.product.prodname_copilot_chat_short %} can help you separate your business logic from your user interface code, making it easier to maintain and scale your application.' +intro: '{% data variables.copilot.copilot_chat_short %} can help you separate your business logic from your user interface code, making it easier to maintain and scale your application.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/decoupling-business-logic-from-ui-components versions: @@ -17,7 +17,7 @@ topics: In many front-end frameworks, business logic can become embedded within user interface (UI) components, making the code hard to maintain or extend, especially as the application grows. -{% data variables.product.prodname_copilot_chat_short %} can help you refactor your code to extract business logic into separate services or state management solutions. This allows the business logic to be reused across different UI components. It also makes the code easier to scale by separating concerns and reducing interdependencies, and it simplifies unit testing by allowing business logic to be tested independently from UI components. +{% data variables.copilot.copilot_chat_short %} can help you refactor your code to extract business logic into separate services or state management solutions. This allows the business logic to be reused across different UI components. It also makes the code easier to scale by separating concerns and reducing interdependencies, and it simplifies unit testing by allowing business logic to be tested independently from UI components. ## Example scenario @@ -60,7 +60,7 @@ The suggested changes refactor the `Counter` component to use Redux for state ma The proposed changes separate the code into five separate files. -> [!NOTE] {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one described here. +> [!NOTE] {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one described here. ### actions.js diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-database-deadlocks-or-data-integrity-issues.md b/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-database-deadlocks-or-data-integrity-issues.md index d9b4afa8b5..b7c96e6cc5 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-database-deadlocks-or-data-integrity-issues.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-database-deadlocks-or-data-integrity-issues.md @@ -1,7 +1,7 @@ --- title: 'Fixing database deadlocks or data integrity issues' shortTitle: Fix database deadlocks -intro: '{% data variables.product.prodname_copilot_chat_short %} can help you avoid code that causes slow or blocked database operations, or tables with missing or incorrect data.' +intro: '{% data variables.copilot.copilot_chat_short %} can help you avoid code that causes slow or blocked database operations, or tables with missing or incorrect data.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/fixing-database-deadlocks-or-data-integrity-issues versions: @@ -17,9 +17,9 @@ topics: Complex database operations–particularly those involving transactions–can lead to deadlocks or data inconsistencies that are hard to debug. -{% data variables.product.prodname_copilot_chat_short %} can help by identifying points in a transaction where locking or deadlocks could occur, and can suggest best practices for transaction isolation or deadlock resolution, such as adjusting locking strategies or handling deadlock exceptions gracefully. +{% data variables.copilot.copilot_chat_short %} can help by identifying points in a transaction where locking or deadlocks could occur, and can suggest best practices for transaction isolation or deadlock resolution, such as adjusting locking strategies or handling deadlock exceptions gracefully. -> [!NOTE] The responses shown in this article are examples. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. +> [!NOTE] The responses shown in this article are examples. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. ## Avoiding simultaneous updates on interdependent rows @@ -42,7 +42,7 @@ COMMIT TRANSACTION; You can check whether there are any problems with this transaction. -In the editor, select the transaction code, then ask {% data variables.product.prodname_copilot_chat_short %}: +In the editor, select the transaction code, then ask {% data variables.copilot.copilot_chat_short %}: `Is this transaction good?` diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-lint-errors.md b/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-lint-errors.md index 9b7e6dd2f5..b3ccb98bcf 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-lint-errors.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/fixing-lint-errors.md @@ -1,7 +1,7 @@ --- title: Fixing lint errors shortTitle: Lint errors -intro: '{% data variables.product.prodname_copilot_chat_short %} can suggest ways to fix issues identified by a code linter.' +intro: '{% data variables.copilot.copilot_chat_short %} can suggest ways to fix issues identified by a code linter.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/fixing-lint-errors versions: @@ -19,7 +19,7 @@ It's good practice to use a linter to check your code for potential errors, styl ## Example scenario -You have run a linter on your code and it has identified some issues that need to be fixed. Rather than fixing these manually, you can ask {% data variables.product.prodname_copilot_chat_short %} to fix them for you. +You have run a linter on your code and it has identified some issues that need to be fixed. Rather than fixing these manually, you can ask {% data variables.copilot.copilot_chat_short %} to fix them for you. ## Example prompts @@ -35,7 +35,7 @@ You have run a linter on your code and it has identified some issues that need t `Use the attached style guide to fix the lint errors` -* Alternatively, you can ask {% data variables.product.prodname_copilot_chat_short %} to fix only a specific type of lint error: +* Alternatively, you can ask {% data variables.copilot.copilot_chat_short %} to fix only a specific type of lint error: `Make sure all functions use snake_case naming style` diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/handling-cross-cutting-concerns.md b/content/copilot/copilot-chat-cookbook/refactoring-code/handling-cross-cutting-concerns.md index 7a36918d12..0d0e6ed00a 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/handling-cross-cutting-concerns.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/handling-cross-cutting-concerns.md @@ -1,7 +1,7 @@ --- title: Handling cross-cutting concerns shortTitle: Cross-cutting concerns -intro: '{% data variables.product.prodname_copilot_chat_short %} can help you avoid code that relates to a concern other than the core concern of the method or function in which the code is located.' +intro: '{% data variables.copilot.copilot_chat_short %} can help you avoid code that relates to a concern other than the core concern of the method or function in which the code is located.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/handling-cross-cutting-concerns versions: @@ -17,7 +17,7 @@ topics: Cross-cutting concerns are aspects of a program that affect multiple parts of the system, such as logging, security, data validation, and error handling. They can become scattered throughout a codebase, leading to code duplication and maintenance challenges. -{% data variables.product.prodname_copilot_chat_short %} can help refactor cross-cutting concerns by suggesting the implementation of Aspect-Oriented Programming (AOP) practices or using decorators and middleware patterns to centralize these concerns in a modular, maintainable way. +{% data variables.copilot.copilot_chat_short %} can help refactor cross-cutting concerns by suggesting the implementation of Aspect-Oriented Programming (AOP) practices or using decorators and middleware patterns to centralize these concerns in a modular, maintainable way. ## Example scenario @@ -89,7 +89,7 @@ class OrderService: ## Example prompt -Open the project workspace in {% data variables.product.prodname_vscode_shortname %} or {% data variables.product.prodname_vs %} and enter the following prompt in the {% data variables.product.prodname_copilot_chat_short %} view. +Open the project workspace in {% data variables.product.prodname_vscode_shortname %} or {% data variables.product.prodname_vs %} and enter the following prompt in the {% data variables.copilot.copilot_chat_short %} view. `@workspace Refactor this project by using AOP to avoid logging that has cross-cutting concerns` diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/improving-code-readability-and-maintainability.md b/content/copilot/copilot-chat-cookbook/refactoring-code/improving-code-readability-and-maintainability.md index 89caf4c02e..02f59cfde8 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/improving-code-readability-and-maintainability.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/improving-code-readability-and-maintainability.md @@ -1,7 +1,7 @@ --- title: 'Improving code readability and maintainability' shortTitle: Improve code readability -intro: '{% data variables.product.prodname_copilot_chat_short %} can suggest ways to make your code easier to understand and maintain.' +intro: '{% data variables.copilot.copilot_chat_short %} can suggest ways to make your code easier to understand and maintain.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/improving-code-readability-and-maintainability versions: @@ -15,15 +15,15 @@ topics: - Copilot --- -Code with poor readability is difficult for other developers to maintain and extend. {% data variables.product.prodname_copilot_chat_short %} can help in a number of ways. For example, by: +Code with poor readability is difficult for other developers to maintain and extend. {% data variables.copilot.copilot_chat_short %} can help in a number of ways. For example, by: * [Suggesting improvements to variable names](#improving-variable-names) * [Avoiding sequential conditional checks](#avoiding-sequential-conditional-checks) * [Reducing nested logic](#reducing-nested-logic) * [Splitting large methods into smaller, more readable ones](#splitting-up-large-methods) -Documenting your code is another way to improve the maintainability of your code. For information about using {% data variables.product.prodname_copilot_chat_short %} to help you add useful comments to your code, see the example prompts in [Documenting code](/copilot/copilot-chat-cookbook/documenting-code). +Documenting your code is another way to improve the maintainability of your code. For information about using {% data variables.copilot.copilot_chat_short %} to help you add useful comments to your code, see the example prompts in [Documenting code](/copilot/copilot-chat-cookbook/documenting-code). -> [!NOTE] The responses shown in this article are examples. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. +> [!NOTE] The responses shown in this article are examples. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. ## Improving variable names @@ -45,7 +45,7 @@ function logPersonsAge(a, b, c) { ### Example prompt -In the editor, select the function you want to change, then ask {% data variables.product.prodname_copilot_chat_short %}: +In the editor, select the function you want to change, then ask {% data variables.copilot.copilot_chat_short %}: `Improve the variable names in this function` diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-data-access-layers.md b/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-data-access-layers.md index 23a171a9a6..30a4045fed 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-data-access-layers.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-data-access-layers.md @@ -1,7 +1,7 @@ --- title: Refactoring data access layers shortTitle: Data access layers -intro: '{% data variables.product.prodname_copilot_chat_short %} can suggest ways to decouple your data access code from your business logic, making an application easier to maintain and scale.' +intro: '{% data variables.copilot.copilot_chat_short %} can suggest ways to decouple your data access code from your business logic, making an application easier to maintain and scale.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/refactoring-data-access-layers versions: @@ -17,9 +17,9 @@ topics: Hardcoded SQL queries and tightly coupled data access code can make it difficult to scale or switch databases, and they often lead to repeated logic. -{% data variables.product.prodname_copilot_chat_short %} can recommend implementing a repository pattern or data access layer that abstracts database interactions, making the code more modular and reducing redundancy. It can also help refactor SQL queries into optimized versions, improving performance and maintainability. +{% data variables.copilot.copilot_chat_short %} can recommend implementing a repository pattern or data access layer that abstracts database interactions, making the code more modular and reducing redundancy. It can also help refactor SQL queries into optimized versions, improving performance and maintainability. -> [!NOTE] The responses described in this article are examples. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. +> [!NOTE] The responses described in this article are examples. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. ## Example scenario diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-for-performance-optimization.md b/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-for-performance-optimization.md index decbbf2347..ecf4d55036 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-for-performance-optimization.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-for-performance-optimization.md @@ -1,7 +1,7 @@ --- title: Refactoring for performance optimization shortTitle: Performance optimization -intro: '{% data variables.product.prodname_copilot_chat_short %} can suggest ways to speed up slow-running code.' +intro: '{% data variables.copilot.copilot_chat_short %} can suggest ways to speed up slow-running code.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/refactoring-for-performance-optimization versions: @@ -17,7 +17,7 @@ topics: Existing code may function correctly but be inefficient, leading to performance bottlenecks. Examples of coding that can adversely impact performance include inefficient loops, unnecessary computations, and excessive memory allocation. -{% data variables.product.prodname_copilot_chat_short %} can identify performance hotspots and suggest refactoring strategies such as optimizing data structures (for example, using hashmaps instead of arrays), reducing redundant calculations, and improving algorithmic efficiency. It can also recommend caching mechanisms or parallelizing operations to improve performance. +{% data variables.copilot.copilot_chat_short %} can identify performance hotspots and suggest refactoring strategies such as optimizing data structures (for example, using hashmaps instead of arrays), reducing redundant calculations, and improving algorithmic efficiency. It can also recommend caching mechanisms or parallelizing operations to improve performance. ## Example scenario @@ -61,7 +61,7 @@ if __name__ == "__main__": {% data variables.product.prodname_copilot_short %} suggests using a sieve function to generate the prime numbers much more efficiently. If you run this program it will complete in a fraction of a second. -> [!NOTE] {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one shown here. +> [!NOTE] {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one shown here. ```python import time diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-to-implement-a-design-pattern.md b/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-to-implement-a-design-pattern.md index 460210656a..ca02b92184 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-to-implement-a-design-pattern.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/refactoring-to-implement-a-design-pattern.md @@ -1,7 +1,7 @@ --- title: Refactoring to implement a design pattern shortTitle: Design patterns -intro: '{% data variables.product.prodname_copilot_chat_short %} can suggest design patterns that you can use to improve your code.' +intro: '{% data variables.copilot.copilot_chat_short %} can suggest design patterns that you can use to improve your code.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/refactoring-to-implement-a-design-pattern versions: @@ -17,9 +17,9 @@ topics: Code that doesn’t follow established design patterns (like Singleton, Factory, or Observer) can lead to issues like tight coupling, lack of flexibility, or duplicated code. -{% data variables.product.prodname_copilot_chat_short %} can help you use appropriate design patterns to make your code more flexible and maintainable. For example, it can recommend converting repetitive instantiations into a Factory pattern, or using the Observer pattern to decouple tightly connected classes. +{% data variables.copilot.copilot_chat_short %} can help you use appropriate design patterns to make your code more flexible and maintainable. For example, it can recommend converting repetitive instantiations into a Factory pattern, or using the Observer pattern to decouple tightly connected classes. -> [!NOTE] The responses described in this article are examples. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. +> [!NOTE] The responses described in this article are examples. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. ## Example scenario diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/simplifying-complex-inheritance-hierarchies.md b/content/copilot/copilot-chat-cookbook/refactoring-code/simplifying-complex-inheritance-hierarchies.md index b591c8842a..37e3ac1fd4 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/simplifying-complex-inheritance-hierarchies.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/simplifying-complex-inheritance-hierarchies.md @@ -1,7 +1,7 @@ --- title: Simplifying complex inheritance hierarchies shortTitle: Simplify inheritance hierarchies -intro: '{% data variables.product.prodname_copilot_chat_short %} can help you to refactor code to avoid classes with multiple layers of inheritance.' +intro: '{% data variables.copilot.copilot_chat_short %} can help you to refactor code to avoid classes with multiple layers of inheritance.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/refactoring-code/simplifying-complex-inheritance-hierarchies versions: @@ -17,7 +17,7 @@ topics: Deep inheritance hierarchies, or improper use of inheritance, can lead to code that is hard to maintain, making it difficult to follow relationships between classes, or to extend them without causing breakage. -{% data variables.product.prodname_copilot_chat_short %} can suggest refactoring inheritance-based designs into more flexible composition-based designs (favoring composition over inheritance). It can also recommend applying patterns like Strategy or Decorator to make the system more extensible without adding complexity to the inheritance structure. +{% data variables.copilot.copilot_chat_short %} can suggest refactoring inheritance-based designs into more flexible composition-based designs (favoring composition over inheritance). It can also recommend applying patterns like Strategy or Decorator to make the system more extensible without adding complexity to the inheritance structure. ## Example scenario diff --git a/content/copilot/copilot-chat-cookbook/refactoring-code/translating-code-to-a-different-programming-language.md b/content/copilot/copilot-chat-cookbook/refactoring-code/translating-code-to-a-different-programming-language.md index 73e8c59a1d..00362759ed 100644 --- a/content/copilot/copilot-chat-cookbook/refactoring-code/translating-code-to-a-different-programming-language.md +++ b/content/copilot/copilot-chat-cookbook/refactoring-code/translating-code-to-a-different-programming-language.md @@ -1,7 +1,7 @@ --- title: Translating code to a different programming language shortTitle: Translate code -intro: '{% data variables.product.prodname_copilot_chat_short %} can help you rewrite code to perform the same operations but in a different programming language.' +intro: '{% data variables.copilot.copilot_chat_short %} can help you rewrite code to perform the same operations but in a different programming language.' versions: feature: copilot category: @@ -75,7 +75,7 @@ print "The file '$file_path' contains $word_count words and $char_count characte {% data variables.product.prodname_copilot_short %} generates the following Typescript code. -> [!NOTE] {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one shown here. +> [!NOTE] {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one shown here. ```typescript copy import * as fs from 'fs'; diff --git a/content/copilot/copilot-chat-cookbook/security-analysis/finding-existing-vulnerabilities-in-code.md b/content/copilot/copilot-chat-cookbook/security-analysis/finding-existing-vulnerabilities-in-code.md index b840a15e52..85070e4b65 100644 --- a/content/copilot/copilot-chat-cookbook/security-analysis/finding-existing-vulnerabilities-in-code.md +++ b/content/copilot/copilot-chat-cookbook/security-analysis/finding-existing-vulnerabilities-in-code.md @@ -17,7 +17,7 @@ topics: While they may be considered "common knowledge" by many developers, the vast majority of newly introduced security weaknesses are due to vulnerabilities like cross-site scripting (XSS), SQL injection, and cross-site request forgery (CSRF). These vulnerabilities can be mitigated by following secure coding practices, such as using parameterized queries, input validation, and avoiding hard-coded sensitive data. GitHub Copilot can help detect and resolve these issues. -> [!NOTE] While {% data variables.product.prodname_copilot_chat_short %} can help find some common security vulnerabilities and help you fix them, you should not rely on {% data variables.product.prodname_copilot_short %} for a comprehensive security analysis. Using {% data variables.product.prodname_code_scanning %} will more thoroughly ensure your code is secure. For more information on setting up {% data variables.product.prodname_code_scanning %}, see [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning). +> [!NOTE] While {% data variables.copilot.copilot_chat_short %} can help find some common security vulnerabilities and help you fix them, you should not rely on {% data variables.product.prodname_copilot_short %} for a comprehensive security analysis. Using {% data variables.product.prodname_code_scanning %} will more thoroughly ensure your code is secure. For more information on setting up {% data variables.product.prodname_code_scanning %}, see [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning). ## Example scenario @@ -32,7 +32,7 @@ function displayName(name) { ## Example prompt -You can ask {% data variables.product.prodname_copilot_chat_short %} to analyze code for common security vulnerabilities and provide explanations and fixes for the issues it finds. +You can ask {% data variables.copilot.copilot_chat_short %} to analyze code for common security vulnerabilities and provide explanations and fixes for the issues it finds. `Analyze this code for potential security vulnerabilities and suggest fixes.` diff --git a/content/copilot/copilot-chat-cookbook/testing-code/create-end-to-end-tests-for-a-webpage.md b/content/copilot/copilot-chat-cookbook/testing-code/create-end-to-end-tests-for-a-webpage.md index c96a4373c3..471362ee6d 100644 --- a/content/copilot/copilot-chat-cookbook/testing-code/create-end-to-end-tests-for-a-webpage.md +++ b/content/copilot/copilot-chat-cookbook/testing-code/create-end-to-end-tests-for-a-webpage.md @@ -1,7 +1,7 @@ --- title: 'Create end-to-end tests for a webpage' shortTitle: Create end-to-end tests -intro: '{% data variables.product.prodname_copilot_chat_short %} can help with generating end-to-end tests.' +intro: '{% data variables.copilot.copilot_chat_short %} can help with generating end-to-end tests.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/testing-code/create-end-to-end-tests-for-a-webpage versions: @@ -15,11 +15,11 @@ topics: - Copilot --- -Creating end-to-end tests for a webpage can be time-consuming and complex as the HTML will be generated dynamically. {% data variables.product.prodname_copilot_chat_short %} can help you create end-to-end tests for a webpage by suggesting the necessary code to interact with the webpage and validate the expected results. +Creating end-to-end tests for a webpage can be time-consuming and complex as the HTML will be generated dynamically. {% data variables.copilot.copilot_chat_short %} can help you create end-to-end tests for a webpage by suggesting the necessary code to interact with the webpage and validate the expected results. ## Example scenario -Imagine a React application that displays product details on a webpage. You need to create end-to-end tests to ensure the product details are displayed correctly. You can ask {% data variables.product.prodname_copilot_chat_short %} to generate these tests for you. +Imagine a React application that displays product details on a webpage. You need to create end-to-end tests to ensure the product details are displayed correctly. You can ask {% data variables.copilot.copilot_chat_short %} to generate these tests for you. ```javascript import React, { useState, useEffect } from 'react'; diff --git a/content/copilot/copilot-chat-cookbook/testing-code/create-mock-objects-to-abstract-layers.md b/content/copilot/copilot-chat-cookbook/testing-code/create-mock-objects-to-abstract-layers.md index aa49070b90..38ceac6b4a 100644 --- a/content/copilot/copilot-chat-cookbook/testing-code/create-mock-objects-to-abstract-layers.md +++ b/content/copilot/copilot-chat-cookbook/testing-code/create-mock-objects-to-abstract-layers.md @@ -1,7 +1,7 @@ --- title: 'Create mock objects to abstract layers' shortTitle: Create mock objects -intro: '{% data variables.product.prodname_copilot_chat_short %} can help with creating mock objects that you can use for unit tests.' +intro: '{% data variables.copilot.copilot_chat_short %} can help with creating mock objects that you can use for unit tests.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/testing-code/create-mock-objects-to-abstract-layers versions: @@ -15,11 +15,11 @@ topics: - Copilot --- -When creating unit tests, it's important to ensure they're isolated and not depending on external services. One way to achieve this is to create mock objects that abstract layers of your application. {% data variables.product.prodname_copilot_chat_short %} can help you generate the code you need to create these mock objects. +When creating unit tests, it's important to ensure they're isolated and not depending on external services. One way to achieve this is to create mock objects that abstract layers of your application. {% data variables.copilot.copilot_chat_short %} can help you generate the code you need to create these mock objects. ## Example scenario -Imagine a website built with TypeScript which displays a list of runners. You have a service which fetches the runners from a database, and the server-side code which uses this service. You want to test the server-side code, but you don't want to make a call to the database. You can ask {% data variables.product.prodname_copilot_chat_short %} to generate a mock object for the service. +Imagine a website built with TypeScript which displays a list of runners. You have a service which fetches the runners from a database, and the server-side code which uses this service. You want to test the server-side code, but you don't want to make a call to the database. You can ask {% data variables.copilot.copilot_chat_short %} to generate a mock object for the service. ```typescript // SvelteKit example at +page.server.ts diff --git a/content/copilot/copilot-chat-cookbook/testing-code/generate-unit-tests.md b/content/copilot/copilot-chat-cookbook/testing-code/generate-unit-tests.md index 78807ed9f0..4d7da74939 100644 --- a/content/copilot/copilot-chat-cookbook/testing-code/generate-unit-tests.md +++ b/content/copilot/copilot-chat-cookbook/testing-code/generate-unit-tests.md @@ -1,7 +1,7 @@ --- title: 'Generate unit tests' shortTitle: Generate unit tests -intro: '{% data variables.product.prodname_copilot_chat_short %} can help with generating unit tests for a function.' +intro: '{% data variables.copilot.copilot_chat_short %} can help with generating unit tests for a function.' redirect_from: - /copilot/example-prompts-for-github-copilot-chat/testing-code/generate-unit-tests versions: @@ -15,11 +15,11 @@ topics: - Copilot --- -A good suite of unit tests is critical to the success of any project. However, writing these tests can be time-consuming and are often neglected. {% data variables.product.prodname_copilot_chat_short %} can help generate these tests for you. +A good suite of unit tests is critical to the success of any project. However, writing these tests can be time-consuming and are often neglected. {% data variables.copilot.copilot_chat_short %} can help generate these tests for you. ## Example scenario -Imagine you have a Python function which validates data before updating the database. You need to create unit tests to ensure the validation performs the way you expect. You can ask {% data variables.product.prodname_copilot_chat_short %} to generate these tests for you. +Imagine you have a Python function which validates data before updating the database. You need to create unit tests to ensure the validation performs the way you expect. You can ask {% data variables.copilot.copilot_chat_short %} to generate these tests for you. ```python def validate_price(price: float): @@ -37,7 +37,7 @@ def validate_price(price: float): {% data reusables.copilot.example-prompts.response-is-an-example %} -If this is your first time asking {% data variables.product.prodname_copilot_chat_short %} to generate unit tests, it may ask you if you wish to configure unit tests for your project. For this example, we are assuming you decline this offer. +If this is your first time asking {% data variables.copilot.copilot_chat_short %} to generate unit tests, it may ask you if you wish to configure unit tests for your project. For this example, we are assuming you decline this offer. {% data variables.product.prodname_copilot_short %} will provide a strategy for generating the tests, and then provide the tests themselves. diff --git a/content/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses.md b/content/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses.md index 7c385aefc6..b96f48b6d2 100644 --- a/content/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses.md +++ b/content/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses.md @@ -1,7 +1,7 @@ --- title: About customizing GitHub Copilot Chat responses shortTitle: About customizing Copilot responses -intro: 'Learn about customizing {% data variables.product.prodname_copilot_chat %} responses to fit with your preferences and requirements.' +intro: 'Learn about customizing {% data variables.copilot.copilot_chat %} responses to fit with your preferences and requirements.' versions: feature: copilot topics: @@ -26,7 +26,7 @@ topics: {% endvisualstudio %} -## About customizing {% data variables.product.prodname_copilot_chat %} responses +## About customizing {% data variables.copilot.copilot_chat %} responses {% webui %} @@ -34,9 +34,9 @@ topics: ### Types of custom instructions -* **Personal custom instructions** apply to all conversations you have with {% data variables.product.prodname_copilot_chat_short %} across the {% data variables.product.github %} website. They allow you to specify your individual preferences, such as preferred language or response style, ensuring that the responses are tailored to your personal needs. +* **Personal custom instructions** apply to all conversations you have with {% data variables.copilot.copilot_chat_short %} across the {% data variables.product.github %} website. They allow you to specify your individual preferences, such as preferred language or response style, ensuring that the responses are tailored to your personal needs. * **Repository custom instructions** apply to conversations within the context of a specific repository. They are useful for defining project-specific coding standards, frameworks, or tools. For example, you can specify that a repository uses TypeScript and a particular library, ensuring consistent responses for all contributors. -* **Organization custom instructions (public preview)** apply to conversations within the context of an organization on the {% data variables.product.github %} website. They are ideal for enforcing organization-wide preferences, such as a common language or security guidelines. Organization custom instructions can only be set by organization owners for organizations with a {% data variables.product.prodname_copilot_enterprise_short %} subscription. +* **Organization custom instructions (public preview)** apply to conversations within the context of an organization on the {% data variables.product.github %} website. They are ideal for enforcing organization-wide preferences, such as a common language or security guidelines. Organization custom instructions can only be set by organization owners for organizations with a {% data variables.copilot.copilot_enterprise_short %} subscription. {% endwebui %} @@ -44,7 +44,7 @@ topics: {% data variables.product.prodname_copilot %} can provide chat responses that are tailored to the way your team works, the tools you use, or the specifics of your project, if you provide it with enough context to do so. Instead of repeatedly adding this contextual detail to your chat questions, you can create files in your repository that automatically add this information for you. -There are two types of files you can use to provide context and instructions to {% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_vscode_shortname %}: +There are two types of files you can use to provide context and instructions to {% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_vscode_shortname %}: * **Repository custom instructions** allow you to specify repository-wide instructions and preferences, in a single file, that apply to any conversation held in the context of the repository. * **Prompt files** (public preview) allow you to save common prompt instructions and relevant context in Markdown files (`*.prompt.md`) that you can then reuse in your chat prompts. Prompt files are only available in {% data variables.product.prodname_vscode_shortname %}. @@ -102,7 +102,7 @@ Common use cases include: > [!NOTE] Prompt files are {% data variables.release-phases.public_preview %} and subject to change. -Prompt files let you build and share reusable prompt instructions with additional context. A prompt file is a Markdown file, stored in your workspace, that mimics the existing format of writing prompts in {% data variables.product.prodname_copilot_chat_short %} (for example, `Rewrite #file:x.ts`). This allows blending natural language instructions, additional context, and even linking to other prompt files as dependencies. +Prompt files let you build and share reusable prompt instructions with additional context. A prompt file is a Markdown file, stored in your workspace, that mimics the existing format of writing prompts in {% data variables.copilot.copilot_chat_short %} (for example, `Rewrite #file:x.ts`). This allows blending natural language instructions, additional context, and even linking to other prompt files as dependencies. Common use cases include: diff --git a/content/copilot/customizing-copilot/adding-organization-custom-instructions-for-github-copilot.md b/content/copilot/customizing-copilot/adding-organization-custom-instructions-for-github-copilot.md index 9abd96d017..1f0b54ebd3 100644 --- a/content/copilot/customizing-copilot/adding-organization-custom-instructions-for-github-copilot.md +++ b/content/copilot/customizing-copilot/adding-organization-custom-instructions-for-github-copilot.md @@ -1,9 +1,9 @@ --- title: Adding organization custom instructions for GitHub Copilot shortTitle: Organization custom instructions -intro: 'Customize {% data variables.product.prodname_copilot_chat %} responses for members of your organization.' +intro: 'Customize {% data variables.copilot.copilot_chat %} responses for members of your organization.' permissions: Organization owners -product: 'Organizations with a {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} plan' +product: 'Organizations with a {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} plan' versions: feature: copilot-org-instructions topics: @@ -12,11 +12,11 @@ topics: {% data reusables.copilot.organization-instructions-note %} -For an overview of the methods you can use to customize {% data variables.product.prodname_copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=webui). +For an overview of the methods you can use to customize {% data variables.copilot.copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=webui). -## About organization custom instructions for {% data variables.product.prodname_copilot_chat %} +## About organization custom instructions for {% data variables.copilot.copilot_chat %} -Organization owners can add instructions for {% data variables.product.prodname_copilot_chat %} in order to tailor chat responses to the needs and preferences of your organization. For example, you can choose to always have {% data variables.product.prodname_copilot_chat_short %} respond in your company's language of choice or with a particular style. Some examples of instructions you could add are: +Organization owners can add instructions for {% data variables.copilot.copilot_chat %} in order to tailor chat responses to the needs and preferences of your organization. For example, you can choose to always have {% data variables.copilot.copilot_chat_short %} respond in your company's language of choice or with a particular style. Some examples of instructions you could add are: * `Always respond in Spanish.` * `Do not generate code blocks in responses.` * `For questions related to security, use the Security Docs Knowledge Base.` diff --git a/content/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot.md b/content/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot.md index 3e324e0944..d9100aa893 100644 --- a/content/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot.md +++ b/content/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot.md @@ -1,7 +1,7 @@ --- title: Adding personal custom instructions for GitHub Copilot shortTitle: Personal custom instructions -intro: 'Customize {% data variables.product.prodname_copilot_chat %} responses to match your personal preferences.' +intro: 'Customize {% data variables.copilot.copilot_chat %} responses to match your personal preferences.' versions: feature: copilot topics: @@ -10,11 +10,11 @@ topics: {% data reusables.copilot.personal-instructions-note %} -For an overview of the methods you can use to customize {% data variables.product.prodname_copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=webui). +For an overview of the methods you can use to customize {% data variables.copilot.copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=webui). -## About personal custom instructions for {% data variables.product.prodname_copilot_chat %} +## About personal custom instructions for {% data variables.copilot.copilot_chat %} -You can add custom instructions for {% data variables.product.prodname_copilot_chat %} in order to receive chat responses that are customized to your personal preferences, across your conversations on the {% data variables.product.github %} website. For example, you can choose to always have {% data variables.product.prodname_copilot_chat_short %} respond in a preferred language or with a particular style. Some examples of instructions you could add are: +You can add custom instructions for {% data variables.copilot.copilot_chat %} in order to receive chat responses that are customized to your personal preferences, across your conversations on the {% data variables.product.github %} website. For example, you can choose to always have {% data variables.copilot.copilot_chat_short %} respond in a preferred language or with a particular style. Some examples of instructions you could add are: * `Always respond in Spanish.` * `Your style is a helpful colleague, minimize explanations but provide enough context to understand the code.` * `Always provide examples in TypeScript.` @@ -26,8 +26,8 @@ You can add custom instructions for {% data variables.product.prodname_copilot_c You can add personal custom instructions either in the Chat panel or in immersive mode. The same instructions will be applied in both modes. 1. In the top right of any page on {% data variables.product.github %}, either: - * Click the **{% octicon "copilot" aria-label="Copilot" %}** icon to open the {% data variables.product.prodname_copilot_chat_short %} panel. - * Click {% octicon "triangle-down" aria-label="The downwards triangle icon" %} next to the **{% octicon "copilot" aria-label="Copilot" %}** icon, then click **Immersive** to open {% data variables.product.prodname_copilot_chat_short %} in the full-page, immersive mode. You can also go directly to [https://github.com/copilot](https://github.com/copilot). + * Click the **{% octicon "copilot" aria-label="Copilot" %}** icon to open the {% data variables.copilot.copilot_chat_short %} panel. + * Click {% octicon "triangle-down" aria-label="The downwards triangle icon" %} next to the **{% octicon "copilot" aria-label="Copilot" %}** icon, then click **Immersive** to open {% data variables.copilot.copilot_chat_short %} in the full-page, immersive mode. You can also go directly to [https://github.com/copilot](https://github.com/copilot). 1. Select the {% octicon "kebab-horizontal" aria-label="Open conversation options" %} dropdown menu at the top right of the Chat panel, or immersive page, then click **Personal instructions**. 1. Add natural language instructions to the text box. diff --git a/content/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot.md b/content/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot.md index db07c70e74..52de7129da 100644 --- a/content/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot.md +++ b/content/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot.md @@ -19,7 +19,7 @@ topics: > > This version of this article is for using repository custom instructions on the {% data variables.product.github %} website. Click the tabs above for information on using custom instructions in other environments. -For an overview of the methods you can use to customize {% data variables.product.prodname_copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=webui). For information on customizing {% data variables.copilot.copilot_coding_agent %} see [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent). +For an overview of the methods you can use to customize {% data variables.copilot.copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=webui). For information on customizing {% data variables.copilot.copilot_coding_agent %} see [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent). ## About repository custom instructions for {% data variables.product.prodname_copilot_short %} @@ -39,13 +39,13 @@ The custom instructions file is also used by {% data variables.product.prodname_ > > This version of this article is for using repository custom instructions in {% data variables.product.prodname_vscode_shortname %}. Click the tabs above for instructions on using custom instructions in other environments. -For an overview of the methods you can use to customize {% data variables.product.prodname_copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=vscode). +For an overview of the methods you can use to customize {% data variables.copilot.copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=vscode). -## About repository custom instructions and prompt files for {% data variables.product.prodname_copilot_chat %} +## About repository custom instructions and prompt files for {% data variables.copilot.copilot_chat %} {% data variables.product.prodname_copilot %} can provide chat responses that are tailored to the way your team works, the tools you use, or the specifics of your project, if you provide it with enough context to do so. Instead of repeatedly adding this contextual detail to your chat questions, you can create files in your repository that automatically add this information for you. -There are two types of files you can use to provide context and instructions to {% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_vscode_shortname %}: +There are two types of files you can use to provide context and instructions to {% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_vscode_shortname %}: * **Repository custom instructions** allow you to specify repository-wide instructions and preferences, in a single file, that apply to any conversation held in the context of the repository. * **Prompt files** (public preview) allow you to save common prompt instructions and relevant context in Markdown files (`*.prompt.md`) that you can then reuse in your chat prompts. Prompt files are only available in {% data variables.product.prodname_vscode_shortname %}. @@ -100,9 +100,9 @@ The following examples demonstrate how to use prompt files. > > This version of this article is for using repository custom instructions in {% data variables.product.prodname_vs %}. Click the tabs above for instructions on using custom instructions in other environments. -For an overview of the methods you can use to customize {% data variables.product.prodname_copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=visualstudio). +For an overview of the methods you can use to customize {% data variables.copilot.copilot_chat %} responses, see [AUTOTITLE](/copilot/customizing-copilot/about-customizing-github-copilot-chat-responses?tool=visualstudio). -## About repository custom instructions for {% data variables.product.prodname_copilot_chat %} +## About repository custom instructions for {% data variables.copilot.copilot_chat %} {% data variables.product.prodname_copilot %} can provide chat responses that are tailored to the way your team works, the tools you use, or the specifics of your project, if you provide it with enough context to do so. Instead of repeatedly adding this contextual detail to your chat questions, you can create a file in your repository that automatically adds this information for you. The additional information is not displayed in the chat, but is available to {% data variables.product.prodname_copilot_short %} to allow it to generate higher quality responses. @@ -119,7 +119,7 @@ For an overview of the methods you can use to customize {% data variables.produc {% webui %} * Your personal choice of whether to use custom instructions must be set to enabled. This is enabled by default. See [Enabling or disabling repository custom instructions](#enabling-or-disabling-repository-custom-instructions) later in this article. -* During the {% data variables.release-phases.public_preview %}, if you're using a {% data variables.product.prodname_copilot_business_short %} {% ifversion ghec %}or {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} plan, the organization {% ifversion ghec %}or enterprise{% endif %} that provides your plan must have the **Opt in to preview features** setting enabled. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization){% ifversion ghec %} and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom){% endif %}. +* During the {% data variables.release-phases.public_preview %}, if you're using a {% data variables.copilot.copilot_business_short %} {% ifversion ghec %}or {% data variables.copilot.copilot_enterprise_short %}{% endif %} plan, the organization {% ifversion ghec %}or enterprise{% endif %} that provides your plan must have the **Opt in to preview features** setting enabled. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization){% ifversion ghec %} and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom){% endif %}. {% endwebui %} @@ -181,11 +181,11 @@ Answer all questions in less than 1000 characters, and words of no more than 12 {% webui %} -The instructions in the `.github/copilot-instructions.md` file are available for use by {% data variables.product.prodname_copilot_chat_short %} as soon as you save the file. The complete set of instructions will be automatically added to chat prompts that relate to the repository containing the instructions file. +The instructions in the `.github/copilot-instructions.md` file are available for use by {% data variables.copilot.copilot_chat_short %} as soon as you save the file. The complete set of instructions will be automatically added to chat prompts that relate to the repository containing the instructions file. -In {% data variables.product.prodname_copilot_chat_short %}'s immersive view ([github.com/copilot](https://github.com/copilot)), you can start a conversation that uses repository custom instructions by adding, as an attachment, the repository that contains the instructions file. +In {% data variables.copilot.copilot_chat_short %}'s immersive view ([github.com/copilot](https://github.com/copilot)), you can start a conversation that uses repository custom instructions by adding, as an attachment, the repository that contains the instructions file. -Whenever repository custom instructions are used by {% data variables.product.prodname_copilot_chat_short %}, the instructions file is added as a reference for the response that's generated. To find out whether repository custom instructions were used, expand the list of references at the top of a chat response in the Chat panel and check whether the `.github/copilot-instructions.md` file is listed. +Whenever repository custom instructions are used by {% data variables.copilot.copilot_chat_short %}, the instructions file is added as a reference for the response that's generated. To find out whether repository custom instructions were used, expand the list of references at the top of a chat response in the Chat panel and check whether the `.github/copilot-instructions.md` file is listed. ![Screenshot of an expanded References list, showing the 'copilot-instructions.md' file highlighted with a dark orange outline.](/assets/images/help/copilot/custom-instructions-ref-in-github.png) @@ -252,7 +252,7 @@ Your choice persists until you change it. > [!NOTE] Prompt files are {% data variables.release-phases.public_preview %} and subject to change. -Prompt files let you build and share reusable prompt instructions with additional context. A prompt file is a Markdown file, stored in your workspace, that mimics the existing format of writing prompts in {% data variables.product.prodname_copilot_chat_short %} (for example, `Rewrite #file:x.ts`). You can have multiple prompt files in your workspace, each of which defines a prompt for a different purpose. +Prompt files let you build and share reusable prompt instructions with additional context. A prompt file is a Markdown file, stored in your workspace, that mimics the existing format of writing prompts in {% data variables.copilot.copilot_chat_short %} (for example, `Rewrite #file:x.ts`). You can have multiple prompt files in your workspace, each of which defines a prompt for a different purpose. ### Enabling prompt files @@ -273,7 +273,7 @@ To enable prompt files, configure the workspace settings. ### Using prompt files -1. At the bottom of the {% data variables.product.prodname_copilot_chat_short %} view, click the **Attach context** icon ({% octicon "paperclip" aria-hidden="true" aria-label="paperclip" %}). +1. At the bottom of the {% data variables.copilot.copilot_chat_short %} view, click the **Attach context** icon ({% octicon "paperclip" aria-hidden="true" aria-label="paperclip" %}). 1. In the dropdown menu, click **Prompt...** and choose the prompt file you want to use. 1. Optionally, attach additional files, including prompt files, to provide more context. 1. Optionally, type additional information in the chat prompt box. diff --git a/content/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot.md b/content/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot.md index 853d99b762..38c431719d 100644 --- a/content/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot.md +++ b/content/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot.md @@ -13,7 +13,7 @@ redirect_from: - /copilot/managing-copilot/managing-github-copilot-in-your-organization/enhancing-copilot-for-your-organization/creating-a-custom-model-for-github-copilot --- -> [!NOTE] The current {% data variables.release-phases.public_preview %} of custom models for {% data variables.product.prodname_copilot_enterprise %} will be discontinued. For now, participants can continue using their custom models, but we are no longer processing new training requests. We encourage participants to try the newer {% data variables.copilot.copilot_gpt_4o %} {% data variables.product.prodname_copilot_short %} code completion model. See [Changing the AI model for Copilot code completion](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion?tool=vscode). +> [!NOTE] The current {% data variables.release-phases.public_preview %} of custom models for {% data variables.copilot.copilot_enterprise %} will be discontinued. For now, participants can continue using their custom models, but we are no longer processing new training requests. We encourage participants to try the newer {% data variables.copilot.copilot_gpt_4o %} {% data variables.product.prodname_copilot_short %} code completion model. See [Changing the AI model for Copilot code completion](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion?tool=vscode). ## Prerequisite @@ -22,8 +22,8 @@ The code on which you want to train a custom model must be hosted in repositorie ## Limitations * For the {% data variables.release-phases.public_preview %}, an enterprise can deploy one custom model in a single organization. -* Code completion suggestions based on the custom model are only available to managed users who get a {% data variables.product.prodname_copilot_enterprise_short %} plan from the organization in which the custom model is deployed. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users). -* The custom model is not used for code suggested in responses by {% data variables.product.prodname_copilot_chat %}. +* Code completion suggestions based on the custom model are only available to managed users who get a {% data variables.copilot.copilot_enterprise_short %} plan from the organization in which the custom model is deployed. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users). +* The custom model is not used for code suggested in responses by {% data variables.copilot.copilot_chat %}. ## About {% data variables.product.prodname_copilot_short %} custom models @@ -55,7 +55,7 @@ If model creation fails, {% data variables.product.prodname_copilot_short %} wil ### About model usage -As soon as the custom model is successfully created, all managed users in your enterprise who get {% data variables.product.prodname_copilot_enterprise_short %} access from the organization in which the custom model is deployed will start to see {% data variables.product.prodname_copilot_short %} code completion suggestions that are generated using the custom model. The custom model will always be used for any code these users edit, irrespective of where the code resides. Users cannot choose which model is used to generate the code completion suggestions they see. +As soon as the custom model is successfully created, all managed users in your enterprise who get {% data variables.copilot.copilot_enterprise_short %} access from the organization in which the custom model is deployed will start to see {% data variables.product.prodname_copilot_short %} code completion suggestions that are generated using the custom model. The custom model will always be used for any code these users edit, irrespective of where the code resides. Users cannot choose which model is used to generate the code completion suggestions they see. ## When you can benefit from a custom model @@ -125,7 +125,7 @@ Retraining the model updates it to include any new code that has been added to t 1. Go to your organization's settings for {% data variables.product.prodname_copilot_short %} custom models. See [Creating a custom model](#creating-a-custom-model) above. 1. On the model training page, click the first ellipsis button (**...**), then click either **Retrain model** or **Delete model**. -If you retrain the model, {% data variables.product.prodname_copilot_short %} will continue to use the current model to generate code completion suggestions until the new model is ready. Once the new model is ready, it will be automatically be used for code completion suggestions for all managed users who get a {% data variables.product.prodname_copilot_enterprise_short %} plan from the organization. +If you retrain the model, {% data variables.product.prodname_copilot_short %} will continue to use the current model to generate code completion suggestions until the new model is ready. Once the new model is ready, it will be automatically be used for code completion suggestions for all managed users who get a {% data variables.copilot.copilot_enterprise_short %} plan from the organization. If you delete the custom model, {% data variables.product.prodname_copilot_short %} will use the base model for generating code completion suggestions for all users who get a {% data variables.product.prodname_copilot_short %} plan from the organization. diff --git a/content/copilot/customizing-copilot/extending-copilot-chat-with-mcp.md b/content/copilot/customizing-copilot/extending-copilot-chat-with-mcp.md index a8c56dd2a7..36c40878b5 100644 --- a/content/copilot/customizing-copilot/extending-copilot-chat-with-mcp.md +++ b/content/copilot/customizing-copilot/extending-copilot-chat-with-mcp.md @@ -2,7 +2,7 @@ title: Extending Copilot Chat with the Model Context Protocol (MCP) allowTitleToDifferFromFilename: true shortTitle: Extend Copilot Chat with MCP -intro: "Learn how to use the Model Context Protocol (MCP) to extend {% data variables.product.prodname_copilot_chat_short %}." +intro: "Learn how to use the Model Context Protocol (MCP) to extend {% data variables.copilot.copilot_chat_short %}." versions: feature: copilot topics: @@ -12,7 +12,7 @@ type: how_to >[!NOTE] > * MCP support is currently in {% data variables.release-phases.public_preview %} and subject to change. -> * MCP support is available in {% data variables.product.prodname_copilot_chat_short %} for {% data variables.product.prodname_vscode %}, JetBrains, Eclipse, and Xcode. +> * MCP support is available in {% data variables.copilot.copilot_chat_short %} for {% data variables.product.prodname_vscode %}, JetBrains, Eclipse, and Xcode. > * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply to your use of this product. {% vscode %} @@ -21,7 +21,7 @@ type: how_to The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to connect AI models to different data sources and tools, enabling them to work together more effectively. -You can use MCP to extend the capabilities of {% data variables.product.prodname_copilot_chat_short %} by integrating it with a wide range of existing tools and services. For example, the {% data variables.product.github %} MCP server allows you to use {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} to perform tasks on {% data variables.product.github %}. You can also use MCP to create new tools and services that work with {% data variables.product.prodname_copilot_chat_short %}, allowing you to customize and enhance your experience. +You can use MCP to extend the capabilities of {% data variables.copilot.copilot_chat_short %} by integrating it with a wide range of existing tools and services. For example, the {% data variables.product.github %} MCP server allows you to use {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} to perform tasks on {% data variables.product.github %}. You can also use MCP to create new tools and services that work with {% data variables.copilot.copilot_chat_short %}, allowing you to customize and enhance your experience. For more information on MCP, see [the official MCP documentation](https://modelcontextprotocol.io/introduction). @@ -70,10 +70,10 @@ You can use the same steps to configure MCP servers in your personal {% data var ![Screenshot of MCP server configuration in {% data variables.product.prodname_vscode %}. The "Start" button is outlined in dark orange. ](/assets/images/help/copilot/mcp-start-server-button.png) -1. Open {% data variables.product.prodname_copilot_chat_short %} by clicking the {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} icon in the title bar of {% data variables.product.prodname_vscode %}. -1. In the {% data variables.product.prodname_copilot_chat_short %} box, select **Agent** from the popup menu. +1. Open {% data variables.copilot.copilot_chat_short %} by clicking the {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} icon in the title bar of {% data variables.product.prodname_vscode %}. +1. In the {% data variables.copilot.copilot_chat_short %} box, select **Agent** from the popup menu. - ![Screenshot of the {% data variables.product.prodname_copilot_chat_short %} box in {% data variables.product.prodname_vscode %}. The "Agent" option is outlined in dark orange.](/assets/images/help/copilot/copilot-chat-agent-option.png) + ![Screenshot of the {% data variables.copilot.copilot_chat_short %} box in {% data variables.product.prodname_vscode %}. The "Agent" option is outlined in dark orange.](/assets/images/help/copilot/copilot-chat-agent-option.png) 1. To view your list of available MCP servers, click the tools icon in the top left corner of the chat box. This will open the MCP server list, where you can see all the MCP servers and associated tools that are currently available in your {% data variables.product.prodname_vscode %} instance. @@ -81,17 +81,17 @@ For more information on configuring MCP servers in {% data variables.product.pro >[!IMPORTANT] Beginning April 4, 2025, the {% data variables.product.github %} MCP server, and installation instructions, will be publicly available in the [github-mcp-server](https://github.com/github/github-mcp-server) repository. -## Using MCP servers in {% data variables.product.prodname_copilot_chat_short %} +## Using MCP servers in {% data variables.copilot.copilot_chat_short %} -Once you have configured your MCP servers, you can use them in {% data variables.product.prodname_copilot_chat_short %} to access a wide range of tools and services. In the example below, we will use the Fetch MCP server to fetch details about a web page. +Once you have configured your MCP servers, you can use them in {% data variables.copilot.copilot_chat_short %} to access a wide range of tools and services. In the example below, we will use the Fetch MCP server to fetch details about a web page. -1. Open {% data variables.product.prodname_copilot_chat_short %} by clicking the {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} icon in the title bar of {% data variables.product.prodname_vscode %}. -1. In the {% data variables.product.prodname_copilot_chat_short %} box, select **Agent** from the popup menu. +1. Open {% data variables.copilot.copilot_chat_short %} by clicking the {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} icon in the title bar of {% data variables.product.prodname_vscode %}. +1. In the {% data variables.copilot.copilot_chat_short %} box, select **Agent** from the popup menu. 1. In the file with the MCP configuration, check that the MCP server is running. If it is not running, click the "Start" button to start the MCP server. ![Screenshot of the MCP server configuration in {% data variables.product.prodname_vscode %}. The "Running" status is outlined in dark orange.](/assets/images/help/copilot/vsc-mcp-server-running.png) -1. Ask {% data variables.product.prodname_copilot_chat_short %} to fetch the details of a URL. For example: +1. Ask {% data variables.copilot.copilot_chat_short %} to fetch the details of a URL. For example: `Fetch https://github.com/github/docs.` @@ -182,9 +182,9 @@ For information on other currently available MCP servers, see [the MCP servers r ## Configuring MCP servers in Eclipse -1. To open the {% data variables.product.prodname_copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse. +1. To open the {% data variables.copilot.copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse. 1. From the menu, select "Edit preferences". -1. In the left pane, expand {% data variables.product.prodname_copilot_chat_short %} and click **MCP**. +1. In the left pane, expand {% data variables.copilot.copilot_chat_short %} and click **MCP**. 1. Define your MCP servers. You can use the following configuration as an example: {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides %} @@ -193,7 +193,7 @@ For information on other currently available MCP servers, see [the MCP servers r ## Creating a new MCP server -You can create a new MCP server to fulfill your specific needs, and then integrate it with {% data variables.product.prodname_copilot_chat_short %}. For example, you can create an MCP server that connects to a database or a web service, and then use that server in {% data variables.product.prodname_copilot_chat_short %} to perform tasks on that database or web service. +You can create a new MCP server to fulfill your specific needs, and then integrate it with {% data variables.copilot.copilot_chat_short %}. For example, you can create an MCP server that connects to a database or a web service, and then use that server in {% data variables.copilot.copilot_chat_short %} to perform tasks on that database or web service. For more information on creating and configuring your own MCP servers, see [the official MCP documentation](https://modelcontextprotocol.io/quickstart/server). diff --git a/content/copilot/customizing-copilot/extending-copilot-coding-agent-with-mcp.md b/content/copilot/customizing-copilot/extending-copilot-coding-agent-with-mcp.md index c700935518..546e7bdcd6 100644 --- a/content/copilot/customizing-copilot/extending-copilot-coding-agent-with-mcp.md +++ b/content/copilot/customizing-copilot/extending-copilot-coding-agent-with-mcp.md @@ -220,13 +220,13 @@ Repository administrators can configure MCP servers by following these steps: {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -1. In the "Code & automation" section of the sidebar, click **{% data variables.product.prodname_copilot_short %}** then **{% data variables.copilot.coding_agent_UI %}**. +1. In the "Code & automation" section of the sidebar, click **{% data variables.product.prodname_copilot_short %}** then **{% data variables.copilot.copilot_agent_short %}**. 1. Add your configuration in the **MCP configuration** section. 1. Click **Save**. Your configuration will be validated to ensure proper syntax. -1. If your MCP server requires a key or secret, add a secret to your Copilot environment. Only secrets with names prefixed with `COPILOT_MCP_` will be available to your MCP configuration. See [Setting up a Copilot environment for Copilot coding agent](#setting-up-a-copilot-environment-for-copilot-coding-agent). +1. If your MCP server requires a key or secret, add a secret to your {% data variables.product.prodname_copilot_short %} environment. Only secrets with names prefixed with `COPILOT_MCP_` will be available to your MCP configuration. See [Setting up a {% data variables.product.prodname_copilot_short %} environment for {% data variables.copilot.copilot_coding_agent %}](#setting-up-a-copilot-environment-for-copilot-coding-agent). ### Setting up a {% data variables.product.prodname_copilot_short %} environment for {% data variables.copilot.copilot_coding_agent %} @@ -268,7 +268,7 @@ If you want to allow {% data variables.product.prodname_copilot_short %} to acce 1. Create a {% data variables.product.pat_generic %} with the appropriate permissions. We recommend using a {% data variables.product.pat_v2 %}, where you can limit the token's access to read-only permissions on specific repositories. For more information on {% data variables.product.pat_generic_plural %}, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -1. In the "Code & automation" section of the sidebar, click **{% data variables.product.prodname_copilot_short %}** then **{% data variables.copilot.coding_agent_UI %}**. +1. In the "Code & automation" section of the sidebar, click **{% data variables.product.prodname_copilot_short %}** then **{% data variables.copilot.copilot_agent_short %}**. 1. Add your configuration in the **MCP configuration** section. 1. Click **Save**. {% data reusables.actions.sidebar-environment %} diff --git a/content/copilot/customizing-copilot/extending-the-capabilities-of-github-copilot-in-your-organization.md b/content/copilot/customizing-copilot/extending-the-capabilities-of-github-copilot-in-your-organization.md index 544438aabd..f4c6ac45f8 100644 --- a/content/copilot/customizing-copilot/extending-the-capabilities-of-github-copilot-in-your-organization.md +++ b/content/copilot/customizing-copilot/extending-the-capabilities-of-github-copilot-in-your-organization.md @@ -2,7 +2,7 @@ title: Extending the capabilities of GitHub Copilot in your organization shortTitle: Install extensions intro: 'You can add additional functionality to {% data variables.product.prodname_copilot_short %} in your organization, by installing certain {% data variables.product.prodname_github_apps %} from {% data variables.product.prodname_marketplace %}.' -product: 'Organization owners can install {% data variables.product.prodname_copilot_extensions %} for an organization.' +product: 'Organization owners can install {% data variables.copilot.copilot_extensions %} for an organization.' versions: feature: copilot-extensions topics: @@ -16,33 +16,33 @@ redirect_from: - /copilot/managing-copilot/managing-github-copilot-in-your-organization/enhancing-copilot-for-your-organization/installing-github-copilot-extensions-for-your-organization --- -## About {% data variables.product.prodname_copilot_extensions %} for your organization +## About {% data variables.copilot.copilot_extensions %} for your organization {% data reusables.copilot.copilot-extensions.copilot-extensions-on-marketplace %} -Any organization owner can install {% data variables.product.prodname_copilot_extensions_short %} for their organization, but your organization must have an active {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan. +Any organization owner can install {% data variables.copilot.copilot_extensions_short %} for their organization, but your organization must have an active {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan. -> [!NOTE] Anyone can install a {% data variables.product.prodname_copilot_extension_short %} on their personal account. However, if they get access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, they will only be able to use the extension if it is installed at the organization level. +> [!NOTE] Anyone can install a {% data variables.copilot.copilot_extension_short %} on their personal account. However, if they get access to {% data variables.product.prodname_copilot_short %} through a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, they will only be able to use the extension if it is installed at the organization level. -You can also create your own custom {% data variables.product.prodname_copilot_extensions_short %} for your organization. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). +You can also create your own custom {% data variables.copilot.copilot_extensions_short %} for your organization. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). ## Prerequisites -Before you install any {% data variables.product.prodname_copilot_extensions_short %} in your organization, you should set a usage policy for {% data variables.product.prodname_copilot_extensions_short %} at the {% ifversion ghec %}enterprise or {% endif %}organization level. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions). +Before you install any {% data variables.copilot.copilot_extensions_short %} in your organization, you should set a usage policy for {% data variables.copilot.copilot_extensions_short %} at the {% ifversion ghec %}enterprise or {% endif %}organization level. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions). -## Installing {% data variables.product.prodname_copilot_extensions %} for your organization +## Installing {% data variables.copilot.copilot_extensions %} for your organization 1. Open [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true). 1. In the left sidebar, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**. -1. In the list of {% data variables.product.prodname_copilot_extensions_short %}, locate an app you'd like to install. -1. To install the {% data variables.product.prodname_copilot_extension_short %} on an organization with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, see [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations). +1. In the list of {% data variables.copilot.copilot_extensions_short %}, locate an app you'd like to install. +1. To install the {% data variables.copilot.copilot_extension_short %} on an organization with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, see [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations). {% data reusables.copilot.copilot-extensions.extension-specific-onboarding-steps %} ## Next steps -After installing a {% data variables.product.prodname_copilot_extension_short %} for your organization, developers in your organization can start using the extension. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). +After installing a {% data variables.copilot.copilot_extension_short %} for your organization, developers in your organization can start using the extension. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). -You can also manage the permissions of installed {% data variables.product.prodname_copilot_extensions_short %}. 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#managing-permissions-for-a-github-copilot-extension-in-your-organization). +You can also manage the permissions of installed {% data variables.copilot.copilot_extensions_short %}. 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#managing-permissions-for-a-github-copilot-extension-in-your-organization). ## Further reading diff --git a/content/copilot/customizing-copilot/managing-copilot-knowledge-bases.md b/content/copilot/customizing-copilot/managing-copilot-knowledge-bases.md index 87f1ed81e9..76640c7fe2 100644 --- a/content/copilot/customizing-copilot/managing-copilot-knowledge-bases.md +++ b/content/copilot/customizing-copilot/managing-copilot-knowledge-bases.md @@ -1,7 +1,7 @@ --- title: Managing Copilot knowledge bases shortTitle: Manage knowledge bases -intro: 'Organization owners can create a knowledge base bringing together Markdown documentation across one or more repositories, and then organization members can use that knowledge base as context for {% data variables.product.prodname_copilot_chat_dotcom_short %}.' +intro: 'Organization owners can create a knowledge base bringing together Markdown documentation across one or more repositories, and then organization members can use that knowledge base as context for {% data variables.copilot.copilot_chat_dotcom_short %}.' versions: ghec: '*' product: '{% data reusables.copilot.ce-product-callout %}' @@ -20,23 +20,23 @@ redirect_from: - /copilot/github-copilot-enterprise/copilot-docset-management/about-copilot-docset-management --- -> [!TIP] If you're looking for a more flexible way to organize context for {% data variables.product.prodname_copilot_short %}, you can also try {% data variables.product.prodname_copilot_spaces %}. +> [!TIP] If you're looking for a more flexible way to organize context for {% data variables.product.prodname_copilot_short %}, you can also try {% data variables.copilot.copilot_spaces %}. > -> {% data variables.product.prodname_copilot_spaces_short %} let you combine code and free-text content—like transcripts or specs—and can be created by any {% data variables.product.prodname_copilot_short %} user, not just organization owners. They’re a good option for more focused or task-specific use cases. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). +> {% data variables.copilot.copilot_spaces_short %} let you combine code and free-text content—like transcripts or specs—and can be created by any {% data variables.product.prodname_copilot_short %} user, not just organization owners. They’re a good option for more focused or task-specific use cases. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). ## About knowledge bases -Organization owners can create knowledge bases, bringing together Markdown documentation across one or more repositories. Organization members can then specify that knowledge base as the context for {% data variables.product.prodname_copilot_chat_dotcom_short %}, {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, and {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}. +Organization owners can create knowledge bases, bringing together Markdown documentation across one or more repositories. Organization members can then specify that knowledge base as the context for {% data variables.copilot.copilot_chat_dotcom_short %}, {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, and {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vs %}. -When you ask a question in {% data variables.product.prodname_copilot_chat %} with a knowledge base selected, {% data variables.product.prodname_copilot %} will search the knowledge base for relevant information and synthesize a response. +When you ask a question in {% data variables.copilot.copilot_chat %} with a knowledge base selected, {% data variables.product.prodname_copilot %} will search the knowledge base for relevant information and synthesize a response. -For more information on how to use knowledge bases in {% data variables.product.prodname_copilot_chat_short %}, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-a-question-about-a-knowledge-base) and [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-a-question-about-a-knowledge-base-in-github-copilot-chat). +For more information on how to use knowledge bases in {% data variables.copilot.copilot_chat_short %}, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-a-question-about-a-knowledge-base) and [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-a-question-about-a-knowledge-base-in-github-copilot-chat). ## Creating a knowledge base You can create a knowledge base from a single repository or a selection of repositories. You can create a knowledge base using public, private, and/or internal repositories. -Knowledge bases you create will be accessible by all organization members with a {% data variables.product.prodname_copilot_enterprise_short %} plan. When an organization member uses a knowledge base as context in {% data variables.product.prodname_copilot_chat %}, the response will only use data from repositories that the organization member has read access to. +Knowledge bases you create will be accessible by all organization members with a {% data variables.copilot.copilot_enterprise_short %} plan. When an organization member uses a knowledge base as context in {% data variables.copilot.copilot_chat %}, the response will only use data from repositories that the organization member has read access to. {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} diff --git a/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-the-cli.md b/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-the-cli.md index 55e66b026e..32d9069871 100644 --- a/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-the-cli.md +++ b/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-the-cli.md @@ -1,7 +1,7 @@ --- title: Configuring GitHub Copilot in the CLI shortTitle: Configure in the CLI -intro: 'Learn how to configure settings and set up aliases for {% data variables.product.prodname_copilot_cli_short %}.' +intro: 'Learn how to configure settings and set up aliases for {% data variables.copilot.copilot_cli_short %}.' versions: feature: copilot-in-the-cli topics: @@ -13,9 +13,9 @@ redirect_from: ## Setting up aliases -You can create aliases for {% data variables.product.prodname_copilot_cli_short %} to reduce keystrokes, and to allow {% data variables.product.prodname_copilot_cli_short %} to execute commands on your behalf. +You can create aliases for {% data variables.copilot.copilot_cli_short %} to reduce keystrokes, and to allow {% data variables.copilot.copilot_cli_short %} to execute commands on your behalf. -To allow {% data variables.product.prodname_copilot_cli_short %} to execute commands, you must run the following commands to create the aliases (as opposed to creating an alias like you would for another shell command). +To allow {% data variables.copilot.copilot_cli_short %} to execute commands, you must run the following commands to create the aliases (as opposed to creating an alias like you would for another shell command). After executing the following commands to create the aliases, you can run `ghcs` and `ghce` instead of `gh copilot suggest` and `gh copilot explain`. @@ -41,7 +41,7 @@ echo 'eval "$(gh copilot alias -- zsh)"' >> ~/.zshrc ## Changing the default execution confirmation -When you use the `ghcs` alias and you select **Execute command**, {% data variables.product.prodname_copilot_cli_short %} will ask for confirmation before executing the command. You can change the default confirmation. +When you use the `ghcs` alias and you select **Execute command**, {% data variables.copilot.copilot_cli_short %} will ask for confirmation before executing the command. You can change the default confirmation. 1. Execute the following command: @@ -54,7 +54,7 @@ When you use the `ghcs` alias and you select **Execute command**, {% data variab ## Changing usage analytics -Unless you opt out, {% data variables.product.prodname_copilot_cli_short %} will send a payload in the format below to the analytics system. This data helps improve the product. {% data variables.product.company_short %} does not look at the data of specific individuals or at specific queries. +Unless you opt out, {% data variables.copilot.copilot_cli_short %} will send a payload in the format below to the analytics system. This data helps improve the product. {% data variables.product.company_short %} does not look at the data of specific individuals or at specific queries. ```json { diff --git a/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment.md b/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment.md index f35069af78..3d4ef0e2ec 100644 --- a/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment.md +++ b/content/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment.md @@ -447,7 +447,7 @@ After updating the extension, Xcode must be restarted for the changes to take ef ## About {% data variables.product.prodname_copilot %} in Eclipse -If you use Eclipse, {% data variables.product.prodname_copilot %} can provide code suggestions as you work in the IDE. You can also use the {% data variables.product.prodname_copilot_chat_short %} panel to work with {% data variables.product.prodname_copilot_short %} as your AI pair programmer. +If you use Eclipse, {% data variables.product.prodname_copilot %} can provide code suggestions as you work in the IDE. You can also use the {% data variables.copilot.copilot_chat_short %} panel to work with {% data variables.product.prodname_copilot_short %} as your AI pair programmer. After you install {% data variables.product.prodname_copilot %} in Eclipse, you can enable or disable it, and you can configure advanced settings within the IDE. diff --git a/content/copilot/managing-copilot/configure-personal-settings/installing-github-copilot-in-the-cli.md b/content/copilot/managing-copilot/configure-personal-settings/installing-github-copilot-in-the-cli.md index 1ce21dafe7..d9687fb54e 100644 --- a/content/copilot/managing-copilot/configure-personal-settings/installing-github-copilot-in-the-cli.md +++ b/content/copilot/managing-copilot/configure-personal-settings/installing-github-copilot-in-the-cli.md @@ -1,6 +1,6 @@ --- title: Installing GitHub Copilot in the CLI -intro: 'Learn how to install {% data variables.product.prodname_copilot_cli_short %} so that you can get suggestions and explanations for the command line.' +intro: 'Learn how to install {% data variables.copilot.copilot_cli_short %} so that you can get suggestions and explanations for the command line.' versions: feature: copilot-in-the-cli topics: @@ -18,9 +18,9 @@ redirect_from: * **Access to {% data variables.product.prodname_copilot %}**. See [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). * **{% data variables.product.prodname_cli %} installed.** {% data reusables.cli.cli-installation %} -If you have access to {% data variables.product.prodname_copilot %} via your organization or enterprise, you cannot use {% data variables.product.prodname_copilot_cli_short %} if your organization owner or enterprise administrator has disabled {% data variables.product.prodname_copilot_cli_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization). +If you have access to {% data variables.product.prodname_copilot %} via your organization or enterprise, you cannot use {% data variables.copilot.copilot_cli_short %} if your organization owner or enterprise administrator has disabled {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization). -## Installing {% data variables.product.prodname_copilot_cli_short %} +## Installing {% data variables.copilot.copilot_cli_short %} 1. If you have not already authenticated to the {% data variables.product.prodname_cli %}, run the following command in your terminal. @@ -28,15 +28,15 @@ If you have access to {% data variables.product.prodname_copilot %} via your org gh auth login ``` -1. To install the {% data variables.product.prodname_copilot_cli_short %} extension, run the following command. +1. To install the {% data variables.copilot.copilot_cli_short %} extension, run the following command. ```shell copy gh extension install github/gh-copilot ``` -## Updating {% data variables.product.prodname_copilot_cli_short %} +## Updating {% data variables.copilot.copilot_cli_short %} -After installing the {% data variables.product.prodname_copilot_cli_short %} extension, you can update at any time by running: +After installing the {% data variables.copilot.copilot_cli_short %} extension, you can update at any time by running: ```shell copy gh extension upgrade gh-copilot diff --git a/content/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment.md b/content/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment.md index 3b13053ce9..36d1f79c81 100644 --- a/content/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment.md +++ b/content/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment.md @@ -13,7 +13,7 @@ redirect_from: ## Prerequisite -To use {% data variables.product.prodname_copilot_short %} in your IDE, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. For more information about how to get access and choose the right plan, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). +To use {% data variables.product.prodname_copilot_short %} in your IDE, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. For more information about how to get access and choose the right plan, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). {% azure_data_studio %} @@ -148,7 +148,7 @@ To see instructions for other popular coding environments, use the tool switcher ### Version compatibility -Starting from {% data variables.product.prodname_vs %} 2022 Version 17.10, the unified {% data variables.product.prodname_copilot_short %} and {% data variables.product.prodname_copilot_chat %} extension is included by default as a built-in component. For more information, see [Install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}](https://learn.microsoft.com/en-us/visualstudio/ide/visual-studio-github-copilot-install-and-states) in the Microsoft documentation. +Starting from {% data variables.product.prodname_vs %} 2022 Version 17.10, the unified {% data variables.product.prodname_copilot_short %} and {% data variables.copilot.copilot_chat %} extension is included by default as a built-in component. For more information, see [Install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}](https://learn.microsoft.com/en-us/visualstudio/ide/visual-studio-github-copilot-install-and-states) in the Microsoft documentation. ## Installing the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vs %} @@ -168,7 +168,7 @@ Starting from {% data variables.product.prodname_vs %} 2022 Version 17.10, the u ## About {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %} -{% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %} allows you to receive coding suggestions from {% data variables.product.prodname_copilot_short %} as you type. You also automatically get access to {% data variables.product.prodname_copilot_chat %}, which allows you to chat with {% data variables.product.prodname_copilot_short %}. +{% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %} allows you to receive coding suggestions from {% data variables.product.prodname_copilot_short %} as you type. You also automatically get access to {% data variables.copilot.copilot_chat %}, which allows you to chat with {% data variables.product.prodname_copilot_short %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page. @@ -227,7 +227,7 @@ Before you can use the {% data variables.product.prodname_copilot %} extension f ## About {% data variables.product.prodname_copilot %} in Eclipse -Installing {% data variables.product.prodname_copilot %} in Eclipse allows you to receive coding suggestions from {% data variables.product.prodname_copilot_short %} as you type. You also automatically get access to {% data variables.product.prodname_copilot_chat %}, which allows you to chat with {% data variables.product.prodname_copilot_short %}. +Installing {% data variables.product.prodname_copilot %} in Eclipse allows you to receive coding suggestions from {% data variables.product.prodname_copilot_short %} as you type. You also automatically get access to {% data variables.copilot.copilot_chat %}, which allows you to chat with {% data variables.product.prodname_copilot_short %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page. diff --git a/content/copilot/managing-copilot/configuring-and-auditing-content-exclusion/excluding-content-from-github-copilot.md b/content/copilot/managing-copilot/configuring-and-auditing-content-exclusion/excluding-content-from-github-copilot.md index a167dad2f7..3136de3ba0 100644 --- a/content/copilot/managing-copilot/configuring-and-auditing-content-exclusion/excluding-content-from-github-copilot.md +++ b/content/copilot/managing-copilot/configuring-and-auditing-content-exclusion/excluding-content-from-github-copilot.md @@ -28,7 +28,7 @@ You can use content exclusions to configure {% data variables.product.prodname_c * Code completion will not be available in the affected files. * The content in affected files will not inform code completion suggestions in other files. -* The content in affected files will not inform {% data variables.product.prodname_copilot_chat %}'s responses. +* The content in affected files will not inform {% data variables.copilot.copilot_chat %}'s responses. * Affected files will not be reviewed in a {% data variables.product.prodname_copilot_short %} code review. ### Who can configure content exclusion @@ -39,7 +39,7 @@ Repository administrators{% ifversion ghec %}, organization owners, and enterpri ### Availability of content exclusions -| Tool | Code completion support | {% data variables.product.prodname_copilot_chat_short %} support | +| Tool | Code completion support | {% data variables.copilot.copilot_chat_short %} support | |-------------------------------------------------|:---------------------------------------------:|:----------------------------------------------------------------:| | {% data variables.product.prodname_vs %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | | {% data variables.product.prodname_vscode %} | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | @@ -225,7 +225,7 @@ There are a few different ways to test your content exclusions, depending on whi 1. Use one or more of the following techniques to test if content is being excluded: * **In JetBrains IDEs, {% data variables.product.prodname_vs %}, and {% data variables.product.prodname_vscode %}**, check the {% data variables.product.prodname_copilot_short %} icon in the status bar. If a {% data variables.product.prodname_copilot_short %} content exclusion applies to the file, the {% data variables.product.prodname_copilot_short %} icon will have a diagonal line through it. Hover over the icon to see whether an organization or the parent repository disabled {% data variables.product.prodname_copilot_short %} for the file. * **In Vim/Neovim**, begin typing in the file. If {% data variables.product.prodname_copilot %} no longer provides inline suggestions as you type, the file is excluded. - * You can also test content exclusions in {% data variables.product.prodname_copilot_chat_short %}. Open the {% data variables.product.prodname_copilot_chat_short %} window, and ask {% data variables.product.prodname_copilot_chat_short %} a question about the excluded file. If your content is excluded successfully, {% data variables.product.prodname_copilot_short %} will be unable to answer your question, and will explain that some files were excluded from the conversation due to content exclusion rules. + * You can also test content exclusions in {% data variables.copilot.copilot_chat_short %}. Open the {% data variables.copilot.copilot_chat_short %} window, and ask {% data variables.copilot.copilot_chat_short %} a question about the excluded file. If your content is excluded successfully, {% data variables.product.prodname_copilot_short %} will be unable to answer your question, and will explain that some files were excluded from the conversation due to content exclusion rules. ## Further reading diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/billing-and-payments/about-billing-for-individual-copilot-plans.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/billing-and-payments/about-billing-for-individual-copilot-plans.md index d273259a49..9ca66e77c4 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/billing-and-payments/about-billing-for-individual-copilot-plans.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/billing-and-payments/about-billing-for-individual-copilot-plans.md @@ -1,7 +1,7 @@ --- title: About billing for individual Copilot plans shortTitle: About billing -intro: 'Learn how billing works for {% data variables.product.prodname_copilot_pro_short %} and {% data variables.product.prodname_copilot_pro_plus_short %}.' +intro: 'Learn how billing works for {% data variables.copilot.copilot_pro_short %} and {% data variables.copilot.copilot_pro_plus_short %}.' versions: feature: copilot type: overview @@ -13,16 +13,16 @@ redirect_from: - /copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/billing-and-payments/about-billing-for-copilot-pro --- -## Pricing for {% data variables.product.prodname_copilot_pro_short %} and {% data variables.product.prodname_copilot_pro_plus_short %} +## Pricing for {% data variables.copilot.copilot_pro_short %} and {% data variables.copilot.copilot_pro_plus_short %} -{% data variables.product.github %} offers two paid plans for individuals: {% data variables.product.prodname_copilot_pro_short %} and {% data variables.product.prodname_copilot_pro_plus_short %}. Both plans are available on a monthly or yearly billing cycle. +{% data variables.product.github %} offers two paid plans for individuals: {% data variables.copilot.copilot_pro_short %} and {% data variables.copilot.copilot_pro_plus_short %}. Both plans are available on a monthly or yearly billing cycle. -**{% data variables.product.prodname_copilot_pro_short %}** +**{% data variables.copilot.copilot_pro_short %}** * **If you choose a monthly billing cycle**, you will be billed {% data variables.copilot.cfi_price_per_month %} per calendar month. * **If you choose a yearly billing cycle**, you will be billed {% data variables.copilot.cfi_price_per_year %} per year. -**{% data variables.product.prodname_copilot_pro_plus_short %}** +**{% data variables.copilot.copilot_pro_plus_short %}** * **If you choose a monthly billing cycle**, you will be billed {% data variables.copilot.cpp_price_per_month %} per calendar month. * **If you choose a yearly billing cycle**, you will be billed {% data variables.copilot.cpp_price_per_year %} per year. @@ -37,9 +37,9 @@ You can change to a monthly or yearly billing cycle at any time. The change will {% ifversion fpt %} -### About the 30-day trial for {% data variables.product.prodname_copilot_pro_short %} +### About the 30-day trial for {% data variables.copilot.copilot_pro_short %} -> [!NOTE] {% data variables.product.prodname_copilot_pro_plus_short %} does not include a trial. You will be billed immediately upon subscribing. +> [!NOTE] {% data variables.copilot.copilot_pro_plus_short %} does not include a trial. You will be billed immediately upon subscribing. Before starting a paid plan for a personal account, you can set up a one-time {% data reusables.copilot.trial-period %}-day trial to evaluate {% data variables.product.prodname_copilot_short %}. To begin a trial, you will need to choose a monthly or yearly billing cycle, and provide a payment method. If you do not cancel the trial before the end of the {% data reusables.copilot.trial-period %} days, the trial will automatically convert to a paid plan. @@ -80,7 +80,7 @@ Your billing date will depend on whether or not you are already being billed by * **If you are not already being billed by {% data variables.product.prodname_dotcom %}**, in most cases your billing cycle will start on the day you sign up for {% data variables.product.prodname_copilot_short %}. For example, if you sign up on 3 September, with monthly billing, your initial billing cycle will run from 3 September until and including 2 October, and then on the same days of subsequent months. For annual billing, if you sign up on 3 September, your initial cycle will end on 2 September the following year. -* **If you already have a billing cycle**, billing for {% data variables.product.prodname_copilot_short %} will be included in your next bill, or your first bill after the end of your 30-day {% data variables.product.prodname_copilot_short %} trial. You will be charged on a pro rata basis for that initial period. If you do not already have an established billing date, you will be billed for {% data variables.product.prodname_copilot_pro_short %} at the end of your 30-day trial, or when you set up a new paid {% data variables.product.prodname_copilot_short %} plan. +* **If you already have a billing cycle**, billing for {% data variables.product.prodname_copilot_short %} will be included in your next bill, or your first bill after the end of your 30-day {% data variables.product.prodname_copilot_short %} trial. You will be charged on a pro rata basis for that initial period. If you do not already have an established billing date, you will be billed for {% data variables.copilot.copilot_pro_short %} at the end of your 30-day trial, or when you set up a new paid {% data variables.product.prodname_copilot_short %} plan. ## Further reading diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/about-individual-copilot-plans-and-benefits.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/about-individual-copilot-plans-and-benefits.md index 2d85ddca3c..d1297b5f71 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/about-individual-copilot-plans-and-benefits.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/about-individual-copilot-plans-and-benefits.md @@ -16,33 +16,33 @@ redirect_from: You can choose from the following plans. -## {% data variables.product.prodname_copilot_free %} +## {% data variables.copilot.copilot_free %} For developers looking to get started with {% data variables.product.prodname_copilot_short %}. * Includes up to **2,000 code completions** in IDEs per month -* Includes up to **50 total chat requests** per month in {% data variables.product.prodname_copilot_chat_short %} +* Includes up to **50 total chat requests** per month in {% data variables.copilot.copilot_chat_short %} * Designed to give you a limited taste of {% data variables.product.prodname_copilot_short %}'s capabilities * No subscription or payment required * Intended for **personal use only**, not for users managed by an organization or enterprise * Great for developers who want to explore {% data variables.product.prodname_copilot_short %}'s capabilities before upgrading to a paid plan -## {% data variables.product.prodname_copilot_pro %} +## {% data variables.copilot.copilot_pro %} For developers who want more flexibility, including unlimited completions and access to additional models. * Includes **unlimited completions** in IDEs -* Access to {% data variables.product.prodname_copilot_chat_short %} and additional models +* Access to {% data variables.copilot.copilot_chat_short %} and additional models * Includes up to **300 premium requests** per month (additional at {% data variables.copilot.additional_premium_requests %} each) * Free for verified students, teachers, and maintainers of popular open source projects -## {% data variables.product.prodname_copilot_pro_plus %} +## {% data variables.copilot.copilot_pro_plus %} For developers who need maximum flexibility, premium access to available models, and expanded request limits. -* Everything in {% data variables.product.prodname_copilot_pro_short %}, plus: +* Everything in {% data variables.copilot.copilot_pro_short %}, plus: - * **Full access** to all available models in {% data variables.product.prodname_copilot_chat_short %} + * **Full access** to all available models in {% data variables.copilot.copilot_chat_short %} * Up to **1,500 premium requests** per month (additional at {% data variables.copilot.additional_premium_requests %} each) * Priority access to advanced AI capabilities @@ -54,13 +54,13 @@ The following table highlights the key differences between individual {% data va {% rowheaders %} -| Feature | {% data variables.product.prodname_copilot_free %} | {% data variables.product.prodname_copilot_pro %} | {% data variables.product.prodname_copilot_pro_plus %} | +| Feature | {% data variables.copilot.copilot_free %} | {% data variables.copilot.copilot_pro %} | {% data variables.copilot.copilot_pro_plus %} | |--------|----------------------------------------------------|--------------------------------------------------|----------------------------------------------------------| | Price | Free | {% data variables.copilot.cfi_price_per_month %} per month, or
{% data variables.copilot.cfi_price_per_year %} per year
([free](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer) for some users) | {% data variables.copilot.cpp_price_per_month %} per month, or
{% data variables.copilot.cpp_price_per_year %} per year | | Real-time code suggestions with the base model | Up to 2,000 per month | Unlimited | Unlimited | | Premium requests | 50 per month | 300 per month | 1,500 per month | | Purchase additional premium requests at {% data variables.copilot.additional_premium_requests %} per request | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_chat_short %} interactions[^1] | Up to 50 per month | Unlimited with base model | Unlimited with base model | +| {% data variables.copilot.copilot_chat_short %} interactions[^1] | Up to 50 per month | Unlimited with base model | Unlimited with base model | | Access to premium models | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} Full access | {% endrowheaders %} @@ -73,15 +73,15 @@ For a detailed comparison of features and benefits, see [AUTOTITLE](/copilot/abo Consider the following to decide which plan is right for you: -* **Just getting started?** Try {% data variables.product.prodname_copilot_free %} to explore basic functionality at no cost. -* **Coding regularly with AI?** Upgrade to {% data variables.product.prodname_copilot_pro %} for more flexibility and access to premium features. -* **Want the best performance and most model access?** Go with {% data variables.product.prodname_copilot_pro_plus %} to unlock everything {% data variables.product.prodname_copilot_short %} has to offer. +* **Just getting started?** Try {% data variables.copilot.copilot_free %} to explore basic functionality at no cost. +* **Coding regularly with AI?** Upgrade to {% data variables.copilot.copilot_pro %} for more flexibility and access to premium features. +* **Want the best performance and most model access?** Go with {% data variables.copilot.copilot_pro_plus %} to unlock everything {% data variables.product.prodname_copilot_short %} has to offer. To learn how to set up the plan that’s right for you, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-started-with-a-copilot-plan). ### Limitations for enterprises -{% data variables.product.prodname_copilot_free_short %} is not suitable for enterprises, as it does not include the following features: +{% data variables.copilot.copilot_free_short %} is not suitable for enterprises, as it does not include the following features: * Access management * Audit logs diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer.md index 142b20780b..7acbce53a0 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer.md @@ -1,7 +1,7 @@ --- title: Getting free access to Copilot Pro as a student, teacher, or maintainer shortTitle: Get free access to Copilot Pro -intro: 'Learn how to use {% data variables.product.prodname_copilot_pro_short %} for free as a student, teacher, or open-source maintainer.' +intro: 'Learn how to use {% data variables.copilot.copilot_pro_short %} for free as a student, teacher, or open-source maintainer.' versions: feature: copilot type: how_to @@ -13,25 +13,25 @@ redirect_from: - /copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-github-copilot-pro-subscription/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer --- -## About free {% data variables.product.prodname_copilot_pro %} access +## About free {% data variables.copilot.copilot_pro %} access -There are three ways to qualify for free access to {% data variables.product.prodname_copilot_pro_short %}: +There are three ways to qualify for free access to {% data variables.copilot.copilot_pro_short %}: * **As a verified student on {% data variables.product.prodname_education %}.** To learn about becoming a verified student, see [AUTOTITLE](/free-pro-team@latest/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-education-for-students/apply-to-github-education-as-a-student). * **As a verified teacher on {% data variables.product.prodname_education %}.** To learn about becoming a verified teacher, see [AUTOTITLE](/free-pro-team@latest/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-education-for-teachers/apply-to-github-education-as-a-teacher). -* **As a maintainer of a popular open-source repository.** To determine if you are an eligible maintainer, see [Accessing {% data variables.product.prodname_copilot_pro_short %} for free](#accessing-copilot-pro-for-free). +* **As a maintainer of a popular open-source repository.** To determine if you are an eligible maintainer, see [Accessing {% data variables.copilot.copilot_pro_short %} for free](#accessing-copilot-pro-for-free). {% data variables.product.company_short %} reevaluates your eligibility every month. -## What if I don't qualify for free access to {% data variables.product.prodname_copilot_pro_short %}? +## What if I don't qualify for free access to {% data variables.copilot.copilot_pro_short %}? If you do not meet the previous criteria, you can either: -* Try {% data variables.product.prodname_copilot_pro_short %} for free with a one-time 30-day trial. After the free trial, you will need a paid plan for continued use. -* Set up {% data variables.product.prodname_copilot_free_short %} to get a limited experience of {% data variables.product.prodname_copilot_short %} without a paid plan. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free). +* Try {% data variables.copilot.copilot_pro_short %} for free with a one-time 30-day trial. After the free trial, you will need a paid plan for continued use. +* Set up {% data variables.copilot.copilot_free_short %} to get a limited experience of {% data variables.product.prodname_copilot_short %} without a paid plan. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free). -## Accessing {% data variables.product.prodname_copilot_pro_short %} for free +## Accessing {% data variables.copilot.copilot_pro_short %} for free {% data reusables.copilot.your-copilot %} -1. If you qualify for free access to {% data variables.product.prodname_copilot_short %}, you will see a page titled "{% data variables.product.prodname_copilot_pro %}" informing you that you are eligible. Click **Get access to {% data variables.product.prodname_copilot %}**. +1. If you qualify for free access to {% data variables.product.prodname_copilot_short %}, you will see a page titled "{% data variables.copilot.copilot_pro %}" informing you that you are eligible. Click **Get access to {% data variables.product.prodname_copilot %}**. 1. On the page that appears, configure the {% data variables.product.prodname_copilot_short %} use policies to meet your needs, then click **Save and complete**. diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-started-with-a-copilot-plan.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-started-with-a-copilot-plan.md index 91d79d62c4..1133e2f4fe 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-started-with-a-copilot-plan.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-started-with-a-copilot-plan.md @@ -22,32 +22,32 @@ redirect_from: You can get started with your {% data variables.product.prodname_copilot_short %} plan by: -* [Accessing {% data variables.product.prodname_copilot_free_short %}](#accessing-copilot-free) -* [Upgrading from {% data variables.product.prodname_copilot_free_short %}](#upgrading-from-copilot-free) -* [Subscribing to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %}](#subscribing-to-copilot-pro-or-copilot-pro) +* [Accessing {% data variables.copilot.copilot_free_short %}](#accessing-copilot-free) +* [Upgrading from {% data variables.copilot.copilot_free_short %}](#upgrading-from-copilot-free) +* [Subscribing to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %}](#subscribing-to-copilot-pro-or-copilot-pro) -## Accessing {% data variables.product.prodname_copilot_free_short %} +## Accessing {% data variables.copilot.copilot_free_short %} -Most individual developers can start using {% data variables.product.prodname_copilot_free_short %} with no setup required. However, there are a few cases where {% data variables.product.prodname_copilot_free_short %} isn't available: +Most individual developers can start using {% data variables.copilot.copilot_free_short %} with no setup required. However, there are a few cases where {% data variables.copilot.copilot_free_short %} isn't available: * You have a {% data variables.enterprise.prodname_managed_user %}. * You are assigned a {% data variables.product.prodname_copilot_short %} seat through an organization. -* You have an existing {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan or {% data variables.product.prodname_copilot_pro_short %} trial. -* You have free access to {% data variables.product.prodname_copilot_pro_short %} as a student, teacher, or open-source maintainer. +* You have an existing {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan or {% data variables.copilot.copilot_pro_short %} trial. +* You have free access to {% data variables.copilot.copilot_pro_short %} as a student, teacher, or open-source maintainer. -There are a few ways to start using {% data variables.product.prodname_copilot_free_short %}, depending on where you're working. +There are a few ways to start using {% data variables.copilot.copilot_free_short %}, depending on where you're working. ### {% data variables.product.prodname_vs %} and {% data variables.product.prodname_vscode_shortname %} -In {% data variables.product.prodname_vs %} and {% data variables.product.prodname_vscode_shortname %} you can access {% data variables.product.prodname_copilot_free_short %} directly from the editor. +In {% data variables.product.prodname_vs %} and {% data variables.product.prodname_vscode_shortname %} you can access {% data variables.copilot.copilot_free_short %} directly from the editor. 1. In the top right of {% data variables.product.prodname_vs %} or {% data variables.product.prodname_vscode_shortname %}, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}**. -1. In the sidebar, click **Sign up for {% data variables.product.prodname_copilot_free_short %}**. +1. In the sidebar, click **Sign up for {% data variables.copilot.copilot_free_short %}**. 1. If you have a {% data variables.product.github %} account, you will be prompted to sign in. If you don't have a {% data variables.product.github %} account, you will be prompted to create one. ### {% data variables.product.prodname_dotcom_the_website %} -With {% data variables.product.prodname_copilot_free_short %}, you can ask {% data variables.product.prodname_copilot_short %} questions within a chat interface on {% data variables.product.github %}. Go to [https://github.com/copilot](https://github.com/copilot) to start chatting with {% data variables.product.prodname_copilot_short %}. +With {% data variables.copilot.copilot_free_short %}, you can ask {% data variables.product.prodname_copilot_short %} questions within a chat interface on {% data variables.product.github %}. Go to [https://github.com/copilot](https://github.com/copilot) to start chatting with {% data variables.product.prodname_copilot_short %}. ### {% data variables.product.prodname_mobile %} @@ -58,18 +58,18 @@ You can also chat with {% data variables.product.prodname_copilot_short %} in {% ### Other IDEs -To use {% data variables.product.prodname_copilot_free_short %} in other IDEs, you'll need to activate it from your {% data variables.product.github %} account settings first. +To use {% data variables.copilot.copilot_free_short %} in other IDEs, you'll need to activate it from your {% data variables.product.github %} account settings first. {% data reusables.user-settings.copilot-settings %} -1. Click **Start using {% data variables.product.prodname_copilot_free_short %}** to activate {% data variables.product.prodname_copilot_free_short %} and open immersive mode. +1. Click **Start using {% data variables.copilot.copilot_free_short %}** to activate {% data variables.copilot.copilot_free_short %} and open immersive mode. 1. To the right of "Install {% data variables.product.prodname_copilot_short %} in your favorite code editor", select the {% octicon "triangle-down" aria-label="More edit options" %} dropdown menu and click your preferred editor. -## Upgrading from {% data variables.product.prodname_copilot_free_short %} +## Upgrading from {% data variables.copilot.copilot_free_short %} -If you’re already using {% data variables.product.prodname_copilot_free_short %} and reach your usage limit, you’ll be prompted to upgrade directly. The upgrade experience varies by where you’re using {% data variables.product.prodname_copilot_short %}: +If you’re already using {% data variables.copilot.copilot_free_short %} and reach your usage limit, you’ll be prompted to upgrade directly. The upgrade experience varies by where you’re using {% data variables.product.prodname_copilot_short %}: * **In {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode_shortname %}, or {% data variables.product.prodname_dotcom_the_website %}**: - You’ll receive a message with your reset date and a link to upgrade to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %}. + You’ll receive a message with your reset date and a link to upgrade to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %}. * **In other IDEs**: You’ll see an error message. You can start a trial or paid plan from your [{% data variables.product.prodname_copilot %} settings](https://github.com/settings/copilot). @@ -77,18 +77,18 @@ If you’re already using {% data variables.product.prodname_copilot_free_short * **In {% data variables.product.prodname_mobile %}**: When you hit the usage limit, you’ll be prompted to upgrade via in-app purchase. -## Subscribing to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} +## Subscribing to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} -You can subscribe to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} at any time to unlock advanced AI features, higher usage limits, and access to additional models. +You can subscribe to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} at any time to unlock advanced AI features, higher usage limits, and access to additional models. > [!TIP] Not sure which plan to choose? For a side-by-side comparison, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/about-individual-copilot-plans-and-benefits). 1. Go to the [plans page](https://github.com/features/copilot/plans). 1. Click **Get started** under the plan you want to subscribe to. -1. Choose whether you want to pay monthly or yearly, and click **Subscribe to {% data variables.product.prodname_copilot_pro_short %}/{% data variables.product.prodname_copilot_pro_plus_short %}**. +1. Choose whether you want to pay monthly or yearly, and click **Subscribe to {% data variables.copilot.copilot_pro_short %}/{% data variables.copilot.copilot_pro_plus_short %}**. If your personal account meets the criteria for a free {% data variables.product.prodname_copilot %} plan instead of a trial or paid plan, you will automatically be taken to step 6. 1. To enable usage beyond your included premium request allowance, select **Yes, I want to enable additional usage for {% data variables.product.prodname_copilot_short %} premium requests**. You can change this setting at any time. Click **Save & continue**. 1. Follow the steps to enter and confirm your billing information and payment details, then click **Submit**. -1. After reviewing your plan details, click **Activate {% data variables.product.prodname_copilot_pro_short %}/{% data variables.product.prodname_copilot_pro_plus_short %}**. +1. After reviewing your plan details, click **Activate {% data variables.copilot.copilot_pro_short %}/{% data variables.copilot.copilot_pro_plus_short %}**. diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/index.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/index.md index e8627b4033..d66bdceea3 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/index.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/index.md @@ -1,7 +1,7 @@ --- title: Managing Copilot as an individual subscriber shortTitle: Manage for individual -intro: 'Individual users can subscribe to {% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_pro_plus_short %}, or {% data variables.product.prodname_copilot_free_short %} for personal use.' +intro: 'Individual users can subscribe to {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, or {% data variables.copilot.copilot_free_short %} for personal use.' versions: feature: copilot topics: diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/disabling-github-copilot-free.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/disabling-github-copilot-free.md index 65f20e3f67..32c473cba5 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/disabling-github-copilot-free.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/disabling-github-copilot-free.md @@ -1,7 +1,7 @@ --- title: Disabling GitHub Copilot Free shortTitle: Disable Copilot Free -intro: 'Learn how to disable {% data variables.product.prodname_copilot_free_short %} in your IDE or {% data variables.product.prodname_dotcom_the_website %}.' +intro: 'Learn how to disable {% data variables.copilot.copilot_free_short %} in your IDE or {% data variables.product.prodname_dotcom_the_website %}.' versions: feature: copilot type: how_to @@ -11,20 +11,20 @@ redirect_from: - /copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-free/disabling-github-copilot-free --- -{% data variables.product.prodname_copilot_free_short %} is automatically disabled when you have a {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan, or when you are granted a license through an organization or enterprise. If you want to disable {% data variables.product.prodname_copilot_free_short %} without subscribing to a paid plan, you can do so in your IDE and in {% data variables.product.prodname_dotcom_the_website %}. +{% data variables.copilot.copilot_free_short %} is automatically disabled when you have a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, or when you are granted a license through an organization or enterprise. If you want to disable {% data variables.copilot.copilot_free_short %} without subscribing to a paid plan, you can do so in your IDE and in {% data variables.product.prodname_dotcom_the_website %}. -## Disabling {% data variables.product.prodname_copilot_free_short %} in {% data variables.product.github %} +## Disabling {% data variables.copilot.copilot_free_short %} in {% data variables.product.github %} -You can disable {% data variables.product.prodname_copilot_free_short %} in your {% data variables.product.github %} account settings. This will disable all features of {% data variables.product.prodname_copilot_short %} on {% data variables.product.github %}. +You can disable {% data variables.copilot.copilot_free_short %} in your {% data variables.product.github %} account settings. This will disable all features of {% data variables.product.prodname_copilot_short %} on {% data variables.product.github %}. {% data reusables.copilot.your-copilot %} 1. Under "Visibility," to the right of "Show {% data variables.product.prodname_copilot_short %}, select **Disabled** from the dropdown. -## Disabling {% data variables.product.prodname_copilot_free_short %} in your IDE +## Disabling {% data variables.copilot.copilot_free_short %} in your IDE -You can partially or fully disable {% data variables.product.prodname_copilot_free_short %} in JetBrains IDEs, {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_vs %}, and XCode: +You can partially or fully disable {% data variables.copilot.copilot_free_short %} in JetBrains IDEs, {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_vs %}, and XCode: 1. Navigate to [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment). 1. At the top of the page, select your IDE. 1. At the top right of the page, under "In this article," select **Enabling or disabling {% data variables.product.prodname_copilot_short %}**. -1. Follow the instructions to disable {% data variables.product.prodname_copilot_free_short %} in your IDE. +1. Follow the instructions to disable {% data variables.copilot.copilot_free_short %} in your IDE. diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/extending-the-capabilities-of-github-copilot-in-your-personal-account.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/extending-the-capabilities-of-github-copilot-in-your-personal-account.md index 5817ea4186..e8b6484f34 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/extending-the-capabilities-of-github-copilot-in-your-personal-account.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/extending-the-capabilities-of-github-copilot-in-your-personal-account.md @@ -13,24 +13,24 @@ redirect_from: - /copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/extending-the-capabilities-of-github-copilot-in-your-personal-account --- -## About {% data variables.product.prodname_copilot_extensions %} for your personal account +## About {% data variables.copilot.copilot_extensions %} for your personal account {% data reusables.copilot.copilot-extensions.copilot-extensions-on-marketplace %} -Anyone can install {% data variables.product.prodname_copilot_extensions_short %} for their personal account, but you must set up {% data variables.product.prodname_copilot_free_short %}, or have an active {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan, to use a {% data variables.product.prodname_copilot_extension_short %} you install. +Anyone can install {% data variables.copilot.copilot_extensions_short %} for their personal account, but you must set up {% data variables.copilot.copilot_free_short %}, or have an active {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, to use a {% data variables.copilot.copilot_extension_short %} you install. -> [!NOTE] If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, {% data variables.product.prodname_copilot_extensions_short %} are installed by organization owners at the organization level, and you do not need to install the extension on your personal account. To start using {% data variables.product.prodname_copilot_extensions_short %} installed in your organization, see [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). +> [!NOTE] If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, {% data variables.copilot.copilot_extensions_short %} are installed by organization owners at the organization level, and you do not need to install the extension on your personal account. To start using {% data variables.copilot.copilot_extensions_short %} installed in your organization, see [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). -You can also create your own custom {% data variables.product.prodname_copilot_extensions_short %} for your personal account. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). +You can also create your own custom {% data variables.copilot.copilot_extensions_short %} for your personal account. For more information, see [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). -## Installing {% data variables.product.prodname_copilot_extensions %} for your personal account +## Installing {% data variables.copilot.copilot_extensions %} for your personal account 1. Open [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true). 1. In the left sidebar, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**. -1. In the list of {% data variables.product.prodname_copilot_extensions_short %}, locate an app you'd like to install. -1. To install the {% data variables.product.prodname_copilot_extension_short %} on your personal account, see [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account#installing-a-github-app-in-your-personal-account). +1. In the list of {% data variables.copilot.copilot_extensions_short %}, locate an app you'd like to install. +1. To install the {% data variables.copilot.copilot_extension_short %} on your personal account, see [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account#installing-a-github-app-in-your-personal-account). {% data reusables.copilot.copilot-extensions.extension-specific-onboarding-steps %} ## Next steps -After installing a {% data variables.product.prodname_copilot_extension_short %}, you can start using the extension in {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). +After installing a {% data variables.copilot.copilot_extension_short %}, you can start using the extension in {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions). diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber.md index db1a92a640..74662cac7e 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber.md @@ -2,7 +2,7 @@ title: Managing Copilot policies as an individual subscriber shortTitle: Manage policies intro: 'Find out how to change your personal settings on {% data variables.product.github %} to configure {% data variables.product.prodname_copilot %}''s behavior.' -product: '{% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_pro_plus_short %}, and {% data variables.product.prodname_copilot_free_short %}' +product: '{% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, and {% data variables.copilot.copilot_free_short %}' topics: - Copilot versions: @@ -32,7 +32,7 @@ If you choose to allow suggestions matching public code, when {% data variables. ## Enabling or disabling {% data variables.copilot.copilot_coding_agent %} -{% data variables.copilot.copilot_coding_agent %} allows you to assign {% data variables.product.prodname_copilot_short %} to {% data variables.product.github %} issues, or ask {% data variables.product.prodname_copilot_short %} to raise a pull request from a prompt in {% data variables.product.prodname_copilot_chat_short %}. +{% data variables.copilot.copilot_coding_agent %} allows you to assign {% data variables.product.prodname_copilot_short %} to {% data variables.product.github %} issues, or ask {% data variables.product.prodname_copilot_short %} to raise a pull request from a prompt in {% data variables.copilot.copilot_chat_short %}. > [!NOTE] > * {% data reusables.gated-features.copilot-coding-agent %} @@ -66,9 +66,9 @@ You can choose whether to allow the following AI models to be used as an alterna {% data reusables.user-settings.copilot-settings %} 1. To the right of the model name, select the dropdown menu, then click **Enabled** or **Disabled**. -## Enabling or disabling web search for {% data variables.product.prodname_copilot_chat %} +## Enabling or disabling web search for {% data variables.copilot.copilot_chat %} -You can enable web search for {% data variables.product.prodname_copilot_chat %}. This setting is disabled by default. If you enable this setting, {% data variables.product.prodname_copilot_chat_short %} will use Bing to search the internet for information related to a question. Bing search is particularly helpful when discussing new technologies or highly specific subjects. +You can enable web search for {% data variables.copilot.copilot_chat %}. This setting is disabled by default. If you enable this setting, {% data variables.copilot.copilot_chat_short %} will use Bing to search the internet for information related to a question. Bing search is particularly helpful when discussing new technologies or highly specific subjects. {% data reusables.user-settings.copilot-settings %} 1. To the right of **{% data variables.product.prodname_copilot_short %} access to Bing**, select the dropdown menu, and then click **Enabled** or **Disabled**. diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/viewing-and-changing-your-copilot-plan.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/viewing-and-changing-your-copilot-plan.md index 47aa212bc6..7a32e32993 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/viewing-and-changing-your-copilot-plan.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/viewing-and-changing-your-copilot-plan.md @@ -44,29 +44,29 @@ You can upgrade or downgrade your {% data variables.product.prodname_copilot_sho 1. In the "{% data variables.product.prodname_copilot %}" section, click the option to upgrade on the right. - * If you're on {% data variables.product.prodname_copilot_free_short %}, click **Upgrade {% data variables.product.prodname_copilot_short %}** to choose a paid plan. - * If you're on {% data variables.product.prodname_copilot_pro_short %}, click **Upgrade to {% data variables.product.prodname_copilot_pro_plus_short %}**. + * If you're on {% data variables.copilot.copilot_free_short %}, click **Upgrade {% data variables.product.prodname_copilot_short %}** to choose a paid plan. + * If you're on {% data variables.copilot.copilot_pro_short %}, click **Upgrade to {% data variables.copilot.copilot_pro_plus_short %}**. 1. Follow the prompts to confirm your selection and billing details. -### Downgrading your {% data variables.product.prodname_copilot_pro_plus_short %} plan +### Downgrading your {% data variables.copilot.copilot_pro_plus_short %} plan {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing-plans-two-platforms %} -1. In the "{% data variables.product.prodname_copilot %}" section, select the **Manage subscription** dropdown on the right and then click **Downgrade to {% data variables.product.prodname_copilot_pro_short %}**. +1. In the "{% data variables.product.prodname_copilot %}" section, select the **Manage subscription** dropdown on the right and then click **Downgrade to {% data variables.copilot.copilot_pro_short %}**. 1. In the downgrade modal, you'll see options to: - * **Keep {% data variables.product.prodname_copilot_pro_plus_short %}**, which cancels the downgrade process. - * **Downgrade to {% data variables.product.prodname_copilot_pro_short %}**, which switches you to {% data variables.product.prodname_copilot_pro_short %} at the start of your next billing cycle. + * **Keep {% data variables.copilot.copilot_pro_plus_short %}**, which cancels the downgrade process. + * **Downgrade to {% data variables.copilot.copilot_pro_short %}**, which switches you to {% data variables.copilot.copilot_pro_short %} at the start of your next billing cycle. - Select **Downgrade to {% data variables.product.prodname_copilot_pro_short %}** to confirm. + Select **Downgrade to {% data variables.copilot.copilot_pro_short %}** to confirm. ## Canceling your {% data variables.product.prodname_copilot_short %} plan -You can cancel your {% data variables.product.prodname_copilot_short %} plan or trial at any time. You’ll retain access to your current features until your billing cycle ends. You will automatically be downgraded to {% data variables.product.prodname_copilot_free_short %} at the end of your billing cycle. +You can cancel your {% data variables.product.prodname_copilot_short %} plan or trial at any time. You’ll retain access to your current features until your billing cycle ends. You will automatically be downgraded to {% data variables.copilot.copilot_free_short %} at the end of your billing cycle. -If you have been granted a free access to {% data variables.product.prodname_copilot_pro_short %} as a verified student, teacher, or maintainer of a popular open source project, you won’t be able to cancel your plan. If you have access to {% data variables.product.prodname_copilot_short %} through an organization{% ifversion ghec %} or enterprise{% endif %}, you will not be able to cancel your plan. In these cases, you can disable {% data variables.product.prodname_copilot_short %} in your environment. See [AUTOTITLE](/copilot/configuring-github-copilot/configuring-github-copilot-in-your-environment). +If you have been granted a free access to {% data variables.copilot.copilot_pro_short %} as a verified student, teacher, or maintainer of a popular open source project, you won’t be able to cancel your plan. If you have access to {% data variables.product.prodname_copilot_short %} through an organization{% ifversion ghec %} or enterprise{% endif %}, you will not be able to cancel your plan. In these cases, you can disable {% data variables.product.prodname_copilot_short %} in your environment. See [AUTOTITLE](/copilot/configuring-github-copilot/configuring-github-copilot-in-your-environment). {% data reusables.copilot.copilot-one-account-short %} @@ -74,11 +74,11 @@ If you have been granted a free access to {% data variables.product.prodname_cop {% data reusables.user-settings.billing-plans-two-platforms %} 1. In the "{% data variables.product.prodname_copilot %}" section, select the **Manage subscription** dropdown on the right and then click **Cancel subscription**. -1. Select **Cancel {% data variables.product.prodname_copilot_pro_plus_short %}/{% data variables.product.prodname_copilot_pro_short %}** to cancel your plan at the end of your current billing cycle. +1. Select **Cancel {% data variables.copilot.copilot_pro_plus_short %}/{% data variables.copilot.copilot_pro_short %}** to cancel your plan at the end of your current billing cycle. -## Canceling your {% data variables.product.prodname_copilot_pro_short %} trial +## Canceling your {% data variables.copilot.copilot_pro_short %} trial -You can cancel your {% data variables.product.prodname_copilot_pro_short %} trial at any time during your trial period. If you cancel during your {% data reusables.copilot.trial-period %}-day trial, you won't be charged. Your cancellation will take effect at the end of your trial period. If you do not cancel your trial, you will be automatically enrolled in a paid plan at the end of your trial period, according to the billing preferences you set up when you started your trial. +You can cancel your {% data variables.copilot.copilot_pro_short %} trial at any time during your trial period. If you cancel during your {% data reusables.copilot.trial-period %}-day trial, you won't be charged. Your cancellation will take effect at the end of your trial period. If you do not cancel your trial, you will be automatically enrolled in a paid plan at the end of your trial period, according to the billing preferences you set up when you started your trial. {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.billing-plans-two-platforms %} diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/disabling-copilot-for-organizations-in-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/disabling-copilot-for-organizations-in-your-enterprise.md index 319bd4ea35..925cff7320 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/disabling-copilot-for-organizations-in-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/disabling-copilot-for-organizations-in-your-enterprise.md @@ -3,7 +3,7 @@ title: Disabling Copilot for organizations in your enterprise shortTitle: Disable for organizations intro: 'Disable {% data variables.product.prodname_copilot %} for some or all of the organizations in your enterprise.' permissions: Enterprise owners -product: 'Enterprises with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Enterprises with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan' versions: feature: copilot-enterprise topics: @@ -23,8 +23,8 @@ redirect_from: 1. Under "Access management", locate the organization for which you want to disable {% data variables.product.prodname_copilot_short %}. 1. To the right of the organization name, select the **Copilot** dropdown menu. - * If your enterprise has a {% data variables.product.prodname_copilot_business_short %} plan, click **Disabled**. - * If your enterprise has a {% data variables.product.prodname_copilot_enterprise_short %} plan, click **Remove access**. + * If your enterprise has a {% data variables.copilot.copilot_business_short %} plan, click **Disabled**. + * If your enterprise has a {% data variables.copilot.copilot_enterprise_short %} plan, click **Remove access**. ## Further reading diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise.md index 491e2da620..fef9504b20 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise.md @@ -3,7 +3,7 @@ title: Enabling Copilot for organizations in your enterprise shortTitle: Enable for organizations intro: 'Enable {% data variables.product.prodname_copilot %} for some or all of the organizations in your enterprise.' permissions: Enterprise owners -product: 'Enterprises with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Enterprises with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan' versions: feature: copilot-enterprise topics: @@ -12,9 +12,9 @@ redirect_from: - /copilot/managing-copilot/managing-copilot-for-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise --- -Owners of enterprises that have a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan can enable {% data variables.product.prodname_copilot %} for all, none, or some organizations within the enterprise. +Owners of enterprises that have a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan can enable {% data variables.product.prodname_copilot %} for all, none, or some organizations within the enterprise. -For enterprises with a {% data variables.product.prodname_copilot_enterprise_short %} plan, enterprise owners can choose to assign either {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} to individual organizations in the enterprise. +For enterprises with a {% data variables.copilot.copilot_enterprise_short %} plan, enterprise owners can choose to assign either {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} to individual organizations in the enterprise. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} @@ -26,8 +26,8 @@ For enterprises with a {% data variables.product.prodname_copilot_enterprise_sho 1. If you selected **Allow for specific organizations**: 1. Under "Access management", locate the organization for which you want to enable {% data variables.product.prodname_copilot_short %}. 1. To the right of the organization name, select the **Copilot** dropdown menu. - * If your enterprise has a {% data variables.product.prodname_copilot_business_short %} plan, click **Enabled**. - * If your enterprise has a {% data variables.product.prodname_copilot_enterprise_short %} plan, click either **Copilot: Enterprise** or **Copilot: Business** to assign a specific Copilot plan to the organization. + * If your enterprise has a {% data variables.copilot.copilot_business_short %} plan, click **Enabled**. + * If your enterprise has a {% data variables.copilot.copilot_enterprise_short %} plan, click either **Copilot: Enterprise** or **Copilot: Business** to assign a specific Copilot plan to the organization. ## Next steps diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/managing-github-copilot-access-to-your-enterprises-network.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/managing-github-copilot-access-to-your-enterprises-network.md index 1a1f7dbce4..1a3032b1e1 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/managing-github-copilot-access-to-your-enterprises-network.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/managing-github-copilot-access-to-your-enterprises-network.md @@ -2,7 +2,7 @@ title: Managing GitHub Copilot access to your enterprise's network intro: 'Learn how to use subscription-based network routing to control {% data variables.product.prodname_copilot_short %} access to your network.' permissions: Enterprise owners -product: '{% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %}' +product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}' versions: feature: copilot-enterprise topics: diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/viewing-copilot-license-usage-in-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/viewing-copilot-license-usage-in-your-enterprise.md index 50b19d92a1..cf501abc26 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/viewing-copilot-license-usage-in-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/viewing-copilot-license-usage-in-your-enterprise.md @@ -2,7 +2,7 @@ title: Viewing Copilot license usage in your enterprise shortTitle: View license usage intro: 'View how many users have access to {% data variables.product.prodname_copilot %} across {% ifversion fpt %}your organization{% else %} all the organizations in your enterprise{% endif %}.' -product: 'Enterprises with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Enterprises with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan' permissions: Enterprise owners versions: feature: copilot-enterprise @@ -17,7 +17,7 @@ redirect_from: ## About your {% data variables.product.prodname_copilot %} usage -If you have a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, you can view usage information for {% data variables.product.prodname_copilot_short %} in your {% ifversion ghec %}enterprise, broken down by organization, or in your{% endif %} organization, broken down by seat assignment status. {% ifversion ghec %}At the enterprise level, this information includes the number of seats assigned in each organization, and the total spending associated with each organization, for the current billing cycle.{% endif %} At the organization level, this information includes the total number of seats, seats carried over from the previous billing cycle, new seats added during the current cycle, and seats to be removed at the end of the current cycle. +If you have a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, you can view usage information for {% data variables.product.prodname_copilot_short %} in your {% ifversion ghec %}enterprise, broken down by organization, or in your{% endif %} organization, broken down by seat assignment status. {% ifversion ghec %}At the enterprise level, this information includes the number of seats assigned in each organization, and the total spending associated with each organization, for the current billing cycle.{% endif %} At the organization level, this information includes the total number of seats, seats carried over from the previous billing cycle, new seats added during the current cycle, and seats to be removed at the end of the current cycle. {% ifversion ghec %} diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md index 278aea2216..e7c18f3756 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md @@ -2,7 +2,7 @@ title: Managing policies and features for Copilot in your enterprise intro: 'Enterprise owners can control the availability of {% data variables.product.prodname_copilot %} and its features for all organizations in the enterprise.' permissions: Enterprise owners -product: '{% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %}' +product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}' versions: feature: copilot-enterprise topics: @@ -27,12 +27,12 @@ You can configure policies for your enterprise. If no policy is chosen at the en | Policy Name | Enforced policy for multiple organizations | | ----------- | ------------------------------------------ | | [{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}](#copilot-in-githubcom) | least restrictive | -| [{% data variables.product.prodname_copilot_cli %}](#github-copilot-in-the-cli) | least restrictive | -| [{% data variables.product.prodname_copilot_desktop_short %} ({% data variables.release-phases.public_preview %})](#copilot-in-github-desktop-public-preview) | least restrictive | -| [{% data variables.product.prodname_copilot_chat %} in the IDE](#github-copilot-chat-in-the-ide) | least restrictive | +| [{% data variables.copilot.copilot_cli %}](#github-copilot-in-the-cli) | least restrictive | +| [{% data variables.copilot.copilot_desktop_short %} ({% data variables.release-phases.public_preview %})](#copilot-in-github-desktop-public-preview) | least restrictive | +| [{% data variables.copilot.copilot_chat %} in the IDE](#github-copilot-chat-in-the-ide) | least restrictive | | [Editor preview features](#editor-preview-features) | least restrictive | -| [{% data variables.product.prodname_copilot_mobile %}](#github-copilot-chat-in-github-mobile) | least restrictive | -| [{% data variables.product.prodname_copilot_extensions %}](#github-copilot-extensions) | least restrictive | +| [{% data variables.copilot.copilot_mobile %}](#github-copilot-chat-in-github-mobile) | least restrictive | +| [{% data variables.copilot.copilot_extensions %}](#github-copilot-extensions) | least restrictive | | [Suggestions matching public code](#suggestions-matching-public-code) | most restrictive | | [Give {% data variables.product.prodname_copilot_short %} access to Bing](#give-copilot-access-to-bing) | least restrictive | | [{% data variables.product.prodname_copilot_short %} access to alternative AI models](#copilot-access-to-alternative-ai-models) | least restrictive | @@ -42,24 +42,24 @@ You can configure policies for your enterprise. If no policy is chosen at the en ### {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} -With a {% data variables.product.prodname_copilot_enterprise_short %} license, you can enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" to provide members of your enterprise access to AI features on the {% data variables.product.github %} website, including: -* **{% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_dotcom_the_website %}** - You can ask {% data variables.product.prodname_copilot %} coding-related questions within a chat interface on {% data variables.product.github %}. You can ask general questions or questions within a specific context such as a repository, issue, file, or symbol. +With a {% data variables.copilot.copilot_enterprise_short %} license, you can enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" to provide members of your enterprise access to AI features on the {% data variables.product.github %} website, including: +* **{% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_dotcom_the_website %}** - You can ask {% data variables.product.prodname_copilot %} coding-related questions within a chat interface on {% data variables.product.github %}. You can ask general questions or questions within a specific context such as a repository, issue, file, or symbol. * **{% data variables.product.prodname_copilot_short %} pull request summaries** - {% data variables.product.prodname_copilot_short %} can generate a summary of the changes made in a pull request, as well as a list of impacted files, using natural language. This overview helps reviewers quickly understand the proposed changes. -* **{% data variables.product.prodname_copilot_short %} knowledge bases** - Organization owners can create knowledge bases consisting of Markdown documentation across one or more repositories, allowing organization members to use that documentation as context when they ask questions in {% data variables.product.prodname_copilot_chat_dotcom_short %}, {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, and {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}. +* **{% data variables.product.prodname_copilot_short %} knowledge bases** - Organization owners can create knowledge bases consisting of Markdown documentation across one or more repositories, allowing organization members to use that documentation as context when they ask questions in {% data variables.copilot.copilot_chat_dotcom_short %}, {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, and {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vs %}. If you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}", you can also configure additional features: {% data reusables.copilot.policies-for-dotcom %} -### {% data variables.product.prodname_copilot_cli %} +### {% data variables.copilot.copilot_cli %} -{% data variables.product.prodname_copilot_cli %} is an extension for {% data variables.product.prodname_cli %} which provides a chat-like interface in the terminal. You can ask {% data variables.product.prodname_copilot %} for command suggestions, or for explanations of commands they run. +{% data variables.copilot.copilot_cli %} is an extension for {% data variables.product.prodname_cli %} which provides a chat-like interface in the terminal. You can ask {% data variables.product.prodname_copilot %} for command suggestions, or for explanations of commands they run. -### {% data variables.product.prodname_copilot_desktop_short %} ({% data variables.release-phases.public_preview %}) +### {% data variables.copilot.copilot_desktop_short %} ({% data variables.release-phases.public_preview %}) You can generate commit messages and descriptions in {% data variables.product.prodname_desktop %} based on the changes you make to your project. -### {% data variables.product.prodname_copilot_chat %} in the IDE +### {% data variables.copilot.copilot_chat %} in the IDE You can chat with {% data variables.product.prodname_copilot %} in your IDE to get code suggestions and answers to coding-related questions without context switching. @@ -67,13 +67,13 @@ You can chat with {% data variables.product.prodname_copilot %} in your IDE to g Some features of {% data variables.product.prodname_copilot_short %} are available as preview features in your editor. You can enable or disable these features for your enterprise. -### {% data variables.product.prodname_copilot_mobile %} +### {% data variables.copilot.copilot_mobile %} -{% data variables.product.prodname_copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %} to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. +{% data variables.copilot.copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %} to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. -### {% data variables.product.prodname_copilot_extensions %} +### {% data variables.copilot.copilot_extensions %} -{% data variables.product.prodname_copilot_extensions %} integrate external tools with {% data variables.product.prodname_copilot_chat %}, helping members of your enterprise reduce context switching, interact with tools using natural language, and customize their {% data variables.product.prodname_copilot_chat_short %} experience. +{% data variables.copilot.copilot_extensions %} integrate external tools with {% data variables.copilot.copilot_chat %}, helping members of your enterprise reduce context switching, interact with tools using natural language, and customize their {% data variables.copilot.copilot_chat_short %} experience. ### Suggestions matching public code @@ -81,13 +81,13 @@ Some features of {% data variables.product.prodname_copilot_short %} are availab ### Give {% data variables.product.prodname_copilot_short %} access to Bing -{% data variables.product.prodname_copilot_chat %} can use Bing to provide enhanced responses by searching the internet for information related to a question. Bing search is particularly helpful when discussing new technologies or highly specific subjects. +{% data variables.copilot.copilot_chat %} can use Bing to provide enhanced responses by searching the internet for information related to a question. Bing search is particularly helpful when discussing new technologies or highly specific subjects. ### {% data variables.product.prodname_copilot_short %} access to alternative AI models -> [!NOTE] Support for GPT-4.5 is only available on {% data variables.product.prodname_copilot_enterprise_short %}. +> [!NOTE] Support for GPT-4.5 is only available on {% data variables.copilot.copilot_enterprise_short %}. -By default, {% data variables.product.prodname_copilot_chat_short %} uses a base model. If you grant access to the alternative models, members of your enterprise can choose to use these models rather than the base model. The available alternative models are: +By default, {% data variables.copilot.copilot_chat_short %} uses a base model. If you grant access to the alternative models, members of your enterprise can choose to use these models rather than the base model. The available alternative models are: * **{% data variables.copilot.copilot_claude %}**. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/using-claude-in-github-copilot). * **{% data variables.copilot.copilot_gemini %}**. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/using-gemini-in-github-copilot). @@ -106,7 +106,7 @@ Enable this policy to allow users to use the {% data variables.product.prodname_ {% data variables.copilot.copilot_coding_agent %} is an autonomous, AI-powered software development agent. During the preview, use of the feature is subject to [GitHub Pre-release License Terms](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms). This feature may use models which are not enabled on your "Models" settings page. The cost of a premium request made by {% data variables.copilot.copilot_coding_agent %} is independent of the model it uses. -With a **{% data variables.product.prodname_copilot_enterprise_short %} license**, you can enable "{% data variables.copilot.copilot_coding_agent %}" to allow members of your enterprise to use {% data variables.copilot.copilot_coding_agent %} under the Copilot license you have assigned them. This will allow them to assign work or issues to {% data variables.product.prodname_copilot_short %} in organization repositories where {% data variables.copilot.copilot_coding_agent %} is available and to enable {% data variables.copilot.copilot_coding_agent %} for their personal repositories. +With a **{% data variables.copilot.copilot_enterprise_short %} license**, you can enable "{% data variables.copilot.copilot_coding_agent %}" to allow members of your enterprise to use {% data variables.copilot.copilot_coding_agent %} under the Copilot license you have assigned them. This will allow them to assign work or issues to {% data variables.product.prodname_copilot_short %} in organization repositories where {% data variables.copilot.copilot_coding_agent %} is available and to enable {% data variables.copilot.copilot_coding_agent %} for their personal repositories. Alternatively, set to "No policy" to leave organization owners to make the decision in their organization settings. diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise.md index 84a32f14df..77936b9f18 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise.md @@ -3,7 +3,7 @@ title: About billing for GitHub Copilot in your enterprise shortTitle: About billing intro: 'Learn about pricing and billing cycles for {% data variables.product.prodname_copilot_short %} in your enterprise.' permissions: 'Enterprise owners' -product: '{% data variables.product.prodname_copilot_for_business %} and {% data variables.product.prodname_copilot_enterprise %}' +product: '{% data variables.copilot.copilot_for_business %} and {% data variables.copilot.copilot_enterprise %}' versions: feature: copilot type: overview @@ -16,10 +16,10 @@ redirect_from: ## About {% data variables.product.prodname_copilot_short %} plans for your enterprise {% data variables.product.company_short %} offers the following plans for enterprise accounts: -* **{% data variables.product.prodname_copilot_business_short %}** at {% data variables.copilot.cfb_price_per_month %} per user per month -* **{% data variables.product.prodname_copilot_enterprise_short %}** at {% data variables.copilot.ce_price_per_month %} per user per month +* **{% data variables.copilot.copilot_business_short %}** at {% data variables.copilot.cfb_price_per_month %} per user per month +* **{% data variables.copilot.copilot_enterprise_short %}** at {% data variables.copilot.ce_price_per_month %} per user per month -When you subscribe to {% data variables.product.prodname_copilot_enterprise_short %} at the enterprise level, you can choose which plan to enable for each organization in your enterprise. +When you subscribe to {% data variables.copilot.copilot_enterprise_short %} at the enterprise level, you can choose which plan to enable for each organization in your enterprise. For guidance, see [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/choosing-your-enterprises-plan-for-github-copilot). @@ -42,7 +42,7 @@ Your enterprise will be charged on whichever payment method you’ve set up for ### About seat assignment for {% data variables.product.prodname_copilot_short %} in your enterprise -A {% data variables.product.prodname_copilot %} seat is a license to use {% data variables.product.prodname_copilot %}, which is granted to a unique user account through an enterprise's {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} plan. Each month, the enterprise is charged for the number of assigned seats. +A {% data variables.product.prodname_copilot %} seat is a license to use {% data variables.product.prodname_copilot %}, which is granted to a unique user account through an enterprise's {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} plan. Each month, the enterprise is charged for the number of assigned seats. If a single user receives a seat from multiple organizations in the same enterprise, the enterprise will only be billed once per billing cycle for that unique user. One of the organizations that assigned {% data variables.product.prodname_copilot_short %} to the user will be chosen at random each month to be billed for the seat. @@ -58,9 +58,9 @@ When you connect an Azure subscription to your organization or enterprise accoun ## About changes to your {% data variables.product.prodname_copilot_short %} plan -If you upgrade an organization from {% data variables.product.prodname_copilot_business_short %} to {% data variables.product.prodname_copilot_enterprise_short %}, all users who currently have a seat for {% data variables.product.prodname_copilot_business_short %} will immediately receive access to {% data variables.product.prodname_copilot_enterprise_short %}. You will be charged for each {% data variables.product.prodname_copilot_enterprise %} seat pro rata for the rest of the cycle. +If you upgrade an organization from {% data variables.copilot.copilot_business_short %} to {% data variables.copilot.copilot_enterprise_short %}, all users who currently have a seat for {% data variables.copilot.copilot_business_short %} will immediately receive access to {% data variables.copilot.copilot_enterprise_short %}. You will be charged for each {% data variables.copilot.copilot_enterprise %} seat pro rata for the rest of the cycle. -If you downgrade an organization's {% data variables.product.prodname_copilot_enterprise %} plan during a billing cycle, the users will have access to {% data variables.product.prodname_copilot_enterprise %} for the rest of the cycle, and the change to your bill will take effect from the following cycle. +If you downgrade an organization's {% data variables.copilot.copilot_enterprise %} plan during a billing cycle, the users will have access to {% data variables.copilot.copilot_enterprise %} for the rest of the cycle, and the change to your bill will take effect from the following cycle. Disabling {% data variables.product.prodname_copilot %} for all organizations in your enterprise will cancel your enterprise's {% data variables.product.prodname_copilot_short %} plan. diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/canceling-copilot-for-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/canceling-copilot-for-your-enterprise.md index 61663f2a55..6d6801b53c 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/canceling-copilot-for-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/canceling-copilot-for-your-enterprise.md @@ -3,7 +3,7 @@ title: Canceling Copilot for your enterprise shortTitle: Cancel plan intro: 'Disabling {% data variables.product.prodname_copilot %} for all organizations in your enterprise will cancel your enterprise''s {% data variables.product.prodname_copilot_short %} plan.' permissions: Enterprise admins -product: '{% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %}' +product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}' versions: feature: copilot-enterprise topics: diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/downgrading-copilot-for-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/downgrading-copilot-for-your-enterprise.md index 8faf2cac7c..f0c564a204 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/downgrading-copilot-for-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/downgrading-copilot-for-your-enterprise.md @@ -1,9 +1,9 @@ --- title: Downgrading Copilot for your enterprise shortTitle: Downgrade subscription -intro: 'You can downgrade organizations in your enterprise from {% data variables.product.prodname_copilot_enterprise_short %} to {% data variables.product.prodname_copilot_business_short %}.' +intro: 'You can downgrade organizations in your enterprise from {% data variables.copilot.copilot_enterprise_short %} to {% data variables.copilot.copilot_business_short %}.' permissions: Enterprise owners -product: 'Enterprises with a {% data variables.product.prodname_copilot_enterprise_short %} plan' +product: 'Enterprises with a {% data variables.copilot.copilot_enterprise_short %} plan' versions: feature: copilot-enterprise topics: diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/subscribing-to-copilot-for-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/subscribing-to-copilot-for-your-enterprise.md index ee1893bd31..5e102151b2 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/subscribing-to-copilot-for-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/subscribing-to-copilot-for-your-enterprise.md @@ -1,7 +1,7 @@ --- title: Subscribing to Copilot for your enterprise shortTitle: Subscribe -intro: 'Enterprise owners can set up a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan for their enterprise.' +intro: 'Enterprise owners can set up a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan for their enterprise.' permissions: Enterprise owners product: 'Enterprises on {% data variables.product.prodname_ghe_cloud %}' versions: @@ -17,12 +17,12 @@ redirect_from: >[!NOTE] > {% data reusables.copilot.signup-procedure-enterprise-msft-ea %} > -> If you do not yet have a {% data variables.product.prodname_ghe_cloud %} account, you can start a free 30-day trial, which includes {% data variables.product.prodname_copilot_for_business %}. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/overview/setting-up-a-trial-of-github-enterprise-cloud). +> If you do not yet have a {% data variables.product.prodname_ghe_cloud %} account, you can start a free 30-day trial, which includes {% data variables.copilot.copilot_for_business %}. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/overview/setting-up-a-trial-of-github-enterprise-cloud). 1. Ensure you are signed in as an enterprise admin on {% data variables.product.github %}. 1. Navigate to the [{% data variables.product.prodname_copilot %} sign up page](https://github.com/github-copilot/purchase). 1. Ensure you are signed in to the right enterprise account. If you are not, click **{% octicon "arrow-switch" aria-hidden="true" aria-label="arrow-switch" %} Switch** and select the enterprise for which you want to purchase {% data variables.product.prodname_copilot %}. You can also append `?enterprise=YOUR-ENTERPRISE` to the URL to pre-select the enterprise. -1. Follow the steps to sign up and enable {% data variables.product.prodname_copilot_short %} for organizations in your enterprise. If you purchased {% data variables.product.prodname_copilot_enterprise_short %}, you will be able to assign either {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} to each individual organization in the enterprise. +1. Follow the steps to sign up and enable {% data variables.product.prodname_copilot_short %} for organizations in your enterprise. If you purchased {% data variables.copilot.copilot_enterprise_short %}, you will be able to assign either {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} to each individual organization in the enterprise. ## Next steps diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/upgrading-copilot-for-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/upgrading-copilot-for-your-enterprise.md index bef5faa4b7..c878a7c5d3 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/upgrading-copilot-for-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-plan-for-your-enterprise/upgrading-copilot-for-your-enterprise.md @@ -1,9 +1,9 @@ --- title: Upgrading Copilot for your enterprise shortTitle: Upgrade plan -intro: 'Change your enterprise''s plan from {% data variables.product.prodname_copilot_business_short %} to {% data variables.product.prodname_copilot_enterprise_short %}.' +intro: 'Change your enterprise''s plan from {% data variables.copilot.copilot_business_short %} to {% data variables.copilot.copilot_enterprise_short %}.' permissions: Enterprise owners -product: 'Enterprises with a {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Enterprises with a {% data variables.copilot.copilot_business_short %} plan' versions: feature: copilot-enterprise topics: @@ -14,21 +14,21 @@ redirect_from: --- >[!NOTE] -> You must already have a paid plan to {% data variables.product.prodname_copilot_business_short %} to upgrade to {% data variables.product.prodname_copilot_enterprise_short %}. Trial plans are not eligible for upgrade. +> You must already have a paid plan to {% data variables.copilot.copilot_business_short %} to upgrade to {% data variables.copilot.copilot_enterprise_short %}. Trial plans are not eligible for upgrade. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.copilot-tab %} -1. In the "{% data variables.product.prodname_copilot_business_short %} is active in your enterprise" section, click **Purchase {% data variables.product.prodname_copilot_enterprise_short %}**. +1. In the "{% data variables.copilot.copilot_business_short %} is active in your enterprise" section, click **Purchase {% data variables.copilot.copilot_enterprise_short %}**. - ![Screenshot of the Copilot "access management" page. A link, labeled "Purchase {% data variables.product.prodname_copilot_enterprise_short %}", is highlighted with an orange outline.](/assets/images/help/copilot/purchase-copilot-enterprise.png) + ![Screenshot of the Copilot "access management" page. A link, labeled "Purchase {% data variables.copilot.copilot_enterprise_short %}", is highlighted with an orange outline.](/assets/images/help/copilot/purchase-copilot-enterprise.png) 1. In the dialog, click **Continue to billing summary**. 1. Review your updated billing summary, then click **Enable plan**. ## Next steps -After upgrading to {% data variables.product.prodname_copilot_enterprise_short %}, you can assign {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} to individual organizations in the enterprise. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise). +After upgrading to {% data variables.copilot.copilot_enterprise_short %}, you can assign {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} to individual organizations in the enterprise. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise). ## Further reading diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization.md index 3929a9552e..20df045f7b 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization.md @@ -23,7 +23,7 @@ shortTitle: 'Add {% data variables.copilot.copilot_coding_agent %}' {% data reusables.organizations.copilot-policy-ent-overrides-org %} -{% data variables.copilot.copilot_coding_agent %} and use of third-party MCP servers are disabled by default for organization members. Organization owners with {% data variables.product.prodname_copilot_enterprise %} can enable these features for members on the {% data variables.product.prodname_copilot_short %} policies page for their organization. See [Enabling {% data variables.product.prodname_copilot_short %} features in your organization](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization). +{% data variables.copilot.copilot_coding_agent %} and use of third-party MCP servers are disabled by default for organization members. Organization owners with {% data variables.copilot.copilot_enterprise %} can enable these features for members on the {% data variables.product.prodname_copilot_short %} policies page for their organization. See [Enabling {% data variables.product.prodname_copilot_short %} features in your organization](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization). * For the "{% data variables.copilot.copilot_coding_agent %}" policy, select "Enabled". * For the "MCP servers on {% data variables.product.prodname_dotcom_the_website %}" policy, select "Enabled". @@ -37,7 +37,7 @@ Owners of any organization—even organizations without a {% data variables.prod 1. Use the "Repository access" control to define which repositories allow {% data variables.copilot.copilot_coding_agent %}. 1. If you choose "Selected repositories", in the "Select repositories" dialog, select the repositories that allow {% data variables.copilot.copilot_coding_agent %}, then click **Select**. -Once Copilot coding agent is enabled for a repository, any user with access to Copilot coding agent and write permission for the repository can delegate work to Copilot. +Once {% data variables.copilot.copilot_coding_agent %} is enabled for a repository, any user with access to {% data variables.copilot.copilot_coding_agent %} and write permission for the repository can delegate work to {% data variables.product.prodname_copilot_short %}. ## Next steps diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-your-proxy-server-or-firewall-for-copilot.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-your-proxy-server-or-firewall-for-copilot.md index c9c093a60a..7978cb9205 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-your-proxy-server-or-firewall-for-copilot.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-your-proxy-server-or-firewall-for-copilot.md @@ -36,6 +36,6 @@ Every user of the proxy server or firewall also needs to configure their own env * [Install and use {% data variables.product.prodname_vs %} and Azure Services behind a firewall or proxy server](https://learn.microsoft.com/en-us/visualstudio/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server) in the Microsoft documentation [^1]: Allows access to authorized users regardless of {% data variables.product.prodname_copilot_short %} plan. Do not add this URL to your allowlist if you are using subscription-based network routing. For more information on subscription-based network routing, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-access-to-copilot-in-your-enterprise/managing-github-copilot-access-to-your-enterprises-network). -[^2]: Allows access to authorized users via a {% data variables.product.prodname_copilot_individuals_short %} plan. Do not add this URL to your allowlist if you are using subscription-based network routing. -[^3]: Allows access to authorized users via a {% data variables.product.prodname_copilot_business_short %} plan. Do not add this URL to your allowlist if you want to use subscription-based network routing to block users from using {% data variables.product.prodname_copilot_business_short %} on your network. -[^4]: Allows access to authorized users via a {% data variables.product.prodname_copilot_enterprise_short %} plan. Do not add this URL to your allowlist if you want to use subscription-based network routing to block users from using {% data variables.product.prodname_copilot_enterprise_short %} on your network. +[^2]: Allows access to authorized users via a {% data variables.copilot.copilot_individuals_short %} plan. Do not add this URL to your allowlist if you are using subscription-based network routing. +[^3]: Allows access to authorized users via a {% data variables.copilot.copilot_business_short %} plan. Do not add this URL to your allowlist if you want to use subscription-based network routing to block users from using {% data variables.copilot.copilot_business_short %} on your network. +[^4]: Allows access to authorized users via a {% data variables.copilot.copilot_enterprise_short %} plan. Do not add this URL to your allowlist if you want to use subscription-based network routing to block users from using {% data variables.copilot.copilot_enterprise_short %} on your network. diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization.md index 51be3c6971..e49bd98b0b 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization.md @@ -2,7 +2,7 @@ title: Granting access to Copilot for members of your organization shortTitle: Grant access intro: 'Grant access to {% data variables.product.prodname_copilot %} for some or all of the members of your organization.' -permissions: 'Organization owners for organizations with a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or{% endif %} {% data variables.product.prodname_copilot_business_short %} plan.' +permissions: 'Organization owners for organizations with a {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or{% endif %} {% data variables.copilot.copilot_business_short %} plan.' versions: feature: copilot redirect_from: @@ -18,7 +18,7 @@ topics: ## Configuring access to {% data variables.product.prodname_copilot %} in your organization -{% ifversion ghec %}After a {% data variables.product.prodname_dotcom %} enterprise owner enables {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} for an organization, an owner of that organization can grant {% data variables.product.prodname_copilot %} access to members of their organization.{% else %}After setting up a {% data variables.product.prodname_copilot_business_short %} plan, an organization owner can grant {% data variables.product.prodname_copilot %} access to members of their organization.{% endif %} +{% ifversion ghec %}After a {% data variables.product.prodname_dotcom %} enterprise owner enables {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} for an organization, an owner of that organization can grant {% data variables.product.prodname_copilot %} access to members of their organization.{% else %}After setting up a {% data variables.copilot.copilot_business_short %} plan, an organization owner can grant {% data variables.product.prodname_copilot %} access to members of their organization.{% endif %} Billing for {% data variables.product.prodname_copilot %} starts when you grant an organization member access, irrespective of when they first use {% data variables.product.prodname_copilot_short %}. If you grant an organization member access midway through a billing cycle, the cost is prorated for the remainder of the cycle. For more information, see [AUTOTITLE](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot). diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-github-copilot-access-to-your-organizations-network.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-github-copilot-access-to-your-organizations-network.md index 8f1bb4e12e..91918bd0a5 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-github-copilot-access-to-your-organizations-network.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-github-copilot-access-to-your-organizations-network.md @@ -2,7 +2,7 @@ title: Managing GitHub Copilot access to your organization's network intro: 'Learn how to use subscription-based network routing to control {% data variables.product.prodname_copilot_short %} access to your network.' permissions: Organization owners -product: '{% data variables.product.prodname_copilot_business_short %}' +product: '{% data variables.copilot.copilot_business_short %}' versions: feature: copilot topics: diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-requests-for-copilot-business-in-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-requests-for-copilot-business-in-your-organization.md index dc6beb0d20..21965b8bef 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-requests-for-copilot-business-in-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-requests-for-copilot-business-in-your-organization.md @@ -6,20 +6,20 @@ permissions: Organization owners redirect_from: - /copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-requests-for-copilot-access-in-your-organization - /copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-requests-for-copilot-access-in-your-organization -product: 'Organizations with a {% data variables.product.prodname_copilot_business_short %} plan and organizations owned by an enterprise with a {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Organizations with a {% data variables.copilot.copilot_business_short %} plan and organizations owned by an enterprise with a {% data variables.copilot.copilot_business_short %} plan' versions: feature: copilot topics: - Copilot --- -As an organization owner, you can manage requests for {% data variables.product.prodname_copilot_for_business %} from your organization's settings. Additionally, {% data variables.product.prodname_dotcom %} sends you a weekly email with a summary of all pending requests. +As an organization owner, you can manage requests for {% data variables.copilot.copilot_for_business %} from your organization's settings. Additionally, {% data variables.product.prodname_dotcom %} sends you a weekly email with a summary of all pending requests. -If your organization is owned by an enterprise, before you can approve a request, you may need to request that the enterprise owners enable {% data variables.product.prodname_copilot_business_short %} for your organization by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get {% data variables.product.prodname_copilot_short %} from an organization." +If your organization is owned by an enterprise, before you can approve a request, you may need to request that the enterprise owners enable {% data variables.copilot.copilot_business_short %} for your organization by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get {% data variables.product.prodname_copilot_short %} from an organization." {% data reusables.profile.access_org %} {% data reusables.organizations.org-list %} 1. In the "Access" section of the sidebar, click **{% octicon "bell" aria-hidden="true" aria-label="bell" %} Requests from members**. -1. To accept the request and grant the member access to {% data variables.product.prodname_copilot_for_business %}, click **Buy {% data variables.product.prodname_copilot_business_short %}**. +1. To accept the request and grant the member access to {% data variables.copilot.copilot_for_business %}, click **Buy {% data variables.copilot.copilot_business_short %}**. -All requests for {% data variables.product.prodname_copilot_business_short %} are grouped together under "{% data variables.product.prodname_copilot_business_short %}." +All requests for {% data variables.copilot.copilot_business_short %} are grouped together under "{% data variables.copilot.copilot_business_short %}." diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/revoking-access-to-copilot-for-members-of-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/revoking-access-to-copilot-for-members-of-your-organization.md index 8a414a7cb2..1151d4cee9 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/revoking-access-to-copilot-for-members-of-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/revoking-access-to-copilot-for-members-of-your-organization.md @@ -2,7 +2,7 @@ title: Revoking access to Copilot for members of your organization shortTitle: Revoke access intro: 'Remove access to {% data variables.product.prodname_copilot %} for some or all of the members of your organization.' -permissions: 'Organization owners for organizations with a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or{% endif %} {% data variables.product.prodname_copilot_business_short %} plan.' +permissions: 'Organization owners for organizations with a {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or{% endif %} {% data variables.copilot.copilot_business_short %} plan.' versions: feature: copilot topics: @@ -27,7 +27,7 @@ Removing a user from the organization(s) that had granted them {% data variables {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.access-settings %} -1. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," select **Enabled For: selected members**. +1. Under {% ifversion ghec %}"{% data variables.copilot.copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.copilot.copilot_business_short %} is active in your organization," select **Enabled For: selected members**. * In the "Confirm policy update" dialog, click **Renew seats**. diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md index 4635819e22..de5f49f21f 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md @@ -2,7 +2,7 @@ title: Managing policies for Copilot in your organization intro: 'Learn how to manage policies for {% data variables.product.prodname_copilot %} in your organization.' permissions: Organization owners -product: 'Organizations with a {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} plan' +product: 'Organizations with a {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} plan' versions: feature: copilot redirect_from: @@ -27,16 +27,16 @@ shortTitle: Manage policies Organization owners can set policies to govern how {% data variables.product.prodname_copilot %} can be used within the organization. For example, an organization owner can enable or disable the following {% data variables.product.prodname_copilot_short %} features{% ifversion ghec %} (unless an enterprise owner has blocked access to these features at the enterprise level){% endif %}: * {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} -* {% data variables.product.prodname_copilot_chat_short %} in the IDE +* {% data variables.copilot.copilot_chat_short %} in the IDE * Editor preview Copilot features, such as: - * Image support in {% data variables.product.prodname_copilot_chat_short %} (available in {% data variables.product.prodname_vscode_shortname %} and {% data variables.product.prodname_vs %}) + * Image support in {% data variables.copilot.copilot_chat_short %} (available in {% data variables.product.prodname_vscode_shortname %} and {% data variables.product.prodname_vs %}) >[!NOTE] This setting only applies to preview features within {% data variables.product.prodname_copilot_short %} and does not control all preview-related settings in {% data variables.product.prodname_vscode_shortname %}. * {% data variables.copilot.copilot_coding_agent %} ({% data variables.release-phases.public_preview %}) -* {% data variables.product.prodname_copilot_spaces %} (public preview) +* {% data variables.copilot.copilot_spaces %} (public preview) * MCP servers on {% data variables.product.prodname_dotcom_the_website %} ({% data variables.release-phases.public_preview %}) -* {% data variables.product.prodname_copilot_mobile_short %} -* {% data variables.product.prodname_copilot_cli_short %} and {% data variables.product.prodname_windows_terminal %} -* {% data variables.product.prodname_copilot_desktop_short %} ({% data variables.release-phases.public_preview %}) +* {% data variables.copilot.copilot_mobile_short %} +* {% data variables.copilot.copilot_cli_short %} and {% data variables.product.prodname_windows_terminal %} +* {% data variables.copilot.copilot_desktop_short %} ({% data variables.release-phases.public_preview %}) * Suggestions matching public code * Access to alternative models for {% data variables.product.prodname_copilot_short %} * Anthropic {% data variables.copilot.copilot_claude %} in {% data variables.product.prodname_copilot_short %} @@ -64,40 +64,40 @@ If an organization member is assigned a seat by multiple organizations with diff For example, to enable or disable suggestion matching, in the "Suggestions matching public code" dropdown, select **Allowed** or **Blocked**. -1. If your organization has a {% data variables.product.prodname_copilot_business_short %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} plan and you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}", two additional options are displayed: +1. If your organization has a {% data variables.copilot.copilot_business_short %}{% ifversion ghec %} or {% data variables.copilot.copilot_enterprise_short %}{% endif %} plan and you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}", two additional options are displayed: {% data reusables.copilot.policies-for-dotcom %} > [!TIP] > If you choose to enable {% data variables.copilot.copilot_coding_agent %} for users, you also need to define which repositories the agent is available in, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization). -## Setting a policy for {% data variables.product.prodname_copilot_extensions %} in your organization +## Setting a policy for {% data variables.copilot.copilot_extensions %} in your organization -{% data variables.product.prodname_copilot_extensions %} integrate external tools with {% data variables.product.prodname_copilot_chat %}. See [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). +{% data variables.copilot.copilot_extensions %} integrate external tools with {% data variables.copilot.copilot_chat %}. See [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). -Before you install {% data variables.product.prodname_copilot_extensions_short %} in your organization, you should set a usage policy for your organization. Setting a usage policy allows you to enable or disable {% data variables.product.prodname_copilot_extensions_short %} for all members of your organization, limiting your security risk. +Before you install {% data variables.copilot.copilot_extensions_short %} in your organization, you should set a usage policy for your organization. Setting a usage policy allows you to enable or disable {% data variables.copilot.copilot_extensions_short %} for all members of your organization, limiting your security risk. {% ifversion ghec %} -If {% data variables.product.prodname_copilot_extensions_short %} have not been enabled or disabled at the enterprise level, you can set a {% data variables.product.prodname_copilot_extensions_short %} policy for your organization. +If {% data variables.copilot.copilot_extensions_short %} have not been enabled or disabled at the enterprise level, you can set a {% data variables.copilot.copilot_extensions_short %} policy for your organization. {% endif %} {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.policy-settings %} -1. In the "{% data variables.product.prodname_copilot_extensions_short %}" section, select the dropdown menu, then enable or disable {% data variables.product.prodname_copilot_extensions_short %} for your organization. +1. In the "{% data variables.copilot.copilot_extensions_short %}" section, select the dropdown menu, then enable or disable {% data variables.copilot.copilot_extensions_short %} for your organization. -### Managing permissions for a {% data variables.product.prodname_copilot_extension %} in your organization +### Managing permissions for a {% data variables.copilot.copilot_extension %} in your organization -After you have installed a {% data variables.product.prodname_copilot_extension_short %} in your organization, you can view the permissions the extension has in your organization, and why those permissions are necessary. If you do not want the {% data variables.product.prodname_copilot_extension_short %} to have the listed permissions, you can suspend or uninstall the extension. +After you have installed a {% data variables.copilot.copilot_extension_short %} in your organization, you can view the permissions the extension has in your organization, and why those permissions are necessary. If you do not want the {% data variables.copilot.copilot_extension_short %} to have the listed permissions, you can suspend or uninstall the extension. {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.apps.access-org-app-settings %} -1. Optionally, to filter your installed {% data variables.product.prodname_github_apps %} for {% data variables.product.prodname_copilot_extensions_short %}, select the **Filter:** dropdown menu, then click **{% data variables.product.prodname_copilot_extensions_short %}**. -1. Next to the {% data variables.product.prodname_copilot_extension_short %} you want to review or modify, click **Configure**. -1. In the "Permissions" section, review the permissions listed for the {% data variables.product.prodname_copilot_extension_short %}. Optionally, you can block the {% data variables.product.prodname_copilot_extension_short %}'s access to your organization in one of two ways: - * To indefinitely suspend the {% data variables.product.prodname_copilot_extension_short %}'s access to resources in your organization while keeping the extension installed, in the "Danger zone" section, click **Suspend**. - * To uninstall a {% data variables.product.prodname_copilot_extension_short %} completely, in the "Danger zone" section, click **Uninstall**. +1. Optionally, to filter your installed {% data variables.product.prodname_github_apps %} for {% data variables.copilot.copilot_extensions_short %}, select the **Filter:** dropdown menu, then click **{% data variables.copilot.copilot_extensions_short %}**. +1. Next to the {% data variables.copilot.copilot_extension_short %} you want to review or modify, click **Configure**. +1. In the "Permissions" section, review the permissions listed for the {% data variables.copilot.copilot_extension_short %}. Optionally, you can block the {% data variables.copilot.copilot_extension_short %}'s access to your organization in one of two ways: + * To indefinitely suspend the {% data variables.copilot.copilot_extension_short %}'s access to resources in your organization while keeping the extension installed, in the "Danger zone" section, click **Suspend**. + * To uninstall a {% data variables.copilot.copilot_extension_short %} completely, in the "Danger zone" section, click **Uninstall**. ## Further reading diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/about-billing-for-github-copilot-in-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/about-billing-for-github-copilot-in-your-organization.md index d394ac0e47..88b819657d 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/about-billing-for-github-copilot-in-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/about-billing-for-github-copilot-in-your-organization.md @@ -3,7 +3,7 @@ title: About billing for GitHub Copilot in your organization shortTitle: About billing intro: 'Learn about pricing and billing cycles for {% data variables.product.prodname_copilot_short %} in your organization.' permissions: 'Organization owners' -product: '{% data variables.product.prodname_copilot_for_business %}' +product: '{% data variables.copilot.copilot_for_business %}' versions: feature: copilot type: overview @@ -15,7 +15,7 @@ redirect_from: ## About pricing for {% data variables.product.prodname_copilot_short %} in your organization -{% data variables.product.prodname_copilot_business_short %} plans are available on a monthly cycle. The plans are billed at the end of each cycle, at {% data variables.copilot.cfb_price_per_month %} per user per month. +{% data variables.copilot.copilot_business_short %} plans are available on a monthly cycle. The plans are billed at the end of each cycle, at {% data variables.copilot.cfb_price_per_month %} per user per month. ## Premium requests @@ -36,7 +36,7 @@ If your organization belongs to an enterprise, your enterprise will be charged o ### About seat assignment for {% data variables.product.prodname_copilot_short %} in your organization -A {% data variables.product.prodname_copilot_short %} seat is a license to use {% data variables.product.prodname_copilot_short %}, which is granted to a unique user account through an organization's {% data variables.product.prodname_copilot_business_short %} plan. Each month, the organization is charged for the number of assigned seats. +A {% data variables.product.prodname_copilot_short %} seat is a license to use {% data variables.product.prodname_copilot_short %}, which is granted to a unique user account through an organization's {% data variables.copilot.copilot_business_short %} plan. Each month, the organization is charged for the number of assigned seats. Removing all assigned {% data variables.product.prodname_copilot_short %} seats in your organization will cancel your organization's {% data variables.product.prodname_copilot_short %} plan. diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/canceling-copilot-for-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/canceling-copilot-for-your-organization.md index 7d7d1fbbfc..ee0688c806 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/canceling-copilot-for-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/canceling-copilot-for-your-organization.md @@ -3,7 +3,7 @@ title: Canceling Copilot for your organization shortTitle: Cancel intro: 'Removing all assigned {% data variables.product.prodname_copilot %} seats in your organization will cancel your organization''s {% data variables.product.prodname_copilot_short %} plan.' permissions: Organization owners -product: '{% data variables.product.prodname_copilot_business_short %}' +product: '{% data variables.copilot.copilot_business_short %}' versions: feature: copilot topics: @@ -18,6 +18,6 @@ redirect_from: > If your organization was granted access to {% data variables.product.prodname_copilot_short %} through an enterprise, your enterprise admin will need to cancel the plan instead. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/canceling-copilot-for-your-enterprise). {% endif %} -To cancel your {% data variables.product.prodname_copilot_business_short %} plan for your organization account, you need to remove all assigned {% data variables.product.prodname_copilot %} seats. +To cancel your {% data variables.copilot.copilot_business_short %} plan for your organization account, you need to remove all assigned {% data variables.product.prodname_copilot %} seats. {% data reusables.copilot.disable-copilot-organization %} diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/subscribing-to-copilot-for-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/subscribing-to-copilot-for-your-organization.md index ef6fb0e0d7..420e46eae6 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/subscribing-to-copilot-for-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-the-copilot-plan-for-your-organization/subscribing-to-copilot-for-your-organization.md @@ -1,7 +1,7 @@ --- title: Subscribing to Copilot for your organization shortTitle: Subscribe -intro: 'Organization owners can set up a {% data variables.product.prodname_copilot_business_short %} plan for their organization.' +intro: 'Organization owners can set up a {% data variables.copilot.copilot_business_short %} plan for their organization.' permissions: Organization owners versions: feature: copilot diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-audit-logs-for-copilot-business.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-audit-logs-for-copilot-business.md index 12337f16e2..77b905f1b4 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-audit-logs-for-copilot-business.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-audit-logs-for-copilot-business.md @@ -1,7 +1,7 @@ --- title: Reviewing audit logs for Copilot Business shortTitle: Audit logs -intro: 'Review the audit logs for your {% data variables.product.prodname_copilot_business_short %} plan to understand what actions have been taken by which users.' +intro: 'Review the audit logs for your {% data variables.copilot.copilot_business_short %} plan to understand what actions have been taken by which users.' redirect_from: - /copilot/managing-copilot-for-business/reviewing-your-organization-or-enterprises-audit-logs-for-copilot-for-business - /copilot/managing-copilot-business/reviewing-your-organization-or-enterprises-audit-logs-for-copilot-business @@ -18,14 +18,14 @@ topics: - Copilot --- -## About audit logs for {% data variables.product.prodname_copilot_business_short %} +## About audit logs for {% data variables.copilot.copilot_business_short %} -You can use the audit logs for {% data variables.product.prodname_copilot_business_short %} to review actions taken by users in your organization{% ifversion ghec %} or enterprise{% endif %}, such as: +You can use the audit logs for {% data variables.copilot.copilot_business_short %} to review actions taken by users in your organization{% ifversion ghec %} or enterprise{% endif %}, such as: * Changes to {% data variables.product.prodname_copilot_short %} settings and policies -* The addition or removal of seats from your {% data variables.product.prodname_copilot_business_short %} plan +* The addition or removal of seats from your {% data variables.copilot.copilot_business_short %} plan -The audit log lists events related to your {% data variables.product.prodname_copilot_business_short %} plan for the last 180 days. +The audit log lists events related to your {% data variables.copilot.copilot_business_short %} plan for the last 180 days. {% ifversion ghec %} @@ -43,12 +43,12 @@ The audit log lists events related to your {% data variables.product.prodname_co {% data reusables.profile.org_settings %} {% data reusables.audit_log.audit_log_sidebar_for_org_admins %} -## Searching audit log events for {% data variables.product.prodname_copilot_business_short %} +## Searching audit log events for {% data variables.copilot.copilot_business_short %} You can search for any of the {% data variables.product.prodname_copilot %} audit log events using the `action` qualifier and the `copilot` category. Some example searches that use this syntax are: * `action:copilot`: Returns all {% data variables.product.prodname_copilot %} audit log events for your organization{% ifversion ghec %} or enterprise{% endif %}. -* `action:copilot.cfb_seat_assignment_created`: Returns all audit log events related to a {% data variables.product.prodname_copilot_business_short %} seat being assigned to a new user. +* `action:copilot.cfb_seat_assignment_created`: Returns all audit log events related to a {% data variables.copilot.copilot_business_short %} seat being assigned to a new user. For a full list of {% data variables.product.prodname_copilot %} audit log events, see{% ifversion ghec %} [AUTOTITLE](/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/audit-log-events-for-your-enterprise#copilot) and{% endif %} [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/audit-log-events-for-your-organization#copilot). diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization.md index d1fcce9c75..c6921aa306 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization.md @@ -3,7 +3,7 @@ title: Reviewing user activity data for Copilot in your organization shortTitle: User activity data intro: 'Review {% data variables.product.prodname_copilot %} usage in your organization to make informed decisions about seat assignment.' permissions: Organization owners -product: 'Organizations with a plan to {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or{% endif %} {% data variables.product.prodname_copilot_business_short %}' +product: 'Organizations with a plan to {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or{% endif %} {% data variables.copilot.copilot_business_short %}' versions: feature: copilot topics: @@ -22,7 +22,7 @@ redirect_from: {% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.access-settings %} -1. At the top of the page, under "{% data variables.product.prodname_copilot %}," you can see an overview of your organization's {% data variables.product.prodname_copilot %} usage. You can see the number seats assigned through your {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} plan, and the estimated monthly cost. +1. At the top of the page, under "{% data variables.product.prodname_copilot %}," you can see an overview of your organization's {% data variables.product.prodname_copilot %} usage. You can see the number seats assigned through your {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or {% endif %}{% data variables.copilot.copilot_business_short %} plan, and the estimated monthly cost. {% ifversion ghec %} ![Screenshot of the {% data variables.product.prodname_copilot %} usage overview.](/assets/images/help/copilot/copilot-usage-overview-enterprise.png) diff --git a/content/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests.md b/content/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests.md index 6cc9b1b40c..70ef2f1827 100644 --- a/content/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests.md +++ b/content/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests.md @@ -18,7 +18,7 @@ redirect_from: A request is any interaction where you ask {% data variables.product.prodname_copilot_short %} to do something for you—whether it’s generating code, answering a question, or helping you through an extension. Each time you send a prompt in a chat window or trigger a response from {% data variables.product.prodname_copilot_short %}, you’re making a request. -If you have {% data variables.product.prodname_copilot_free_short %} enabled, your {% data variables.product.github %} account comes with up to 2,000 code completions and up to 50 chats or premium requests per month. +If you have {% data variables.copilot.copilot_free_short %} enabled, your {% data variables.product.github %} account comes with up to 2,000 code completions and up to 50 chats or premium requests per month. If you're on a paid plan, you get unlimited code completions, unlimited agent requests, and unlimited chat interactions using the base model. Rate limiting is in place to accommodate for high demand. Learn more about [current models and usage](/copilot/about-github-copilot/plans-for-github-copilot). @@ -32,11 +32,11 @@ Some {% data variables.product.prodname_copilot_short %} features use more advan The following {% data variables.product.prodname_copilot_short %} features can use premium requests: -* [{% data variables.product.prodname_copilot_chat_short %}](/copilot/using-github-copilot/copilot-chat) +* [{% data variables.copilot.copilot_chat_short %}](/copilot/using-github-copilot/copilot-chat) * [{% data variables.copilot.copilot_coding_agent %}](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot) [^1] -* [{% data variables.product.prodname_copilot_agent_short %} mode](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide#copilot-edits) +* [Agent mode in {% data variables.copilot.copilot_chat_short %}](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide#copilot-edits) * [{% data variables.product.prodname_copilot_short %} code review](/copilot/using-github-copilot/code-review/using-copilot-code-review) -* [{% data variables.product.prodname_copilot_extensions_short %}](/copilot/building-copilot-extensions/about-building-copilot-extensions) +* [{% data variables.copilot.copilot_extensions_short %}](/copilot/building-copilot-extensions/about-building-copilot-extensions) [^1]: {% data variables.copilot.copilot_coding_agent %} uses a fixed multiplier of 1 for the premium requests it uses, and may use multiple premium requests in response to one user prompt. @@ -46,7 +46,7 @@ Each model has a premium request multiplier, based on its complexity and resourc | Model | Premium requests | |-------------------------------------------------------------------------|------------------------------------------------------------------------------| -| Base model (currently {% data variables.copilot.copilot_gpt_41 %}) [^2] | 0 (paid users), 1 ({% data variables.product.prodname_copilot_free_short %}) | +| Base model (currently {% data variables.copilot.copilot_gpt_41 %}) [^2] | 0 (paid users), 1 ({% data variables.copilot.copilot_free_short %}) | | Premium {% data variables.copilot.copilot_gpt_41 %} | 1 | | {% data variables.copilot.copilot_gpt_4o %} | 1 | | {% data variables.copilot.copilot_gpt_45 %} | 50 | @@ -69,8 +69,8 @@ Each model has a premium request multiplier, based on its complexity and resourc > [!NOTE] > The option to purchase additional premium requests is not available to: > -> * Users on {% data variables.product.prodname_copilot_free_short %}. To access more premium requests, upgrade to a paid plan. -> * Users who subscribe, or have subscribed, to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} through {% data variables.product.prodname_mobile %} on iOS or Android. +> * Users on {% data variables.copilot.copilot_free_short %}. To access more premium requests, upgrade to a paid plan. +> * Users who subscribe, or have subscribed, to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} through {% data variables.product.prodname_mobile %} on iOS or Android. > > Budget setting for premium requests will be available starting **June 4, 2025**. @@ -82,6 +82,6 @@ Additional premium requests beyond your plan’s included amount are billed at { Premium request usage is based on the model’s multiplier and the feature you’re using. For example: -* If you use **GPT-4.5** (50× multiplier) to ask a single question in {% data variables.product.prodname_copilot_chat_short %}, that interaction counts as **50 premium requests**. -* If you're on **{% data variables.product.prodname_copilot_free_short %}**, even interactions with the **base model** use **1 premium request** each. +* If you use **GPT-4.5** (50× multiplier) to ask a single question in {% data variables.copilot.copilot_chat_short %}, that interaction counts as **50 premium requests**. +* If you're on **{% data variables.copilot.copilot_free_short %}**, even interactions with the **base model** use **1 premium request** each. * If you're on a **paid plan**, using the base model does not count against your monthly premium request allowance. diff --git a/content/copilot/quickstart.md b/content/copilot/quickstart.md index c2213a4c8b..aedabe5ecf 100644 --- a/content/copilot/quickstart.md +++ b/content/copilot/quickstart.md @@ -26,7 +26,7 @@ topics: You can use {% data variables.product.prodname_copilot_short %} to get answers to coding-related questions, such as how best to code something, how to fix a bug, or how someone else's code works. For full details of what {% data variables.product.prodname_copilot_short %} can do, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). -If you have access to {% data variables.product.prodname_copilot_workspace %}, {% data variables.product.prodname_copilot_short %} can also help you when you are editing files in a pull request on the {% data variables.product.github %} website by offering you code completion suggestions. For more information about {% data variables.product.prodname_copilot_workspace %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). +If you have access to {% data variables.copilot.copilot_workspace %}, {% data variables.product.prodname_copilot_short %} can also help you when you are editing files in a pull request on the {% data variables.product.github %} website by offering you code completion suggestions. For more information about {% data variables.copilot.copilot_workspace %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). Instructions for using {% data variables.product.prodname_copilot_short %} differ depending on where you are using it. This version of the quickstart is for {% data variables.product.github %}. Click the tabs above for instructions on using {% data variables.product.prodname_copilot_short %} in other environments. @@ -62,7 +62,7 @@ To use {% data variables.product.prodname_copilot_short %} on the {% data variab ## Other questions you can ask -There are many more things you can do with {% data variables.product.prodname_copilot_chat_dotcom %}. For example: +There are many more things you can do with {% data variables.copilot.copilot_chat_dotcom %}. For example: * Ask a general question about software development * Ask exploratory questions about a repository @@ -74,7 +74,7 @@ For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat- ## Next steps -* **Find out more about {% data variables.product.prodname_copilot_chat %}** - See [AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion fpt %}.{% endif %}{% ifversion ghec %} and [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom).{% endif %} +* **Find out more about {% data variables.copilot.copilot_chat %}** - See [AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion fpt %}.{% endif %}{% ifversion ghec %} and [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom).{% endif %} * **Get {% data variables.product.prodname_copilot_short %} code completion suggestions in an IDE** - See [AUTOTITLE](/enterprise-cloud@latest/copilot/using-github-copilot/using-github-copilot-code-suggestions-in-your-editor). * **Learn how to write effective prompts** - See [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot). * **Use {% data variables.product.prodname_copilot_short %} on your mobile device** - See [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile). @@ -214,13 +214,13 @@ After you've installed the {% data variables.product.prodname_copilot %} extensi > [!NOTE] {% data reusables.copilot.chat-access-denied %} 1. Open an existing code file. -1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.product.prodname_copilot_chat %}**. -1. In the {% data variables.product.prodname_copilot_chat_short %} window, type `what does this file do` then press Enter. +1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.copilot.copilot_chat %}**. +1. In the {% data variables.copilot.copilot_chat_short %} window, type `what does this file do` then press Enter. {% data variables.product.prodname_copilot_short %}'s answer is displayed below your question. 1. Select a line of code in the editor. -1. In the {% data variables.product.prodname_copilot_chat_short %} window, type `explain this line` then press Enter. +1. In the {% data variables.copilot.copilot_chat_short %} window, type `explain this line` then press Enter. ## Get your first code completion suggestion @@ -265,16 +265,16 @@ After you've installed the {% data variables.product.prodname_copilot %} plugin, > [!NOTE] {% data reusables.copilot.chat-access-denied %} 1. Open an existing code file. -1. Open the {% data variables.product.prodname_copilot_chat_short %} window by clicking the **{% data variables.product.prodname_copilot_chat_short %}** icon at the right side of the JetBrains IDE window. +1. Open the {% data variables.copilot.copilot_chat_short %} window by clicking the **{% data variables.copilot.copilot_chat_short %}** icon at the right side of the JetBrains IDE window. - ![Screenshot of the {% data variables.product.prodname_copilot_chat_short %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) + ![Screenshot of the {% data variables.copilot.copilot_chat_short %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) -1. In the {% data variables.product.prodname_copilot_chat_short %} window, type `what does this file do` then press Enter. +1. In the {% data variables.copilot.copilot_chat_short %} window, type `what does this file do` then press Enter. {% data variables.product.prodname_copilot_short %}'s answer is displayed below your question. 1. Select a line of code in the editor. -1. In the {% data variables.product.prodname_copilot_chat_short %} window, type `explain this line` then press Enter. +1. In the {% data variables.copilot.copilot_chat_short %} window, type `explain this line` then press Enter. ## Get your first code completion suggestion diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-copilot-coding-agent-on-githubcom.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-copilot-coding-agent-on-githubcom.md index 29a0ec8918..8366708f14 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-copilot-coding-agent-on-githubcom.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-copilot-coding-agent-on-githubcom.md @@ -13,7 +13,7 @@ redirect_from: ## About {% data variables.copilot.copilot_coding_agent %} on {% data variables.product.prodname_dotcom_the_website %} -{% data variables.copilot.copilot_coding_agent %} is an autonomous and asynchronous software development agent integrated into {% data variables.product.github %}. The agent can pick up a task from an issue or from {% data variables.product.prodname_copilot_chat_short %}, create a pull request, and then iterate on the pull request in response to comments. +{% data variables.copilot.copilot_coding_agent %} is an autonomous and asynchronous software development agent integrated into {% data variables.product.github %}. The agent can pick up a task from an issue or from {% data variables.copilot.copilot_chat_short %}, create a pull request, and then iterate on the pull request in response to comments. {% data variables.copilot.copilot_coding_agent %} can generate tailored changes based on your description and configurations, including tasks like bug fixes, implementing incremental new features, prototyping, documentation, and codebase maintenance. After the initial pull request is created, the agent can iterate with you, based on your feedback and reviews. @@ -25,7 +25,7 @@ The agent works by using a combination of natural language processing and machin ### Prompt processing -The task provided to {% data variables.product.prodname_copilot_short %} through an issue, pull request comment or {% data variables.product.prodname_copilot_chat_short %} message is combined with other relevant, contextual information to form a prompt. That prompt is sent to a large language model for processing. Inputs can take the form of plain natural language, code snippets, or images. +The task provided to {% data variables.product.prodname_copilot_short %} through an issue, pull request comment or {% data variables.copilot.copilot_chat_short %} message is combined with other relevant, contextual information to form a prompt. That prompt is sent to a large language model for processing. Inputs can take the form of plain natural language, code snippets, or images. ### Language model analysis diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github-mobile.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github-mobile.md index daacec4542..ca579506e2 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github-mobile.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github-mobile.md @@ -1,7 +1,7 @@ --- title: Responsible use of GitHub Copilot Chat in GitHub Mobile shortTitle: Chat in GitHub Mobile -intro: 'Learn how to use {% data variables.product.prodname_copilot_chat %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_chat %} responsibly by understanding its purposes, capabilities, and limitations.' redirect_from: - /early-access/copilot/about-github-copilot-chat-in-github-mobile - /copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile @@ -14,15 +14,15 @@ topics: type: rai --- -## About {% data variables.product.prodname_copilot_mobile %} +## About {% data variables.copilot.copilot_mobile %} -{% data variables.product.prodname_copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. In addition to {% data variables.product.prodname_mobile %}, {% data variables.product.prodname_copilot_chat_short %} is currently supported in the {% data variables.product.github %} website, {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and the JetBrains suite of IDEs. For more information about {% data variables.product.prodname_copilot %}, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). +{% data variables.copilot.copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. In addition to {% data variables.product.prodname_mobile %}, {% data variables.copilot.copilot_chat_short %} is currently supported in the {% data variables.product.github %} website, {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and the JetBrains suite of IDEs. For more information about {% data variables.product.prodname_copilot %}, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). -{% data variables.product.prodname_copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.product.prodname_copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. +{% data variables.copilot.copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.copilot.copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. -The primary supported language for {% data variables.product.prodname_copilot_mobile %} is English. +The primary supported language for {% data variables.copilot.copilot_mobile %} is English. -{% data variables.product.prodname_copilot_chat %} works by using a combination of natural language processing and machine learning to understand your question and provide you with an answer. This process can be broken down into a number of steps. +{% data variables.copilot.copilot_chat %} works by using a combination of natural language processing and machine learning to understand your question and provide you with an answer. This process can be broken down into a number of steps. {% data reusables.rai.copilot.about-copilot-chat-in-mobile %} diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github.md index d2cf0cbe09..6d7788d3bc 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-github.md @@ -1,7 +1,7 @@ --- title: Responsible use of GitHub Copilot Chat in GitHub shortTitle: Chat in GitHub -intro: 'Learn how to use {% data variables.product.prodname_copilot_chat_dotcom %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_chat_dotcom %} responsibly by understanding its purposes, capabilities, and limitations.' versions: feature: copilot topics: @@ -11,29 +11,29 @@ redirect_from: - /copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-githubcom --- -## About {% data variables.product.prodname_copilot_chat_dotcom %} +## About {% data variables.copilot.copilot_chat_dotcom %} -{% data variables.product.prodname_copilot_chat_dotcom %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.github %}. +{% data variables.copilot.copilot_chat_dotcom %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.github %}. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. -> [!NOTE] {% data variables.product.prodname_copilot_chat_short %} is also available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and the JetBrains suite of IDEs. However, features available in these IDEs differ from features available on {% data variables.product.github %}. +> [!NOTE] {% data variables.copilot.copilot_chat_short %} is also available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and the JetBrains suite of IDEs. However, features available in these IDEs differ from features available on {% data variables.product.github %}. -{% data variables.product.prodname_copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.product.prodname_copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. +{% data variables.copilot.copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.copilot.copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. -The primary supported language for {% data variables.product.prodname_copilot_chat_dotcom_short %} is English. +The primary supported language for {% data variables.copilot.copilot_chat_dotcom_short %} is English. -{% data variables.product.prodname_copilot_chat %} works by using a combination of natural language processing and machine learning to understand your question and provide you with an answer. This process can be broken down into a number of steps. +{% data variables.copilot.copilot_chat %} works by using a combination of natural language processing and machine learning to understand your question and provide you with an answer. This process can be broken down into a number of steps. ### Input processing -The input prompt from the user is pre-processed by the {% data variables.product.prodname_copilot_chat_short %} system, combined with contextual information (for example, the current date and time and the name of the repository the user is currently viewing), and sent to a large language model. User input can take the form of code snippets or plain language. +The input prompt from the user is pre-processed by the {% data variables.copilot.copilot_chat_short %} system, combined with contextual information (for example, the current date and time and the name of the repository the user is currently viewing), and sent to a large language model. User input can take the form of code snippets or plain language. The large language model will take the prompt, gather additional context (for example repository data stored on {% data variables.product.prodname_dotcom %} or search results from Bing), and provide a response based on the prompt. The system is only intended to respond to coding-related questions. ### Language model analysis -The pre-processed prompt is then passed through the {% data variables.product.prodname_copilot_chat_short %} language model, which is a neural network that has been trained on a large body of text data. The language model analyzes the input prompt. +The pre-processed prompt is then passed through the {% data variables.copilot.copilot_chat_short %} language model, which is a neural network that has been trained on a large body of text data. The language model analyzes the input prompt. ### Response generation @@ -41,113 +41,113 @@ The language model generates a response based on its analysis of the input promp ### Output formatting -The response generated by {% data variables.product.prodname_copilot_chat_short %} is formatted and presented to the user. {% data variables.product.prodname_copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files, issues, Bing search results, or documentation, may also be provided. +The response generated by {% data variables.copilot.copilot_chat_short %} is formatted and presented to the user. {% data variables.copilot.copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files, issues, Bing search results, or documentation, may also be provided. -{% data variables.product.prodname_copilot_chat_short %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.product.prodname_copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.product.prodname_copilot_chat_short %}, see [Improving performance for {% data variables.product.prodname_copilot_chat_short %}](#improving-performance-for-copilot-chat). +{% data variables.copilot.copilot_chat_short %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.copilot.copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.copilot.copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.copilot.copilot_chat_short %}, see [Improving performance for {% data variables.copilot.copilot_chat_short %}](#improving-performance-for-copilot-chat). -## Use cases for {% data variables.product.prodname_copilot_chat_short %} +## Use cases for {% data variables.copilot.copilot_chat_short %} -{% data variables.product.prodname_copilot_chat_short %} can provide coding assistance in a variety of scenarios. +{% data variables.copilot.copilot_chat_short %} can provide coding assistance in a variety of scenarios. ### Answering coding questions -You can ask {% data variables.product.prodname_copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. +You can ask {% data variables.copilot.copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. -The response generated by {% data variables.product.prodname_copilot_chat_short %} may use the model's training data set, search results from Bing, code in your repositories, and Markdown documentation in your knowledge bases to answer your questions. +The response generated by {% data variables.copilot.copilot_chat_short %} may use the model's training data set, search results from Bing, code in your repositories, and Markdown documentation in your knowledge bases to answer your questions. This can be a useful tool for programmers, as it can provide guidance and support for common coding tasks and challenges. ### Explaining code and suggesting improvements -{% data variables.product.prodname_copilot_chat_short %} can help explain selected code by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, if you select a function or code block in the code editor, {% data variables.product.prodname_copilot_chat_short %} can generate a natural language description of what the code does and how it fits into the overall system. This can include information such as the function's input and output parameters, its dependencies, and its purpose in the larger application. +{% data variables.copilot.copilot_chat_short %} can help explain selected code by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, if you select a function or code block in the code editor, {% data variables.copilot.copilot_chat_short %} can generate a natural language description of what the code does and how it fits into the overall system. This can include information such as the function's input and output parameters, its dependencies, and its purpose in the larger application. -{% data variables.product.prodname_copilot_chat_short %} can also suggest potential improvements to selected code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. +{% data variables.copilot.copilot_chat_short %} can also suggest potential improvements to selected code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. -By generating explanations and suggesting related documentation, {% data variables.product.prodname_copilot_chat_short %} may help you to understand the selected code, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.product.prodname_copilot_chat_short %}'s output. +By generating explanations and suggesting related documentation, {% data variables.copilot.copilot_chat_short %} may help you to understand the selected code, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.copilot.copilot_chat_short %}'s output. ### Proposing code fixes -{% data variables.product.prodname_copilot_chat_short %} can propose a fix for bugs in your code by suggesting code snippets and solutions based on the context of the error or issue. This can be useful if you are struggling to identify the root cause of a bug or you need guidance on the best way to fix it. For example, if your code produces an error message or warning, {% data variables.product.prodname_copilot_chat_short %} can suggest possible fixes based on the error message, the code's syntax, and the surrounding code. +{% data variables.copilot.copilot_chat_short %} can propose a fix for bugs in your code by suggesting code snippets and solutions based on the context of the error or issue. This can be useful if you are struggling to identify the root cause of a bug or you need guidance on the best way to fix it. For example, if your code produces an error message or warning, {% data variables.copilot.copilot_chat_short %} can suggest possible fixes based on the error message, the code's syntax, and the surrounding code. -{% data variables.product.prodname_copilot_chat_short %} can suggest changes to variables, control structures, or function calls that might resolve the issue and generate code snippets that can be incorporated into the codebase. However, it's important to note that the suggested fixes may not always be optimal or complete, so you'll need to review and test the suggestions. +{% data variables.copilot.copilot_chat_short %} can suggest changes to variables, control structures, or function calls that might resolve the issue and generate code snippets that can be incorporated into the codebase. However, it's important to note that the suggested fixes may not always be optimal or complete, so you'll need to review and test the suggestions. ### Planning coding tasks -{% data variables.product.prodname_copilot_chat_short %} can read a {% data variables.product.prodname_dotcom %} issue and summarize it, answer questions about it, or propose next steps. This can be useful if you have a long, complex issue with many comments, and you want to understand it quickly or figure out what to do next. +{% data variables.copilot.copilot_chat_short %} can read a {% data variables.product.prodname_dotcom %} issue and summarize it, answer questions about it, or propose next steps. This can be useful if you have a long, complex issue with many comments, and you want to understand it quickly or figure out what to do next. -However, it's important to note that {% data variables.product.prodname_copilot_chat_short %}'s answers and summaries may not always be accurate or complete, so you'll need to review {% data variables.product.prodname_copilot_chat_short %}'s output for accuracy. +However, it's important to note that {% data variables.copilot.copilot_chat_short %}'s answers and summaries may not always be accurate or complete, so you'll need to review {% data variables.copilot.copilot_chat_short %}'s output for accuracy. ### Finding out about releases, discussions, and commits -{% data variables.product.prodname_copilot_chat_short %} can help you find out what changed in a specific release, it can summarize the information in a discussion, and it can explain the changes in a specific commit. This can be useful if, for example, you are new to a project, you want to quickly get the gist of a discussion, or you need to work on code that someone else wrote. However, it's important to note that {% data variables.product.prodname_copilot_chat_short %}'s summaries of releases, discussions, and commits may not always be accurate or complete. +{% data variables.copilot.copilot_chat_short %} can help you find out what changed in a specific release, it can summarize the information in a discussion, and it can explain the changes in a specific commit. This can be useful if, for example, you are new to a project, you want to quickly get the gist of a discussion, or you need to work on code that someone else wrote. However, it's important to note that {% data variables.copilot.copilot_chat_short %}'s summaries of releases, discussions, and commits may not always be accurate or complete. -## Improving performance for {% data variables.product.prodname_copilot_chat_short %} +## Improving performance for {% data variables.copilot.copilot_chat_short %} -{% data variables.product.prodname_copilot_chat_short %} can support a wide range of practical applications like Q&A, code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the limitations of {% data variables.product.prodname_copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.product.prodname_copilot_chat_short %}, see [Limitations of {% data variables.product.prodname_copilot_chat %}](#limitations-of-github-copilot-chat). +{% data variables.copilot.copilot_chat_short %} can support a wide range of practical applications like Q&A, code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the limitations of {% data variables.copilot.copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.copilot.copilot_chat_short %}, see [Limitations of {% data variables.copilot.copilot_chat %}](#limitations-of-github-copilot-chat). ### Keep your prompts on topic -{% data variables.product.prodname_copilot_chat_short %} is intended to address queries related to coding exclusively. Therefore, limiting the prompt to coding questions or tasks can enhance the model's output quality. +{% data variables.copilot.copilot_chat_short %} is intended to address queries related to coding exclusively. Therefore, limiting the prompt to coding questions or tasks can enhance the model's output quality. -### Use {% data variables.product.prodname_copilot_chat_short %} as a tool, not a replacement +### Use {% data variables.copilot.copilot_chat_short %} as a tool, not a replacement -While {% data variables.product.prodname_copilot_chat_short %} can be a powerful tool for generating code, it is important to use it as a tool rather than a replacement for human programming. You should always review and test the code generated by {% data variables.product.prodname_copilot_chat_short %} to ensure that it meets your requirements and is free of errors or security concerns. +While {% data variables.copilot.copilot_chat_short %} can be a powerful tool for generating code, it is important to use it as a tool rather than a replacement for human programming. You should always review and test the code generated by {% data variables.copilot.copilot_chat_short %} to ensure that it meets your requirements and is free of errors or security concerns. ### Use secure coding and code review practices -While {% data variables.product.prodname_copilot_chat_short %} can generate syntactically correct code, it may not always be secure. You should always follow best practices for secure coding, such as avoiding hard-coded passwords or SQL injection vulnerabilities, as well as following code review best practices, to address {% data variables.product.prodname_copilot_chat_short %}'s limitations. +While {% data variables.copilot.copilot_chat_short %} can generate syntactically correct code, it may not always be secure. You should always follow best practices for secure coding, such as avoiding hard-coded passwords or SQL injection vulnerabilities, as well as following code review best practices, to address {% data variables.copilot.copilot_chat_short %}'s limitations. ### Provide feedback {% data reusables.rai.copilot-dotcom-feedback-collection %} -If you encounter any issues or limitations with {% data variables.product.prodname_copilot_chat_dotcom_short %}, we recommend that you provide feedback by clicking the thumbs down icon below each chat response. This can help the developers to improve the tool and address any concerns or limitations. +If you encounter any issues or limitations with {% data variables.copilot.copilot_chat_dotcom_short %}, we recommend that you provide feedback by clicking the thumbs down icon below each chat response. This can help the developers to improve the tool and address any concerns or limitations. ### Stay up to date -{% data variables.product.prodname_copilot_chat_short %} is a new technology and is likely to evolve over time. For {% data variables.product.prodname_copilot_chat_dotcom %} you will always have access to the latest product experience. You should stay up to date with any new security risks or best practices that may emerge. +{% data variables.copilot.copilot_chat_short %} is a new technology and is likely to evolve over time. For {% data variables.copilot.copilot_chat_dotcom %} you will always have access to the latest product experience. You should stay up to date with any new security risks or best practices that may emerge. -## Limitations of {% data variables.product.prodname_copilot_chat %} +## Limitations of {% data variables.copilot.copilot_chat %} -Depending on factors such as your codebase and input data, you may experience different levels of performance when using {% data variables.product.prodname_copilot_chat_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.product.prodname_copilot_chat_short %}. +Depending on factors such as your codebase and input data, you may experience different levels of performance when using {% data variables.copilot.copilot_chat_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.copilot.copilot_chat_short %}. ### Limited scope -{% data variables.product.prodname_copilot_chat_short %} has been trained on a large body of code but still has a limited scope and may not be able to handle more complex code structures or obscure programming languages. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may be more challenging for {% data variables.product.prodname_copilot_chat_short %} to provide assistance with. Additionally, {% data variables.product.prodname_copilot_chat_short %} can only suggest code based on the context of the code being written, so it may not be able to identify larger design or architectural issues. +{% data variables.copilot.copilot_chat_short %} has been trained on a large body of code but still has a limited scope and may not be able to handle more complex code structures or obscure programming languages. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may be more challenging for {% data variables.copilot.copilot_chat_short %} to provide assistance with. Additionally, {% data variables.copilot.copilot_chat_short %} can only suggest code based on the context of the code being written, so it may not be able to identify larger design or architectural issues. ### Potential biases -{% data variables.product.prodname_copilot_short %}'s training data (drawn from existing code repositories) and context gathered by the large language model (for example, Bing search results) may contain biases and errors that can be perpetuated by the tool. Additionally, {% data variables.product.prodname_copilot_chat_short %} may be biased towards certain programming languages or coding styles, which can lead to suboptimal or incomplete code suggestions. +{% data variables.product.prodname_copilot_short %}'s training data (drawn from existing code repositories) and context gathered by the large language model (for example, Bing search results) may contain biases and errors that can be perpetuated by the tool. Additionally, {% data variables.copilot.copilot_chat_short %} may be biased towards certain programming languages or coding styles, which can lead to suboptimal or incomplete code suggestions. ### Security risks -{% data variables.product.prodname_copilot_chat_short %} generates code based on the context of the code being written, which can potentially expose sensitive information or vulnerabilities if not used carefully. You should be careful when using {% data variables.product.prodname_copilot_chat_short %} to generate code for security-sensitive applications and always review and test the generated code thoroughly. +{% data variables.copilot.copilot_chat_short %} generates code based on the context of the code being written, which can potentially expose sensitive information or vulnerabilities if not used carefully. You should be careful when using {% data variables.copilot.copilot_chat_short %} to generate code for security-sensitive applications and always review and test the generated code thoroughly. ### Matches with public code -{% data variables.product.prodname_copilot_chat_short %} is capable of generating new code, which it does in a probabilistic way. While the probability that it may produce code that matches code in the training set is low, a {% data variables.product.prodname_copilot_chat_short %} suggestion may contain some code snippets that match code in the training set. +{% data variables.copilot.copilot_chat_short %} is capable of generating new code, which it does in a probabilistic way. While the probability that it may produce code that matches code in the training set is low, a {% data variables.copilot.copilot_chat_short %} suggestion may contain some code snippets that match code in the training set. -If you have disabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} utilizes filters that prevent it from showing code that matches code found in public repositories on {% data variables.product.prodname_dotcom %}. However, you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. +If you have disabled suggestions that match public code then {% data variables.copilot.copilot_chat_short %} utilizes filters that prevent it from showing code that matches code found in public repositories on {% data variables.product.prodname_dotcom %}. However, you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. -If you have enabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} displays a message if matching code is found. The message includes links to repositories on {% data variables.product.github %} that contain matching code, and any license details that were found. For more information, see [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions). +If you have enabled suggestions that match public code then {% data variables.copilot.copilot_chat_short %} displays a message if matching code is found. The message includes links to repositories on {% data variables.product.github %} that contain matching code, and any license details that were found. For more information, see [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions). ### Inaccurate code -One of the limitations of {% data variables.product.prodname_copilot_chat_short %} is that it may generate code that appears to be valid but may not actually be semantically or syntactically correct or may not accurately reflect the intent of the developer. To mitigate the risk of inaccurate code, you should carefully review and test the generated code, particularly when dealing with critical or sensitive applications. You should also ensure that the generated code adheres to best practices and design patterns and fits within the overall architecture and style of the codebase. +One of the limitations of {% data variables.copilot.copilot_chat_short %} is that it may generate code that appears to be valid but may not actually be semantically or syntactically correct or may not accurately reflect the intent of the developer. To mitigate the risk of inaccurate code, you should carefully review and test the generated code, particularly when dealing with critical or sensitive applications. You should also ensure that the generated code adheres to best practices and design patterns and fits within the overall architecture and style of the codebase. ### Inaccurate responses to non-coding topics -{% data variables.product.prodname_copilot_chat_short %} is not designed to answer non-coding questions, and therefore its responses may not always be accurate or helpful in these contexts. If a user asks {% data variables.product.prodname_copilot_chat_short %} a non-coding question, it may generate an answer that is irrelevant or nonsensical, or it may simply indicate that it is unable to provide a useful response. +{% data variables.copilot.copilot_chat_short %} is not designed to answer non-coding questions, and therefore its responses may not always be accurate or helpful in these contexts. If a user asks {% data variables.copilot.copilot_chat_short %} a non-coding question, it may generate an answer that is irrelevant or nonsensical, or it may simply indicate that it is unable to provide a useful response. ### Leveraging a web search to answer a question -Depending on the question you ask, {% data variables.product.prodname_copilot_chat %} can optionally use a Bing search to help answer your question. {% data variables.product.prodname_copilot_short %} will use Bing for queries about recent events, new trends or technologies, highly specific subjects, or when a web search is explicitly requested by the user. Your {% data variables.product.prodname_enterprise %} administrator can enable Bing for your whole enterprise, or can delegate this decision to the organizational administrator. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). +Depending on the question you ask, {% data variables.copilot.copilot_chat %} can optionally use a Bing search to help answer your question. {% data variables.product.prodname_copilot_short %} will use Bing for queries about recent events, new trends or technologies, highly specific subjects, or when a web search is explicitly requested by the user. Your {% data variables.product.prodname_enterprise %} administrator can enable Bing for your whole enterprise, or can delegate this decision to the organizational administrator. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). 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). ## Next steps -For details of how to use {% data variables.product.prodname_copilot_chat_dotcom %}, see: +For details of how to use {% data variables.copilot.copilot_chat_dotcom %}, see: * [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom){% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-your-ide.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-your-ide.md index 769516af35..74251fadec 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-your-ide.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-your-ide.md @@ -1,7 +1,7 @@ --- title: Responsible use of GitHub Copilot Chat in your IDE shortTitle: Chat in your IDE -intro: 'Learn how to use {% data variables.product.prodname_copilot_chat %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_chat %} responsibly by understanding its purposes, capabilities, and limitations.' redirect_from: - /early-access/copilot/github-copilot-chat-transparency-note - /early-access/copilot/github-copilot-chat-technical-preview-license-terms @@ -29,7 +29,7 @@ type: rai {% data reusables.rai.copilot.copilot-chat-ide-response-generation %} -When you use the `@github` chat participant, {% data variables.product.prodname_copilot_chat_short %} will be able to gather context from your code stored on {% data variables.product.github %} and search results from Bing (if enabled by your administrator). +When you use the `@github` chat participant, {% data variables.copilot.copilot_chat_short %} will be able to gather context from your code stored on {% data variables.product.github %} and search results from Bing (if enabled by your administrator). {% data reusables.rai.copilot.copilot-chat-ide-output-formatting %} @@ -39,9 +39,9 @@ When you use the `@github` chat participant, {% data variables.product.prodname_ ### Answering coding questions -You can ask {% data variables.product.prodname_copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. +You can ask {% data variables.copilot.copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. -The response generated by {% data variables.product.prodname_copilot_chat_short %} will use the model's training data set to answer your questions. +The response generated by {% data variables.copilot.copilot_chat_short %} will use the model's training data set to answer your questions. When you use the `@github` chat participant, the response generated may additionally use search results from Bing, code in your repositories, and Markdown documentation in your knowledge bases. @@ -71,7 +71,7 @@ This can be a useful tool for programmers, as it can provide guidance and suppor {% data reusables.rai.copilot.copilot-chat-ide-response-generation %} -When you use the `@github` chat participant, {% data variables.product.prodname_copilot_chat_short %} will be able to gather context from your code stored on {% data variables.product.github %} and search results from Bing (if enabled by your administrator). +When you use the `@github` chat participant, {% data variables.copilot.copilot_chat_short %} will be able to gather context from your code stored on {% data variables.product.github %} and search results from Bing (if enabled by your administrator). {% data reusables.rai.copilot.copilot-chat-ide-output-formatting %} @@ -81,9 +81,9 @@ When you use the `@github` chat participant, {% data variables.product.prodname_ ### Answering coding questions -You can ask {% data variables.product.prodname_copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. +You can ask {% data variables.copilot.copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. -The response generated by {% data variables.product.prodname_copilot_chat_short %} will use the model's training data set to answer your questions. +The response generated by {% data variables.copilot.copilot_chat_short %} will use the model's training data set to answer your questions. This can be a useful tool for programmers, as it can provide guidance and support for common coding tasks and challenges. @@ -115,9 +115,9 @@ This can be a useful tool for programmers, as it can provide guidance and suppor ### Answering coding questions -You can ask {% data variables.product.prodname_copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. +You can ask {% data variables.copilot.copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. -The response generated by {% data variables.product.prodname_copilot_chat_short %} will use the model's training data set to answer your questions. +The response generated by {% data variables.copilot.copilot_chat_short %} will use the model's training data set to answer your questions. This can be a useful tool for programmers, as it can provide guidance and support for common coding tasks and challenges. @@ -145,26 +145,26 @@ This can be a useful tool for programmers, as it can provide guidance and suppor {% data reusables.rai.copilot.copilot-chat-ide-output-formatting %} -## Use cases for {% data variables.product.prodname_copilot_chat %} +## Use cases for {% data variables.copilot.copilot_chat %} -{% data variables.product.prodname_copilot_chat %} can provide coding assistance in a variety of scenarios. +{% data variables.copilot.copilot_chat %} can provide coding assistance in a variety of scenarios. {% data reusables.rai.copilot.copilot-chat-generate-test-cases %} ### Explaining code and suggesting improvements -{% data variables.product.prodname_copilot_chat_short %} can help explain the code in a file by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, you can ask {% data variables.product.prodname_copilot_short %} to explain a named function in the currently displayed file and {% data variables.product.prodname_copilot_chat_short %} will generate a natural language description of what the code does. This can include information such as the function's input and output parameters, and its dependencies. +{% data variables.copilot.copilot_chat_short %} can help explain the code in a file by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, you can ask {% data variables.product.prodname_copilot_short %} to explain a named function in the currently displayed file and {% data variables.copilot.copilot_chat_short %} will generate a natural language description of what the code does. This can include information such as the function's input and output parameters, and its dependencies. -{% data variables.product.prodname_copilot_chat_short %} can also suggest potential improvements to the code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. +{% data variables.copilot.copilot_chat_short %} can also suggest potential improvements to the code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. -By generating explanations and suggesting related documentation, {% data variables.product.prodname_copilot_chat_short %} may help you to understand the code in a project, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.product.prodname_copilot_chat_short %}'s output. +By generating explanations and suggesting related documentation, {% data variables.copilot.copilot_chat_short %} may help you to understand the code in a project, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.copilot.copilot_chat_short %}'s output. {% data reusables.rai.copilot.copilot-chat-propose-fixes %} ### Answering coding questions -You can ask {% data variables.product.prodname_copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. +You can ask {% data variables.copilot.copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. -The response generated by {% data variables.product.prodname_copilot_chat_short %} will use the model's training data set to answer your questions. +The response generated by {% data variables.copilot.copilot_chat_short %} will use the model's training data set to answer your questions. This can be a useful tool for programmers, as it can provide guidance and support for common coding tasks and challenges. diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-github-desktop.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-github-desktop.md index 8dedb49673..1ae7b99170 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-github-desktop.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-github-desktop.md @@ -1,7 +1,7 @@ --- title: Responsible use of GitHub Copilot in GitHub Desktop shortTitle: Copilot in GitHub Desktop -intro: 'Learn how to use {% data variables.product.prodname_copilot_desktop_short %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_desktop_short %} responsibly by understanding its purposes, capabilities, and limitations.' product: '{% data reusables.gated-features.copilot-in-desktop %}' versions: feature: copilot @@ -10,7 +10,7 @@ topics: type: rai --- -## About {% data variables.product.prodname_copilot_desktop_short %} +## About {% data variables.copilot.copilot_desktop_short %} {% data variables.product.prodname_copilot_short %} commit message generation is an AI-powered feature that allows you to create a commit message summary (title) and description based on the changes you've selected to commit through {% data variables.product.prodname_desktop %}. @@ -22,29 +22,29 @@ The only supported language for {% data variables.product.prodname_copilot_short When you click on the copilot button, a call is generated to the {% data variables.product.prodname_copilot_short %} API to generate suggested text to insert into the summary and description boxes. The text complete request includes information from the selected changes in the different files of the repository in a prompt that requests {% data variables.product.prodname_copilot_short %} to generate a suggestion for a commit message that accurately describes those changes. The response is then used to fill the summary and description boxes. You can then review the suggested message, edit it if needed, and then make a commit with it. -## Use cases for {% data variables.product.prodname_copilot_desktop_short %} +## Use cases for {% data variables.copilot.copilot_desktop_short %} -{% data variables.product.prodname_copilot_desktop_short %} aims to streamline the author workflow so that they can save time and maintain clear commit histories when summarizing their changes. For many users, this could be helpful for saving time when committing large changes. Authors can review, edit, or regenerate suggestions before finalizing and manually pushing the commits to a branch. They can also select specific lines of code or files for better context understanding to increase accuracy. The feature is integrated seamlessly into the commit workflow for a smoother experience. +{% data variables.copilot.copilot_desktop_short %} aims to streamline the author workflow so that they can save time and maintain clear commit histories when summarizing their changes. For many users, this could be helpful for saving time when committing large changes. Authors can review, edit, or regenerate suggestions before finalizing and manually pushing the commits to a branch. They can also select specific lines of code or files for better context understanding to increase accuracy. The feature is integrated seamlessly into the commit workflow for a smoother experience. -## Improving {% data variables.product.prodname_copilot_desktop_short %} +## Improving {% data variables.copilot.copilot_desktop_short %} -To enhance the experience and address some of the limitations of {% data variables.product.prodname_copilot_desktop_short %}, there are various measures that you can adopt. For more information about the limitations, see [Limitations of {% data variables.product.prodname_copilot_desktop_short %}](#limitations-of-copilot-in-github-desktop). +To enhance the experience and address some of the limitations of {% data variables.copilot.copilot_desktop_short %}, there are various measures that you can adopt. For more information about the limitations, see [Limitations of {% data variables.copilot.copilot_desktop_short %}](#limitations-of-copilot-in-github-desktop). -### Use {% data variables.product.prodname_copilot_desktop %} as a tool, not a replacement +### Use {% data variables.copilot.copilot_desktop %} as a tool, not a replacement The feature is intended to supplement rather than replace a human's work to draft commit messages. The quality of the commit message suggestions will depend on the quality of the code changes and the context in the changed files. We encourage you to select specific lines of code changes or files for better context understanding and increased accuracy. It remains your responsibility to review and assess the accuracy of information in the commits you create. ### Provide feedback -If you encounter any issues or limitations with {% data variables.product.prodname_copilot_desktop_short %}, you can provide feedback by creating an issue in the [{% data variables.product.prodname_desktop %} open source repository](https://github.com/desktop/desktop/issues/new?template=bug_report.yaml ). This can help the developers to improve the tool and address any concerns or limitations. +If you encounter any issues or limitations with {% data variables.copilot.copilot_desktop_short %}, you can provide feedback by creating an issue in the [{% data variables.product.prodname_desktop %} open source repository](https://github.com/desktop/desktop/issues/new?template=bug_report.yaml ). This can help the developers to improve the tool and address any concerns or limitations. -## Limitations of {% data variables.product.prodname_copilot_desktop_short %} +## Limitations of {% data variables.copilot.copilot_desktop_short %} -Depending on factors such as your operating system and input data, you may encounter different levels of accuracy when using {% data variables.product.prodname_copilot_desktop_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.product.prodname_copilot_desktop_short %}. +Depending on factors such as your operating system and input data, you may encounter different levels of accuracy when using {% data variables.copilot.copilot_desktop_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.copilot.copilot_desktop_short %}. ### Limited scope -{% data variables.product.prodname_copilot_desktop_short %} operates within defined boundaries and might struggle with intricate code changes, short diff windows, or recently developed programming languages. The quality of suggestions it provides can be influenced by the availability and diversity of training data. For instance, inquiries about well-documented languages like Python may yield more accurate responses compared to questions about less popular languages. +{% data variables.copilot.copilot_desktop_short %} operates within defined boundaries and might struggle with intricate code changes, short diff windows, or recently developed programming languages. The quality of suggestions it provides can be influenced by the availability and diversity of training data. For instance, inquiries about well-documented languages like Python may yield more accurate responses compared to questions about less popular languages. ### Inaccurate responses @@ -60,7 +60,7 @@ Because a commit message is a summary of the changes that were made in a reposit ### Potential biases and errors -{% data variables.product.prodname_copilot_desktop %} training data is sourced from existing online sources. It’s important to note that these sources may include biases and errors of the individuals who contributed to the training data. {% data variables.product.prodname_copilot_desktop_short %} may inadvertently perpetuate these biases and errors. +{% data variables.copilot.copilot_desktop %} training data is sourced from existing online sources. It’s important to note that these sources may include biases and errors of the individuals who contributed to the training data. {% data variables.copilot.copilot_desktop_short %} may inadvertently perpetuate these biases and errors. ## Further reading diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-the-cli.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-the-cli.md index 7d0f6ad17a..fa688fe5f1 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-the-cli.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-in-the-cli.md @@ -1,7 +1,7 @@ --- title: Responsible use of GitHub Copilot in the CLI shortTitle: Copilot in the CLI -intro: 'Learn how to use {% data variables.product.prodname_copilot_cli %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_cli %} responsibly by understanding its purposes, capabilities, and limitations.' product: '{% data reusables.gated-features.copilot-in-cli %}' versions: feature: copilot-in-the-cli @@ -13,17 +13,17 @@ redirect_from: - /copilot/github-copilot-in-the-cli/about-github-copilot-in-the-cli --- -## About {% data variables.product.prodname_copilot_cli %} +## About {% data variables.copilot.copilot_cli %} -{% data variables.product.prodname_copilot_cli %} provides a chat-like interface in the terminal that allows you to ask questions about the command line. You can ask {% data variables.product.prodname_copilot %} to provide either command suggestions or explanations of given commands. +{% data variables.copilot.copilot_cli %} provides a chat-like interface in the terminal that allows you to ask questions about the command line. You can ask {% data variables.product.prodname_copilot %} to provide either command suggestions or explanations of given commands. -The only supported language for {% data variables.product.prodname_copilot_cli %} is English. +The only supported language for {% data variables.copilot.copilot_cli %} is English. -{% data variables.product.prodname_copilot_cli %} parses your question and provides an answer using a combination of natural language processing and machine learning. This process can be broken down into a number of steps. +{% data variables.copilot.copilot_cli %} parses your question and provides an answer using a combination of natural language processing and machine learning. This process can be broken down into a number of steps. ### Input processing -The input prompt from the user is pre-processed by {% data variables.product.prodname_copilot_cli %} and sent to a {% data variables.product.company_short %} service that is connected to a large language model that then generates a response based on the context and prompt. User input can take the form of natural language prompts or questions. It may also include choosing the command type they would like to ask about from a predetermined list, i.e. generic shell command, Git (`git`), or {% data variables.product.prodname_cli %} (`gh`). The system is only intended to respond to command line-related questions. For more information about {% data variables.product.prodname_cli %}, see [AUTOTITLE](/github-cli/github-cli/about-github-cli). +The input prompt from the user is pre-processed by {% data variables.copilot.copilot_cli %} and sent to a {% data variables.product.company_short %} service that is connected to a large language model that then generates a response based on the context and prompt. User input can take the form of natural language prompts or questions. It may also include choosing the command type they would like to ask about from a predetermined list, i.e. generic shell command, Git (`git`), or {% data variables.product.prodname_cli %} (`gh`). The system is only intended to respond to command line-related questions. For more information about {% data variables.product.prodname_cli %}, see [AUTOTITLE](/github-cli/github-cli/about-github-cli). ### Language model analysis @@ -35,65 +35,65 @@ The language model generates a response based on its analysis of the input promp ### Output formatting -The response generated by {% data variables.product.prodname_copilot_cli %} is formatted and presented to you. {% data variables.product.prodname_copilot_cli_short %} uses syntax highlighting, indentation, and other formatting features to add clarity to the generated response. +The response generated by {% data variables.copilot.copilot_cli %} is formatted and presented to you. {% data variables.copilot.copilot_cli_short %} uses syntax highlighting, indentation, and other formatting features to add clarity to the generated response. -{% data variables.product.prodname_copilot_cli_short %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_cli %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. {% data variables.product.prodname_copilot_cli_short %} also provides an optional feedback mechanism to rate suggestions, which helps us improve the tool for the future. For more information, see [Improving {% data variables.product.prodname_copilot_cli %}](#improving-github-copilot-in-the-cli). +{% data variables.copilot.copilot_cli_short %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.copilot.copilot_cli %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. {% data variables.copilot.copilot_cli_short %} also provides an optional feedback mechanism to rate suggestions, which helps us improve the tool for the future. For more information, see [Improving {% data variables.copilot.copilot_cli %}](#improving-github-copilot-in-the-cli). -## Use cases for {% data variables.product.prodname_copilot_cli %} +## Use cases for {% data variables.copilot.copilot_cli %} -{% data variables.product.prodname_copilot_cli %} can help you by providing either command suggestions or explanations of given commands. +{% data variables.copilot.copilot_cli %} can help you by providing either command suggestions or explanations of given commands. ### Find the right command to perform a task -{% data variables.product.prodname_copilot_cli %} aims to suggest commands that help you perform the tasks you’re trying to complete. To help {% data variables.product.prodname_copilot_cli_short %} provide better suggestions, you can specify the type of command you are looking for (generic, `git`, or `gh`). If the result isn’t quite what you’re looking for, you can keep revising your question until the returned command meets your expectations. Once you’ve generated the perfect command for your task, you can copy it to your clipboard to run it wherever you need, or you can ask {% data variables.product.prodname_copilot_cli %} to execute the command for you. +{% data variables.copilot.copilot_cli %} aims to suggest commands that help you perform the tasks you’re trying to complete. To help {% data variables.copilot.copilot_cli_short %} provide better suggestions, you can specify the type of command you are looking for (generic, `git`, or `gh`). If the result isn’t quite what you’re looking for, you can keep revising your question until the returned command meets your expectations. Once you’ve generated the perfect command for your task, you can copy it to your clipboard to run it wherever you need, or you can ask {% data variables.copilot.copilot_cli %} to execute the command for you. ### Explain an unfamiliar command -{% data variables.product.prodname_copilot_cli %} can help explain a command that you asked about by generating a natural language description of the command's functionality and purpose. This can be useful if you want to understand the command's behavior for the specific example provided without having to read or search through the command's documentation. The explanation can include information such as the command's input and output parameters and examples of how it could be used. +{% data variables.copilot.copilot_cli %} can help explain a command that you asked about by generating a natural language description of the command's functionality and purpose. This can be useful if you want to understand the command's behavior for the specific example provided without having to read or search through the command's documentation. The explanation can include information such as the command's input and output parameters and examples of how it could be used. -By generating explanations, {% data variables.product.prodname_copilot_cli %} may help you to understand the command better, leading to enhanced learning, improved productivity, and less context switching. However, it's important to note that the generated explanations may not always be accurate or complete, so you'll need to review, and occasionally correct, its output. You remain responsible for ensuring the accuracy and appropriateness of the commands you run in the command line. +By generating explanations, {% data variables.copilot.copilot_cli %} may help you to understand the command better, leading to enhanced learning, improved productivity, and less context switching. However, it's important to note that the generated explanations may not always be accurate or complete, so you'll need to review, and occasionally correct, its output. You remain responsible for ensuring the accuracy and appropriateness of the commands you run in the command line. -## Improving {% data variables.product.prodname_copilot_cli %} +## Improving {% data variables.copilot.copilot_cli %} -To enhance the experience and address some of the limitations of {% data variables.product.prodname_copilot_cli %}, there are various measures that you can adopt. For more information about the limitations, see [Limitations of {% data variables.product.prodname_copilot_cli %}](#limitations-of-github-copilot-in-the-cli). +To enhance the experience and address some of the limitations of {% data variables.copilot.copilot_cli %}, there are various measures that you can adopt. For more information about the limitations, see [Limitations of {% data variables.copilot.copilot_cli %}](#limitations-of-github-copilot-in-the-cli). -### Use {% data variables.product.prodname_copilot_cli %} as a tool, not a replacement +### Use {% data variables.copilot.copilot_cli %} as a tool, not a replacement -While {% data variables.product.prodname_copilot_cli %} can be a powerful tool for enhancing understanding of commands and the command line, it is important to use it as a tool rather than a replacement for human programming. You should always review and verify the command generated by {% data variables.product.prodname_copilot_cli_short %} to ensure that it meets your requirements and is free of errors or security concerns. +While {% data variables.copilot.copilot_cli %} can be a powerful tool for enhancing understanding of commands and the command line, it is important to use it as a tool rather than a replacement for human programming. You should always review and verify the command generated by {% data variables.copilot.copilot_cli_short %} to ensure that it meets your requirements and is free of errors or security concerns. ### Provide feedback -If you encounter any issues or limitations with {% data variables.product.prodname_copilot_cli %}, we recommend that you provide feedback by selecting the "Rate response" option in {% data variables.product.prodname_copilot_cli %}. This can help the developers to improve the tool and address any concerns or limitations. +If you encounter any issues or limitations with {% data variables.copilot.copilot_cli %}, we recommend that you provide feedback by selecting the "Rate response" option in {% data variables.copilot.copilot_cli %}. This can help the developers to improve the tool and address any concerns or limitations. -## Limitations of {% data variables.product.prodname_copilot_cli %} +## Limitations of {% data variables.copilot.copilot_cli %} -Depending on factors such as your operating system and input data, you may encounter different levels of accuracy when using {% data variables.product.prodname_copilot_cli %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.product.prodname_copilot_cli %}. +Depending on factors such as your operating system and input data, you may encounter different levels of accuracy when using {% data variables.copilot.copilot_cli %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.copilot.copilot_cli %}. ### Limited scope -{% data variables.product.prodname_copilot_cli %} operates within defined boundaries and might struggle with intricate commands, less common ones, or more recently developed tools. The quality of suggestions it provides for each language can be influenced by the availability and diversity of training data. For instance, inquiries about well-documented commands and tools like Git may yield more accurate responses compared to questions about more obscure command line tools. +{% data variables.copilot.copilot_cli %} operates within defined boundaries and might struggle with intricate commands, less common ones, or more recently developed tools. The quality of suggestions it provides for each language can be influenced by the availability and diversity of training data. For instance, inquiries about well-documented commands and tools like Git may yield more accurate responses compared to questions about more obscure command line tools. ### Potential biases and errors -{% data variables.product.prodname_copilot_cli %}'s training data is sourced from existing online sources. It’s important to note that these sources may include biases and errors of the individuals who contributed to the training data. {% data variables.product.prodname_copilot_cli_short %} may inadvertently perpetuate these biases and errors. Additionally, {% data variables.product.prodname_copilot_cli %} might perform differently depending on the scripting languages or scripting styles, potentially resulting in suboptimal or incomplete command suggestions or explanations. +{% data variables.copilot.copilot_cli %}'s training data is sourced from existing online sources. It’s important to note that these sources may include biases and errors of the individuals who contributed to the training data. {% data variables.copilot.copilot_cli_short %} may inadvertently perpetuate these biases and errors. Additionally, {% data variables.copilot.copilot_cli %} might perform differently depending on the scripting languages or scripting styles, potentially resulting in suboptimal or incomplete command suggestions or explanations. ### Inaccurate responses -{% data variables.product.prodname_copilot_cli %} may generate seemingly valid but syntactically or semantically incorrect commands. To avoid issues, always carefully review and verify suggestions, especially for critical or destructive tasks such as deleting content. Ensure generated commands align with best practices and fit your workflow. +{% data variables.copilot.copilot_cli %} may generate seemingly valid but syntactically or semantically incorrect commands. To avoid issues, always carefully review and verify suggestions, especially for critical or destructive tasks such as deleting content. Ensure generated commands align with best practices and fit your workflow. ### Risk management and user accountability in command execution -Additional caution is required with the addition of the functionality to ask {% data variables.product.prodname_copilot_cli %} to execute a command, particularly regarding the potential destructiveness of some suggested commands. You may encounter commands for file deletion or hard drive formatting, which can cause problems if used incorrectly. While such commands may be necessary in certain scenarios, you need to be careful when accepting and running these commands. +Additional caution is required with the addition of the functionality to ask {% data variables.copilot.copilot_cli %} to execute a command, particularly regarding the potential destructiveness of some suggested commands. You may encounter commands for file deletion or hard drive formatting, which can cause problems if used incorrectly. While such commands may be necessary in certain scenarios, you need to be careful when accepting and running these commands. -Additionally, you are ultimately responsible for the commands executed by {% data variables.product.prodname_copilot_cli %}. It is entirely your decision whether to use commands generated by {% data variables.product.prodname_copilot_cli %}. Despite the presence of fail-safes and safety mechanisms, you must understand that executing commands carries inherent risks. {% data variables.product.prodname_copilot_cli %} provides a powerful tool set, but you should approach its recommendations with caution and ensure that commands align with your intentions and requirements. +Additionally, you are ultimately responsible for the commands executed by {% data variables.copilot.copilot_cli %}. It is entirely your decision whether to use commands generated by {% data variables.copilot.copilot_cli %}. Despite the presence of fail-safes and safety mechanisms, you must understand that executing commands carries inherent risks. {% data variables.copilot.copilot_cli %} provides a powerful tool set, but you should approach its recommendations with caution and ensure that commands align with your intentions and requirements. ### Inaccurate responses to non-coding topics -{% data variables.product.prodname_copilot_cli %} is not designed to answer questions beyond the scope of command line-related tasks. As a result, its responses might not consistently offer accuracy or assistance when confronted with questions unrelated to coding or general command line use. When you inquire about non-coding topics, {% data variables.product.prodname_copilot_cli %} may express its inability to provide a meaningful response. +{% data variables.copilot.copilot_cli %} is not designed to answer questions beyond the scope of command line-related tasks. As a result, its responses might not consistently offer accuracy or assistance when confronted with questions unrelated to coding or general command line use. When you inquire about non-coding topics, {% data variables.copilot.copilot_cli %} may express its inability to provide a meaningful response. ### Differing performance based on natural language -{% data variables.product.prodname_copilot_cli %} has been trained on natural language content written predominantly in English. As a result, you may notice differing performance when providing {% data variables.product.prodname_copilot_cli %} with natural language input prompts in languages other than English. +{% data variables.copilot.copilot_cli %} has been trained on natural language content written predominantly in English. As a result, you may notice differing performance when providing {% data variables.copilot.copilot_cli %} with natural language input prompts in languages other than English. ## Further reading diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-pull-request-summaries.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-pull-request-summaries.md index 48ca8a4ae6..c95b77437f 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-pull-request-summaries.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-pull-request-summaries.md @@ -1,7 +1,7 @@ --- title: Responsible use of GitHub Copilot pull request summaries shortTitle: Pull request summaries -intro: 'Learn how to use {% data variables.product.prodname_copilot_for_prs %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_for_prs %} responsibly by understanding its purposes, capabilities, and limitations.' versions: feature: copilot topics: @@ -11,15 +11,15 @@ redirect_from: - /copilot/github-copilot-enterprise/copilot-pull-request-summaries/about-copilot-pull-request-summaries --- -## About {% data variables.product.prodname_copilot_for_prs %} +## About {% data variables.copilot.copilot_for_prs %} -{% data variables.product.prodname_copilot_for_prs %} is an AI-powered feature that allows you to create a summary of the changes that were made in a pull request, which files they impact, and what a reviewer should focus on when they conduct their review. +{% data variables.copilot.copilot_for_prs %} is an AI-powered feature that allows you to create a summary of the changes that were made in a pull request, which files they impact, and what a reviewer should focus on when they conduct their review. When a user requests a summary, {% data variables.product.prodname_copilot_short %} scans through the pull request and provides an overview of the changes made in prose, as well as a bulleted list of changes with the files that they impact. -The only supported language for {% data variables.product.prodname_copilot_for_prs %} is English. +The only supported language for {% data variables.copilot.copilot_for_prs %} is English. -{% data variables.product.prodname_copilot_for_prs %} uses a simple-prompt flow leveraging the {% data variables.product.prodname_copilot_short %} API, with no additional trained models. This utilizes the generic large language model. +{% data variables.copilot.copilot_for_prs %} uses a simple-prompt flow leveraging the {% data variables.product.prodname_copilot_short %} API, with no additional trained models. This utilizes the generic large language model. ### Response generation @@ -40,13 +40,13 @@ Larger pull requests can take a couple minutes for {% data variables.product.pro ## Use case for pull request summaries -The goal of {% data variables.product.prodname_copilot_for_prs %} is to help optimize an author's ability to quickly provide context when they request a human review that requires sharing context of the changes that were made. It may help increase developer productivity by reducing the time taken to open a pull request. +The goal of {% data variables.copilot.copilot_for_prs %} is to help optimize an author's ability to quickly provide context when they request a human review that requires sharing context of the changes that were made. It may help increase developer productivity by reducing the time taken to open a pull request. For many users, it could provide more helpful context for the changes that were made within a pull request than would normally be available. ## Improving performance of pull request summaries -### Use {% data variables.product.prodname_copilot_for_prs %} as a tool, not a replacement +### Use {% data variables.copilot.copilot_for_prs %} as a tool, not a replacement The feature is intended to supplement rather than replace a human's work to add context, and we encourage you to continue adding useful context and let {% data variables.product.prodname_copilot_short %} do the busy work of parsing the code and linking to specific files. It remains your responsibility to review and assess the accuracy of information in a pull request that you create. @@ -54,7 +54,7 @@ The feature is intended to supplement rather than replace a human's work to add {% data reusables.rai.copilot-dotcom-feedback-collection %} -If you encounter any issues or limitations with {% data variables.product.prodname_copilot_for_prs %}, you can provide feedback by clicking the "Bad summary" button (a thumbs down icon), which is displayed below the text box after a summary is generated and before you click **Create pull request** or **Update comment**. +If you encounter any issues or limitations with {% data variables.copilot.copilot_for_prs %}, you can provide feedback by clicking the "Bad summary" button (a thumbs down icon), which is displayed below the text box after a summary is generated and before you click **Create pull request** or **Update comment**. ![Screenshot of the bottom of a pull request comment. The feedback icons, thumbs up and thumbs down, are highlighted with a dark orange outline.](/assets/images/help/copilot/copilot-summary-feedback.png) @@ -62,7 +62,7 @@ After you rate a summary as good or bad, you can provide written feedback by cli ## Limitations of pull request summaries -Currently, our team is aware that there are limitations to this feature. Many of them are expected in leveraging our {% data variables.product.prodname_copilot_short %} API; however, there are a few that are specific to {% data variables.product.prodname_copilot_for_prs %} which pertain to limited scope, longer processing times, and inaccurate responses. We also note that users should expect terms used in their PR to appear in the AI-generated summary. This feature has been subject to RAI Red Teaming and we will continue to monitor the efficacy and safety of the feature over time. For more information, see [Microsoft AI Red Team building future of safer AI](https://www.microsoft.com/en-us/security/blog/2023/08/07/microsoft-ai-red-team-building-future-of-safer-ai/) on the Microsoft security blog. +Currently, our team is aware that there are limitations to this feature. Many of them are expected in leveraging our {% data variables.product.prodname_copilot_short %} API; however, there are a few that are specific to {% data variables.copilot.copilot_for_prs %} which pertain to limited scope, longer processing times, and inaccurate responses. We also note that users should expect terms used in their PR to appear in the AI-generated summary. This feature has been subject to RAI Red Teaming and we will continue to monitor the efficacy and safety of the feature over time. For more information, see [Microsoft AI Red Team building future of safer AI](https://www.microsoft.com/en-us/security/blog/2023/08/07/microsoft-ai-red-team-building-future-of-safer-ai/) on the Microsoft security blog. ### Limited scope diff --git a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-text-completion.md b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-text-completion.md index 8ba8c64d13..ea654221b2 100644 --- a/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-text-completion.md +++ b/content/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-text-completion.md @@ -1,10 +1,10 @@ --- title: Responsible use of GitHub Copilot text completion shortTitle: Copilot text completion -intro: 'Learn how to use {% data variables.product.prodname_copilot_autocomplete_pr %} responsibly by understanding its purposes, capabilities, and limitations.' +intro: 'Learn how to use {% data variables.copilot.copilot_autocomplete_pr %} responsibly by understanding its purposes, capabilities, and limitations.' versions: feature: copilot -permissions: 'Members of an enterprise with a subscription to {% data variables.product.prodname_copilot_enterprise %}' +permissions: 'Members of an enterprise with a subscription to {% data variables.copilot.copilot_enterprise %}' topics: - Copilot type: rai @@ -16,21 +16,21 @@ type: rai {% endif %} -## About {% data variables.product.prodname_copilot_autocomplete_pr %} +## About {% data variables.copilot.copilot_autocomplete_pr %} -{% data variables.product.prodname_copilot_autocomplete_pr %} is an AI-powered feature that allows users to more easily write pull request descriptions by suggesting text as you type. +{% data variables.copilot.copilot_autocomplete_pr %} is an AI-powered feature that allows users to more easily write pull request descriptions by suggesting text as you type. When you pause briefly while typing a summary, {% data variables.product.prodname_copilot_short %} scans through the pull request and provides suggested prose, attempting to finish your thought. -The only supported language for {% data variables.product.prodname_copilot_autocomplete_pr %} is English. +The only supported language for {% data variables.copilot.copilot_autocomplete_pr %} is English. -{% data variables.product.prodname_copilot_autocomplete_pr %} uses a simple-prompt flow leveraging the {% data variables.product.prodname_copilot_short %} API, utilizing the generic large language model, with no additional trained models. +{% data variables.copilot.copilot_autocomplete_pr %} uses a simple-prompt flow leveraging the {% data variables.product.prodname_copilot_short %} API, utilizing the generic large language model, with no additional trained models. When you pause during typing the pull request description, a call is generated to the {% data variables.product.prodname_copilot_short %} API to generate suggested text to insert into the description at the current cursor position. The text complete request includes information from the pull request, including the pull request title, any text already in the description, the pull request commit titles, partial raw diffs, and recently viewed pull request and issue titles in a prompt that requests {% data variables.product.prodname_copilot_short %} to generate a suggestion for the next words you are likely to type. The response is then displayed as grayed out text following the cursor. You can accept the suggested text by pressing the tab key, or reject the suggestion by simply continuing to type, or moving the cursor focus out of the description field. ## Use case for pull request text complete -The goal of {% data variables.product.prodname_copilot_autocomplete_pr %} is to help the pull request author to quickly provide context to the human reviewers of the pull request. When reviewing a pull request it is valuable to understand context such as why changes are being requested and how the pull request makes those changes. It may help increase developer productivity by reducing the time taken to open a pull request. +The goal of {% data variables.copilot.copilot_autocomplete_pr %} is to help the pull request author to quickly provide context to the human reviewers of the pull request. When reviewing a pull request it is valuable to understand context such as why changes are being requested and how the pull request makes those changes. It may help increase developer productivity by reducing the time taken to open a pull request. ## Improving the performance of pull request text complete @@ -38,7 +38,7 @@ The feature is intended to supplement rather than replace a human's work adding ## Limitations of pull request text complete -Currently, our team is aware that there are limitations to this feature. Many of them are expected in leveraging our {% data variables.product.prodname_copilot_short %} API; however, there are a few that are specific to {% data variables.product.prodname_copilot_autocomplete_pr %} which pertain to limited scope for very large pull requests, and potentially inaccurate responses. We also note that users should expect terms used in their pull request to appear in the AI-generated suggestions. +Currently, our team is aware that there are limitations to this feature. Many of them are expected in leveraging our {% data variables.product.prodname_copilot_short %} API; however, there are a few that are specific to {% data variables.copilot.copilot_autocomplete_pr %} which pertain to limited scope for very large pull requests, and potentially inaccurate responses. We also note that users should expect terms used in their pull request to appear in the AI-generated suggestions. This feature has been subject to RAI Red Teaming and we will continue to monitor the efficacy and safety of the feature over time. For more information, see [Microsoft AI Red Team building future of safer AI](https://www.microsoft.com/en-us/security/blog/2023/08/07/microsoft-ai-red-team-building-future-of-safer-ai/) on the Microsoft security blog. diff --git a/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/managing-your-companys-spending-on-github-copilot.md b/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/managing-your-companys-spending-on-github-copilot.md index 83e4171044..4d0d95072c 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/managing-your-companys-spending-on-github-copilot.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/managing-your-companys-spending-on-github-copilot.md @@ -7,7 +7,7 @@ versions: topics: - Copilot permissions: Enterprise owners and billing managers -product: '{% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}' +product: '{% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %}' redirect_from: - /copilot/rolling-out-github-copilot-at-scale/managing-your-companys-spending-on-github-copilot --- @@ -32,7 +32,7 @@ We recommend that you identify the people with this role and communicate with th Premium requests over the allowance are rejected unless you have set a budget. Depending on the type of development tasks your developers use {% data variables.product.prodname_copilot_short %} for, you may find developers need to make more premium requests than the allowance included in your plan. -Premium requests over the allowance are charged at a rate of {% data variables.copilot.additional_premium_requests %} per request, with an additional multiplier applied to certain models. You can also increase your monthly allowance by upgrading to {% data variables.product.prodname_copilot_enterprise_short %}. +Premium requests over the allowance are charged at a rate of {% data variables.copilot.additional_premium_requests %} per request, with an additional multiplier applied to certain models. You can also increase your monthly allowance by upgrading to {% data variables.copilot.copilot_enterprise_short %}. For pricing details and a list of available models, see [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot#comparing-copilot-plans). @@ -68,7 +68,7 @@ You can view a CSV report that shows the cumulative number of premium requests p * Understand if developers are frequently hitting the limit and would benefit from you enabling additional premium requests or upgrading your plan. * Identify users who are making a large number of premium requests over the limit, and follow up to the users to understand their use cases and requirements. -* After enabling additional premium requests, track usage to determine if it would be more cost effective to upgrade to {% data variables.product.prodname_copilot_enterprise_short %}. +* After enabling additional premium requests, track usage to determine if it would be more cost effective to upgrade to {% data variables.copilot.copilot_enterprise_short %}. You can download the report for an enterprise account, or for an organization that is not part of an enterprise. @@ -80,7 +80,7 @@ You can download the report for an enterprise account, or for an organization th With {% data variables.product.github %}'s new billing platform, you can create cost centers to map spending to individual business units or groups of users. Cost centers allow you to track costs tied to different initiatives and charge the costs to specific areas of your business. -For example, if you were running a pilot program for {% data variables.product.prodname_copilot_enterprise %} for a group of employees, you might want to create a cost center to track their spending and set a budget independently of the rest of the company. +For example, if you were running a pilot program for {% data variables.copilot.copilot_enterprise %} for a group of employees, you might want to create a cost center to track their spending and set a budget independently of the rest of the company. ### Create a cost center @@ -111,7 +111,7 @@ With {% data variables.product.github %}'s new billing platform, you can underst 1. Go to your enterprise or organization account settings and click **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**. 1. In the left sidebar, click **Usage**. 1. In the "Metered usage" section, in the search field, enter `product:copilot`. To filter by cost center, add a query like `cost_center:ce-pilot-group`. -1. To understand spending differences between {% data variables.product.prodname_copilot_business_short %} and {% data variables.product.prodname_copilot_enterprise_short %} plans, select the **Group: None** dropdown menu and click **Group: SKU**. +1. To understand spending differences between {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %} plans, select the **Group: None** dropdown menu and click **Group: SKU**. ![Screenshot of the "Usage" page. A line chart tracks Copilot spending over the current month, grouped by SKU.](/assets/images/help/copilot/track-spending.png) diff --git a/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/reminding-inactive-users.md b/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/reminding-inactive-users.md index e068711fca..cb8d8affa9 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/reminding-inactive-users.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/reminding-inactive-users.md @@ -5,7 +5,7 @@ intro: 'Use the {% data variables.product.github %} API to identify inactive use versions: feature: copilot permissions: Organization owners and billing managers -product: '{% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}' +product: '{% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %}' topics: - Copilot allowTitleToDifferFromFilename: true @@ -72,7 +72,7 @@ To use this workflow: To create a variable, see [AUTOTITLE](/actions/writing-workflows/choosing-what-your-workflow-does/store-information-in-variables#creating-configuration-variables-for-a-repository). 1. Create a {% data variables.product.pat_generic %} with permission to call the [List all Copilot seat assignments for an organization](/rest/copilot/copilot-user-management#list-all-copilot-seat-assignments-for-an-organization) API endpoint. For example, create a fine-grained token with the following details: * **Resource owner**: The organization where you're looking for inactive users. - * **Organization permissions**: {% data variables.product.prodname_copilot_for_business %} (read-only). + * **Organization permissions**: {% data variables.copilot.copilot_for_business %} (read-only). To create a token, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token). 1. Save the access token as a {% data variables.product.prodname_actions %} secret in your repository or organization. Call the secret `COPILOT_LICENSE_READ`. @@ -85,7 +85,7 @@ To use this workflow: ### Example workflow ->[!NOTE] This example assumes you assign licenses through an organization. If you use a dedicated enterprise account for {% data variables.product.prodname_copilot_business_short %}, you will need to use different API endpoints. See [AUTOTITLE](/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts#automate-license-management). +>[!NOTE] This example assumes you assign licenses through an organization. If you use a dedicated enterprise account for {% data variables.copilot.copilot_business_short %}, you will need to use different API endpoints. See [AUTOTITLE](/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts#automate-license-management). diff --git a/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/setting-up-a-self-serve-process-for-github-copilot-licenses.md b/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/setting-up-a-self-serve-process-for-github-copilot-licenses.md index d444a42482..d4333b9136 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/setting-up-a-self-serve-process-for-github-copilot-licenses.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/setting-up-a-self-serve-process-for-github-copilot-licenses.md @@ -16,22 +16,22 @@ When you've enabled {% data variables.product.prodname_copilot %} in an organiza This article outlines two approaches your company can take: -* {% data variables.product.github %}'s **request access** feature for {% data variables.product.prodname_copilot_business_short %}, which requires no setup but does require explicit approvals from an administrator +* {% data variables.product.github %}'s **request access** feature for {% data variables.copilot.copilot_business_short %}, which requires no setup but does require explicit approvals from an administrator * Your own integration with **{% data variables.product.github %}'s API**, which allows you to create your own process with instant access ## Approach 1: Use {% data variables.product.github %}'s "request access" feature -If you have a {% data variables.product.prodname_copilot_business_short %} plan, members of an organization can request access to {% data variables.product.prodname_copilot %} on their settings page. Then, an organization owner must review and approve each request. +If you have a {% data variables.copilot.copilot_business_short %} plan, members of an organization can request access to {% data variables.product.prodname_copilot %} on their settings page. Then, an organization owner must review and approve each request. The process, which you should **communicate with users**, is as follows. -1. An organization or enterprise owner ensures {% data variables.product.prodname_copilot_business_short %} is enabled in the organization where you want to manage access. +1. An organization or enterprise owner ensures {% data variables.copilot.copilot_business_short %} is enabled in the organization where you want to manage access. 1. Members of the organization go to their personal settings page at https://github.com/settings/copilot and click **Ask admin for access**. 1. An organization owner reviews and approves requests on the "Requests from members" page in the organization. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/managing-requests-for-copilot-business-in-your-organization). You should set up a process where requests are reviewed regularly, so that interested users can get access to {% data variables.product.prodname_copilot_short %} quickly. -Users can also request access from organizations where {% data variables.product.prodname_copilot_business_short %} is not enabled. In this case, organization owners will be prompted to ask an enterprise owner to enable {% data variables.product.prodname_copilot_short %} for the organization. +Users can also request access from organizations where {% data variables.copilot.copilot_business_short %} is not enabled. In this case, organization owners will be prompted to ask an enterprise owner to enable {% data variables.product.prodname_copilot_short %} for the organization. ## Approach 2: Integrate with the API @@ -53,7 +53,7 @@ const response = await octokit.request('POST /orgs/{org}/copilot/billing/selecte }) ``` ->[!NOTE] This endpoint only works if you use organizations on {% data variables.product.github %}. If {% data variables.product.company_short %} has provided you with a **dedicated enterprise for managing {% data variables.product.prodname_copilot_business_short %} licenses**, you will need to add users to enterprise teams instead. To request API documentation, please contact your account manager. +>[!NOTE] This endpoint only works if you use organizations on {% data variables.product.github %}. If {% data variables.product.company_short %} has provided you with a **dedicated enterprise for managing {% data variables.copilot.copilot_business_short %} licenses**, you will need to add users to enterprise teams instead. To request API documentation, please contact your account manager. ### Example implementations diff --git a/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/driving-copilot-adoption-in-your-company.md b/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/driving-copilot-adoption-in-your-company.md index bb1efc4c6e..c7d6a6fcb1 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/driving-copilot-adoption-in-your-company.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/driving-copilot-adoption-in-your-company.md @@ -78,7 +78,7 @@ You can also use {% data variables.product.prodname_discussions %} to create a s ### Providing learning resources -In addition to your onboarding resources, you may want to provide a library of learning resources to help teams advance their skills with {% data variables.product.prodname_copilot_short %}. The {% data variables.product.prodname_copilot_chat_short %} Cookbook is a great place to start. The Cookbook is a collection of example prompts that you can use to learn how to ask {% data variables.product.prodname_copilot_short %} for help with a wide range of tasks. See [AUTOTITLE](/copilot/copilot-chat-cookbook). +In addition to your onboarding resources, you may want to provide a library of learning resources to help teams advance their skills with {% data variables.product.prodname_copilot_short %}. The {% data variables.copilot.copilot_chat_short %} Cookbook is a great place to start. The Cookbook is a collection of example prompts that you can use to learn how to ask {% data variables.product.prodname_copilot_short %} for help with a wide range of tasks. See [AUTOTITLE](/copilot/copilot-chat-cookbook). ### Communicating expectations diff --git a/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai.md b/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai.md index 0a113da7bb..52b5ba8e93 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai.md @@ -30,9 +30,9 @@ To hit a tight deadline, you're aiming to speed up each stage of the process, fo >[!NOTE] {% data variables.product.github %} is continually expanding its AI-powered platform. Some of the features described in this article are in {% data variables.release-phases.public_preview %}, and may not be enabled for enterprises by default. You will find resources for each feature in the [Get started with agentic AI](#get-started-with-agentic-ai) section. -## 1. Plan with {% data variables.product.prodname_copilot_chat_short %} +## 1. Plan with {% data variables.copilot.copilot_chat_short %} -1. To start planning, a product manager works with **{% data variables.product.prodname_copilot_chat_short %}** at `https://github.com/copilot`. +1. To start planning, a product manager works with **{% data variables.copilot.copilot_chat_short %}** at `https://github.com/copilot`. They ask {% data variables.product.prodname_copilot_short %} high-level questions to get a sense of the development work required for the new feature. To give {% data variables.product.prodname_copilot_short %} access to important context about the project, they upload mockup files and link to the repository where the codebase is stored. @@ -47,18 +47,18 @@ To hit a tight deadline, you're aiming to speed up each stage of the process, fo ## 2. Create with {% data variables.product.prodname_github_models %} and agent mode 1. The PM shares the results with the developer and asks the developer to start by finding the best AI model to provide the tailored umbrella recommendations, based on the cost and effectiveness of the models. -1. The developer asks **{% data variables.product.prodname_copilot_chat_short %}** to recommend several AI models for the job and the pros and cons of each. To provide useful context, they ask Copilot to consider the information in the [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task) {% data variables.product.prodname_docs %} article. +1. The developer asks **{% data variables.copilot.copilot_chat_short %}** to recommend several AI models for the job and the pros and cons of each. To provide useful context, they ask Copilot to consider the information in the [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task) {% data variables.product.prodname_docs %} article. 1. To settle on a model from the shortlist, the developer uses the **{% data variables.product.prodname_github_models %}** playground to compare results from the same prompt across models. They save time by testing models on a single platform, rather than needing to set up an API key for each model separately. ![Screenshot of the GitHub Models playground, with windows for sending prompts to two models side by side.](/assets/images/help/copilot/sdlc-guide/model-compare.png) 1. With the model decided, the developer opens the code in **{% data variables.product.prodname_vscode_shortname %}**. -1. The developer starts writing code for the new widget. To speed up their work, they use **{% data variables.product.prodname_copilot_chat_short %}** in "Ask" and "Edit" mode for syntax questions and high-level suggestions. +1. The developer starts writing code for the new widget. To speed up their work, they use **{% data variables.copilot.copilot_chat_short %}** in "Ask" and "Edit" mode for syntax questions and high-level suggestions. >[!TIP] > The developer works with AI in the way that works best for them, but your organization has control over the experience. For example, you can: > * **Control the models** that the developer can use for development work in order to meet compliance requirements and manage costs. - > * **Exclude certain files** from {% data variables.product.prodname_copilot_chat_short %}'s reach. + > * **Exclude certain files** from {% data variables.copilot.copilot_chat_short %}'s reach. > * **Save effective prompts** that have been tested with {% data variables.product.prodname_github_models %}, so other users can benefit. 1. When the developer has written some code, they switch to **agent mode** to ask {% data variables.product.prodname_copilot_short %} to refactor the code into several different functions for better readability. @@ -93,7 +93,7 @@ To hit a tight deadline, you're aiming to speed up each stage of the process, fo 1. After the release, the product manager collects customer feedback and identifies an opportunity to improve the widget's suggestions by switching to a more reliable API for weather data. They create an issue to implement this change, and **assign it to {% data variables.product.prodname_copilot_short %}** directly on {% data variables.product.github %}. 1. {% data variables.copilot.copilot_coding_agent %} works in the background and opens a pull request, which the product manager marks as ready for review. - ![Screenshot a pull request created by the Copilot coding agent.](/assets/images/help/copilot/sdlc-guide/agent-pr.png) + ![Screenshot of a pull request created by {% data variables.copilot.copilot_coding_agent %}.](/assets/images/help/copilot/sdlc-guide/agent-pr.png) 1. A developer reviews {% data variables.product.prodname_copilot_short %}'s pull request and leaves feedback, which {% data variables.product.prodname_copilot_short %} incorporates. Finally, the developer merges the pull request. @@ -105,10 +105,10 @@ To hit a tight deadline, you're aiming to speed up each stage of the process, fo 1. {% data variables.product.prodname_copilot_short %} works in the background and opens a pull request on {% data variables.product.github %}, ready for another developer to review. -## 6. Secure with {% data variables.product.prodname_copilot_autofix_short %} +## 6. Secure with {% data variables.copilot.copilot_autofix_short %} 1. An administrator has enabled {% data variables.product.prodname_code_scanning %} on the repository, and a {% data variables.product.prodname_code_scanning %} alert suggests a potential vulnerability in the code. -1. A security manager requests **{% data variables.product.prodname_copilot_autofix_short %}** to automatically suggest a fix for the vulnerability, which a developer reviews and approves. +1. A security manager requests **{% data variables.copilot.copilot_autofix_short %}** to automatically suggest a fix for the vulnerability, which a developer reviews and approves. ![Screenshot of a code scanning alert on GitHub.com. A button labeled "Generate fix" is outlined in orange.](/assets/images/help/copilot/sdlc-guide/autofix.png) @@ -126,14 +126,14 @@ To integrate agentic AI features effectively into your workstreams, you'll need | Feature | More information | | ------- | ---------------- | -| Immersive view of {% data variables.product.prodname_copilot_chat_short %} | [AUTOTITLE](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github#submitting-a-question-to-copilot-chat) | -| {% data variables.product.prodname_copilot_chat_short %} agent mode | [Use agent mode in VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) | +| Immersive view of {% data variables.copilot.copilot_chat_short %} | [AUTOTITLE](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github#submitting-a-question-to-copilot-chat) | +| {% data variables.copilot.copilot_chat_short %} agent mode | [Use agent mode in VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) | | Content exclusions | [AUTOTITLE](/copilot/managing-copilot/configuring-and-auditing-content-exclusion/excluding-content-from-github-copilot) | | MCP servers ({% data variables.release-phases.public_preview %}) | [AUTOTITLE](/copilot/customizing-copilot/extending-copilot-chat-with-mcp#configuring-mcp-servers-in-visual-studio-code) | | GitHub Models playground ({% data variables.release-phases.public_preview %}) | [AUTOTITLE](/github-models/prototyping-with-ai-models#experimenting-with-ai-models-in-the-playground) | | Custom instructions | [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot?tool=vscode) | | Copilot code review | [AUTOTITLE](/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot) | | {% data variables.copilot.copilot_coding_agent %} ({% data variables.release-phases.public_preview %}) | [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org) | -| {% data variables.product.prodname_copilot_autofix_short %} | [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning) | +| {% data variables.copilot.copilot_autofix_short %} | [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning) | {% endrowheaders %} diff --git a/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org.md b/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org.md index c8c133330d..44ae09af7f 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org.md @@ -30,7 +30,7 @@ product: '{% data reusables.gated-features.copilot-coding-agent %}' {% data variables.product.prodname_copilot_short %} can help your organization address well-defined and scoped issues, such as increasing test coverage, fixing bugs or flaky tests, or updating config files or documentation. For more on the kinds of issues {% data variables.product.prodname_copilot_short %} works best on, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/best-practices-for-using-copilot-to-work-on-tasks). -Developers stay in the flow when they ask {% data variables.product.prodname_copilot_short %} to create pull requests directly from {% data variables.product.prodname_copilot_chat_short %} instead of opening issues that may sit in a backlog. +Developers stay in the flow when they ask {% data variables.product.prodname_copilot_short %} to create pull requests directly from {% data variables.copilot.copilot_chat_short %} instead of opening issues that may sit in a backlog. When used effectively, {% data variables.copilot.copilot_coding_agent %} offers productivity benefits over traditional AI assistants in IDEs: @@ -85,7 +85,7 @@ All AI models are trained to meet a request, even if they don't have all the inf Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 aria-label="link-external" %} -> [!TIP] During the {% data variables.release-phases.public_preview %}, you need {% data variables.product.prodname_copilot_pro_plus %} or {% data variables.product.prodname_copilot_enterprise %} to use {% data variables.copilot.copilot_coding_agent %}. +> [!TIP] During the {% data variables.release-phases.public_preview %}, you need {% data variables.copilot.copilot_pro_plus %} or {% data variables.copilot.copilot_enterprise %} to use {% data variables.copilot.copilot_coding_agent %}. As with any other change to working practices, it's important to run a trial to learn how to deploy {% data variables.copilot.copilot_coding_agent %} effectively in your organization or enterprise. diff --git a/content/copilot/rolling-out-github-copilot-at-scale/measuring-adoption/analyzing-usage-over-time-with-the-copilot-metrics-api.md b/content/copilot/rolling-out-github-copilot-at-scale/measuring-adoption/analyzing-usage-over-time-with-the-copilot-metrics-api.md index 3814f60a33..5b1994e6ca 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/measuring-adoption/analyzing-usage-over-time-with-the-copilot-metrics-api.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/measuring-adoption/analyzing-usage-over-time-with-the-copilot-metrics-api.md @@ -4,7 +4,7 @@ shortTitle: Analyze usage over time intro: 'Learn how to connect to the API, store data, and analyze usage trends.' versions: feature: copilot -product: '{% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}' +product: '{% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %}' redirect_from: - /copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/analyzing-usage-over-time-with-the-copilot-metrics-api - /copilot/rolling-out-github-copilot-at-scale/analyzing-usage-over-time-with-the-copilot-metrics-api @@ -31,8 +31,8 @@ This guide demonstrates how to query the API, store data, and analyze a trend fo Endpoints are available to get data for an enterprise, organization, organization team, or enterprise team on {% data variables.product.prodname_dotcom_the_website %}. -* If you have a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan as part of a regular organization or enterprise, you can use the endpoints for **an enterprise, an organization, or an organization team**. You don't have access to enterprise teams unless you're enrolled in a preview. -* If you use a dedicated enterprise for {% data variables.product.prodname_copilot_for_business %}—an enterprise account without the ability to create organizations—you can use the endpoints for **an enterprise or an enterprise team**. +* If you have a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan as part of a regular organization or enterprise, you can use the endpoints for **an enterprise, an organization, or an organization team**. You don't have access to enterprise teams unless you're enrolled in a preview. +* If you use a dedicated enterprise for {% data variables.copilot.copilot_for_business %}—an enterprise account without the ability to create organizations—you can use the endpoints for **an enterprise or an enterprise team**. {% data reusables.copilot.metrics-api-ghecom %} diff --git a/content/copilot/rolling-out-github-copilot-at-scale/planning-your-rollout/choosing-your-enterprises-plan-for-github-copilot.md b/content/copilot/rolling-out-github-copilot-at-scale/planning-your-rollout/choosing-your-enterprises-plan-for-github-copilot.md index 17b4eed272..967433a81a 100644 --- a/content/copilot/rolling-out-github-copilot-at-scale/planning-your-rollout/choosing-your-enterprises-plan-for-github-copilot.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/planning-your-rollout/choosing-your-enterprises-plan-for-github-copilot.md @@ -1,7 +1,7 @@ --- title: Choosing your enterprise's plan for GitHub Copilot shortTitle: Choose your plan -intro: 'Choose between {% data variables.product.prodname_copilot_business_short %} and {% data variables.product.prodname_copilot_enterprise_short %}.' +intro: 'Choose between {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %}.' versions: feature: copilot topics: @@ -17,9 +17,9 @@ When you adopt {% data variables.product.prodname_copilot %} in a company, you w * Meet regulations and security requirements with features like file exclusion, policies, and audit logs * Benefit from advanced {% data variables.product.prodname_copilot_short %} features -{% data variables.product.prodname_copilot_enterprise_short %} offers additional features for enterprises that want to customize {% data variables.product.prodname_copilot_short %} for their needs. +{% data variables.copilot.copilot_enterprise_short %} offers additional features for enterprises that want to customize {% data variables.product.prodname_copilot_short %} for their needs. -This article helps you to decide whether to adopt {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %}. +This article helps you to decide whether to adopt {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %}. Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 aria-label="link-external" %} @@ -27,33 +27,33 @@ This article helps you to decide whether to adopt {% data variables.product.prod {% data variables.product.company_short %} offers two {% data variables.product.prodname_copilot_short %} plans for customers on {% data variables.product.prodname_ghe_cloud %}: -* **{% data variables.product.prodname_copilot_business_short %}** ({% data variables.copilot.cfb_price_per_month %} per user per month): includes most {% data variables.product.prodname_copilot_short %} features in IDEs and on the {% data variables.product.github %} website. -* **{% data variables.product.prodname_copilot_enterprise_short %}** ({% data variables.copilot.ce_price_per_month %} per user per month): allows companies to customize {% data variables.product.prodname_copilot_short %} for their code and processes, and includes a higher allowance for premium requests. To learn more, see the sections below. +* **{% data variables.copilot.copilot_business_short %}** ({% data variables.copilot.cfb_price_per_month %} per user per month): includes most {% data variables.product.prodname_copilot_short %} features in IDEs and on the {% data variables.product.github %} website. +* **{% data variables.copilot.copilot_enterprise_short %}** ({% data variables.copilot.ce_price_per_month %} per user per month): allows companies to customize {% data variables.product.prodname_copilot_short %} for their code and processes, and includes a higher allowance for premium requests. To learn more, see the sections below. For a full comparison, see our [plans page](https://github.com/features/copilot/plans). ## About mixed plans -When you subscribe your enterprise account to {% data variables.product.prodname_copilot_enterprise_short %}, you don't need to use this plan across the whole enterprise. Instead, you can choose a plan individually for each organization in your enterprise. This approach allows you to: +When you subscribe your enterprise account to {% data variables.copilot.copilot_enterprise_short %}, you don't need to use this plan across the whole enterprise. Instead, you can choose a plan individually for each organization in your enterprise. This approach allows you to: -* Evaluate the benefits of {% data variables.product.prodname_copilot_enterprise_short %} for a smaller group of users before rolling it out further. -* Enable {% data variables.product.prodname_copilot_enterprise_short %} in the organizations where it will have the most impact, such as organizations with complex documentation or specialized engineering requirements. +* Evaluate the benefits of {% data variables.copilot.copilot_enterprise_short %} for a smaller group of users before rolling it out further. +* Enable {% data variables.copilot.copilot_enterprise_short %} in the organizations where it will have the most impact, such as organizations with complex documentation or specialized engineering requirements. ## Do we have projects with complex requirements? For complex projects like monorepos or legacy codebases, developers in your company may need to spend a long time finding and reading documentation before they can contribute. -With {% data variables.product.prodname_copilot_enterprise_short %}, you can create **knowledge bases** that bring together documentation from one or more repositories in an organization, allowing {% data variables.product.prodname_copilot_short %} to synthesize information from your documentation in its responses. +With {% data variables.copilot.copilot_enterprise_short %}, you can create **knowledge bases** that bring together documentation from one or more repositories in an organization, allowing {% data variables.product.prodname_copilot_short %} to synthesize information from your documentation in its responses. ## Will we use {% data variables.copilot.copilot_code-review_short %} at scale? With {% data variables.copilot.copilot_code-review_short %}, {% data variables.product.prodname_copilot_short %} can provide feedback on pull requests on {% data variables.product.github %}. How much you use this feature depends on the goals of your rollout. For example, if a goal is to increase velocity by accelerating approvals of pull requests, then you may be encouraging developers to use {% data variables.copilot.copilot_code-review_short %} as much as possible. -With {% data variables.product.prodname_copilot_enterprise_short %}, you can make {% data variables.product.prodname_copilot_short %}'s reviews more consistent across your repositories by adding **custom coding guidelines** written in natural language. {% data variables.product.prodname_copilot_short %} will give feedback based on the guidelines when it reviews code, which can increase developers' confidence in the reviews and allow you to encourage consistency in coding standards across teams. +With {% data variables.copilot.copilot_enterprise_short %}, you can make {% data variables.product.prodname_copilot_short %}'s reviews more consistent across your repositories by adding **custom coding guidelines** written in natural language. {% data variables.product.prodname_copilot_short %} will give feedback based on the guidelines when it reviews code, which can increase developers' confidence in the reviews and allow you to encourage consistency in coding standards across teams. {% data reusables.copilot.code-review.custom-coding-guidelines-prerequisites %} -{% data variables.product.prodname_copilot_enterprise_short %} also includes a higher allowance for premium requests, which include code reviews. To learn more, see [How much will we benefit from premium requests?](#how-much-will-we-benefit-from-premium-requests). +{% data variables.copilot.copilot_enterprise_short %} also includes a higher allowance for premium requests, which include code reviews. To learn more, see [How much will we benefit from premium requests?](#how-much-will-we-benefit-from-premium-requests). ## How much will we benefit from premium requests? @@ -71,9 +71,9 @@ Regardless of your plan, you can set a spending limit for premium requests over To summarize: -* Choose {% data variables.product.prodname_copilot_enterprise_short %} if your company has projects with complex requirements or large amounts of documentation. Knowledge bases give {% data variables.product.prodname_copilot_short %} enhanced context, which can save developers time and allow them to focus on tasks they enjoy. -* If you think your developers will benefit from premium models and {% data variables.product.prodname_copilot_short %} code reviews, it may be cost effective to choose {% data variables.product.prodname_copilot_enterprise_short %} rather than pay for premium requests over your allowance. -* If you're not sure about a full rollout, choose {% data variables.product.prodname_copilot_enterprise_short %} at the enterprise level and enable it for individual organizations where it will have the most impact. +* Choose {% data variables.copilot.copilot_enterprise_short %} if your company has projects with complex requirements or large amounts of documentation. Knowledge bases give {% data variables.product.prodname_copilot_short %} enhanced context, which can save developers time and allow them to focus on tasks they enjoy. +* If you think your developers will benefit from premium models and {% data variables.product.prodname_copilot_short %} code reviews, it may be cost effective to choose {% data variables.copilot.copilot_enterprise_short %} rather than pay for premium requests over your allowance. +* If you're not sure about a full rollout, choose {% data variables.copilot.copilot_enterprise_short %} at the enterprise level and enable it for individual organizations where it will have the most impact. ## Further reading diff --git a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md index baca518183..3022d152f3 100644 --- a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md +++ b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md @@ -3,7 +3,7 @@ title: 'Setting up GitHub Copilot for your enterprise' shortTitle: Set up for enterprise intro: "Follow these steps to set up {% data variables.product.prodname_copilot %} in your enterprise." permissions: Enterprise owners -product: 'Enterprises with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Enterprises with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan' versions: feature: copilot-enterprise topics: diff --git a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md index c9331a4442..9e01675eb4 100644 --- a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md +++ b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md @@ -3,7 +3,7 @@ title: 'Setting up GitHub Copilot for your organization' shortTitle: Set up for organization intro: "Follow these steps to set up {% data variables.product.prodname_copilot %} in your organization." permissions: Organization owners -product: 'Organizations with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan' +product: 'Organizations with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan' versions: feature: copilot topics: @@ -17,9 +17,9 @@ redirect_from: ## 1. Subscribe your organization to {% data variables.product.prodname_copilot %} -Set up a {% data variables.product.prodname_copilot_business_short %} plan for your organization. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/subscribing-to-copilot-for-your-organization). +Set up a {% data variables.copilot.copilot_business_short %} plan for your organization. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/subscribing-to-copilot-for-your-organization). -If your organization is part of an enterprise with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan, your enterprise owner can instead enable {% data variables.product.prodname_copilot_short %} for your organization. You can request access from your enterprise owner by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get Copilot from an organization." +If your organization is part of an enterprise with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan, your enterprise owner can instead enable {% data variables.product.prodname_copilot_short %} for your organization. You can request access from your enterprise owner by going to [https://github.com/settings/copilot](https://github.com/settings/copilot) and requesting access under "Get Copilot from an organization." ## 2. Set policies @@ -49,7 +49,7 @@ Planning and implementing an effective enablement process is essential to drive Enhance the {% data variables.product.prodname_copilot_short %} experience for your organization by: -* **Setting up knowledge bases** for use with {% data variables.product.prodname_copilot_chat_short %} _({% data variables.product.prodname_copilot_enterprise_short %} only)_. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-copilot-knowledge-bases). +* **Setting up knowledge bases** for use with {% data variables.copilot.copilot_chat_short %} _({% data variables.copilot.copilot_enterprise_short %} only)_. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-copilot-knowledge-bases). * **Fine tuning {% data variables.product.prodname_copilot_short %}** by creating a custom large language model. See [AUTOTITLE](/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot). -* **Installing {% data variables.product.prodname_copilot_extensions_short %}** to integrate other tools with {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/installing-github-copilot-extensions-for-your-organization). +* **Installing {% data variables.copilot.copilot_extensions_short %}** to integrate other tools with {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/installing-github-copilot-extensions-for-your-organization). * **Adding {% data variables.copilot.copilot_coding_agent %}** as a team member to work asynchronously on issues. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org). diff --git a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself.md b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself.md index eccc399675..b976b82034 100644 --- a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself.md +++ b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself.md @@ -13,12 +13,12 @@ topics: There are a few ways that you can get access to {% data variables.product.prodname_copilot %}: -* **Use {% data variables.product.prodname_copilot_free_short %}**. Get a limited experience of {% data variables.product.prodname_copilot_short %} with up to 2,000 code completions and 50 chats or premium requests per month-no paid plan required. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free). +* **Use {% data variables.copilot.copilot_free_short %}**. Get a limited experience of {% data variables.product.prodname_copilot_short %} with up to 2,000 code completions and 50 chats or premium requests per month-no paid plan required. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free). * **Sign up for a paid plan**. You can subscribe to either: - * **{% data variables.product.prodname_copilot_pro_short %}**, which includes a one-time 30-day free trial and 300 monthly premium requests. - * **{% data variables.product.prodname_copilot_pro_plus_short %}**, which includes 1,500 monthly premium requests and full access to all available models. [Subscribe to {% data variables.product.prodname_copilot_pro_plus_short %}](https://github.com/github-copilot/signup?ref_cta=Copilot+Pro%2B&ref_loc=subscriptions+page&ref_page=docs). + * **{% data variables.copilot.copilot_pro_short %}**, which includes a one-time 30-day free trial and 300 monthly premium requests. + * **{% data variables.copilot.copilot_pro_plus_short %}**, which includes 1,500 monthly premium requests and full access to all available models. [Subscribe to {% data variables.copilot.copilot_pro_plus_short %}](https://github.com/github-copilot/signup?ref_cta=Copilot+Pro%2B&ref_loc=subscriptions+page&ref_page=docs). * **Use {% data variables.product.prodname_copilot_short %} through your organization or enterprise**. If you're part of an organization or enterprise with a {% data variables.product.prodname_copilot_short %} plan, you can request access at [https://github.com/settings/copilot](https://github.com/settings/copilot) under "Get {% data variables.product.prodname_copilot_short %} from an organization." @@ -48,11 +48,11 @@ All users can configure {% data variables.product.prodname_copilot_short %} sett If you have your own {% data variables.product.prodname_copilot_short %} plan (instead of using your organization or enterprise's plan), you can: -* **Install {% data variables.product.prodname_copilot_extensions_short %}** to integrate other tools with {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/installing-github-copilot-extensions-for-your-personal-account). +* **Install {% data variables.copilot.copilot_extensions_short %}** to integrate other tools with {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/installing-github-copilot-extensions-for-your-personal-account). * **Manage policies**. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber). ## 7. Start using {% data variables.product.prodname_copilot_short %} -Start using {% data variables.product.prodname_copilot_short %} to help you write code faster and more efficiently. For all the ways you can use {% data variables.product.prodname_copilot_short %}, see [AUTOTITLE](/copilot/using-github-copilot). {% data variables.product.prodname_copilot_short %} code suggestions, {% data variables.product.prodname_copilot_chat_dotcom_short %}, and {% data variables.product.prodname_copilot_chat_short %} in your IDE are a great place to start. +Start using {% data variables.product.prodname_copilot_short %} to help you write code faster and more efficiently. For all the ways you can use {% data variables.product.prodname_copilot_short %}, see [AUTOTITLE](/copilot/using-github-copilot). {% data variables.product.prodname_copilot_short %} code suggestions, {% data variables.copilot.copilot_chat_dotcom_short %}, and {% data variables.copilot.copilot_chat_short %} in your IDE are a great place to start. To learn how to best use {% data variables.product.prodname_copilot_short %}, see [AUTOTITLE](/copilot/using-github-copilot/best-practices-for-using-github-copilot) and [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot). diff --git a/content/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot.md b/content/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot.md index 50f0de0f3e..e41d6267ed 100644 --- a/content/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot.md +++ b/content/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot.md @@ -25,7 +25,7 @@ For more information about configuring {% data variables.product.prodname_copilo ## {% data variables.product.prodname_copilot %} not working in some files -If you're using {% data variables.product.prodname_copilot %} with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} license, you may not see code completion suggestions in your editor for some files. This happens when a file is excluded from being used by {% data variables.product.prodname_copilot %}. Content exclusion can be configured by a repository administrator, or by an organization owner. +If you're using {% data variables.product.prodname_copilot %} with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} license, you may not see code completion suggestions in your editor for some files. This happens when a file is excluded from being used by {% data variables.product.prodname_copilot %}. Content exclusion can be configured by a repository administrator, or by an organization owner. When a file is affected by a content exclusion setting, {% data variables.product.prodname_copilot %} will not suggest code completion in that file, and the content of that file will not be used to inform code completion suggestions in other files. @@ -54,11 +54,11 @@ If you cannot connect to the server, you can create a discussion in our [discuss This is a known issue and our team is working towards a fix. For more information, see this comment on a [{% data variables.product.prodname_github_community %} discussion](https://github.com/orgs/community/discussions/40522#discussioncomment-4701470). -## Error: "No valid OAuth token detected" in {% data variables.product.prodname_copilot_cli %} +## Error: "No valid OAuth token detected" in {% data variables.copilot.copilot_cli %} -This error suggests that a classic or fine-grained {% data variables.product.pat_generic %} might be in use, either via the `GITHUB_TOKEN` or `GH_TOKEN` environment variables, or during a `gh auth login` attempt. {% data variables.product.prodname_copilot_cli %} currently only supports using the {% data variables.product.prodname_cli %} OAuth app. +This error suggests that a classic or fine-grained {% data variables.product.pat_generic %} might be in use, either via the `GITHUB_TOKEN` or `GH_TOKEN` environment variables, or during a `gh auth login` attempt. {% data variables.copilot.copilot_cli %} currently only supports using the {% data variables.product.prodname_cli %} OAuth app. -For more information, see the [{% data variables.product.prodname_copilot_cli_short %} extension repository](https://github.com/github/gh-copilot). +For more information, see the [{% data variables.copilot.copilot_cli_short %} extension repository](https://github.com/github/gh-copilot). ## Error: "Sorry, your request was rate-limited." diff --git a/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat.md b/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat.md index 1377f81ee9..18f2ddab91 100644 --- a/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat.md +++ b/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat.md @@ -1,6 +1,6 @@ --- title: Troubleshooting issues with GitHub Copilot Chat -intro: 'This guide describes common issues with {% data variables.product.prodname_copilot_chat_short %} and how to resolve them.' +intro: 'This guide describes common issues with {% data variables.copilot.copilot_chat_short %} and how to resolve them.' product: '{% data reusables.gated-features.copilot-chat-callout %}' defaultTool: vscode topics: @@ -14,19 +14,19 @@ redirect_from: - /copilot/troubleshooting-github-copilot/troubleshooting-authentication-issues-with-github-copilot-chat --- -You can use {% data variables.product.prodname_copilot_chat %} in your IDE or on the {% data variables.product.github %} website. Click the tabs above for troubleshooting information for {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode %}, and on {% data variables.product.github %} in the browser. +You can use {% data variables.copilot.copilot_chat %} in your IDE or on the {% data variables.product.github %} website. Click the tabs above for troubleshooting information for {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode %}, and on {% data variables.product.github %} in the browser. -If you need help with {% data variables.product.prodname_copilot_chat_short %} and can't find the answer here, you can report a bug or ask for help. For more information, see [Sharing feedback about {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#sharing-feedback-about-github-copilot-chat). +If you need help with {% data variables.copilot.copilot_chat_short %} and can't find the answer here, you can report a bug or ask for help. For more information, see [Sharing feedback about {% data variables.copilot.copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#sharing-feedback-about-github-copilot-chat). {% vscode %} -If you can't find {% data variables.product.prodname_copilot_chat_short %} in your editor, make sure you have checked the [Prerequisites](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#prerequisites) section. +If you can't find {% data variables.copilot.copilot_chat_short %} in your editor, make sure you have checked the [Prerequisites](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#prerequisites) section. ## Troubleshooting issues caused by version incompatibility {% data reusables.copilot.vscode-version-compatibility %} -To use {% data variables.product.prodname_copilot_chat_short %}, make sure you are using the [latest version of {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/updates). +To use {% data variables.copilot.copilot_chat_short %}, make sure you are using the [latest version of {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/updates). ## Troubleshooting authentication issues in your editor @@ -44,7 +44,7 @@ If you are signed in to {% data variables.product.github %} but {% data variable {% visualstudio %} -If you can't find {% data variables.product.prodname_copilot_chat_short %} in your editor, make sure you have checked the [Prerequisites](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#prerequisites) section. +If you can't find {% data variables.copilot.copilot_chat_short %} in your editor, make sure you have checked the [Prerequisites](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#prerequisites) section. ## Troubleshooting authentication issues in your editor @@ -52,9 +52,9 @@ If you can't find {% data variables.product.prodname_copilot_chat_short %} in yo ### Troubleshooting authentication issues in {% data variables.product.prodname_vs %} -If you experience authentication issues when you try to use {% data variables.product.prodname_copilot_chat %}, you can try the following steps to resolve the issue. +If you experience authentication issues when you try to use {% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_vs %}, you can try the following steps to resolve the issue. -1. Check that the {% data variables.product.prodname_dotcom %} ID you are signed into {% data variables.product.prodname_vs %} with is the same as the one you have been granted access to {% data variables.product.prodname_copilot_chat %} with. +1. Check that the {% data variables.product.prodname_dotcom %} ID you are signed into {% data variables.product.prodname_vs %} with is the same as the one you have been granted access to {% data variables.copilot.copilot_chat %} with. 1. Check whether your {% data variables.product.prodname_dotcom %} ID/credentials need refreshing in {% data variables.product.prodname_vs %}. For more information, see [Work with {% data variables.product.prodname_dotcom %} accounts in {% data variables.product.prodname_vs %}](https://learn.microsoft.com/en-us/visualstudio/ide/work-with-github-accounts?view=vs-2022) in the {% data variables.product.prodname_vs %} documentation. 1. Try removing and re-adding your {% data variables.product.prodname_dotcom %} ID to {% data variables.product.prodname_vs %} and restarting {% data variables.product.prodname_vs %}. 1. If the above steps don't work, click the **Share feedback** button and select **Report a problem** to report the issue to the {% data variables.product.prodname_vs %} team. @@ -69,6 +69,6 @@ If you experience authentication issues when you try to use {% data variables.pr If a chat response terminates unexpectedly, before the response is complete, try resubmitting the question. -In {% data variables.product.prodname_copilot_chat_short %}'s immersive view (the [github.com/copilot](https://github.com/copilot) page), you can resubmit your question by clicking the {% octicon "sync" aria-label="Retry" %} button under the chat response. +In {% data variables.copilot.copilot_chat_short %}'s immersive view (the [github.com/copilot](https://github.com/copilot) page), you can resubmit your question by clicking the {% octicon "sync" aria-label="Retry" %} button under the chat response. {% endwebui %} diff --git a/content/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot.md b/content/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot.md index 7e07624eeb..00ddc53957 100644 --- a/content/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot.md +++ b/content/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot.md @@ -36,7 +36,7 @@ curl --verbose -x http://YOUR-PROXY-URL:PORT -i -L https://copilot-proxy.githubu If you receive an error related to "revocation for the certificate," you can try the request again with the `--insecure` flag. If the request only succeeds when the `--insecure` flag is added, this may indicate that {% data variables.product.prodname_copilot %} will only connect successfully if you ignore certificate errors. For more information, see [Troubleshooting certificate-related errors](#troubleshooting-certificate-related-errors). -If you're specifically having difficulty with {% data variables.product.prodname_copilot_chat_short %} in your editor, run the above `curl` commands but use `https://api.githubcopilot.com/_ping` instead of `https://copilot-proxy.githubusercontent.com/_ping`. +If you're specifically having difficulty with {% data variables.copilot.copilot_chat_short %} in your editor, run the above `curl` commands but use `https://api.githubcopilot.com/_ping` instead of `https://copilot-proxy.githubusercontent.com/_ping`. If you're unable to connect and the `curl` requests don't help to identify the error, it may help to collect detailed diagnostic logs in your editor. If you're working with your company's IT department or {% data variables.contact.contact_support_page %}, sharing these diagnostics may help to resolve the error. Enabling debug logging in your editor will help you to share more specific information. For more information, see [AUTOTITLE](/copilot/troubleshooting-github-copilot/viewing-logs-for-github-copilot-in-your-environment). diff --git a/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat.md b/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat.md index 1eb3e200e9..d0446ccfc9 100644 --- a/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat.md +++ b/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat.md @@ -1,14 +1,14 @@ --- title: Changing the AI model for Copilot Chat shortTitle: 'Change the chat model' -intro: 'Learn how to change the default LLM for {% data variables.product.prodname_copilot_chat_short %} to a different model.' +intro: 'Learn how to change the default LLM for {% data variables.copilot.copilot_chat_short %} to a different model.' versions: feature: copilot topics: - Copilot --- -By default, {% data variables.product.prodname_copilot_chat_short %} uses a base model to provide fast, capable responses for a wide range of tasks, such as summarization, knowledge-based questions, reasoning, math, and coding. +By default, {% data variables.copilot.copilot_chat_short %} uses a base model to provide fast, capable responses for a wide range of tasks, such as summarization, knowledge-based questions, reasoning, math, and coding. However, you are not limited to using this model. You can choose from a selection of other models, each with its own particular strengths. You may have a favorite model that you like to use, or you might prefer to use a particular model for inquiring about a specific subject. @@ -16,18 +16,18 @@ However, you are not limited to using this model. You can choose from a selectio {% data variables.product.prodname_copilot_short %} allows you to change the model during a chat and have the alternative model used to generate responses to your prompts. -Changing the model that's used by {% data variables.product.prodname_copilot_chat_short %} does not affect the model that's used for {% data variables.product.prodname_copilot_short %} code completion. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion). +Changing the model that's used by {% data variables.copilot.copilot_chat_short %} does not affect the model that's used for {% data variables.product.prodname_copilot_short %} code completion. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion). {% webui %} > [!NOTE] -> * Multiple model support in {% data variables.product.prodname_copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -> * Support for GPT-4.5 is only available on {% data variables.product.prodname_copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.product.prodname_copilot_enterprise_short %}{% endif %}. -> * You can only use an alternative AI model in the immersive view of {% data variables.product.prodname_copilot_chat_short %}. This is the full-page version of {% data variables.product.prodname_copilot_chat_short %} that's displayed at [https://github.com/copilot](https://github.com/copilot). The {% data variables.product.prodname_copilot_chat_short %} panel always uses the default model. +> * Multiple model support in {% data variables.copilot.copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> * Support for GPT-4.5 is only available on {% data variables.copilot.copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.copilot.copilot_enterprise_short %}{% endif %}. +> * You can only use an alternative AI model in the immersive view of {% data variables.copilot.copilot_chat_short %}. This is the full-page version of {% data variables.copilot.copilot_chat_short %} that's displayed at [https://github.com/copilot](https://github.com/copilot). The {% data variables.copilot.copilot_chat_short %} panel always uses the default model. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} -The following models are currently available in the immersive mode of {% data variables.product.prodname_copilot_chat_short %}: +The following models are currently available in the immersive mode of {% data variables.copilot.copilot_chat_short %}: * {% data variables.copilot.copilot_gpt_4o %} * {% data variables.copilot.copilot_gpt_41 %} @@ -46,7 +46,7 @@ The following models are currently available in the immersive mode of {% data va For more information about these models, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task). -### Limitations of AI models for {% data variables.product.prodname_copilot_chat_short %} +### Limitations of AI models for {% data variables.copilot.copilot_chat_short %} Experimental pre-release versions of the models may not interact with all filters correctly, including the duplication detection filter. @@ -56,7 +56,7 @@ These instructions are for {% data variables.product.prodname_copilot_short %} o {% data reusables.copilot.model-picker-enable-alternative-models %} -> [!NOTE] If you use {% data variables.product.prodname_copilot_extensions_short %}, they may override the model you select. +> [!NOTE] If you use {% data variables.copilot.copilot_extensions_short %}, they may override the model you select. 1. In the top right of any page on {% data variables.product.github %}, click {% octicon "triangle-down" aria-label="The downwards triangle icon" %} beside the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon and click **Immersive** in the dropdown menu. @@ -71,12 +71,12 @@ These instructions are for {% data variables.product.prodname_copilot_short %} o {% vscode %} > [!NOTE] -> * Multiple model support in {% data variables.product.prodname_copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -> * Support for GPT-4.5 is only available on {% data variables.product.prodname_copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.product.prodname_copilot_enterprise_short %}{% endif %}. +> * Multiple model support in {% data variables.copilot.copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> * Support for GPT-4.5 is only available on {% data variables.copilot.copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.copilot.copilot_enterprise_short %}{% endif %}. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} -The following models are currently available through multi-model {% data variables.product.prodname_copilot_chat_short %}: +The following models are currently available through multi-model {% data variables.copilot.copilot_chat_short %}: * {% data variables.copilot.copilot_gpt_4o %} * {% data variables.copilot.copilot_gpt_41 %} @@ -109,11 +109,11 @@ These instructions are for {% data variables.product.prodname_vscode_shortname % {% visualstudio %} -> [!NOTE] Multiple model support in {% data variables.product.prodname_copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> [!NOTE] Multiple model support in {% data variables.copilot.copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} -The following models are currently available through multi-model {% data variables.product.prodname_copilot_chat_short %}: +The following models are currently available through multi-model {% data variables.copilot.copilot_chat_short %}: * {% data variables.copilot.copilot_gpt_4o %} * {% data variables.copilot.copilot_claude_sonnet_35 %} @@ -123,17 +123,17 @@ The following models are currently available through multi-model {% data variabl For more information about these models, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task). -## Changing the AI model for {% data variables.product.prodname_copilot_chat_short %} +## Changing the AI model for {% data variables.copilot.copilot_chat_short %} These instructions are for {% data variables.product.prodname_vs %}. For instructions on different clients, click the appropriate tab at the top of this page. -To use multi-model {% data variables.product.prodname_copilot_chat_short %}, you must use {% data variables.product.prodname_vs %} 2022 version 17.12 or later. See the [{% data variables.product.prodname_vs %} downloads page](https://visualstudio.microsoft.com/downloads/). +To use multi-model {% data variables.copilot.copilot_chat_short %}, you must use {% data variables.product.prodname_vs %} 2022 version 17.12 or later. See the [{% data variables.product.prodname_vs %} downloads page](https://visualstudio.microsoft.com/downloads/). {% data reusables.copilot.model-picker-enable-alternative-models %} {% data reusables.copilot.chat-model-limitations-ide %} -1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.product.prodname_copilot_chat %}**. +1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.copilot.copilot_chat %}**. 1. In the bottom right of the chat view, select the **CURRENT-MODEL** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %} dropdown menu, then click the AI model of your choice. {% endvisualstudio %} @@ -141,12 +141,12 @@ To use multi-model {% data variables.product.prodname_copilot_chat_short %}, you {% jetbrains %} > [!NOTE] -> * Multiple model support in {% data variables.product.prodname_copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -> * Support for GPT-4.5 is only available on {% data variables.product.prodname_copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.product.prodname_copilot_enterprise_short %}{% endif %}. +> * Multiple model support in {% data variables.copilot.copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> * Support for GPT-4.5 is only available on {% data variables.copilot.copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.copilot.copilot_enterprise_short %}{% endif %}. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} -The following models are currently available through multi-model {% data variables.product.prodname_copilot_chat_short %}: +The following models are currently available through multi-model {% data variables.copilot.copilot_chat_short %}: * {% data variables.copilot.copilot_gpt_4o %} * {% data variables.copilot.copilot_gpt_41 %} @@ -163,7 +163,7 @@ The following models are currently available through multi-model {% data variabl For more information about these models, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task). -## Changing the AI model for {% data variables.product.prodname_copilot_chat_short %} +## Changing the AI model for {% data variables.copilot.copilot_chat_short %} These instructions are for the JetBrains IDEs. For instructions on different clients, click the appropriate tab at the top of this page. @@ -172,7 +172,7 @@ These instructions are for the JetBrains IDEs. For instructions on different cli {% data reusables.copilot.chat-model-limitations-ide %} 1. Click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon in the status bar. -1. In the popup menu, click **Open {% data variables.product.prodname_copilot_chat %}**. +1. In the popup menu, click **Open {% data variables.copilot.copilot_chat %}**. 1. In the bottom right of the chat view, select an AI model of your choice from the {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu. {% endjetbrains %} @@ -180,12 +180,12 @@ These instructions are for the JetBrains IDEs. For instructions on different cli {% eclipse %} > [!NOTE] -> * Multiple model support in {% data variables.product.prodname_copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -> * Support for GPT-4.5 is only available on {% data variables.product.prodname_copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.product.prodname_copilot_enterprise_short %}{% endif %}. +> * Multiple model support in {% data variables.copilot.copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> * Support for GPT-4.5 is only available on {% data variables.copilot.copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.copilot.copilot_enterprise_short %}{% endif %}. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} -The following models are currently available through multi-model {% data variables.product.prodname_copilot_chat_short %}: +The following models are currently available through multi-model {% data variables.copilot.copilot_chat_short %}: * {% data variables.copilot.copilot_gpt_4o %} * {% data variables.copilot.copilot_gpt_45 %} (preview) @@ -198,7 +198,7 @@ The following models are currently available through multi-model {% data variabl For more information about these models, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task). -## Changing the AI model for {% data variables.product.prodname_copilot_chat_short %} +## Changing the AI model for {% data variables.copilot.copilot_chat_short %} These instructions are for the Eclipse IDE. For instructions on different clients, click the appropriate tab at the top of this page. @@ -215,12 +215,12 @@ These instructions are for the Eclipse IDE. For instructions on different client {% xcode %} > [!NOTE] -> * Multiple model support in {% data variables.product.prodname_copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -> * Support for GPT-4.5 is only available on {% data variables.product.prodname_copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.product.prodname_copilot_enterprise_short %}{% endif %}. +> * Multiple model support in {% data variables.copilot.copilot_chat_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> * Support for GPT-4.5 is only available on {% data variables.copilot.copilot_pro_plus_short %}{% ifversion copilot-enterprise %} and {% data variables.copilot.copilot_enterprise_short %}{% endif %}. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} -The following models are currently available through multi-model {% data variables.product.prodname_copilot_chat_short %}: +The following models are currently available through multi-model {% data variables.copilot.copilot_chat_short %}: * {% data variables.copilot.copilot_gpt_4o %} * {% data variables.copilot.copilot_gpt_41 %} @@ -237,17 +237,17 @@ The following models are currently available through multi-model {% data variabl For more information about these models, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task). -## Changing the AI model for {% data variables.product.prodname_copilot_chat_short %} +## Changing the AI model for {% data variables.copilot.copilot_chat_short %} These instructions are for Xcode. For instructions on different clients, click the appropriate tab at the top of this page. -To use multi-model {% data variables.product.prodname_copilot_chat_short %}, you must install the {% data variables.product.prodname_copilot %} for Xcode extension. See [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment). +To use multi-model {% data variables.copilot.copilot_chat_short %}, you must install the {% data variables.product.prodname_copilot %} for Xcode extension. See [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment). {% data reusables.copilot.model-picker-enable-alternative-models %} {% data reusables.copilot.chat-model-limitations-ide %} -1. To open the chat view, click **Editor** in the menu bar, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** then **Open Chat**. {% data variables.product.prodname_copilot_chat_short %} opens in a new window. +1. To open the chat view, click **Editor** in the menu bar, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** then **Open Chat**. {% data variables.copilot.copilot_chat_short %} opens in a new window. 1. In the bottom right of the chat view, select the **CURRENT-MODEL** {% octicon "triangle-down" aria-hidden="true" aria-label="triangle-down" %} dropdown menu, then click the AI model of your choice. {% endxcode %} diff --git a/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion.md b/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion.md index 2a6d11a0a2..c5b7620af3 100644 --- a/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion.md +++ b/content/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion.md @@ -62,11 +62,11 @@ By default, {% data variables.product.prodname_copilot_short %} code completion ## Effects of switching the AI model -Changing the model that's used for {% data variables.product.prodname_copilot_short %} code completion does not affect the model that's used by {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +Changing the model that's used for {% data variables.product.prodname_copilot_short %} code completion does not affect the model that's used by {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). There are no changes to the data collection and usage policy if you change the AI model. -If you are on a {% data variables.product.prodname_copilot_free_short %} subscription, all completions count against your completions quota regardless of the model used. See [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot#comparing-copilot-subscriptions). +If you are on a {% data variables.copilot.copilot_free_short %} subscription, all completions count against your completions quota regardless of the model used. See [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot#comparing-copilot-subscriptions). The setting to enable or disable suggestions that match public code are applied irrespective of which model you choose. See [AUTOTITLE](/enterprise-cloud@latest/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions). @@ -74,7 +74,7 @@ The setting to enable or disable suggestions that match public code are applied {% ifversion fpt %} -If you have a {% data variables.product.prodname_copilot_free_short %} or {% data variables.product.prodname_copilot_pro_short %} subscription, the model switcher for {% data variables.product.prodname_copilot_short %} code completion is automatically enabled. +If you have a {% data variables.copilot.copilot_free_short %} or {% data variables.copilot.copilot_pro_short %} subscription, the model switcher for {% data variables.product.prodname_copilot_short %} code completion is automatically enabled. {% endif %} diff --git a/content/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task.md b/content/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task.md index 2f59cb92dd..5fdfdc562a 100644 --- a/content/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task.md +++ b/content/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task.md @@ -1,7 +1,7 @@ --- title: Choosing the right AI model for your task shortTitle: 'Choose the right AI model' -intro: 'Compare available AI models in {% data variables.product.prodname_copilot_chat_short %} and choose the best model for your task.' +intro: 'Compare available AI models in {% data variables.copilot.copilot_chat_short %} and choose the best model for your task.' versions: feature: copilot topics: @@ -10,7 +10,7 @@ topics: ## Comparison of AI models for {% data variables.product.prodname_copilot %} -{% data variables.product.prodname_copilot %} supports multiple AI models with different capabilities. The model you choose affects the quality and relevance of responses by {% data variables.product.prodname_copilot_chat_short %} and {% data variables.product.prodname_copilot_short %} code completion. Some models offer lower latency, while others offer fewer hallucinations or better performance on specific tasks. +{% data variables.product.prodname_copilot %} supports multiple AI models with different capabilities. The model you choose affects the quality and relevance of responses by {% data variables.copilot.copilot_chat_short %} and {% data variables.product.prodname_copilot_short %} code completion. Some models offer lower latency, while others offer fewer hallucinations or better performance on specific tasks. This article helps you compare the available models, understand the strengths of each model, and choose the model that best fits your task. For guidance across different models using real-world tasks, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/comparing-ai-models-using-different-tasks). @@ -73,7 +73,7 @@ The following table summarizes the strengths of {% data variables.copilot.copilo ## {% data variables.copilot.copilot_gpt_4o %} -OpenAI {% data variables.copilot.copilot_gpt_4o %} is a multimodal model that supports text and images. It responds in real time and works well for lightweight development tasks and conversational prompts in {% data variables.product.prodname_copilot_chat_short %}. +OpenAI {% data variables.copilot.copilot_gpt_4o %} is a multimodal model that supports text and images. It responds in real time and works well for lightweight development tasks and conversational prompts in {% data variables.copilot.copilot_chat_short %}. Compared to previous models, {% data variables.copilot.copilot_gpt_4o %} improves performance in multilingual contexts and demonstrates stronger capabilities when interpreting visual content. It delivers GPT-4 Turbo–level performance with lower latency and cost, making it a good default choice for many common developer tasks. @@ -117,7 +117,7 @@ The following table summarizes when an alternative model may be a better choice: ## GPT-4.5 > [!NOTE] -> GPT-4.5 in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. +> GPT-4.5 in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. OpenAI GPT-4.5 improves reasoning, reliability, and contextual understanding. It works well for development tasks that involve complex logic, high-quality code generation, or interpreting nuanced intent. @@ -413,7 +413,7 @@ For more information on using Claude in {% data variables.product.prodname_copil ## {% data variables.copilot.copilot_gemini_flash %} -{% data variables.copilot.copilot_gemini_flash %} is Google’s high-speed, multimodal model optimized for real-time, interactive applications that benefit from visual input and agentic reasoning. In {% data variables.product.prodname_copilot_chat_short %}, {% data variables.copilot.copilot_gemini_flash %} enables fast responses and cross-modal understanding. +{% data variables.copilot.copilot_gemini_flash %} is Google’s high-speed, multimodal model optimized for real-time, interactive applications that benefit from visual input and agentic reasoning. In {% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_gemini_flash %} enables fast responses and cross-modal understanding. For more information about {% data variables.copilot.copilot_gemini_flash %}, see [Google's documentation](https://cloud.google.com/vertex-ai/generative-ai/docs/models/gemini/2-0-flash). For more information on using {% data variables.copilot.copilot_gemini %} in {% data variables.product.prodname_copilot_short %}, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/using-gemini-in-github-copilot). diff --git a/content/copilot/using-github-copilot/ai-models/comparing-ai-models-using-different-tasks.md b/content/copilot/using-github-copilot/ai-models/comparing-ai-models-using-different-tasks.md index 99e0bfade9..a4ee2e7183 100644 --- a/content/copilot/using-github-copilot/ai-models/comparing-ai-models-using-different-tasks.md +++ b/content/copilot/using-github-copilot/ai-models/comparing-ai-models-using-different-tasks.md @@ -12,7 +12,7 @@ redirect_from: ## Overview -Each AI model supported in {% data variables.product.prodname_copilot_chat_short %} has different strengths. To help you decide which model to use, this article provides real-world examples of common developer tasks along with sample prompts, responses, and guidance on why a particular model is a good fit. +Each AI model supported in {% data variables.copilot.copilot_chat_short %} has different strengths. To help you decide which model to use, this article provides real-world examples of common developer tasks along with sample prompts, responses, and guidance on why a particular model is a good fit. These examples show how models vary in their reasoning style, response depth, and ability to handle visual input. Use them to compare output quality and choose the right model for your specific workflow. diff --git a/content/copilot/using-github-copilot/ai-models/using-claude-in-github-copilot.md b/content/copilot/using-github-copilot/ai-models/using-claude-in-github-copilot.md index 4797dbf9a9..a174e6807d 100644 --- a/content/copilot/using-github-copilot/ai-models/using-claude-in-github-copilot.md +++ b/content/copilot/using-github-copilot/ai-models/using-claude-in-github-copilot.md @@ -2,7 +2,7 @@ title: Using Claude in Copilot Chat allowTitleToDifferFromFilename: true shortTitle: 'Use {% data variables.copilot.copilot_claude %}' -intro: 'Learn how to enable {% data variables.copilot.copilot_claude %} in {% data variables.product.prodname_copilot_chat %} for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' +intro: 'Learn how to enable {% data variables.copilot.copilot_claude %} in {% data variables.copilot.copilot_chat %} for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' versions: feature: copilot topics: @@ -12,32 +12,32 @@ redirect_from: - /copilot/using-github-copilot/ai-models/using-claude-sonnet-in-github-copilot --- -## About {% data variables.copilot.copilot_claude %} in {% data variables.product.prodname_copilot_chat %} +## About {% data variables.copilot.copilot_claude %} in {% data variables.copilot.copilot_chat %} {% data reusables.copilot.claude-public-preview-note %} -{% data variables.copilot.copilot_claude %} is a family of large language models that you can use as an alternative to the default model used by {% data variables.product.prodname_copilot_chat_short %}. {% data variables.copilot.copilot_claude %} excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. Learn more about [Claude's capabilities](https://www.anthropic.com/claude). +{% data variables.copilot.copilot_claude %} is a family of large language models that you can use as an alternative to the default model used by {% data variables.copilot.copilot_chat_short %}. {% data variables.copilot.copilot_claude %} excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. Learn more about [Claude's capabilities](https://www.anthropic.com/claude). * {% data variables.copilot.copilot_claude_opus %} is available in: - * {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} - * Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} + * {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} + * Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} * {% data variables.copilot.copilot_claude_sonnet_40 %} is available in: - * {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} - * Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} + * {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} + * Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} * {% data variables.copilot.copilot_claude_sonnet_35 %} and {% data variables.copilot.copilot_claude_sonnet_37 %} are available in: - * {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} - * {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %} 2022 + * {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} + * {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vs %} 2022 * **3.5**: Version 17.12 or later * **3.7**: Version 17.13 or later - * {% data variables.product.prodname_copilot_chat_short %} in Xcode - * {% data variables.product.prodname_copilot_chat_short %} in Eclipse - * {% data variables.product.prodname_copilot_chat_short %} in JetBrains - * Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} + * {% data variables.copilot.copilot_chat_short %} in Xcode + * {% data variables.copilot.copilot_chat_short %} in Eclipse + * {% data variables.copilot.copilot_chat_short %} in JetBrains + * Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} {% data variables.copilot.copilot_claude_opus %} and {% data variables.copilot.copilot_claude_sonnet_40 %} are hosted by Anthropic PBC and Google Cloud Platform. {% data variables.copilot.copilot_claude_sonnet_37 %} is hosted by Amazon Web Services, Anthropic PBC, and Google Cloud Platform. {% data variables.copilot.copilot_claude_sonnet_35 %} is hosted exclusively by Amazon Web Services. {% data variables.product.github %} has provider agreements in place to ensure data is not used for training. Additional details for each provider are included below: @@ -58,13 +58,13 @@ You must enable access to each {% data variables.copilot.copilot_claude %} indiv ### Setup for individual use > [!NOTE] -> * {% data variables.copilot.copilot_claude_opus %} is not currently available for {% data variables.product.prodname_copilot_free_short %} and {% data variables.product.prodname_copilot_pro_short %}. -> * {% data variables.copilot.copilot_claude_sonnet_40 %} and {% data variables.copilot.copilot_claude_sonnet_37 %} are not currently available for {% data variables.product.prodname_copilot_free_short %}. -> * {% data variables.copilot.copilot_claude_sonnet_37 %} is not currently available for {% data variables.product.prodname_copilot_free_short %}. +> * {% data variables.copilot.copilot_claude_opus %} is not currently available for {% data variables.copilot.copilot_free_short %} and {% data variables.copilot.copilot_pro_short %}. +> * {% data variables.copilot.copilot_claude_sonnet_40 %} and {% data variables.copilot.copilot_claude_sonnet_37 %} are not currently available for {% data variables.copilot.copilot_free_short %}. +> * {% data variables.copilot.copilot_claude_sonnet_37 %} is not currently available for {% data variables.copilot.copilot_free_short %}. -If you have a {% data variables.product.prodname_copilot_free_short %} or {% data variables.product.prodname_copilot_pro_short %} subscription, you can enable {% data variables.copilot.copilot_claude %} in two ways: +If you have a {% data variables.copilot.copilot_free_short %} or {% data variables.copilot.copilot_pro_short %} subscription, you can enable {% data variables.copilot.copilot_claude %} in two ways: -* The first time you choose to use {% data variables.copilot.copilot_claude %} models with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.product.prodname_copilot_chat_short %}, you will be prompted to allow access to the model. +* The first time you choose to use {% data variables.copilot.copilot_claude %} models with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.copilot.copilot_chat_short %}, you will be prompted to allow access to the model. Clicking **Allow** enables you to use {% data variables.copilot.copilot_claude %} and updates the policy in your personal settings on {% data variables.product.github %}. @@ -75,13 +75,13 @@ If you have a {% data variables.product.prodname_copilot_free_short %} or {% dat ### Setup for organization {% ifversion ghec %}and enterprise{% endif %} use > [!NOTE] -> {% data variables.copilot.copilot_claude_opus %} is not currently available for {% data variables.product.prodname_copilot_business_short %}. +> {% data variables.copilot.copilot_claude_opus %} is not currently available for {% data variables.copilot.copilot_business_short %}. -As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_claude %} models for everyone who has been assigned a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}. +As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_claude %} models for everyone who has been assigned a {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or {% endif %}{% data variables.copilot.copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}. ## Using {% data variables.copilot.copilot_claude %} -For details on how to change the model that {% data variables.product.prodname_copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +For details on how to change the model that {% data variables.copilot.copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). ## Leaving feedback diff --git a/content/copilot/using-github-copilot/ai-models/using-gemini-in-github-copilot.md b/content/copilot/using-github-copilot/ai-models/using-gemini-in-github-copilot.md index 7fd0b8b29d..7d1e776a4c 100644 --- a/content/copilot/using-github-copilot/ai-models/using-gemini-in-github-copilot.md +++ b/content/copilot/using-github-copilot/ai-models/using-gemini-in-github-copilot.md @@ -2,7 +2,7 @@ title: Using Gemini in Copilot Chat allowTitleToDifferFromFilename: true shortTitle: 'Use {% data variables.copilot.copilot_gemini %}' -intro: 'Learn how to enable {% data variables.copilot.copilot_gemini %} in {% data variables.product.prodname_copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' +intro: 'Learn how to enable {% data variables.copilot.copilot_gemini %} in {% data variables.copilot.copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' versions: feature: copilot topics: @@ -13,12 +13,12 @@ redirect_from: ## About {% data variables.copilot.copilot_gemini %} in {% data variables.product.prodname_copilot %} -{% data variables.copilot.copilot_gemini %} models are large language models (LLMs) that you can use as an alternative to the default model used by {% data variables.product.prodname_copilot_chat_short %}. {% data variables.copilot.copilot_gemini %} models are responsive LLMs that can empower you to build apps faster and more easily, so you can focus on great experiences for your users. {% data reusables.copilot.gemini-model-info %} +{% data variables.copilot.copilot_gemini %} models are large language models (LLMs) that you can use as an alternative to the default model used by {% data variables.copilot.copilot_chat_short %}. {% data variables.copilot.copilot_gemini %} models are responsive LLMs that can empower you to build apps faster and more easily, so you can focus on great experiences for your users. {% data reusables.copilot.gemini-model-info %} {% data variables.copilot.copilot_gemini %} is currently available in: -* {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} -* Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} +* {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} +* Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} {% data variables.product.prodname_copilot %} uses {% data variables.copilot.copilot_gemini_flash %} and {% data variables.copilot.copilot_gemini_25_pro %} hosted on Google Cloud Platform (GCP). When using {% data variables.copilot.copilot_gemini %} models, prompts and metadata are sent to GCP, which makes the [following data commitment](https://cloud.google.com/gemini/docs/discover/data-governance): _{% data variables.copilot.copilot_gemini %} doesn't use your prompts, or its responses, as data to train its models._ @@ -32,11 +32,11 @@ You must enable access to {% data variables.copilot.copilot_gemini_flash %} and ### Setup for individual use -> [!NOTE] {% data variables.copilot.copilot_gemini_25_pro %} is not currently available for {% data variables.product.prodname_copilot_free_short %}. +> [!NOTE] {% data variables.copilot.copilot_gemini_25_pro %} is not currently available for {% data variables.copilot.copilot_free_short %}. -If you have a {% data variables.product.prodname_copilot_free_short %}, {% data variables.product.prodname_copilot_pro_short %}, or {% data variables.product.prodname_copilot_pro_plus_short %} subscription, you can enable {% data variables.copilot.copilot_gemini %} in two ways: +If you have a {% data variables.copilot.copilot_free_short %}, {% data variables.copilot.copilot_pro_short %}, or {% data variables.copilot.copilot_pro_plus_short %} subscription, you can enable {% data variables.copilot.copilot_gemini %} in two ways: -* The first time you choose to use {% data variables.copilot.copilot_gemini %} models with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.product.prodname_copilot_chat_short %}, you will be prompted to allow access to the model. +* The first time you choose to use {% data variables.copilot.copilot_gemini %} models with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.copilot.copilot_chat_short %}, you will be prompted to allow access to the model. Clicking **Allow** enables you to use {% data variables.copilot.copilot_gemini %} and updates the policy in your personal settings on {% data variables.product.github %}. @@ -46,8 +46,8 @@ If you have a {% data variables.product.prodname_copilot_free_short %}, {% data ### Setup for organization {% ifversion ghec %}and enterprise{% endif %} use -As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable both {% data variables.copilot.copilot_gemini_flash %} and {% data variables.copilot.copilot_gemini_25_pro %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-access-to-alternative-ai-models){% endif %}. +As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable both {% data variables.copilot.copilot_gemini_flash %} and {% data variables.copilot.copilot_gemini_25_pro %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or {% endif %}{% data variables.copilot.copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-access-to-alternative-ai-models){% endif %}. ## Using {% data variables.copilot.copilot_gemini %} -For details of how to change the model that {% data variables.product.prodname_copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +For details of how to change the model that {% data variables.copilot.copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). diff --git a/content/copilot/using-github-copilot/ai-models/using-openai-gpt-41-in-github-copilot.md b/content/copilot/using-github-copilot/ai-models/using-openai-gpt-41-in-github-copilot.md index ebfb1bc1c8..ef35d52e9b 100644 --- a/content/copilot/using-github-copilot/ai-models/using-openai-gpt-41-in-github-copilot.md +++ b/content/copilot/using-github-copilot/ai-models/using-openai-gpt-41-in-github-copilot.md @@ -2,21 +2,21 @@ title: Using OpenAI GPT-4.1 in Copilot Chat allowTitleToDifferFromFilename: true shortTitle: 'Use OpenAI {% data variables.copilot.copilot_gpt_41 %}' -intro: 'Learn how to enable OpenAI {% data variables.copilot.copilot_gpt_41 %} in {% data variables.product.prodname_copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' +intro: 'Learn how to enable OpenAI {% data variables.copilot.copilot_gpt_41 %} in {% data variables.copilot.copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' versions: feature: copilot topics: - Copilot --- -## About OpenAI {% data variables.copilot.copilot_gpt_41 %} in {% data variables.product.prodname_copilot_chat %} +## About OpenAI {% data variables.copilot.copilot_gpt_41 %} in {% data variables.copilot.copilot_chat %} -OpenAI has a family of large language models that you can use as an alternative to the default model used by {% data variables.product.prodname_copilot_chat_short %}. {% data variables.copilot.copilot_gpt_41 %} is one of those models and excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. For information about the capabilities of {% data variables.copilot.copilot_gpt_41 %}, see the [OpenAI documentation](https://platform.openai.com/docs/models). +OpenAI has a family of large language models that you can use as an alternative to the default model used by {% data variables.copilot.copilot_chat_short %}. {% data variables.copilot.copilot_gpt_41 %} is one of those models and excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. For information about the capabilities of {% data variables.copilot.copilot_gpt_41 %}, see the [OpenAI documentation](https://platform.openai.com/docs/models). {% data variables.copilot.copilot_gpt_41 %} is currently available in: -* {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} -* Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} +* {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} +* Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} {% data variables.copilot.copilot_gpt_41 %} is hosted by GitHub's Azure tenant when used in {% data variables.product.prodname_copilot %}. @@ -30,9 +30,9 @@ You must enable access to OpenAI {% data variables.copilot.copilot_gpt_41 %} ind ### Setup for individual use -If you have a {% data variables.product.prodname_copilot_free_short %}, {% data variables.product.prodname_copilot_pro_short %}, or {% data variables.product.prodname_copilot_pro_plus_short %} subscription, you can enable OpenAI {% data variables.copilot.copilot_gpt_41 %} in two ways: +If you have a {% data variables.copilot.copilot_free_short %}, {% data variables.copilot.copilot_pro_short %}, or {% data variables.copilot.copilot_pro_plus_short %} subscription, you can enable OpenAI {% data variables.copilot.copilot_gpt_41 %} in two ways: -* The first time you choose to use {% data variables.copilot.copilot_gpt_41 %} with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.product.prodname_copilot_chat_short %}, you will be prompted to allow access to the model. +* The first time you choose to use {% data variables.copilot.copilot_gpt_41 %} with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.copilot.copilot_chat_short %}, you will be prompted to allow access to the model. Clicking **Allow** enables you to use {% data variables.copilot.copilot_gpt_41 %} and updates the policy in your personal settings on {% data variables.product.github %}. @@ -42,8 +42,8 @@ If you have a {% data variables.product.prodname_copilot_free_short %}, {% data ### Setup for organization {% ifversion ghec %}and enterprise{% endif %} use -As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_gpt_41 %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}. +As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_gpt_41 %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or {% endif %}{% data variables.copilot.copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}. ## Using {% data variables.copilot.copilot_gpt_41 %} -For details of how to change the model that {% data variables.product.prodname_copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +For details of how to change the model that {% data variables.copilot.copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). diff --git a/content/copilot/using-github-copilot/ai-models/using-openai-o3-in-github-copilot.md b/content/copilot/using-github-copilot/ai-models/using-openai-o3-in-github-copilot.md index 465ffddbb4..28d391b7e9 100644 --- a/content/copilot/using-github-copilot/ai-models/using-openai-o3-in-github-copilot.md +++ b/content/copilot/using-github-copilot/ai-models/using-openai-o3-in-github-copilot.md @@ -2,23 +2,23 @@ title: Using OpenAI o3 in Copilot Chat allowTitleToDifferFromFilename: true shortTitle: 'Use OpenAI {% data variables.copilot.copilot_o3 %}' -intro: 'Learn how to enable OpenAI {% data variables.copilot.copilot_o3 %} in {% data variables.product.prodname_copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' +intro: 'Learn how to enable OpenAI {% data variables.copilot.copilot_o3 %} in {% data variables.copilot.copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' versions: feature: copilot topics: - Copilot --- -## About OpenAI {% data variables.copilot.copilot_o3 %} in {% data variables.product.prodname_copilot_chat %} +## About OpenAI {% data variables.copilot.copilot_o3 %} in {% data variables.copilot.copilot_chat %} {% data reusables.copilot.o3-public-preview-note %} -OpenAI has a family of large language models that you can use as an alternative to the default model used by {% data variables.product.prodname_copilot_chat_short %}. {% data variables.copilot.copilot_o3 %} is one of those models and excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. For information about the capabilities of {% data variables.copilot.copilot_o3 %}, see the [OpenAI documentation](https://platform.openai.com/docs/models). +OpenAI has a family of large language models that you can use as an alternative to the default model used by {% data variables.copilot.copilot_chat_short %}. {% data variables.copilot.copilot_o3 %} is one of those models and excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. For information about the capabilities of {% data variables.copilot.copilot_o3 %}, see the [OpenAI documentation](https://platform.openai.com/docs/models). {% data variables.copilot.copilot_o3 %} is currently available in: -* {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} -* Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} +* {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} +* Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} {% data variables.copilot.copilot_o3 %} is hosted by OpenAI and GitHub's Azure tenant when used in {% data variables.product.prodname_copilot %}. OpenAI makes the [following data commitment](https://openai.com/enterprise-privacy/): _We [OpenAI] do not train our models on your business data by default_. GitHub maintains a [zero data retention agreement](https://platform.openai.com/docs/guides/your-data) with OpenAI. @@ -32,9 +32,9 @@ You must enable access to OpenAI {% data variables.copilot.copilot_o3 %} individ ### Setup for individual use -If you have a {% data variables.product.prodname_copilot_pro_plus_short %} subscription, you can enable OpenAI {% data variables.copilot.copilot_o3 %} in two ways: +If you have a {% data variables.copilot.copilot_pro_plus_short %} subscription, you can enable OpenAI {% data variables.copilot.copilot_o3 %} in two ways: -* The first time you choose to use {% data variables.copilot.copilot_o3 %} with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.product.prodname_copilot_chat_short %}, you will be prompted to allow access to the model. +* The first time you choose to use {% data variables.copilot.copilot_o3 %} with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.copilot.copilot_chat_short %}, you will be prompted to allow access to the model. Clicking **Allow** enables you to use {% data variables.copilot.copilot_o3 %} and updates the policy in your personal settings on {% data variables.product.github %}. @@ -46,10 +46,10 @@ If you have a {% data variables.product.prodname_copilot_pro_plus_short %} subsc ### Setup enterprise use -As an enterprise owner, you can enable or disable {% data variables.copilot.copilot_o3 %} for everyone who has been assigned a {% data variables.product.prodname_copilot_enterprise_short %} seat through your enterprise. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). +As an enterprise owner, you can enable or disable {% data variables.copilot.copilot_o3 %} for everyone who has been assigned a {% data variables.copilot.copilot_enterprise_short %} seat through your enterprise. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). {% endif %} ## Using {% data variables.copilot.copilot_o3 %} -For details of how to change the model that {% data variables.product.prodname_copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +For details of how to change the model that {% data variables.copilot.copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). diff --git a/content/copilot/using-github-copilot/ai-models/using-openai-o4-mini-in-github-copilot.md b/content/copilot/using-github-copilot/ai-models/using-openai-o4-mini-in-github-copilot.md index 98b90e45fb..3d645ce277 100644 --- a/content/copilot/using-github-copilot/ai-models/using-openai-o4-mini-in-github-copilot.md +++ b/content/copilot/using-github-copilot/ai-models/using-openai-o4-mini-in-github-copilot.md @@ -2,23 +2,23 @@ title: Using OpenAI o4-mini in Copilot Chat allowTitleToDifferFromFilename: true shortTitle: 'Use OpenAI {% data variables.copilot.copilot_o4_mini %}' -intro: 'Learn how to enable OpenAI {% data variables.copilot.copilot_o4_mini %} in {% data variables.product.prodname_copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' +intro: 'Learn how to enable OpenAI {% data variables.copilot.copilot_o4_mini %} in {% data variables.copilot.copilot_chat %}, for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' versions: feature: copilot topics: - Copilot --- -## About OpenAI {% data variables.copilot.copilot_o4_mini %} in {% data variables.product.prodname_copilot_chat %} +## About OpenAI {% data variables.copilot.copilot_o4_mini %} in {% data variables.copilot.copilot_chat %} {% data reusables.copilot.o4-mini-public-preview-note %} -OpenAI has a family of large language models that you can use as an alternative to the default model used by {% data variables.product.prodname_copilot_chat_short %}. {% data variables.copilot.copilot_o4_mini %} is one of those models and excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. For information about the capabilities of {% data variables.copilot.copilot_o4_mini %}, see the [OpenAI documentation](https://platform.openai.com/docs/models). +OpenAI has a family of large language models that you can use as an alternative to the default model used by {% data variables.copilot.copilot_chat_short %}. {% data variables.copilot.copilot_o4_mini %} is one of those models and excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. For information about the capabilities of {% data variables.copilot.copilot_o4_mini %}, see the [OpenAI documentation](https://platform.openai.com/docs/models). {% data variables.copilot.copilot_o4_mini %} is currently available in: -* {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} -* Immersive mode in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.github %} +* {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} +* Immersive mode in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %} {% data variables.copilot.copilot_o4_mini %} is hosted by OpenAI and GitHub's Azure tenant when used in {% data variables.product.prodname_copilot %}. OpenAI makes the [following data commitment](https://openai.com/enterprise-privacy/): _We [OpenAI] do not train our models on your business data by default_. GitHub maintains a [zero data retention agreement](https://platform.openai.com/docs/guides/your-data) with OpenAI. @@ -32,9 +32,9 @@ You must enable access to OpenAI {% data variables.copilot.copilot_o4_mini %} in ### Setup for individual use -If you have a {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} subscription, you can enable OpenAI {% data variables.copilot.copilot_o4_mini %} in two ways: +If you have a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} subscription, you can enable OpenAI {% data variables.copilot.copilot_o4_mini %} in two ways: -* The first time you choose to use {% data variables.copilot.copilot_o4_mini %} with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.product.prodname_copilot_chat_short %}, you will be prompted to allow access to the model. +* The first time you choose to use {% data variables.copilot.copilot_o4_mini %} with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.copilot.copilot_chat_short %}, you will be prompted to allow access to the model. Clicking **Allow** enables you to use {% data variables.copilot.copilot_o4_mini %} and updates the policy in your personal settings on {% data variables.product.github %}. @@ -44,8 +44,8 @@ If you have a {% data variables.product.prodname_copilot_pro_short %} or {% data ### Setup for organization {% ifversion ghec %}and enterprise{% endif %} use -As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_o4_mini %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}. +As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_o4_mini %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.copilot.copilot_enterprise_short %} or {% endif %}{% data variables.copilot.copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}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){% ifversion ghec %} and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}. ## Using {% data variables.copilot.copilot_o4_mini %} -For details of how to change the model that {% data variables.product.prodname_copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +For details of how to change the model that {% data variables.copilot.copilot_chat_short %} uses, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). diff --git a/content/copilot/using-github-copilot/asking-github-copilot-questions-in-windows-terminal.md b/content/copilot/using-github-copilot/asking-github-copilot-questions-in-windows-terminal.md index e8165654da..18ef3afc18 100644 --- a/content/copilot/using-github-copilot/asking-github-copilot-questions-in-windows-terminal.md +++ b/content/copilot/using-github-copilot/asking-github-copilot-questions-in-windows-terminal.md @@ -14,7 +14,7 @@ versions: * **{% data variables.product.prodname_windows_terminal %} Canary installed**. For installation instructions, see [Installing {% data variables.product.prodname_windows_terminal %} Canary](https://github.com/microsoft/terminal?tab=readme-ov-file#installing-windows-terminal-canary). * **{% data variables.product.prodname_copilot %} connected to Terminal Chat**. See [AUTOTITLE](/copilot/quickstart?tool=windowsterminal). -If you have access to {% data variables.product.prodname_copilot %} via your organization or enterprise, you cannot use {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_windows_terminal %} if your organization owner or enterprise administrator has disabled {% data variables.product.prodname_copilot_cli_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization). +If you have access to {% data variables.product.prodname_copilot %} via your organization or enterprise, you cannot use {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_windows_terminal %} if your organization owner or enterprise administrator has disabled {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization). ## Getting command explanations and suggestions diff --git a/content/copilot/using-github-copilot/best-practices-for-using-github-copilot.md b/content/copilot/using-github-copilot/best-practices-for-using-github-copilot.md index 1ae6df4156..78309f9a9c 100644 --- a/content/copilot/using-github-copilot/best-practices-for-using-github-copilot.md +++ b/content/copilot/using-github-copilot/best-practices-for-using-github-copilot.md @@ -26,7 +26,7 @@ shortTitle: Best practices ## Choose the right {% data variables.product.prodname_copilot_short %} tool for the job -While {% data variables.product.prodname_copilot_short %} code completion and {% data variables.product.prodname_copilot_chat_short %} share some functionality, the two tools are best used in different circumstances. +While {% data variables.product.prodname_copilot_short %} code completion and {% data variables.copilot.copilot_chat_short %} share some functionality, the two tools are best used in different circumstances. **Code completion works best for:** @@ -35,12 +35,12 @@ While {% data variables.product.prodname_copilot_short %} code completion and {% * Generating code from inline comments in natural language * Generating tests for test-driven development -**Alternatively, {% data variables.product.prodname_copilot_chat_short %} is best suited for:** +**Alternatively, {% data variables.copilot.copilot_chat_short %} is best suited for:** * Answering questions about code in natural language * Generating large sections of code, then iterating on that code to meet your needs -* Accomplishing specific tasks with keywords and skills. {% data variables.product.prodname_copilot_chat_short %} has built-in keywords and skills designed to provide important context for prompts and accomplish common tasks quickly. Different types of keywords and skills are available in different {% data variables.product.prodname_copilot_chat_short %} platforms. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#using-keywords-in-your-prompt){% ifversion fpt %}.{% else %} and [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#powered-by-skills).{% endif %} -* Completing a task as a specific persona. For example, you can tell {% data variables.product.prodname_copilot_chat_short %} that it is a Senior C++ Developer who cares greatly about code quality, readability, and efficiency, then ask it to review your code. +* Accomplishing specific tasks with keywords and skills. {% data variables.copilot.copilot_chat_short %} has built-in keywords and skills designed to provide important context for prompts and accomplish common tasks quickly. Different types of keywords and skills are available in different {% data variables.copilot.copilot_chat_short %} platforms. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#using-keywords-in-your-prompt){% ifversion fpt %}.{% else %} and [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#powered-by-skills).{% endif %} +* Completing a task as a specific persona. For example, you can tell {% data variables.copilot.copilot_chat_short %} that it is a Senior C++ Developer who cares greatly about code quality, readability, and efficiency, then ask it to review your code. ## Create thoughtful prompts @@ -57,7 +57,7 @@ To learn more, see [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering- While {% data variables.product.prodname_copilot_short %} is very powerful, it is still a tool capable of making mistakes, and you should always validate the code it suggests. Use the following tips to ensure you are accepting accurate, secure suggestions: -* **Understand suggested code before you implement it.** To ensure you fully understand {% data variables.product.prodname_copilot_short %}'s suggestion, you can ask {% data variables.product.prodname_copilot_chat_short %} to explain the code. +* **Understand suggested code before you implement it.** To ensure you fully understand {% data variables.product.prodname_copilot_short %}'s suggestion, you can ask {% data variables.copilot.copilot_chat_short %} to explain the code. * **Review {% data variables.product.prodname_copilot_short %}'s suggestions carefully.** Consider not just the functionality and security of the suggested code, but also the readability and maintainability of the code moving forward. * **Use automated tests and tooling to check {% data variables.product.prodname_copilot_short %}'s work.** With the help of tools like linting, {% data variables.product.prodname_code_scanning %}, and IP scanning, you can automate an additional layer of security and accuracy checks. @@ -69,16 +69,16 @@ There are several adjustments you can make to steer {% data variables.product.pr * **Provide {% data variables.product.prodname_copilot_short %} with helpful context:** * If you are using {% data variables.product.prodname_copilot_short %} in your IDE, open relevant files and close irrelevant files. - * In {% data variables.product.prodname_copilot_chat_short %}, if a particular request is no longer helpful context, delete that request from the conversation. Alternatively, if none of the context of a particular conversation is helpful, start a new conversation. - * If you are using {% data variables.product.prodname_copilot_chat_dotcom_short %}, provide specific repositories, files, symbols, and more as context. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom). - * If you are using {% data variables.product.prodname_copilot_chat_short %} in your IDE, use keywords to focus {% data variables.product.prodname_copilot_short %} on a specific task or piece of context. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#using-keywords-in-your-prompt). + * In {% data variables.copilot.copilot_chat_short %}, if a particular request is no longer helpful context, delete that request from the conversation. Alternatively, if none of the context of a particular conversation is helpful, start a new conversation. + * If you are using {% data variables.copilot.copilot_chat_dotcom_short %}, provide specific repositories, files, symbols, and more as context. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom). + * If you are using {% data variables.copilot.copilot_chat_short %} in your IDE, use keywords to focus {% data variables.product.prodname_copilot_short %} on a specific task or piece of context. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#using-keywords-in-your-prompt). * **Rewrite your prompts to generate different responses.** If {% data variables.product.prodname_copilot_short %} is not providing a helpful response, try rephrasing your prompt, or even breaking your request down into multiple smaller prompts. * **Pick the best available suggestion.** When you are using code completion, {% data variables.product.prodname_copilot_short %} might offer more than one suggestion. You can use keyboard shortcuts to quickly look through all available suggestions. For the default keyboard shortcuts for your operating system, see [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment#keyboard-shortcuts-for-github-copilot). * **Provide feedback to improve future suggestions.** You can provide feedback in many ways: * For code completion, accept or reject {% data variables.product.prodname_copilot_short %}'s suggestion. - * For individual responses in {% data variables.product.prodname_copilot_chat_short %}, click the thumbs up or thumbs down icons next to the response. - * For {% data variables.product.prodname_copilot_chat_short %} in your IDE, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#sharing-feedback) for instructions specific to your environment. - * For {% data variables.product.prodname_copilot_chat_dotcom_short %}, leave a comment on the [feedback discussion](https://github.com/orgs/community/discussions/110314). + * For individual responses in {% data variables.copilot.copilot_chat_short %}, click the thumbs up or thumbs down icons next to the response. + * For {% data variables.copilot.copilot_chat_short %} in your IDE, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#sharing-feedback) for instructions specific to your environment. + * For {% data variables.copilot.copilot_chat_dotcom_short %}, leave a comment on the [feedback discussion](https://github.com/orgs/community/discussions/110314). ## Stay up-to-date on {% data variables.product.prodname_copilot_short %}'s features diff --git a/content/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot.md b/content/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot.md index 7ad57ac3a7..fae13b756e 100644 --- a/content/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot.md +++ b/content/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot.md @@ -12,7 +12,7 @@ topics: By default, {% data variables.product.prodname_copilot_short %} will only review a pull request if it's assigned to the pull request in the same way you would assign a human reviewer. However: -* Individual users on the {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan can configure {% data variables.product.prodname_copilot_short %} to automatically review all pull requests they create. +* Individual users on the {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan can configure {% data variables.product.prodname_copilot_short %} to automatically review all pull requests they create. * Repository owners can configure {% data variables.product.prodname_copilot_short %} to automatically review all pull requests in the repository that are created by people with access to {% data variables.product.prodname_copilot_short %}. * Organization owners can configure {% data variables.product.prodname_copilot_short %} to automatically review all pull requests in some or all of the repositories in the organization where the pull request is created by a {% data variables.product.prodname_copilot_short %} user. @@ -36,7 +36,7 @@ After you configure automatic code review, {% data variables.product.prodname_co ## Configuring automatic code review for all pull requests you create > [!NOTE] -> This is only available if you are on the {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan. +> This is only available if you are on the {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan. {% data reusables.copilot.your-copilot %} 1. Locate the **Automatic {% data variables.copilot.copilot_code-review_short %}** option and click the dropdown button. diff --git a/content/copilot/using-github-copilot/code-review/using-copilot-code-review.md b/content/copilot/using-github-copilot/code-review/using-copilot-code-review.md index 2734693d0c..cf928a514a 100644 --- a/content/copilot/using-github-copilot/code-review/using-copilot-code-review.md +++ b/content/copilot/using-github-copilot/code-review/using-copilot-code-review.md @@ -31,7 +31,7 @@ The current functionality and availability of the two types of review is summari | | 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. | +| Premium/standard feature | Standard feature available to all {% data variables.product.prodname_copilot_short %} subscribers | Premium feature. Available with the {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, {% data variables.copilot.copilot_business_short %}, and {% data variables.copilot.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

{% 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) | @@ -66,7 +66,7 @@ This version of the article relates to {% data variables.copilot.copilot_code-re ### 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. +{% data variables.copilot.copilot_code-review_short %} on the {% data variables.product.github %} website is a premium feature, available with the {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, {% data variables.copilot.copilot_business_short %}, and {% data variables.copilot.copilot_enterprise_short %} plans. ### Code review monthly quota @@ -162,7 +162,7 @@ By default, you manually request a review from {% data variables.product.prodnam 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. +> [!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.copilot.copilot_chat %} extension. ### Reviewing a selection of code @@ -247,6 +247,6 @@ To use {% data variables.copilot.copilot_code-review_short %}, you must use {% d 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. +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.copilot.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 %} diff --git a/content/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot.md b/content/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot.md index f6004ddc2f..0e868ebb82 100644 --- a/content/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot.md +++ b/content/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot.md @@ -30,7 +30,7 @@ With {% data variables.copilot.copilot_coding_agent %}, {% data variables.produc To delegate development tasks to {% data variables.product.prodname_copilot_short %}, you can: * Assign an issue to {% data variables.product.prodname_copilot_short %} -* Use {% data variables.product.prodname_copilot_chat %} to ask {% data variables.product.prodname_copilot_short %} to create a pull request +* Use {% data variables.copilot.copilot_chat %} to ask {% data variables.product.prodname_copilot_short %} to create a pull request {% data variables.product.prodname_copilot_short %} will evaluate the task it has been assigned based on the prompt you give it—whether that's from the issue description or a chat message. Then {% data variables.product.prodname_copilot_short %} will make the required changes and open a pull request. When {% data variables.product.prodname_copilot_short %} finishes, it will request a review from you, and you can leave pull request comments to ask {% data variables.product.prodname_copilot_short %} to iterate. diff --git a/content/copilot/using-github-copilot/coding-agent/asking-copilot-to-create-a-pull-request.md b/content/copilot/using-github-copilot/coding-agent/asking-copilot-to-create-a-pull-request.md index 75074bc13c..2b76374875 100644 --- a/content/copilot/using-github-copilot/coding-agent/asking-copilot-to-create-a-pull-request.md +++ b/content/copilot/using-github-copilot/coding-agent/asking-copilot-to-create-a-pull-request.md @@ -1,7 +1,7 @@ --- title: Asking Copilot to create a pull request shortTitle: Create a PR from chat -intro: 'You can use a {% data variables.product.prodname_copilot_chat_short %} prompt to ask {% data variables.product.prodname_copilot_short %} to create a pull request.' +intro: 'You can use a {% data variables.copilot.copilot_chat_short %} prompt to ask {% data variables.product.prodname_copilot_short %} to create a pull request.' product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot @@ -14,7 +14,7 @@ redirect_from: --- > [!NOTE] -> * If you have access to {% data variables.copilot.copilot_coding_agent %}, you can create a pull request from {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, and on {% data variables.product.prodname_dotcom_the_website %}. +> * If you have access to {% data variables.copilot.copilot_coding_agent %}, you can create a pull request from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, and on {% data variables.product.prodname_dotcom_the_website %}. > * {% data reusables.copilot.coding-agent.preview-note-text %} ## Introduction @@ -25,9 +25,9 @@ Instead—if {% data variables.copilot.copilot_coding_agent %} is available—yo For information on making {% data variables.copilot.copilot_coding_agent %} available, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/enabling-copilot-coding-agent). -## Creating a pull request from {% data variables.product.prodname_copilot_chat_short %} +## Creating a pull request from {% data variables.copilot.copilot_chat_short %} -1. Open {% data variables.product.prodname_copilot_chat %}, in your IDE, or while viewing a file on {% data variables.product.prodname_dotcom_the_website %}. +1. Open {% data variables.copilot.copilot_chat %}, in your IDE, or while viewing a file on {% data variables.product.prodname_dotcom_the_website %}. 1. Type a prompt asking {% data variables.product.prodname_copilot_short %} to create a pull request, and giving details of what you want {% data variables.product.prodname_copilot_short %} to change. For example, `@github Create a PR to put backticks around file names and variables in output.` diff --git a/content/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent.md b/content/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent.md index 66b8a8b80e..d03228f5f2 100644 --- a/content/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent.md +++ b/content/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent.md @@ -18,16 +18,16 @@ redirect_from: ## {% data variables.product.prodname_copilot_short %} is not available in the "Assignees" list on my issue -You can only assign issues to {% data variables.product.prodname_copilot_short %} if you have access to {% data variables.product.prodname_copilot_short %} through either the **{% data variables.product.prodname_copilot_pro_plus %}** plan or the **{% data variables.product.prodname_copilot_enterprise %}** plan. +You can only assign issues to {% data variables.product.prodname_copilot_short %} if you have access to {% data variables.product.prodname_copilot_short %} through either the **{% data variables.copilot.copilot_pro_plus %}** plan or the **{% data variables.copilot.copilot_enterprise %}** plan. If you do not already have a subscription for one of these plans, click this button for more information:
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 aria-label="link-external" %} -If you _do_ have either {% data variables.product.prodname_copilot_pro_plus %} or {% data variables.product.prodname_copilot_enterprise %}, check that {% data variables.copilot.copilot_coding_agent %} {% ifversion ghec %}is enabled and{% endif %} has been made available for the repository: +If you _do_ have either {% data variables.copilot.copilot_pro_plus %} or {% data variables.copilot.copilot_enterprise %}, check that {% data variables.copilot.copilot_coding_agent %} {% ifversion ghec %}is enabled and{% endif %} has been made available for the repository: {% ifversion ghec %} -* If you are on the {% data variables.product.prodname_copilot_enterprise_short %} plan, your ability to use {% data variables.copilot.copilot_coding_agent %} is controlled at the enterprise level. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/adding-copilot-coding-agent-to-enterprise). +* If you are on the {% data variables.copilot.copilot_enterprise_short %} plan, your ability to use {% data variables.copilot.copilot_coding_agent %} is controlled at the enterprise level. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/adding-copilot-coding-agent-to-enterprise). {% endif %} @@ -38,7 +38,7 @@ If you _do_ have either {% data variables.product.prodname_copilot_pro_plus %} o > [!NOTE] > You can check whether {% data variables.copilot.copilot_coding_agent %} has been enabled for you in the features page of your {% data variables.product.prodname_copilot_short %} settings: [github.com/settings/copilot/features](https://github.com/settings/copilot/features). -## {% data variables.product.prodname_copilot_short %} can't create a pull request from {% data variables.product.prodname_copilot_chat_short %} +## {% data variables.product.prodname_copilot_short %} can't create a pull request from {% data variables.copilot.copilot_chat_short %} If you asked {% data variables.product.prodname_copilot_short %} to create a pull request and it responds that it cannot directly create a pull request, check that {% data variables.copilot.copilot_coding_agent %} is available. diff --git a/content/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs.md b/content/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs.md index a4a0c8e355..b6604b7fa4 100644 --- a/content/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs.md +++ b/content/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs.md @@ -16,7 +16,7 @@ redirect_from: ## Introduction -After you assign an issue to {% data variables.product.prodname_copilot_short %}, or use {% data variables.product.prodname_copilot_chat_short %} to ask {% data variables.product.prodname_copilot_short %} to create a pull request, {% data variables.product.prodname_copilot_short %} works autonomously to complete the task. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot). +After you assign an issue to {% data variables.product.prodname_copilot_short %}, or use {% data variables.copilot.copilot_chat_short %} to ask {% data variables.product.prodname_copilot_short %} to create a pull request, {% data variables.product.prodname_copilot_short %} works autonomously to complete the task. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot). During or after an agent session, you can inspect the session logs to understand {% data variables.product.prodname_copilot_short %}'s approach to your problem. diff --git a/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile.md b/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile.md index 218cf845cc..c48396ba92 100644 --- a/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile.md +++ b/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile.md @@ -1,6 +1,6 @@ --- title: Asking GitHub Copilot questions in GitHub Mobile -intro: 'You can use {% data variables.product.prodname_copilot_mobile %} to answer general questions about software development, or specific questions about the code in a repository{% ifversion ghec %}. With {% data variables.product.prodname_copilot_enterprise_short %} you can also ask specific questions about a pull request, issue, or discussion{% endif %}.' +intro: 'You can use {% data variables.copilot.copilot_mobile %} to answer general questions about software development, or specific questions about the code in a repository{% ifversion ghec %}. With {% data variables.copilot.copilot_enterprise_short %} you can also ask specific questions about a pull request, issue, or discussion{% endif %}.' topics: - Copilot - Mobile @@ -16,17 +16,17 @@ redirect_from: ## Overview -{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions in {% data variables.product.prodname_mobile %}. You can also use {% data variables.product.prodname_copilot_chat %} on either {% data variables.product.github %} or within a supported IDE. For information on using {% data variables.product.prodname_copilot_chat %} in an IDE, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide). +{% data variables.copilot.copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions in {% data variables.product.prodname_mobile %}. You can also use {% data variables.copilot.copilot_chat %} on either {% data variables.product.github %} or within a supported IDE. For information on using {% data variables.copilot.copilot_chat %} in an IDE, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide). -{% data variables.product.prodname_copilot_mobile_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile). +{% data variables.copilot.copilot_mobile_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile). -In {% data variables.product.prodname_mobile %}, you can use {% data variables.product.prodname_copilot_chat_short %} to ask: +In {% data variables.product.prodname_mobile %}, you can use {% data variables.copilot.copilot_chat_short %} to ask: * General software-related questions, without a particular context. For more information, see [Asking a general question about software development](#asking-a-general-question-about-software-development). * Questions asked in the context of your project. For more information, see [Asking questions about a specific repository](#asking-exploratory-questions-about-a-repository). * Questions about a specific file or specified lines of code within a file. For more information, see [Asking questions about specific pieces of code](#asking-questions-about-specific-pieces-of-code).{% ifversion ghec %} -With {% data variables.product.prodname_copilot_enterprise_short %}, you can also ask: +With {% data variables.copilot.copilot_enterprise_short %}, you can also ask: * Questions about a specific pull request. For more information, see [Asking questions about a specific pull request](#asking-questions-about-a-specific-pull-request). * Questions about a specific issue. For more information, see [Asking questions about a specific issue](#asking-questions-about-a-specific-issue). @@ -35,15 +35,15 @@ With {% data variables.product.prodname_copilot_enterprise_short %}, you can als ## Limitations -The following limitations apply to {% data variables.product.prodname_copilot_mobile_short %}: +The following limitations apply to {% data variables.copilot.copilot_mobile_short %}: -* The quality of the results from {% data variables.product.prodname_copilot_chat_short %} may, in some situations, be degraded if very large files, or a large number of files, are used as a context for a question. +* The quality of the results from {% data variables.copilot.copilot_chat_short %} may, in some situations, be degraded if very large files, or a large number of files, are used as a context for a question. ## Prerequisites -To use {% data variables.product.prodname_copilot_mobile_short %}, click the {% data variables.product.prodname_copilot_short %} icon in {% data variables.product.prodname_mobile %} to initiate a chat. If you don't already have an active {% data variables.product.prodname_copilot %} subscription, you will automatically get subscribed to {% data variables.product.prodname_copilot_free_short %}. +To use {% data variables.copilot.copilot_mobile_short %}, click the {% data variables.product.prodname_copilot_short %} icon in {% data variables.product.prodname_mobile %} to initiate a chat. If you don't already have an active {% data variables.product.prodname_copilot %} subscription, you will automatically get subscribed to {% data variables.copilot.copilot_free_short %}. -If you are part of an organization{% ifversion ghec %} or enterprise{% endif %} with a {% data variables.product.prodname_copilot_for_business %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise %}{% endif %} subscription, the organization{% ifversion ghec %} or enterprise{% endif %} owner may need to grant you access to {% data variables.product.prodname_copilot_mobile_short %}. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/enabling-github-copilot-chat-for-github-mobile). +If you are part of an organization{% ifversion ghec %} or enterprise{% endif %} with a {% data variables.copilot.copilot_for_business %}{% ifversion ghec %} or {% data variables.copilot.copilot_enterprise %}{% endif %} subscription, the organization{% ifversion ghec %} or enterprise{% endif %} owner may need to grant you access to {% data variables.copilot.copilot_mobile_short %}. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/enabling-github-copilot-chat-for-github-mobile). ## Asking a general question about software development @@ -62,7 +62,7 @@ You can ask a general question about software development{% ifversion ghec %} th 1. Within a conversation thread, you can ask follow-up questions. {% data variables.product.prodname_copilot_short %} will answer within the context of the conversation. For example, you could type "tell me more" to get {% data variables.product.prodname_copilot_short %} to expand on its last comment. - You can use your initial question as a foundation for follow-up questions. A detailed foundational prompt can help {% data variables.product.prodname_copilot_short %} provide more relevant answers to your follow-up questions. For more information, see [Prompting {% data variables.product.prodname_copilot_chat %} to become your personal AI assistant for accessibility](https://github.blog/2023-10-09-prompting-github-copilot-chat-to-become-your-personal-ai-assistant-for-accessibility/) on the {% data variables.product.prodname_dotcom %} Blog. + You can use your initial question as a foundation for follow-up questions. A detailed foundational prompt can help {% data variables.product.prodname_copilot_short %} provide more relevant answers to your follow-up questions. For more information, see [Prompting {% data variables.copilot.copilot_chat %} to become your personal AI assistant for accessibility](https://github.blog/2023-10-09-prompting-github-copilot-chat-to-become-your-personal-ai-assistant-for-accessibility/) on the {% data variables.product.prodname_dotcom %} Blog. {% data reusables.copilot.chat-mobile-conversation-buttons %} @@ -82,9 +82,9 @@ You can ask questions about a specific repository, to get help with understandin * Are there any specific environment requirements for working on this project? > [!IMPORTANT] - > {% data variables.product.prodname_copilot_short %}'s ability to answer natural language questions like these in a repository context is improved when the repository has been indexed for semantic code search. Without indexing, {% data variables.product.prodname_copilot_mobile_short %} may not be able to provide the most relevant answers to your questions. + > {% data variables.product.prodname_copilot_short %}'s ability to answer natural language questions like these in a repository context is improved when the repository has been indexed for semantic code search. Without indexing, {% data variables.copilot.copilot_mobile_short %} may not be able to provide the most relevant answers to your questions. > - > You can't trigger the creation of a semantic code search index for a repository from {% data variables.product.prodname_mobile %}. Instead you must use {% data variables.product.prodname_copilot_chat_short %} in a web browser. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/indexing-repositories-for-copilot-chat). + > You can't trigger the creation of a semantic code search index for a repository from {% data variables.product.prodname_mobile %}. Instead you must use {% data variables.copilot.copilot_chat_short %} in a web browser. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/indexing-repositories-for-copilot-chat). {% data reusables.copilot.chat-mobile-conversation-buttons %} @@ -95,7 +95,7 @@ You can chat with {% data variables.product.prodname_copilot_short %} about a fi 1. In {% data variables.product.prodname_mobile %}, navigate to a repository and open a file. 1. Do one of the following: * To ask a question about the entire file, tap the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the bottom right corner of the file view. - * To ask a question about specific lines within the file, select and copy the lines you want to ask about. Then tap the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) and paste the copied lines in the {% data variables.product.prodname_copilot_chat_short %} input field. + * To ask a question about specific lines within the file, select and copy the lines you want to ask about. Then tap the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) and paste the copied lines in the {% data variables.copilot.copilot_chat_short %} input field. 1. Type a question in the "Ask {% data variables.product.prodname_copilot_short %}" box at the bottom of the chat panel and send the message. @@ -173,11 +173,11 @@ You can ask questions about a specific discussion in a repository. {% endif %} -## Extending {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_mobile %} +## Extending {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_mobile %} {% data reusables.copilot.copilot-extensions.extending-copilot-chat %} -## Hiding {% data variables.product.prodname_copilot_chat_short %} +## Hiding {% data variables.copilot.copilot_chat_short %} You can hide the floating {% data variables.product.prodname_copilot_short %} button in {% data variables.product.prodname_mobile %}. @@ -186,9 +186,9 @@ You can hide the floating {% data variables.product.prodname_copilot_short %} bu 1. Tap **{% data variables.product.prodname_copilot_short %}**. 1. Next to "Hide {% data variables.product.prodname_copilot_short %}", use the toggle to hide {% data variables.product.prodname_copilot_short %}. -## Sharing feedback about {% data variables.product.prodname_copilot_mobile %} +## Sharing feedback about {% data variables.copilot.copilot_mobile %} -To give feedback about a particular {% data variables.product.prodname_copilot_chat_short %} response: +To give feedback about a particular {% data variables.copilot.copilot_chat_short %} response: 1. Tap the ellipsis (**...**) in the top right corner above the chat response you want to provide feedback on, and tap either **Like {% data variables.product.prodname_copilot_short %} response {% octicon "thumbsup" aria-label="The thumbs up icon" %}** or **Dislike {% data variables.product.prodname_copilot_short %} response {% octicon "thumbsdown" aria-label="The thumbs down icon" %}**, 1. Optionally, provide information about why you liked or disliked the response. diff --git a/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github.md b/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github.md index fdc16779b3..c657f3f5c8 100644 --- a/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github.md +++ b/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github.md @@ -1,7 +1,7 @@ --- title: Asking GitHub Copilot questions in GitHub shortTitle: Chat in GitHub -intro: 'You can use {% data variables.product.prodname_copilot_chat_dotcom %} to answer general questions about software development, or specific questions about the issues or code in a repository.' +intro: 'You can use {% data variables.copilot.copilot_chat_dotcom %} to answer general questions about software development, or specific questions about the issues or code in a repository.' versions: feature: copilot topics: @@ -18,22 +18,22 @@ redirect_from: ## Overview -{% data variables.product.prodname_copilot_chat_dotcom %} is a chat interface that lets you ask and receive answers to coding-related questions on the {% data variables.product.github %} website. +{% data variables.copilot.copilot_chat_dotcom %} is a chat interface that lets you ask and receive answers to coding-related questions on the {% data variables.product.github %} website. -{% data variables.product.prodname_copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom). +{% data variables.copilot.copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom). -On {% data variables.product.github %}, you can use {% data variables.product.prodname_copilot_chat_short %} to ask different questions in different contexts. For example, you can ask about a specific repository, a specific issue, or a specific pull request. You can also ask general questions about software development, or about a specific programming language. +On {% data variables.product.github %}, you can use {% data variables.copilot.copilot_chat_short %} to ask different questions in different contexts. For example, you can ask about a specific repository, a specific issue, or a specific pull request. You can also ask general questions about software development, or about a specific programming language. ### Limitations -The quality of the results from {% data variables.product.prodname_copilot_chat_short %} may, in some situations, be degraded if very large files, or a large number of files, are used as a context for a question. +The quality of the results from {% data variables.copilot.copilot_chat_short %} may, in some situations, be degraded if very large files, or a large number of files, are used as a context for a question. -### Viewing and editing generated files within {% data variables.product.prodname_copilot_chat_short %} +### Viewing and editing generated files within {% data variables.copilot.copilot_chat_short %} > [!NOTE] > This feature is currently in {% data variables.release-phases.public_preview %} and subject to change. -When you ask a question, {% data variables.product.prodname_copilot_short %} may generate one or more files as part of its response. In the {% data variables.product.prodname_copilot_chat_short %} panel, the files are displayed inline, within the chat response. In immersive view (that is, at [https://github.com/copilot](https://github.com/copilot)), the generated files are displayed in a side panel. You can view and edit the files in the panel, or download them to your computer. +When you ask a question, {% data variables.product.prodname_copilot_short %} may generate one or more files as part of its response. In the {% data variables.copilot.copilot_chat_short %} panel, the files are displayed inline, within the chat response. In immersive view (that is, at [https://github.com/copilot](https://github.com/copilot)), the generated files are displayed in a side panel. You can view and edit the files in the panel, or download them to your computer. For example, asking `Generate a simple calculator using HTML, CSS, and JavaScript` may generate multiple files, such as `index.html`, `styles.css`, and `script.js`. @@ -45,27 +45,27 @@ When using the {% data variables.copilot.copilot_gpt_4o %} and {% data variables ![Screenshot of the {% data variables.product.prodname_copilot_short %} chat panel with the status information expanded and the skill that was used highlighted with an orange outline.](/assets/images/help/copilot/chat-show-skill.png) -You can explicitly ask {% data variables.product.prodname_copilot_chat_dotcom %} to use a particular skill - for example, `Use the Bing skill to find the latest GPT4 model from OpenAI`. +You can explicitly ask {% data variables.copilot.copilot_chat_dotcom %} to use a particular skill - for example, `Use the Bing skill to find the latest GPT4 model from OpenAI`. You can generate a list of currently available skills by asking {% data variables.product.prodname_copilot_short %}: `What skills are available?` -## Customizing {% data variables.product.prodname_copilot_chat_short %} responses +## Customizing {% data variables.copilot.copilot_chat_short %} responses -{% data variables.product.prodname_copilot %} can provide chat responses that are tailored to the way your team works, the tools you use, the specifics of your project, or your personal preferences, if you provide it with enough context to do so. Instead of repeating instructions in each prompt, you can create and save instructions for {% data variables.product.prodname_copilot_chat_short %} to customize what responses you receive. +{% data variables.product.prodname_copilot %} can provide chat responses that are tailored to the way your team works, the tools you use, the specifics of your project, or your personal preferences, if you provide it with enough context to do so. Instead of repeating instructions in each prompt, you can create and save instructions for {% data variables.copilot.copilot_chat_short %} to customize what responses you receive. -There are two types of custom instructions you can add for {% data variables.product.prodname_copilot_chat_short %}: +There are two types of custom instructions you can add for {% data variables.copilot.copilot_chat_short %}: * Repository instructions: You can create a custom instructions file for a repository, so that all prompts asked in the context of the repository automatically include the instructions you've defined * Personal instructions: You can add personal instructions so that all the chat responses you, as a user, receive are tailored to your preferences For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot) and [AUTOTITLE](/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot). -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.change-the-ai-model %} -## Submitting a question to {% data variables.product.prodname_copilot_chat_short %} +## Submitting a question to {% data variables.copilot.copilot_chat_short %} -You can open {% data variables.product.prodname_copilot_chat_short %} from any page on {% data variables.product.github %}. Certain questions may require you to be in a specific context, such as a repository, issue, or pull request. The following procedure describes how to ask a general software related question, and demonstrates the core functionality of {% data variables.product.prodname_copilot_chat_short %} on {% data variables.product.github %}. For more information on other scenarios, see [Asking {% data variables.product.prodname_copilot_chat_short %} questions in different contexts](/copilot/using-github-copilot/asking-github-copilot-questions-in-github#asking-copilot-chat-questions-in-different-contexts). +You can open {% data variables.copilot.copilot_chat_short %} from any page on {% data variables.product.github %}. Certain questions may require you to be in a specific context, such as a repository, issue, or pull request. The following procedure describes how to ask a general software related question, and demonstrates the core functionality of {% data variables.copilot.copilot_chat_short %} on {% data variables.product.github %}. For more information on other scenarios, see [Asking {% data variables.copilot.copilot_chat_short %} questions in different contexts](/copilot/using-github-copilot/asking-github-copilot-questions-in-github#asking-copilot-chat-questions-in-different-contexts). Depending on the question you ask, and your enterprise and organization settings, {% data variables.product.prodname_copilot_short %} may respond using information based on the results of a Bing search. By using Bing search, {% data variables.product.prodname_copilot_short %} can answer a broad range of tech-related questions with up-to-date details based on information currently available on the internet. For information on how to enable or disable Bing search integration, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-web-search-for-github-copilot-chat) and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). @@ -87,7 +87,7 @@ Depending on the question you ask, and your enterprise and organization settings 1. If {% data variables.product.prodname_copilot_short %} uses a Bing search to answer your question, "Using web search results for 'SEARCH QUERY'" is displayed above the response. Click this to see the search results that {% data variables.product.prodname_copilot_short %} used to answer your question. 1. Within a conversation thread, you can ask follow-up questions. {% data variables.product.prodname_copilot_short %} will answer within the context of the conversation. For example, you could type "tell me more" to get {% data variables.product.prodname_copilot_short %} to expand on its last comment. - You can use your initial question as a foundation for follow-up questions. A detailed foundational prompt can help {% data variables.product.prodname_copilot_short %} provide more relevant answers to your follow-up questions. For more information, see [Prompting {% data variables.product.prodname_copilot_chat %} to become your personal AI assistant for accessibility](https://github.blog/2023-10-09-prompting-github-copilot-chat-to-become-your-personal-ai-assistant-for-accessibility/) on the {% data variables.product.prodname_dotcom %} Blog. + You can use your initial question as a foundation for follow-up questions. A detailed foundational prompt can help {% data variables.product.prodname_copilot_short %} provide more relevant answers to your follow-up questions. For more information, see [Prompting {% data variables.copilot.copilot_chat %} to become your personal AI assistant for accessibility](https://github.blog/2023-10-09-prompting-github-copilot-chat-to-become-your-personal-ai-assistant-for-accessibility/) on the {% data variables.product.prodname_dotcom %} Blog. 1. To start a new conversation, click {% data reusables.copilot.pencil-paper-icon %} at the top left of the page. 1. To see a list of your previous conversations, click {% octicon "sidebar-collapse" aria-label="Open sidebar" %} at the top left of the page. @@ -106,11 +106,11 @@ For help deciding which model to use, see [AUTOTITLE](/copilot/using-github-copi ### Using subthreads in a conversation > [!NOTE] -> Subthreading in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and is subject to change. +> Subthreading in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and is subject to change. Subthreads are branches of a conversation that are created from a point in a conversation where you asked a question. Subthreads offer more control and flexibility for exploring aspects of a topic, or new topics, all within the same thread. -You can create and navigate through subthreads in {% data variables.product.prodname_copilot_chat_short %}'s immersive view. In the {% data variables.product.prodname_copilot_chat_short %} panel, if you open a conversation that contains subthreads, only the most recently edited subthread is displayed. +You can create and navigate through subthreads in {% data variables.copilot.copilot_chat_short %}'s immersive view. In the {% data variables.copilot.copilot_chat_short %} panel, if you open a conversation that contains subthreads, only the most recently edited subthread is displayed. You can create a subthread in immersive mode by either editing or retrying any of your questions in the conversation. @@ -149,20 +149,20 @@ To navigate between subthreads: Hover over the counter to display the edit and navigation buttons, then click {% octicon "chevron-left" aria-label="Previous response" %} or {% octicon "chevron-right" aria-label="Next response" %} to navigate to the previous or next subthread. -## Asking {% data variables.product.prodname_copilot_chat_short %} questions in different contexts +## Asking {% data variables.copilot.copilot_chat_short %} questions in different contexts -You can ask {% data variables.product.prodname_copilot_chat_short %} different types of questions depending on where you are on {% data variables.product.github %}. For example, to ask a question about a specific repository, you must be in the context of that repository. The following sections describe how to access the different contexts. +You can ask {% data variables.copilot.copilot_chat_short %} different types of questions depending on where you are on {% data variables.product.github %}. For example, to ask a question about a specific repository, you must be in the context of that repository. The following sections describe how to access the different contexts. For examples of the types of questions you can ask in different contexts, see [AUTOTITLE](/copilot/using-github-copilot/example-use-cases/example-prompts-for-copilot-chat?tool=webui). -## Asking {% data variables.product.prodname_copilot_chat_short %} questions in a repository +## Asking {% data variables.copilot.copilot_chat_short %} questions in a repository To ask a question about a specific repository, you must be viewing the repository on {% data variables.product.github %}. 1. Navigate to a repository on {% data variables.product.github %}. {% data reusables.copilot.open-chat-panel %} - {% data variables.product.prodname_copilot_chat_short %} will open a new conversation, with the repository you are viewing selected as the context for your question. + {% data variables.copilot.copilot_chat_short %} will open a new conversation, with the repository you are viewing selected as the context for your question. ![Screenshot of the {% data variables.product.prodname_copilot_short %} chat panel opened inside a repository. The specified repository is highlighted with a dark orange outline.](/assets/images/help/copilot/copilot-chat-in-repository.png) @@ -172,7 +172,7 @@ To ask a question about a specific repository, you must be viewing the repositor > > {% data variables.product.prodname_copilot_short %}'s ability to answer natural language questions in a repository context is improved when the repository has been indexed for semantic code search. The indexing status of the repository is displayed when you start a conversation that has a repository context. For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/indexing-repositories-for-copilot-chat). -## Asking {% data variables.product.prodname_copilot_chat_short %} questions about a specific file or symbol +## Asking {% data variables.copilot.copilot_chat_short %} questions about a specific file or symbol You can ask {% data variables.product.prodname_copilot_short %} about a specific file, folder, or symbol within a repository. @@ -197,9 +197,9 @@ You can ask {% data variables.product.prodname_copilot_short %} about a specific {% ifversion ghec %} -## Asking {% data variables.product.prodname_copilot_chat_short %} questions about a knowledge base +## Asking {% data variables.copilot.copilot_chat_short %} questions about a knowledge base -Organization owners (with a {% data variables.product.prodname_copilot_enterprise_short %} subscription) can create knowledge bases, grouping together Markdown documentation across one or more repositories. You can use a knowledge base to ask questions with that context in mind. +Organization owners (with a {% data variables.copilot.copilot_enterprise_short %} subscription) can create knowledge bases, grouping together Markdown documentation across one or more repositories. You can use a knowledge base to ask questions with that context in mind. When you enter a query, {% data variables.product.prodname_copilot_short %} searches for relevant documentation snippets, synthesizes a summary of the relevant snippets to answer your question, and provides links to the source documentation for additional context. @@ -221,7 +221,7 @@ When you enter a query, {% data variables.product.prodname_copilot_short %} sear {% endif %} -## Asking {% data variables.product.prodname_copilot_chat_short %} questions about specific pieces of code +## Asking {% data variables.copilot.copilot_chat_short %} questions about specific pieces of code You can chat with {% data variables.product.prodname_copilot_short %} about a file in your repository, or about specific lines of code within a file. @@ -235,7 +235,7 @@ You can chat with {% data variables.product.prodname_copilot_short %} about a fi 1. Select the lines by clicking the line number for the first line you want to select, holding down Shift and clicking the line number for the last line you want to select. 1. To ask your own question about the selected lines, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) to the right of your selection. - This displays the {% data variables.product.prodname_copilot_chat %} panel with the selected lines indicated as the context of your question. + This displays the {% data variables.copilot.copilot_chat %} panel with the selected lines indicated as the context of your question. 1. To ask a predefined question, click the downward-pointing button beside the {% data variables.product.prodname_copilot_short %} icon, then choose one of the options. ![Screenshot of the {% data variables.product.prodname_copilot_short %} buttons, highlighted with a dark orange outline, to the right of some selected code.](/assets/images/help/copilot/copilot-buttons-inline-code.png) @@ -277,7 +277,7 @@ You can ask {% data variables.product.prodname_copilot_short %} different questi 1. On {% data variables.product.github %}, navigate to a pull request in a repository. {% data reusables.copilot.open-chat-panel %} {% data reusables.copilot.chat-previous-conversation %} -1. At the bottom of the {% data variables.product.prodname_copilot_chat_short %} panel, in the "Ask {% data variables.product.prodname_copilot_short %}" box, type a question and press Enter. +1. At the bottom of the {% data variables.copilot.copilot_chat_short %} panel, in the "Ask {% data variables.product.prodname_copilot_short %}" box, type a question and press Enter. ### Ask about changes to a specific file in a pull request @@ -293,7 +293,7 @@ You can ask {% data variables.product.prodname_copilot_short %} different questi 1. Click the line number for the first line you want to select, then hold down Shift and click the line number for the last line you want to select. 1. Ask {% data variables.product.prodname_copilot_short %} a question, or choose from a list of predefined questions. * _To ask your own question about the selected lines_, to the right of your selection, click the {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %} icon. - This displays the {% data variables.product.prodname_copilot_chat %} panel with the selected lines indicated as the context of your question. + This displays the {% data variables.copilot.copilot_chat %} panel with the selected lines indicated as the context of your question. ### Ask why a workflow has failed @@ -301,7 +301,7 @@ You can ask {% data variables.product.prodname_copilot_short %} different questi 1. Scroll to the bottom of the page, then, next to one of the failing checks, click **Details**. {% data reusables.copilot.open-chat-panel %} {% data reusables.copilot.chat-previous-conversation %} -1. At the bottom of the {% data variables.product.prodname_copilot_chat_short %} panel, in the "Ask {% data variables.product.prodname_copilot_short %}" box, ask {% data variables.product.prodname_copilot_short %} why the pull request has failed and press Enter. +1. At the bottom of the {% data variables.copilot.copilot_chat_short %} panel, in the "Ask {% data variables.product.prodname_copilot_short %}" box, ask {% data variables.product.prodname_copilot_short %} why the pull request has failed and press Enter. {% data variables.product.prodname_copilot_short %} will respond with information about why the pull request failed. {% data variables.product.prodname_copilot_short %} may also provide suggestions for how to fix the issue. @@ -311,7 +311,7 @@ You can ask {% data variables.product.prodname_copilot_short %} different questi You can ask {% data variables.product.prodname_copilot_short %} to summarize or answer questions about a specific issue or discussion. -> [!NOTE] The quality of {% data variables.product.prodname_copilot_chat_short %}'s responses may be degraded when working with issues or discussions that have very long bodies or a large number of comments. For example, this may occur if you ask {% data variables.product.prodname_copilot_short %} to summarize a long-running discussion. Where this happens, {% data variables.product.prodname_copilot_short %} will warn you so you can double check its output. +> [!NOTE] The quality of {% data variables.copilot.copilot_chat_short %}'s responses may be degraded when working with issues or discussions that have very long bodies or a large number of comments. For example, this may occur if you ask {% data variables.product.prodname_copilot_short %} to summarize a long-running discussion. Where this happens, {% data variables.product.prodname_copilot_short %} will warn you so you can double check its output. 1. Navigate to an issue or discussion on {% data variables.product.github %}. {% data reusables.copilot.open-chat-panel %} @@ -336,11 +336,11 @@ You can ask {% data variables.product.prodname_copilot_short %} to explain the c {% data reusables.copilot.stop-response-generation %} -## Using images in {% data variables.product.prodname_copilot_chat_short %} +## Using images in {% data variables.copilot.copilot_chat_short %} > [!NOTE] > * Attaching images to chat prompts is currently in {% data variables.release-phases.public_preview %} and is subject to change. -> * You can only attach an image in the immersive view of {% data variables.product.prodname_copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)), not in the chat panel. +> * You can only attach an image in the immersive view of {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)), not in the chat panel. You can attach an image to {% data variables.product.prodname_copilot_short %} and then ask about the image. For example, you can attach: @@ -348,7 +348,7 @@ You can attach an image to {% data variables.product.prodname_copilot_short %} a ### Attaching an image to your chat prompt -1. Go to the immersive view of {% data variables.product.prodname_copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)). +1. Go to the immersive view of {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)). 1. If you see the AI model picker at the top of the page, select one of the models that supports adding images to prompts: * {% data variables.copilot.copilot_gpt_41 %} (the default that's used if you don't see a model picker) @@ -368,7 +368,7 @@ You can attach an image to {% data variables.product.prodname_copilot_short %} a {% data reusables.copilot.type-prompt-for-image %} -## Accessing {% data variables.product.prodname_copilot_chat_short %} from the search bar +## Accessing {% data variables.copilot.copilot_chat_short %} from the search bar You can ask {% data variables.product.prodname_copilot_short %} a question about an entire repository by typing your question in the main search box of the repository. @@ -386,11 +386,11 @@ You can ask {% data variables.product.prodname_copilot_short %} a question about ![Screenshot of the main search box on {% data variables.product.prodname_dotcom %}. The drop-down option "Ask {% data variables.product.prodname_copilot_short %}" is highlighted with an orange outline.](/assets/images/help/copilot/ask-copilot-from-search-bar.png) - The {% data variables.product.prodname_copilot_chat %} panel is displayed and {% data variables.product.prodname_copilot_short %} responds to your request. + The {% data variables.copilot.copilot_chat %} panel is displayed and {% data variables.product.prodname_copilot_short %} responds to your request. {% data reusables.copilot.stop-response-generation %} -## Accessing {% data variables.product.prodname_copilot_chat_short %} from the dashboard +## Accessing {% data variables.copilot.copilot_chat_short %} from the dashboard You can access {% data variables.product.prodname_copilot_short %}'s immersive view from the dashboard. The dashboard is your personalized overview of your activity on {% data variables.product.github %}, seen when you visit https://github.com while logged in. @@ -401,15 +401,15 @@ You can access {% data variables.product.prodname_copilot_short %}'s immersive v You will be taken to the immersive view where {% data variables.product.prodname_copilot_short %} will respond to your request. -## Extending {% data variables.product.prodname_copilot_chat_dotcom_short %} +## Extending {% data variables.copilot.copilot_chat_dotcom_short %} {% data reusables.copilot.copilot-extensions.extending-copilot-chat %} -## Sharing {% data variables.product.prodname_copilot_chat_short %} conversations +## Sharing {% data variables.copilot.copilot_chat_short %} conversations > [!NOTE] This feature is currently in {% data variables.release-phases.public_preview %} and subject to change. During the {% data variables.release-phases.public_preview %}, this feature is only available to users without enterprise or team memberships. -You can share {% data variables.product.prodname_copilot_chat_short %} conversations from the immersive view ([https://github.com/copilot](https://github.com/copilot)). Shared conversations are public or private (i.e. permission-based), depending on the referenced content, for example, a conversation about a private repository. If you share a private conversation, the recipient must have the necessary permissions to view the content. +You can share {% data variables.copilot.copilot_chat_short %} conversations from the immersive view ([https://github.com/copilot](https://github.com/copilot)). Shared conversations are public or private (i.e. permission-based), depending on the referenced content, for example, a conversation about a private repository. If you share a private conversation, the recipient must have the necessary permissions to view the content. Once you share a conversation, the conversation and future messages will be visible to anyone with the link. @@ -422,13 +422,13 @@ Once you share a conversation, the conversation and future messages will be visi 1. To share the conversation, click **Share**. This will generate a link to the conversation. 1. To copy the conversation link, click the **{% octicon "copy" aria-label="Copy conversation icon" %}** copy icon. The link is copied to your clipboard. -## Sharing feedback about {% data variables.product.prodname_copilot_chat_dotcom %} +## Sharing feedback about {% data variables.copilot.copilot_chat_dotcom %} {% data reusables.rai.copilot-dotcom-feedback-collection %} -To give feedback about a particular {% data variables.product.prodname_copilot_chat_short %} response, click either the thumbs up or thumbs down icon at the bottom of each chat response. +To give feedback about a particular {% data variables.copilot.copilot_chat_short %} response, click either the thumbs up or thumbs down icon at the bottom of each chat response. -To give feedback about {% data variables.product.prodname_copilot_chat_short %} in general, click the ellipsis (**...**) at the top right of the chat panel, then click **{% octicon "comment-discussion" aria-hidden="true" aria-label="comment-discussion" %} Give feedback**. +To give feedback about {% data variables.copilot.copilot_chat_short %} in general, click the ellipsis (**...**) at the top right of the chat panel, then click **{% octicon "comment-discussion" aria-hidden="true" aria-label="comment-discussion" %} Give feedback**. ## Further reading diff --git a/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide.md b/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide.md index 712e924706..9180d095ce 100644 --- a/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide.md +++ b/content/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide.md @@ -1,6 +1,6 @@ --- title: Asking GitHub Copilot questions in your IDE -intro: 'Use {% data variables.product.prodname_copilot_chat_short %} in your editor to give you code suggestions, explain code, generate unit tests, and suggest code fixes.' +intro: 'Use {% data variables.copilot.copilot_chat_short %} in your editor to give you code suggestions, explain code, generate unit tests, and suggest code fixes.' topics: - Copilot redirect_from: @@ -26,11 +26,11 @@ shortTitle: Chat in IDE ## Submitting prompts -You can ask {% data variables.product.prodname_copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. +You can ask {% data variables.copilot.copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. 1. To open the chat view, click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon in the title bar of {% data variables.product.prodname_vscode %}. If the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon is not displayed, right-click the title bar and make sure that **Command Center** is selected. - ![Screenshot of the '{% data variables.product.prodname_copilot_chat_short %}' button, highlighted with a dark orange outline.](/assets/images/help/copilot/vsc-copilot-chat-icon.png) + ![Screenshot of the '{% data variables.copilot.copilot_chat_short %}' button, highlighted with a dark orange outline.](/assets/images/help/copilot/vsc-copilot-chat-icon.png) 1. Enter a prompt in the prompt box, or click one of the suggested prompts. For an introduction to the kinds of prompts you can use, see [AUTOTITLE](/copilot/using-github-copilot/guides-on-using-github-copilot/getting-started-with-prompts-for-copilot-chat). @@ -38,7 +38,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} to give you The response may contain text, code blocks, buttons, images, URIs, and file trees. The response often includes interactive elements. For example, the response may include a menu to insert a code block, or a button to invoke a {% data variables.product.prodname_vscode %} command. - To see the files that {% data variables.product.prodname_copilot_chat_short %} used to generate the response, select the **Used _n_ references** dropdown at the top of the response. The references may include a link to a custom instructions file for your repository. This file contains additional information that is automatically added to all of your chat questions to improve the quality of the responses. For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot). + To see the files that {% data variables.copilot.copilot_chat_short %} used to generate the response, select the **Used _n_ references** dropdown at the top of the response. The references may include a link to a custom instructions file for your repository. This file contains additional information that is automatically added to all of your chat questions to improve the quality of the responses. For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot). ## Using keywords in your prompt @@ -48,7 +48,7 @@ You can use special keywords to help {% data variables.product.prodname_copilot_ Chat participants are like domain experts who have a specialty that they can help you with. -{% data variables.product.prodname_copilot_chat_short %} can infer relevant chat participants based on your natural language prompt, improving discovery of advanced capabilities without you having to explicitly specify the participant you want to use in your prompt. +{% data variables.copilot.copilot_chat_short %} can infer relevant chat participants based on your natural language prompt, improving discovery of advanced capabilities without you having to explicitly specify the participant you want to use in your prompt. > [!NOTE] Automatic inference for chat participants is currently in {% data variables.release-phases.public_preview %} and is subject to change. @@ -56,9 +56,9 @@ Alternatively, you can manually specify a chat participant to scope your prompt For a list of available chat participants, type `@` in the chat prompt box. See also [AUTOTITLE](/copilot/using-github-copilot/github-copilot-chat-cheat-sheet?tool=vscode#chat-participants) or [Chat participants](https://code.visualstudio.com/docs/copilot/copilot-chat#_chat-participants) in the {% data variables.product.prodname_vscode %} documentation. -### {% data variables.product.prodname_copilot_extensions_short %} chat participants +### {% data variables.copilot.copilot_extensions_short %} chat participants -You can also install {% data variables.product.prodname_copilot_extensions_short %} that provide chat participants. You can install these extensions from [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true) and from [{% data variables.product.prodname_vscode_marketplace %}](https://marketplace.visualstudio.com/search?target=VSCode&category=Chat&sortBy=Installs). For information about extensions from {% data variables.product.prodname_marketplace %} that provide chat participants, see [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions). +You can also install {% data variables.copilot.copilot_extensions_short %} that provide chat participants. You can install these extensions from [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true) and from [{% data variables.product.prodname_vscode_marketplace %}](https://marketplace.visualstudio.com/search?target=VSCode&category=Chat&sortBy=Installs). For information about extensions from {% data variables.product.prodname_marketplace %} that provide chat participants, see [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions). ### Slash commands @@ -80,24 +80,24 @@ To see all available chat variables, type `#` in the chat prompt box. See also [ ## Asking a question about a knowledge base -> [!NOTE] This feature is only available if you have a {% data variables.product.prodname_copilot_enterprise_short %} subscription. +> [!NOTE] This feature is only available if you have a {% data variables.copilot.copilot_enterprise_short %} subscription. Organization owners can create knowledge bases, grouping together Markdown documentation across one or more repositories. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-copilot-knowledge-bases). You can tell {% data variables.product.prodname_copilot_short %} to answer a question within the context of a knowledge base. -1. At the bottom of the {% data variables.product.prodname_copilot_chat_short %} window, in the **Ask {% data variables.product.prodname_copilot_short %} or type / for commands** text box, type `@github #kb`, then press **Enter** to open the knowledge base selector. +1. At the bottom of the {% data variables.copilot.copilot_chat_short %} window, in the **Ask {% data variables.product.prodname_copilot_short %} or type / for commands** text box, type `@github #kb`, then press **Enter** to open the knowledge base selector. 1. Pick one of your available knowledge bases using the arrow keys, then press **Enter**. 1. In the **Ask {% data variables.product.prodname_copilot_short %} or type / for commands** text box, continue your message with your question, and then press **Enter**. -1. {% data variables.product.prodname_copilot_chat_short %} will process your question and provide an answer, with citations from your knowledge base, in the chat window. +1. {% data variables.copilot.copilot_chat_short %} will process your question and provide an answer, with citations from your knowledge base, in the chat window. {% endif %} -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.change-the-ai-model %} -## Additional ways to access {% data variables.product.prodname_copilot_chat_short %} +## Additional ways to access {% data variables.copilot.copilot_chat_short %} In addition to submitting prompts through the chat view, you can submit prompts in other ways: @@ -107,9 +107,9 @@ In addition to submitting prompts through the chat view, you can submit prompts See [inline chat](https://code.visualstudio.com/docs/copilot/copilot-chat#_inline-chat), [quick chat](https://code.visualstudio.com/docs/copilot/copilot-chat#_quick-chat), and [chat smart actions](https://code.visualstudio.com/docs/copilot/copilot-chat#_chat-smart-actions) in the {% data variables.product.prodname_vscode %} documentation for more details. -## {% data variables.product.prodname_copilot_edits_short %} +## {% data variables.copilot.copilot_edits_short %} -Use {% data variables.product.prodname_copilot_edits_short %} to make changes across multiple files directly from a single {% data variables.product.prodname_copilot_chat_short %} prompt. {% data variables.product.prodname_copilot_edits_short %} has the following modes: +Use {% data variables.copilot.copilot_edits_short %} to make changes across multiple files directly from a single {% data variables.copilot.copilot_chat_short %} prompt. {% data variables.copilot.copilot_edits_short %} has the following modes: * [Edit mode](#edit-mode) lets {% data variables.product.prodname_copilot_short %} make controlled edits to multiple files. * [Agent mode](#agent-mode) lets {% data variables.product.prodname_copilot_short %} autonomously accomplish a set task. @@ -120,16 +120,16 @@ Use {% data variables.product.prodname_copilot_edits_short %} to make changes ac #### Using edit mode -1. To start an edit session, select **Open Chat** from the {% data variables.product.prodname_copilot_chat_short %} menu. +1. To start an edit session, select **Open Chat** from the {% data variables.copilot.copilot_chat_short %} menu. 1. At the bottom of the chat panel, select **Edit** from the mode dropdown. - ![Screenshot of the {% data variables.product.prodname_copilot_chat_short %} mode dropdown. The "Edit" option is outlined in dark orange.](/assets/images/help/copilot/chat-mode-vscode.png) + ![Screenshot of the {% data variables.copilot.copilot_chat_short %} mode dropdown. The "Edit" option is outlined in dark orange.](/assets/images/help/copilot/chat-mode-vscode.png) 1. Optionally, add relevant files to the _working set_ to indicate to {% data variables.product.prodname_copilot %} which files you want to work on. -1. Submit a prompt. In response to your prompt, {% data variables.product.prodname_copilot_edits_short %} determines which files in your _working set_ to change and adds a short description of the change. +1. Submit a prompt. In response to your prompt, {% data variables.copilot.copilot_edits_short %} determines which files in your _working set_ to change and adds a short description of the change. 1. Review the changes and **Apply** or **Discard** the edits for each file. -For more detailed instructions, see [{% data variables.product.prodname_copilot_edits_short %}](https://code.visualstudio.com/docs/copilot/copilot-edits) in the {% data variables.product.prodname_vscode %} documentation. +For more detailed instructions, see [{% data variables.copilot.copilot_edits_short %}](https://code.visualstudio.com/docs/copilot/copilot-edits) in the {% data variables.product.prodname_vscode %} documentation. ### Agent mode @@ -137,18 +137,18 @@ For more detailed instructions, see [{% data variables.product.prodname_copilot_ #### Using agent mode -1. To start an edit session, select **Open Chat** from the {% data variables.product.prodname_copilot_chat_short %} menu. +1. To start an edit session, select **Open Chat** from the {% data variables.copilot.copilot_chat_short %} menu. 1. At the bottom of the chat panel, select **Agent** from the mode dropdown. 1. Submit a prompt. In response to your prompt, {% data variables.product.prodname_copilot_short %} streams the edits in the editor, updates the working set, and if necessary, suggests terminal commands to run. 1. Review the changes. If {% data variables.product.prodname_copilot_short %} suggested terminal commands, confirm whether or not {% data variables.product.prodname_copilot_short %} can run them. In response, {% data variables.product.prodname_copilot_short %} iterates and performs additional actions to complete the task in your original prompt. You can also directly [open agent mode in {% data variables.product.prodname_vscode_shortname %}](vscode://GitHub.Copilot-Chat/chat?mode=agent). -For more information, see [{% data variables.product.prodname_copilot_edits_short %}](https://aka.ms/vscode-copilot-agent) in the {% data variables.product.prodname_vscode %} documentation. +For more information, see [{% data variables.copilot.copilot_edits_short %}](https://aka.ms/vscode-copilot-agent) in the {% data variables.product.prodname_vscode %} documentation. {% data reusables.copilot.copilot-edits.agent-mode-requests %} -## Using images in {% data variables.product.prodname_copilot_chat_short %} +## Using images in {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.using-images-in-chat %} @@ -163,7 +163,7 @@ For more information, see [{% data variables.product.prodname_copilot_edits_shor * {% data variables.copilot.copilot_gemini_flash %} * {% data variables.copilot.copilot_gemini_25_pro %} - ![Screenshot of {% data variables.product.prodname_copilot_chat_short %} with the model picker highlighted with a dark orange outline.](/assets/images/help/copilot/vsc-chat-model-picker.png) + ![Screenshot of {% data variables.copilot.copilot_chat_short %} with the model picker highlighted with a dark orange outline.](/assets/images/help/copilot/vsc-chat-model-picker.png) 1. Do one of the following: @@ -177,12 +177,12 @@ For more information, see [{% data variables.product.prodname_copilot_edits_shor To indicate whether a response was helpful, use the thumbs up and thumbs down icons that appear next to the response. -To leave feedback about the {% data variables.product.prodname_copilot_chat %} extension, open an issue in the [microsoft/vscode-copilot-release](https://github.com/microsoft/vscode-copilot-release/issues) repository. +To leave feedback about the {% data variables.copilot.copilot_chat %} extension, open an issue in the [microsoft/vscode-copilot-release](https://github.com/microsoft/vscode-copilot-release/issues) repository. ## Further reading * [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot) -* [Using {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/copilot/copilot-chat) and [Getting started with {% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/copilot/getting-started-chat) in the {% data variables.product.prodname_vscode %} documentation +* [Using {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/copilot/copilot-chat) and [Getting started with {% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/copilot/getting-started-chat) in the {% data variables.product.prodname_vscode %} documentation * [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom) * [AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat) * [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot) @@ -199,30 +199,30 @@ To leave feedback about the {% data variables.product.prodname_copilot_chat %} e * **{% data variables.product.prodname_vs %} 2022 version 17.8 or later**. See [Install {% data variables.product.prodname_vs %}](https://learn.microsoft.com/visualstudio/install/install-visual-studio) in the {% data variables.product.prodname_vs %} documentation. * _For {% data variables.product.prodname_vs %} 17.8 and 17.9:_ * **{% data variables.product.prodname_copilot %} extension**. See [Install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-install-and-states) in the {% data variables.product.prodname_vs %} documentation. - * **{% data variables.product.prodname_copilot_chat %} extension**. See [Install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-install-and-states) in the {% data variables.product.prodname_vs %} documentation. + * **{% data variables.copilot.copilot_chat %} extension**. See [Install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-install-and-states) in the {% data variables.product.prodname_vs %} documentation. - _{% data variables.product.prodname_vs %} 17.10 and later have the {% data variables.product.prodname_copilot %} and {% data variables.product.prodname_copilot_chat %} extensions built in. You don't need to install them separately._ + _{% data variables.product.prodname_vs %} 17.10 and later have the {% data variables.product.prodname_copilot %} and {% data variables.copilot.copilot_chat %} extensions built in. You don't need to install them separately._ * **Sign in to {% data variables.product.company_short %} in {% data variables.product.prodname_vs %}**. If you experience authentication issues, see [AUTOTITLE](/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat#troubleshooting-authentication-issues-in-your-editor). {% data reusables.copilot.chat-access-denied %} ## Submitting prompts -You can ask {% data variables.product.prodname_copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. +You can ask {% data variables.copilot.copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. -1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.product.prodname_copilot_chat %}**. -1. In the {% data variables.product.prodname_copilot_chat_short %} window, enter a prompt, then press **Enter**. For example prompts, see [AUTOTITLE](/copilot/using-github-copilot/guides-on-using-github-copilot/getting-started-with-prompts-for-copilot-chat). +1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.copilot.copilot_chat %}**. +1. In the {% data variables.copilot.copilot_chat_short %} window, enter a prompt, then press **Enter**. For example prompts, see [AUTOTITLE](/copilot/using-github-copilot/guides-on-using-github-copilot/getting-started-with-prompts-for-copilot-chat). 1. Evaluate {% data variables.product.prodname_copilot_short %}'s response, and submit a follow up prompt if needed. The response often includes interactive elements. For example, the response may include buttons to copy, insert, or preview the result of a code block. - To see the files that {% data variables.product.prodname_copilot_chat_short %} used to generate the response, click the **References** link below the response. The references may include a link to a custom instructions file for your repository. This file contains additional information that is automatically added to all of your chat questions to improve the quality of the responses. For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot). + To see the files that {% data variables.copilot.copilot_chat_short %} used to generate the response, click the **References** link below the response. The references may include a link to a custom instructions file for your repository. This file contains additional information that is automatically added to all of your chat questions to improve the quality of the responses. For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot). ## Using keywords in your prompt You can use special keywords to help {% data variables.product.prodname_copilot_short %} understand your prompt. -### Extending {% data variables.product.prodname_copilot_chat_short %} +### Extending {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.copilot-extensions.extending-copilot-chat %} @@ -234,7 +234,7 @@ To see all available slash commands, type `/` in the chat prompt box. See also [ ### References -By default, {% data variables.product.prodname_copilot_chat_short %} will reference the file that you have open or the code that you have selected. You can also use `#` followed by a file name, file name and line numbers, or `solution` to reference a specific file, lines, or solution. +By default, {% data variables.copilot.copilot_chat_short %} will reference the file that you have open or the code that you have selected. You can also use `#` followed by a file name, file name and line numbers, or `solution` to reference a specific file, lines, or solution. See also [AUTOTITLE](/copilot/using-github-copilot/github-copilot-chat-cheat-sheet?tool=visualstudio#references) or [Reference](https://learn.microsoft.com/visualstudio/ide/copilot-chat-context#reference) in the {% data variables.product.prodname_vs %} documentation. @@ -243,9 +243,9 @@ See also [AUTOTITLE](/copilot/using-github-copilot/github-copilot-chat-cheat-she > [!NOTE] > The `@github` chat participant is currently in preview, and only available in [{% data variables.product.prodname_vs %} 2022 Preview 2](https://visualstudio.microsoft.com/vs/preview/) onwards. -{% data variables.product.prodname_copilot_short %}'s {% data variables.product.prodname_dotcom %}-specific skills expand the type of information {% data variables.product.prodname_copilot_short %} can provide. To access these skills in {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}, include `@github` in your question. +{% data variables.product.prodname_copilot_short %}'s {% data variables.product.prodname_dotcom %}-specific skills expand the type of information {% data variables.product.prodname_copilot_short %} can provide. To access these skills in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vs %}, include `@github` in your question. -When you add `@github` to a question, {% data variables.product.prodname_copilot_short %} dynamically selects an appropriate skill, based on the content of your question. You can also explicitly ask {% data variables.product.prodname_copilot_chat_short %} to use a particular skill. For example, `@github Search the web to find the latest GPT4 model from OpenAI.` +When you add `@github` to a question, {% data variables.product.prodname_copilot_short %} dynamically selects an appropriate skill, based on the content of your question. You can also explicitly ask {% data variables.copilot.copilot_chat_short %} to use a particular skill. For example, `@github Search the web to find the latest GPT4 model from OpenAI.` You can generate a list of currently available skills by asking {% data variables.product.prodname_copilot_short %}: `@github What skills are available?` @@ -254,49 +254,49 @@ You can generate a list of currently available skills by asking {% data variable ## Asking a question about a knowledge base (preview) > [!NOTE] -> * This feature is only available if you have a {% data variables.product.prodname_copilot_enterprise_short %} subscription. +> * This feature is only available if you have a {% data variables.copilot.copilot_enterprise_short %} subscription. > * Support for knowledge bases is currently in preview, and only available in [{% data variables.product.prodname_vs %} 2022 Preview 3](https://visualstudio.microsoft.com/vs/preview/) onwards. Organization owners can create knowledge bases, grouping together Markdown documentation across one or more repositories. For more information, see [AUTOTITLE](/copilot/github-copilot-enterprise/managing-copilot-knowledge-bases). You can tell {% data variables.product.prodname_copilot_short %} to answer a question within the context of a knowledge base. -1. At the bottom of the {% data variables.product.prodname_copilot_chat_short %} window, in the **Ask {% data variables.product.prodname_copilot_short %}: Type / for commands and # to reference** text box, type `@github`, press #, then select a knowledge base from the list. +1. At the bottom of the {% data variables.copilot.copilot_chat_short %} window, in the **Ask {% data variables.product.prodname_copilot_short %}: Type / for commands and # to reference** text box, type `@github`, press #, then select a knowledge base from the list. 1. In the **Type / for commands and # to reference** text box, continue your message with your question, and then press **Enter**. -1. {% data variables.product.prodname_copilot_chat_short %} will process your question and provide an answer, with citations from your knowledge base, in the chat window. +1. {% data variables.copilot.copilot_chat_short %} will process your question and provide an answer, with citations from your knowledge base, in the chat window. {% endif %} -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.change-the-ai-model %} -## Additional ways to access {% data variables.product.prodname_copilot_chat_short %} +## Additional ways to access {% data variables.copilot.copilot_chat_short %} In addition to submitting prompts through the chat window, you can submit prompts inline. To start an inline chat, right click in your editor window and select **Ask {% data variables.product.prodname_copilot_short %}**. See [Ask questions in the inline chat view](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-chat#ask-questions-in-the-inline-chat-view) in the {% data variables.product.prodname_vs %} documentation for more details. -## {% data variables.product.prodname_copilot_edits_short %} +## {% data variables.copilot.copilot_edits_short %} > [!NOTE] > * This feature is currently in {% data variables.release-phases.public_preview %} and subject to change. > * Available in {% data variables.product.prodname_vs %} 17.14 and later. -{% data variables.product.prodname_copilot_edits_short %} lets you make changes across multiple files from a single {% data variables.product.prodname_copilot_chat_short %} prompt +{% data variables.copilot.copilot_edits_short %} lets you make changes across multiple files from a single {% data variables.copilot.copilot_chat_short %} prompt Use agent mode when you have a specific task in mind and want to enable {% data variables.product.prodname_copilot_short %} to autonomously edit your code. In agent mode, {% data variables.product.prodname_copilot_short %} determines which files to make changes to, offers code changes and terminal commands to complete the task, and iterates to remediate issues until the original task is complete. ### Using agent mode -1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.product.prodname_copilot_chat %}**. +1. In the {% data variables.product.prodname_vs %} menu bar, click **View**, then click **{% data variables.copilot.copilot_chat %}**. 1. At the bottom of the chat panel, select **Agent** from the mode dropdown. 1. Submit a prompt. In response to your prompt, {% data variables.product.prodname_copilot_short %} streams the edits in the editor, updates the working set, and if necessary, suggests terminal commands to run. 1. Review the changes. If {% data variables.product.prodname_copilot_short %} suggested terminal commands, confirm whether or not {% data variables.product.prodname_copilot_short %} can run them. In response, {% data variables.product.prodname_copilot_short %} iterates and performs additional actions to complete the task in your original prompt. -When you use {% data variables.product.prodname_copilot_agent_short %} mode, {% data variables.product.prodname_copilot_short %} may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions {% data variables.product.prodname_copilot_short %} takes on your behalf. The total premium requests used will depend on the complexity of the task, the number of steps involved, and the model selected. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/monitoring-usage-and-entitlements/avoiding-unexpected-copilot-costs). +When you use agent mode, {% data variables.product.prodname_copilot_short %} may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions {% data variables.product.prodname_copilot_short %} takes on your behalf. The total premium requests used will depend on the complexity of the task, the number of steps involved, and the model selected. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/monitoring-usage-and-entitlements/avoiding-unexpected-copilot-costs). -## Using images in {% data variables.product.prodname_copilot_chat_short %} +## Using images in {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.using-images-in-chat %} @@ -322,7 +322,7 @@ When you use {% data variables.product.prodname_copilot_agent_short %} mode, {% ## Sharing feedback -To share feedback about {% data variables.product.prodname_copilot_chat_short %}, you can use the **Send feedback** button in {% data variables.product.prodname_vs %}. For more information on providing feedback for {% data variables.product.prodname_vs %}, see the [{% data variables.product.prodname_vs %} Feedback](https://learn.microsoft.com/en-us/visualstudio/ide/how-to-report-a-problem-with-visual-studio?view=vs-2022) documentation. +To share feedback about {% data variables.copilot.copilot_chat_short %}, you can use the **Send feedback** button in {% data variables.product.prodname_vs %}. For more information on providing feedback for {% data variables.product.prodname_vs %}, see the [{% data variables.product.prodname_vs %} Feedback](https://learn.microsoft.com/en-us/visualstudio/ide/how-to-report-a-problem-with-visual-studio?view=vs-2022) documentation. 1. In the top right corner of the {% data variables.product.prodname_vs %} window, click the **Send feedback** button. @@ -335,8 +335,8 @@ To share feedback about {% data variables.product.prodname_copilot_chat_short %} ## Further reading * [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot) -* [Using {% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_vs %} in the Microsoft Learn documentation](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-chat?view=vs-2022#use-copilot-chat-in-visual-studio) -* [Tips to improve {% data variables.product.prodname_copilot_chat %} results in the Microsoft Learn documentation](https://learn.microsoft.com/en-us/visualstudio/ide/copilot-chat-context?view=vs-2022) +* [Using {% data variables.copilot.copilot_chat %} in {% data variables.product.prodname_vs %} in the Microsoft Learn documentation](https://learn.microsoft.com/visualstudio/ide/visual-studio-github-copilot-chat?view=vs-2022#use-copilot-chat-in-visual-studio) +* [Tips to improve {% data variables.copilot.copilot_chat %} results in the Microsoft Learn documentation](https://learn.microsoft.com/en-us/visualstudio/ide/copilot-chat-context?view=vs-2022) * [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom) * [AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat) * [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot) @@ -359,11 +359,11 @@ To share feedback about {% data variables.product.prodname_copilot_chat_short %} ## Submitting prompts -You can ask {% data variables.product.prodname_copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. +You can ask {% data variables.copilot.copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. -1. Open the {% data variables.product.prodname_copilot_chat_short %} window by clicking the **{% data variables.product.prodname_copilot_chat %}** icon at the right side of the JetBrains IDE window. +1. Open the {% data variables.copilot.copilot_chat_short %} window by clicking the **{% data variables.copilot.copilot_chat %}** icon at the right side of the JetBrains IDE window. - ![Screenshot of the {% data variables.product.prodname_copilot_chat %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) + ![Screenshot of the {% data variables.copilot.copilot_chat %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) 1. Enter a prompt in the prompt box. For example prompts, see [AUTOTITLE](/copilot/using-github-copilot/guides-on-using-github-copilot/getting-started-with-prompts-for-copilot-chat). @@ -371,7 +371,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} to give you The response often includes interactive elements. For example, the response may include buttons to copy or insert a code block. - To see the files that {% data variables.product.prodname_copilot_chat_short %} used to generate the response, select the **References** dropdown below the response. + To see the files that {% data variables.copilot.copilot_chat_short %} used to generate the response, select the **References** dropdown below the response. ## Using keywords in your prompt @@ -383,7 +383,7 @@ Chat participants are like domain experts who have a specialty that they can hel For a list of available chat participants, type `@` in the chat prompt box. See also [AUTOTITLE](/copilot/using-github-copilot/github-copilot-chat-cheat-sheet?tool=jetbrains#chat-participants-1). -### Extending {% data variables.product.prodname_copilot_chat_short %} +### Extending {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.copilot-extensions.extending-copilot-chat %} @@ -395,25 +395,25 @@ To see all available slash commands, type `/` in the chat prompt box. See also [ ### File references -By default, {% data variables.product.prodname_copilot_chat_short %} will reference the file that you have open or the code that you have selected. You can also tell {% data variables.product.prodname_copilot_chat_short %} which files to reference by dragging a file into the chat prompt box. Alternatively, you can right click on a file, select **GitHub Copilot**, then select **Reference File in Chat**. +By default, {% data variables.copilot.copilot_chat_short %} will reference the file that you have open or the code that you have selected. You can also tell {% data variables.copilot.copilot_chat_short %} which files to reference by dragging a file into the chat prompt box. Alternatively, you can right click on a file, select **GitHub Copilot**, then select **Reference File in Chat**. ## Using {% data variables.product.prodname_dotcom %} skills for {% data variables.product.prodname_copilot_short %} {% data reusables.copilot.using-skills %} -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.change-the-ai-model %} -## Additional ways to access {% data variables.product.prodname_copilot_chat_short %} +## Additional ways to access {% data variables.copilot.copilot_chat_short %} * **Built-in requests**. In addition to submitting prompts through the chat window, you can submit built-in requests by right clicking in a file, selecting **{% data variables.product.prodname_copilot %}**, then selecting one of the options. * **Inline**. You can submit a chat prompt inline, and scope it to a highlighted code block or your current file. * To start an inline chat, right click on a code block or anywhere in your current file, hover over **{% data variables.product.prodname_copilot %}**, then select **{% octicon "plus" aria-hidden="true" aria-label="plus" %} {% data variables.product.prodname_copilot_short %}: Inline Chat**, or enter Ctrl+Shift+I. -## {% data variables.product.prodname_copilot_edits_short %} +## {% data variables.copilot.copilot_edits_short %} -Use {% data variables.product.prodname_copilot_edits_short %} to make changes across multiple files directly from a single {% data variables.product.prodname_copilot_chat_short %} prompt. {% data variables.product.prodname_copilot_edits_short %} has the following modes: +Use {% data variables.copilot.copilot_edits_short %} to make changes across multiple files directly from a single {% data variables.copilot.copilot_chat_short %} prompt. {% data variables.copilot.copilot_edits_short %} has the following modes: * [Edit mode](#edit-mode-1) lets {% data variables.product.prodname_copilot_short %} make controlled edits to multiple files. * [Agent mode](#agent-mode-1) lets {% data variables.product.prodname_copilot_short %} autonomously accomplish a set task. @@ -424,10 +424,10 @@ Use {% data variables.product.prodname_copilot_edits_short %} to make changes ac #### Using edit mode -1. To start an edit session, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** in the menu bar, then select **Open {% data variables.product.prodname_copilot_chat %}**. -1. At the top of the chat panel, click **{% data variables.product.prodname_copilot_edits_short %}**. +1. To start an edit session, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** in the menu bar, then select **Open {% data variables.copilot.copilot_chat %}**. +1. At the top of the chat panel, click **{% data variables.copilot.copilot_edits_short %}**. 1. Add relevant files to the _working set_ to indicate to {% data variables.product.prodname_copilot %} which files you want to work on. You can add all open files by clicking **Add all open files** or individually search for single files. -1. Submit a prompt. In response to your prompt, {% data variables.product.prodname_copilot_edits_short %} determines which files in your _working set_ to change and adds a short description of the change. +1. Submit a prompt. In response to your prompt, {% data variables.copilot.copilot_edits_short %} determines which files in your _working set_ to change and adds a short description of the change. 1. Review the changes and **Accept** or **Discard** the edits for each file. ### Agent mode @@ -436,7 +436,7 @@ Use {% data variables.product.prodname_copilot_edits_short %} to make changes ac #### Using agent mode -1. To start an edit session using agent mode, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** in the menu bar, then select **Open {% data variables.product.prodname_copilot_chat %}**. +1. To start an edit session using agent mode, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** in the menu bar, then select **Open {% data variables.copilot.copilot_chat %}**. 1. At the top of the chat panel, click the **Agent** tab. 1. Submit a prompt. In response to your prompt, {% data variables.product.prodname_copilot_short %} streams the edits in the editor, updates the working set, and if necessary, suggests terminal commands to run. 1. Review the changes. If {% data variables.product.prodname_copilot_short %} suggested terminal commands, confirm whether or not {% data variables.product.prodname_copilot_short %} can run them. In response, {% data variables.product.prodname_copilot_short %} iterates and performs additional actions to complete the task in your original prompt. @@ -445,15 +445,15 @@ Use {% data variables.product.prodname_copilot_edits_short %} to make changes ac ## Sharing feedback -To share feedback about {% data variables.product.prodname_copilot_chat_short %}, you can use the **share feedback** link in JetBrains. +To share feedback about {% data variables.copilot.copilot_chat_short %}, you can use the **share feedback** link in JetBrains. -1. At the right side of the JetBrains IDE window, click the **{% data variables.product.prodname_copilot_chat_short %}** icon to open the {% data variables.product.prodname_copilot_chat_short %} window. +1. At the right side of the JetBrains IDE window, click the **{% data variables.copilot.copilot_chat_short %}** icon to open the {% data variables.copilot.copilot_chat_short %} window. - ![Screenshot of the {% data variables.product.prodname_copilot_chat_short %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) + ![Screenshot of the {% data variables.copilot.copilot_chat_short %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) -1. At the top of the {% data variables.product.prodname_copilot_chat_short %} window, click the **share feedback** link. +1. At the top of the {% data variables.copilot.copilot_chat_short %} window, click the **share feedback** link. - ![Screenshot of the share feedback link in the {% data variables.product.prodname_copilot_chat_short %} window.](/assets/images/help/copilot/jetbrains-share-feedback.png) + ![Screenshot of the share feedback link in the {% data variables.copilot.copilot_chat_short %} window.](/assets/images/help/copilot/jetbrains-share-feedback.png) ## Further reading @@ -477,9 +477,9 @@ To use {% data variables.product.prodname_copilot %} for Xcode, you must install ## Submitting prompts -You can ask {% data variables.product.prodname_copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. +You can ask {% data variables.copilot.copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. -1. To open the chat view, click **Editor** in the menu bar, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** then **Open Chat**. {% data variables.product.prodname_copilot_chat_short %} opens in a new window. +1. To open the chat view, click **Editor** in the menu bar, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** then **Open Chat**. {% data variables.copilot.copilot_chat_short %} opens in a new window. 1. Enter a prompt in the prompt box. For example prompts, see [AUTOTITLE](/copilot/using-github-copilot/guides-on-using-github-copilot/getting-started-with-prompts-for-copilot-chat). @@ -487,7 +487,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} to give you The response often includes interactive elements. For example, the response may include buttons to copy or insert a code block. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.change-the-ai-model %} @@ -517,7 +517,7 @@ To see all available slash commands, type `/` in the chat prompt box. For more i ## File references -By default, {% data variables.product.prodname_copilot_chat_short %} will reference the file that you have open or the code that you have selected. To attach a specific file as reference, click {% octicon "paperclip" aria-label="Add attachments" %} in the chat prompt box. +By default, {% data variables.copilot.copilot_chat_short %} will reference the file that you have open or the code that you have selected. To attach a specific file as reference, click {% octicon "paperclip" aria-label="Add attachments" %} in the chat prompt box. ## Chat management @@ -551,9 +551,9 @@ To indicate whether a response was helpful, use {% octicon "thumbsup" aria-label ## Submitting prompts -You can ask {% data variables.product.prodname_copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. +You can ask {% data variables.copilot.copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. -1. To open the {% data variables.product.prodname_copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse, then click **Open Chat**. +1. To open the {% data variables.copilot.copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse, then click **Open Chat**. 1. Enter a prompt in the prompt box, then press Enter. @@ -571,7 +571,7 @@ Use slash commands to avoid writing complex prompts for common scenarios. To use To see all available slash commands, type `/` in the chat prompt box. -## AI models for {% data variables.product.prodname_copilot_chat_short %} +## AI models for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.change-the-ai-model %} @@ -581,7 +581,7 @@ To see all available slash commands, type `/` in the chat prompt box. ### Using agent mode -1. To open the {% data variables.product.prodname_copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse, then click **Open Chat**. +1. To open the {% data variables.copilot.copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse, then click **Open Chat**. 1. At the bottom of the chat panel, select **Agent** from the mode dropdown. 1. Submit a prompt. In response to your prompt, {% data variables.product.prodname_copilot_short %} streams the edits in the editor, updates the working set, and if necessary, suggests terminal commands to run. 1. Review the changes. If {% data variables.product.prodname_copilot_short %} suggested terminal commands, confirm whether or not {% data variables.product.prodname_copilot_short %} can run them. In response, {% data variables.product.prodname_copilot_short %} iterates and performs additional actions to complete the task in your original prompt. diff --git a/content/copilot/using-github-copilot/copilot-chat/getting-started-with-prompts-for-copilot-chat.md b/content/copilot/using-github-copilot/copilot-chat/getting-started-with-prompts-for-copilot-chat.md index 0cebd12a87..16fa3272d5 100644 --- a/content/copilot/using-github-copilot/copilot-chat/getting-started-with-prompts-for-copilot-chat.md +++ b/content/copilot/using-github-copilot/copilot-chat/getting-started-with-prompts-for-copilot-chat.md @@ -1,6 +1,6 @@ --- title: Getting started with prompts for Copilot Chat -intro: 'Get an overview of ways to use {% data variables.product.prodname_copilot_chat_short %}.' +intro: 'Get an overview of ways to use {% data variables.copilot.copilot_chat_short %}.' topics: - Copilot defaultTool: vscode @@ -12,9 +12,9 @@ redirect_from: shortTitle: Get started with chat --- -You can ask {% data variables.product.prodname_copilot_chat_short %} specific questions about your project or general software questions. You can also ask {% data variables.product.prodname_copilot_chat_short %} to write code, fix errors, write tests, and document code. +You can ask {% data variables.copilot.copilot_chat_short %} specific questions about your project or general software questions. You can also ask {% data variables.copilot.copilot_chat_short %} to write code, fix errors, write tests, and document code. -Use the tabs above to select the environment where you are using {% data variables.product.prodname_copilot_chat_short %}. +Use the tabs above to select the environment where you are using {% data variables.copilot.copilot_chat_short %}. {% vscode %} @@ -22,7 +22,7 @@ Some of the following example prompts use chat participants (preceded by `@`), s ## Ask general software questions -You can ask {% data variables.product.prodname_copilot_chat_short %} general software questions. For example: +You can ask {% data variables.copilot.copilot_chat_short %} general software questions. For example: * `tell me about nodejs web server frameworks` * `how can I create an Express app` @@ -30,7 +30,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} general sof ## Ask questions about your project -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about your project. +You can ask {% data variables.copilot.copilot_chat_short %} questions about your project. * `what sorting algorithm does this function use` * `@workspace how are notifications scheduled` @@ -118,7 +118,7 @@ Use the `@terminal` chat participant to ask specific questions about the command ## Ask general software questions -You can ask {% data variables.product.prodname_copilot_chat_short %} general software questions. For example: +You can ask {% data variables.copilot.copilot_chat_short %} general software questions. For example: * `tell me about nodejs web server frameworks` * `how can I create an Express app` @@ -126,7 +126,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} general sof ## Ask questions about your project -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about your project. To give {% data variables.product.prodname_copilot_short %} the correct context, try some of these strategies: +You can ask {% data variables.copilot.copilot_chat_short %} questions about your project. To give {% data variables.product.prodname_copilot_short %} the correct context, try some of these strategies: * Highlight relevant lines of code. * Open the relevant file. @@ -184,7 +184,7 @@ The `/tests` slash command writes tests for existing code. If you prefer to writ ## Ask general software questions -You can ask {% data variables.product.prodname_copilot_chat_short %} general software questions. For example: +You can ask {% data variables.copilot.copilot_chat_short %} general software questions. For example: * `tell me about nodejs web server frameworks` * `how can I create an Express app` @@ -192,7 +192,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} general sof ## Ask questions about your project -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about your project. To give {% data variables.product.prodname_copilot_short %} the correct context, try some of these strategies: +You can ask {% data variables.copilot.copilot_chat_short %} questions about your project. To give {% data variables.product.prodname_copilot_short %} the correct context, try some of these strategies: * Highlight relevant lines of code. * Open the relevant file. @@ -240,11 +240,11 @@ The `/tests` slash command writes tests for existing code. If you prefer to writ {% webui %} -Some of the example prompts require you to be in a specific context on the {% data variables.product.github %} website. For more information on how to access those contexts, see [Asking {% data variables.product.prodname_copilot_chat_short %} questions in different contexts](/copilot/using-github-copilot/asking-github-copilot-questions-in-github#asking-copilot-chat-questions-in-different-contexts). +Some of the example prompts require you to be in a specific context on the {% data variables.product.github %} website. For more information on how to access those contexts, see [Asking {% data variables.copilot.copilot_chat_short %} questions in different contexts](/copilot/using-github-copilot/asking-github-copilot-questions-in-github#asking-copilot-chat-questions-in-different-contexts). ## Ask general software questions -You can ask {% data variables.product.prodname_copilot_chat_short %} general software questions. For example: +You can ask {% data variables.copilot.copilot_chat_short %} general software questions. For example: * `tell me about nodejs web server frameworks` * `how can I create an Express app` @@ -252,7 +252,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} general sof ## Ask questions about a repository -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about a repository. For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about a repository. For example: * `what is the purpose of this repository?` * `When was the most recent release?` @@ -261,7 +261,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} questions a ## Ask questions about a specific file or symbol -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about a specific file or symbol. For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about a specific file or symbol. For example: * `what sorting algorithm does this function use` * `how are these files related` @@ -269,7 +269,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} questions a ## Ask questions about a knowledge base -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about a knowledge base. For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about a knowledge base. For example: * `How do I deploy a new application?` * `What's the process for creating a new REST API?` @@ -277,7 +277,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} questions a ## Ask questions about a specific piece of code -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about a specific piece of code. You might ask a question about a whole file, or a specific line. For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about a specific piece of code. You might ask a question about a whole file, or a specific line. For example: If you are asking about a whole file, you could enter: @@ -293,16 +293,16 @@ If you are asking about specific lines, you could enter: ## Ask questions about alerts from {% data variables.product.prodname_GHAS %} products -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about security alerts in repositories in your organization from {% data variables.product.prodname_GHAS %} features ({% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_secret_scanning %}, and {% data variables.product.prodname_dependabot_alerts %}). For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about security alerts in repositories in your organization from {% data variables.product.prodname_GHAS %} features ({% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_secret_scanning %}, and {% data variables.product.prodname_dependabot_alerts %}). For example: * `How would I fix this alert?` * `How many alerts do I have on this pull request?` * `Which line of code is this {% data variables.product.prodname_code_scanning %} alert referencing?` * `What library is affected by this {% data variables.product.prodname_dependabot %} alert?` -## Ask {% data variables.product.prodname_copilot_chat_short %} questions in a pull request +## Ask {% data variables.copilot.copilot_chat_short %} questions in a pull request -You can ask {% data variables.product.prodname_copilot_chat_short %} questions in a pull request. Your question could relate to various elements of the pull request For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions in a pull request. Your question could relate to various elements of the pull request For example: You might ask for a summary of the changes in the pull request: @@ -325,15 +325,15 @@ You might ask why a workflow failed: * `Tell me why this job failed` * `Suggest a fix for this error` -## Ask {% data variables.product.prodname_copilot_chat_short %} questions about a specific issue or discussion +## Ask {% data variables.copilot.copilot_chat_short %} questions about a specific issue or discussion -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about a specific issue or discussion. For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about a specific issue or discussion. For example: * `what is the purpose of this issue?` -## Ask {% data variables.product.prodname_copilot_chat_short %} questions about a specific commit +## Ask {% data variables.copilot.copilot_chat_short %} questions about a specific commit -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about a specific commit. For example: +You can ask {% data variables.copilot.copilot_chat_short %} questions about a specific commit. For example: * `what is the purpose of this commit?` * `what is the expected output of this commit?` @@ -345,7 +345,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} questions a ## Ask general software questions -You can ask {% data variables.product.prodname_copilot_chat_short %} general software questions. For example: +You can ask {% data variables.copilot.copilot_chat_short %} general software questions. For example: * `tell me about nodejs web server frameworks` * `how can I create an Express app` @@ -353,10 +353,10 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} general sof ## Ask questions about files your project -You can ask {% data variables.product.prodname_copilot_chat_short %} questions about the file that's currently displayed in the editor, or about files you have attached to your conversation in the {% data variables.product.prodname_copilot_chat_short %} panel. To give {% data variables.product.prodname_copilot_short %} the correct context: +You can ask {% data variables.copilot.copilot_chat_short %} questions about the file that's currently displayed in the editor, or about files you have attached to your conversation in the {% data variables.copilot.copilot_chat_short %} panel. To give {% data variables.product.prodname_copilot_short %} the correct context: * Open the relevant file in the editor. -* Click the paperclip icon in the {% data variables.product.prodname_copilot_chat_short %} panel, then search for and select files you want to attach to the conversation. +* Click the paperclip icon in the {% data variables.copilot.copilot_chat_short %} panel, then search for and select files you want to attach to the conversation. For example: diff --git a/content/copilot/using-github-copilot/copilot-chat/github-copilot-chat-cheat-sheet.md b/content/copilot/using-github-copilot/copilot-chat/github-copilot-chat-cheat-sheet.md index 8c017f1769..d95d2bce7f 100644 --- a/content/copilot/using-github-copilot/copilot-chat/github-copilot-chat-cheat-sheet.md +++ b/content/copilot/using-github-copilot/copilot-chat/github-copilot-chat-cheat-sheet.md @@ -1,7 +1,7 @@ --- title: GitHub Copilot Chat cheat sheet shortTitle: Copilot Chat cheat sheet -intro: "Use this cheat sheet to quickly reference the most common commands and options for using {% data variables.product.prodname_copilot_chat %}." +intro: "Use this cheat sheet to quickly reference the most common commands and options for using {% data variables.copilot.copilot_chat %}." versions: feature: copilot topics: @@ -16,13 +16,13 @@ This version of this article is for {% data variables.product.prodname_copilot_s {% data reusables.copilot.about-copilot-enhancements %} -For information about how to get started with {% data variables.product.prodname_copilot_chat_short %} in the {% data variables.product.github %} website, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-github). +For information about how to get started with {% data variables.copilot.copilot_chat_short %} in the {% data variables.product.github %} website, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-github). ## Slash commands Use slash commands to avoid writing complex prompts for common scenarios. To use a slash command, type `/` in the chat prompt box, followed by the command name. -Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.product.prodname_copilot_chat_short %}. +Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.copilot.copilot_chat_short %}. | Command | Description | | --- | --- | @@ -39,13 +39,13 @@ This version of this article is for {% data variables.product.prodname_copilot_s {% data reusables.copilot.about-copilot-enhancements %} -For information about how to get started with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). +For information about how to get started with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). ## Slash commands Use slash commands to avoid writing complex prompts for common scenarios. To use a slash command, type `/` in the chat prompt box, followed by the command name. -Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.product.prodname_copilot_chat_short %}. +Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.copilot.copilot_chat_short %}. | Command | Description | | --- | --- | @@ -78,7 +78,7 @@ Use chat variables to include specific context in your prompt. To use a chat var Chat participants are like domain experts who have a specialty that they can help you with. You can specify a chat participant by typing `@` in the chat prompt box, followed by a chat participant name. To see all available chat participants, type `@` in the chat prompt box. -Below is a list of some of the most common chat participants for using {% data variables.product.prodname_copilot_chat_short %}. +Below is a list of some of the most common chat participants for using {% data variables.copilot.copilot_chat_short %}. | Variable | Description | |--------------|----------------------------------------------------------------------------------------------| @@ -96,13 +96,13 @@ This version of this article is for {% data variables.product.prodname_copilot_s {% data reusables.copilot.about-copilot-enhancements %} -For information about how to get started with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). +For information about how to get started with {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vs %}, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). ## Slash commands Use slash commands to avoid writing complex prompts for common scenarios. To use a slash command, type `/` in the chat prompt box, followed by the command name. -Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.product.prodname_copilot_chat_short %}. +Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.copilot.copilot_chat_short %}. | Command | Description | | --- | --- | @@ -115,7 +115,7 @@ Available slash commands may vary, depending on your environment and the context ## References -By default, {% data variables.product.prodname_copilot_chat_short %} will reference the file that you have open or the code that you have selected. You can also use # followed by a file name, file name and line numbers, or solution to reference a specific file, lines, or solution. +By default, {% data variables.copilot.copilot_chat_short %} will reference the file that you have open or the code that you have selected. You can also use # followed by a file name, file name and line numbers, or solution to reference a specific file, lines, or solution. | Example | Description | | --- | --- | @@ -132,13 +132,13 @@ This version of this article is for {% data variables.product.prodname_copilot_s {% data reusables.copilot.about-copilot-enhancements %} -For information about how to get started with {% data variables.product.prodname_copilot_chat_short %} in JetBrains, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). +For information about how to get started with {% data variables.copilot.copilot_chat_short %} in JetBrains, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). ## Slash commands Use slash commands to avoid writing complex prompts for common scenarios. To use a slash command, type `/` in the chat prompt box, followed by the command name. -Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.product.prodname_copilot_chat_short %}. +Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of some of the most common slash commands for using {% data variables.copilot.copilot_chat_short %}. | Command | Description | | --- | --- | @@ -166,13 +166,13 @@ This version of this article is for {% data variables.product.prodname_copilot_s {% data reusables.copilot.about-copilot-enhancements %} -For information about how to get started with {% data variables.product.prodname_copilot_chat_short %} in Xcode, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). +For information about how to get started with {% data variables.copilot.copilot_chat_short %} in Xcode, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). ## Slash commands Use slash commands to avoid writing complex prompts for common scenarios. To use a slash command, type `/` in the chat prompt box, followed by the command name. -Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of the slash commands for using {% data variables.product.prodname_copilot_chat_short %}. +Available slash commands may vary, depending on your environment and the context of your chat. To view a list of currently available slash commands, type `/` in the chat prompt box of your current environment. Below is a list of the slash commands for using {% data variables.copilot.copilot_chat_short %}. | Command | Description | |-------------|----------------------------------------------------| diff --git a/content/copilot/using-github-copilot/copilot-chat/index.md b/content/copilot/using-github-copilot/copilot-chat/index.md index 427fa32650..6f4d41d7d7 100644 --- a/content/copilot/using-github-copilot/copilot-chat/index.md +++ b/content/copilot/using-github-copilot/copilot-chat/index.md @@ -1,6 +1,6 @@ --- title: Copilot Chat -intro: "Learn how to use {% data variables.product.prodname_copilot_chat_short %} across different environments." +intro: "Learn how to use {% data variables.copilot.copilot_chat_short %} across different environments." versions: feature: copilot topics: diff --git a/content/copilot/using-github-copilot/copilot-chat/indexing-repositories-for-copilot-chat.md b/content/copilot/using-github-copilot/copilot-chat/indexing-repositories-for-copilot-chat.md index 89f24baec2..7fc7462768 100644 --- a/content/copilot/using-github-copilot/copilot-chat/indexing-repositories-for-copilot-chat.md +++ b/content/copilot/using-github-copilot/copilot-chat/indexing-repositories-for-copilot-chat.md @@ -1,7 +1,7 @@ --- title: Indexing repositories for Copilot Chat shortTitle: Semantic indexing -intro: '{% data variables.product.prodname_copilot_chat %} improves responses to questions about code by indexing your repositories.' +intro: '{% data variables.copilot.copilot_chat %} improves responses to questions about code by indexing your repositories.' versions: feature: copilot topics: @@ -16,11 +16,11 @@ redirect_from: ## Benefit of indexing repositories -{% data variables.product.prodname_copilot_chat_short %}'s ability to answer natural language questions in a repository context is optimized when the semantic code search index for the repository is up to date. +{% data variables.copilot.copilot_chat_short %}'s ability to answer natural language questions in a repository context is optimized when the semantic code search index for the repository is up to date. -When you start a conversation with {% data variables.product.prodname_copilot_chat_short %} that has a repository context, the repository is automatically indexed to improve context-enriched answers to your questions about the code's structure and logic in {% data variables.product.github %} and {% data variables.product.prodname_vscode %}. For example, you can ask **“How does this repo manage HTTP requests and responses?”** and {% data variables.product.prodname_copilot_chat_short %} will reference relevant sections of your code to deliver an informed answer. +When you start a conversation with {% data variables.copilot.copilot_chat_short %} that has a repository context, the repository is automatically indexed to improve context-enriched answers to your questions about the code's structure and logic in {% data variables.product.github %} and {% data variables.product.prodname_vscode %}. For example, you can ask **“How does this repo manage HTTP requests and responses?”** and {% data variables.copilot.copilot_chat_short %} will reference relevant sections of your code to deliver an informed answer. -**{% data variables.product.prodname_copilot_chat_short %} will not use your indexed repository for model training.** +**{% data variables.copilot.copilot_chat_short %} will not use your indexed repository for model training.** For more information on how to ask questions, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-github). @@ -28,12 +28,12 @@ For more information on how to ask questions, see [AUTOTITLE](/copilot/using-git Indexing runs in the background and initial indexing can take up to 60 seconds for a large repository. Once a repository has been indexed for the first time, re-indexing is much quicker and the index will typically be automatically updated to include the latest changes within seconds of you starting a new conversation. -Once an index has been created for a repository, {% data variables.product.prodname_copilot_chat_short %} uses it to answer questions asked by any {% data variables.product.prodname_copilot_short %} user in {% data variables.product.github %} and {% data variables.product.prodname_vscode %}. +Once an index has been created for a repository, {% data variables.copilot.copilot_chat_short %} uses it to answer questions asked by any {% data variables.product.prodname_copilot_short %} user in {% data variables.product.github %} and {% data variables.product.prodname_vscode %}. > [!TIP] There is no limit to how many repositories you can index. -## Excluding content from {% data variables.product.prodname_copilot_chat_short %} answers +## Excluding content from {% data variables.copilot.copilot_chat_short %} answers -Enterprise or organization owners with a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} plan can define content exclusions to control the behavior of {% data variables.product.prodname_copilot %} for the {% data variables.product.prodname_copilot_short %} seats they manage. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/excluding-content-from-github-copilot). +Enterprise or organization owners with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} plan can define content exclusions to control the behavior of {% data variables.product.prodname_copilot %} for the {% data variables.product.prodname_copilot_short %} seats they manage. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/excluding-content-from-github-copilot). -If a semantic code search index is created for a repository that is included in a content exclusion policy, data is filtered according to the policy before being passed to {% data variables.product.prodname_copilot_chat_short %}. +If a semantic code search index is created for a repository that is included in a content exclusion policy, data is filtered according to the policy before being passed to {% data variables.copilot.copilot_chat_short %}. diff --git a/content/copilot/using-github-copilot/copilot-chat/prompt-engineering-for-copilot-chat.md b/content/copilot/using-github-copilot/copilot-chat/prompt-engineering-for-copilot-chat.md index cd6db08ec6..e9a7614f38 100644 --- a/content/copilot/using-github-copilot/copilot-chat/prompt-engineering-for-copilot-chat.md +++ b/content/copilot/using-github-copilot/copilot-chat/prompt-engineering-for-copilot-chat.md @@ -10,7 +10,7 @@ redirect_from: - /copilot/using-github-copilot/prompt-engineering-for-github-copilot --- -A prompt is a request that you make to {% data variables.product.prodname_copilot %}. For example, a question that you ask {% data variables.product.prodname_copilot_chat_short %}, or a code snippet that you ask {% data variables.product.prodname_copilot_short %} to complete. In addition to your prompt, {% data variables.product.prodname_copilot_short %} uses additional context, like the code in your current file and the chat history, to generate a response. +A prompt is a request that you make to {% data variables.product.prodname_copilot %}. For example, a question that you ask {% data variables.copilot.copilot_chat_short %}, or a code snippet that you ask {% data variables.product.prodname_copilot_short %} to complete. In addition to your prompt, {% data variables.product.prodname_copilot_short %} uses additional context, like the code in your current file and the chat history, to generate a response. Follow the tips in this article to write prompts that generate better responses from {% data variables.product.prodname_copilot_short %}. @@ -78,7 +78,7 @@ Ambiguity can also apply to libraries: If you are using {% data variables.product.prodname_copilot_short %} in your IDE to get suggestions as you code, open any relevant files and close irrelevant files. {% data variables.product.prodname_copilot_short %} will use the open files to understand your request. -If you are using {% data variables.product.prodname_copilot_chat_short %} in your IDE, open the file or highlight the code that you want {% data variables.product.prodname_copilot_short %} to reference. You can also use keywords to manually supply context to {% data variables.product.prodname_copilot_chat_short %}. For example, you can add the `@workspace` chat participant in VS Code, or `@project` in JetBrains IDEs. See [AUTOTITLE](/copilot/using-github-copilot/github-copilot-chat-cheat-sheet). +If you are using {% data variables.copilot.copilot_chat_short %} in your IDE, open the file or highlight the code that you want {% data variables.product.prodname_copilot_short %} to reference. You can also use keywords to manually supply context to {% data variables.copilot.copilot_chat_short %}. For example, you can add the `@workspace` chat participant in VS Code, or `@project` in JetBrains IDEs. See [AUTOTITLE](/copilot/using-github-copilot/github-copilot-chat-cheat-sheet). ## Experiment and iterate @@ -86,11 +86,11 @@ If you don’t get the result that you want, iterate on your prompt and try agai If you are using {% data variables.product.prodname_copilot_short %} to get suggestions as you code, you can delete the suggestion entirely and start over. Or you can keep the suggestion and request modifications. -If you are using {% data variables.product.prodname_copilot_chat_short %}, you can reference the previous response in your next request. Or, you can delete the previous response and start over. +If you are using {% data variables.copilot.copilot_chat_short %}, you can reference the previous response in your next request. Or, you can delete the previous response and start over. ## Keep history relevant -{% data variables.product.prodname_copilot_chat_short %} uses the chat history to get context about your request. To give {% data variables.product.prodname_copilot_short %} only the relevant history: +{% data variables.copilot.copilot_chat_short %} uses the chat history to get context about your request. To give {% data variables.product.prodname_copilot_short %} only the relevant history: * Use threads to start a new conversation for a new task * Delete requests that are no longer relevant or that didn’t give you the desired result diff --git a/content/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces.md b/content/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces.md index 830db6a8e9..8c1205df35 100644 --- a/content/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces.md +++ b/content/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces.md @@ -1,8 +1,8 @@ --- title: About organizing and sharing context with Copilot Spaces shortTitle: Organize and share context -intro: 'Understand how gathering context with {% data variables.product.prodname_copilot_spaces %} can improve your results and help your teammates.' -permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.' +intro: 'Understand how gathering context with {% data variables.copilot.copilot_spaces %} can improve your results and help your teammates.' +permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.' versions: feature: copilot type: overview @@ -12,26 +12,26 @@ topics: {% data reusables.copilot.copilot-spaces.preview-note %} -{% data variables.product.prodname_copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. {% data variables.product.prodname_copilot_spaces_short %} can include code from repositories, free-text content like transcripts or notes, and more—grouped together in one place. You can ask {% data variables.product.prodname_copilot_short %} questions grounded in that context, or share the space with your team to support collaboration and knowledge sharing. +{% data variables.copilot.copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. {% data variables.copilot.copilot_spaces_short %} can include code from repositories, free-text content like transcripts or notes, and more—grouped together in one place. You can ask {% data variables.product.prodname_copilot_short %} questions grounded in that context, or share the space with your team to support collaboration and knowledge sharing. -## Why use {% data variables.product.prodname_copilot_spaces %}? +## Why use {% data variables.copilot.copilot_spaces %}? -Whether you’re working solo or collaborating across a team, {% data variables.product.prodname_copilot_spaces_short %} help you make {% data variables.product.prodname_copilot_short %} more useful. +Whether you’re working solo or collaborating across a team, {% data variables.copilot.copilot_spaces_short %} help you make {% data variables.product.prodname_copilot_short %} more useful. -With {% data variables.product.prodname_copilot_spaces %} you can: +With {% data variables.copilot.copilot_spaces %} you can: * Get more relevant, specific answers from {% data variables.product.prodname_copilot_short %}. * Stay in flow by collecting what you need for a task in one place. * Reduce repeated questions by sharing knowledge with your team. * Support onboarding and reuse with self-service context that lives beyond chat history. -### How are {% data variables.product.prodname_copilot_spaces_short %} different from knowledge bases? +### How are {% data variables.copilot.copilot_spaces_short %} different from knowledge bases? -{% data variables.product.prodname_copilot_spaces_short %} are optimized for specific tasks and grounded conversations. Because context in {% data variables.product.prodname_copilot_spaces_short %} is scoped, {% data variables.product.prodname_copilot_short %}'s responses are more accurate and relevant. +{% data variables.copilot.copilot_spaces_short %} are optimized for specific tasks and grounded conversations. Because context in {% data variables.copilot.copilot_spaces_short %} is scoped, {% data variables.product.prodname_copilot_short %}'s responses are more accurate and relevant. {% rowheaders %} -| | {% data variables.product.prodname_copilot_spaces %} | Knowledge bases | +| | {% data variables.copilot.copilot_spaces %} | Knowledge bases | | -------------------- | --------------------------- | -------------------------------------------------------------- | | Who can create | Anyone with a {% data variables.product.prodname_copilot_short %} license | Organization owners | | Owned by | Organizations or individual users | Organizations | @@ -40,19 +40,19 @@ With {% data variables.product.prodname_copilot_spaces %} you can: {% endrowheaders %} -## Who can use {% data variables.product.prodname_copilot_spaces_short %}? +## Who can use {% data variables.copilot.copilot_spaces_short %}? -Anyone with a {% data variables.product.prodname_copilot_short %} license, including {% data variables.product.prodname_copilot_free_short %}, can create and use {% data variables.product.prodname_copilot_spaces_short %}. +Anyone with a {% data variables.product.prodname_copilot_short %} license, including {% data variables.copilot.copilot_free_short %}, can create and use {% data variables.copilot.copilot_spaces_short %}. -During the {% data variables.release-phases.public_preview %}, if you're using a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, the organization or enterprise that provides your plan must have the **Opt in to preview features** setting enabled. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) or [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom). +During the {% data variables.release-phases.public_preview %}, if you're using a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, the organization or enterprise that provides your plan must have the **Opt in to preview features** setting enabled. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) or [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom). -{% data variables.product.prodname_copilot_spaces_short %} can belong to a personal account or to an organization. Spaces owned by an organization can be shared with other organization members (read-only) or kept private to the person who created the space. +{% data variables.copilot.copilot_spaces_short %} can belong to a personal account or to an organization. Spaces owned by an organization can be shared with other organization members (read-only) or kept private to the person who created the space. -Questions you submit in a space count as {% data variables.product.prodname_copilot_chat_short %} requests. +Questions you submit in a space count as {% data variables.copilot.copilot_chat_short %} requests. -* If you're a {% data variables.product.prodname_copilot_free_short %} user, this usage counts toward your monthly chat limit. -* If you use {% data variables.product.prodname_copilot_spaces_short %} with a premium model, this usage counts toward your premium usage quota. +* If you're a {% data variables.copilot.copilot_free_short %} user, this usage counts toward your monthly chat limit. +* If you use {% data variables.copilot.copilot_spaces_short %} with a premium model, this usage counts toward your premium usage quota. ## Next steps -To start using {% data variables.product.prodname_copilot_spaces_short %}, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces). +To start using {% data variables.copilot.copilot_spaces_short %}, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces). diff --git a/content/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces.md b/content/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces.md index 2667eef83f..606c9188d2 100644 --- a/content/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces.md +++ b/content/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces.md @@ -1,8 +1,8 @@ --- title: Collaborating with your team using Copilot Spaces shortTitle: Collaborate with your team -intro: 'Learn how to share {% data variables.product.prodname_copilot_spaces %} with your team to support collaboration and knowledge sharing.' -permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.' +intro: 'Learn how to share {% data variables.copilot.copilot_spaces %} with your team to support collaboration and knowledge sharing.' +permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.' versions: feature: copilot type: how_to @@ -12,7 +12,7 @@ topics: {% data reusables.copilot.copilot-spaces.preview-note %} -{% data variables.product.prodname_copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. Sharing {% data variables.product.prodname_copilot_spaces %} helps your team: +{% data variables.copilot.copilot_spaces %} let you organize the context that {% data variables.product.prodname_copilot_short %} uses to answer your questions. Sharing {% data variables.copilot.copilot_spaces %} helps your team: * Avoid repeated explanations and handoffs. * Stay aligned on how a system works or what’s expected. @@ -27,7 +27,7 @@ topics: For example, a subject matter expert creates a space called “Accessibility Reviews” that includes your team’s internal accessibility checklist, product guidelines, and WCAG documentation. Developers can ask {% data variables.product.prodname_copilot_short %} questions directly in the space to ensure they're following the latest guidelines in their work. -## Sharing {% data variables.product.prodname_copilot_spaces_short %} +## Sharing {% data variables.copilot.copilot_spaces_short %} When you create a space, you can choose whether it’s owned by you or by one of your organizations. If you choose an organization: @@ -43,6 +43,6 @@ To share a space with your organization: Other people in your organization can now view the space in the "Organizations" tab and use it to ask questions. Additionally, you can also click **{% octicon "link" aria-label="the link" %} Copy link** to copy the link to the space and share it with others. -## Accessing shared {% data variables.product.prodname_copilot_spaces_short %} +## Accessing shared {% data variables.copilot.copilot_spaces_short %} If you’re part of an organization that has shared spaces, you can access them in the **Organizations** tab on [https://github.com/copilot/spaces](https://github.com/copilot/spaces). diff --git a/content/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces.md b/content/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces.md index 661ff727a5..8f58661dfd 100644 --- a/content/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces.md +++ b/content/copilot/using-github-copilot/copilot-spaces/creating-and-using-copilot-spaces.md @@ -2,7 +2,7 @@ title: Creating and using Copilot Spaces shortTitle: Create and use Copilot Spaces intro: 'Create spaces to organize and centralize relevant content that grounds {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task.' -permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.' +permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.' versions: feature: copilot type: how_to @@ -14,11 +14,11 @@ topics: 1. To create a space, go to [https://github.com/copilot/spaces](https://github.com/copilot/spaces), and click **Create space**. 1. Give your space a name. -1. Choose whether the space is owned by you or by an organization you belong to. Organization-owned {% data variables.product.prodname_copilot_spaces_short %} can be shared using {% data variables.product.github %}’s built-in permission model. +1. Choose whether the space is owned by you or by an organization you belong to. Organization-owned {% data variables.copilot.copilot_spaces_short %} can be shared using {% data variables.product.github %}’s built-in permission model. 1. Optionally, add a description to help others understand the purpose of the space. 1. Click **Create**. -## Adding context to {% data variables.product.prodname_copilot_spaces_short %} +## Adding context to {% data variables.copilot.copilot_spaces_short %} You can add two types of context to your space: @@ -30,11 +30,11 @@ You can add two types of context to your space: * **References**: You can add any code hosted in {% data variables.product.github %} repositories, including public and private repositories. You can also add free-text content, such as transcripts or notes. - >[!TIP] You don’t need formal docs to get value from {% data variables.product.prodname_copilot_spaces_short %}. Try pasting in a Slack thread, a video call summary, or even bullet-point notes. + >[!TIP] You don’t need formal docs to get value from {% data variables.copilot.copilot_spaces_short %}. Try pasting in a Slack thread, a video call summary, or even bullet-point notes. -This context will be used to provide more relevant answers to your questions. Additionally, {% data variables.product.prodname_copilot_spaces_short %} will always refer to the latest version of the code on the `main` branch of the repository. +This context will be used to provide more relevant answers to your questions. Additionally, {% data variables.copilot.copilot_spaces_short %} will always refer to the latest version of the code on the `main` branch of the repository. -## Using {% data variables.product.prodname_copilot_spaces_short %} +## Using {% data variables.copilot.copilot_spaces_short %} Once you've added context to your space, you can ask {% data variables.product.prodname_copilot_short %} questions in the chat interface. Your chat will be grounded in the context you've added. @@ -42,5 +42,5 @@ You can also change the large language model (LLM) used for your space by select ## Next steps -* To learn more about how to use {% data variables.product.prodname_copilot_spaces_short %} to help you with development work, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces). +* To learn more about how to use {% data variables.copilot.copilot_spaces_short %} to help you with development work, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces). * To learn how to share your space with your team, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/collaborating-with-your-team-using-copilot-spaces). diff --git a/content/copilot/using-github-copilot/copilot-spaces/index.md b/content/copilot/using-github-copilot/copilot-spaces/index.md index a70007fcd8..7c8d726f63 100644 --- a/content/copilot/using-github-copilot/copilot-spaces/index.md +++ b/content/copilot/using-github-copilot/copilot-spaces/index.md @@ -1,6 +1,6 @@ --- title: Copilot Spaces -intro: "Organize and centralize relevant content into {% data variables.product.prodname_copilot_spaces_short %} that ground {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task." +intro: "Organize and centralize relevant content into {% data variables.copilot.copilot_spaces_short %} that ground {% data variables.product.prodname_copilot_short %}’s responses in the right context for a specific task." versions: feature: copilot topics: diff --git a/content/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces.md b/content/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces.md index c4e31fb6d7..8b881e197c 100644 --- a/content/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces.md +++ b/content/copilot/using-github-copilot/copilot-spaces/speeding-up-development-work-with-copilot-spaces.md @@ -1,8 +1,8 @@ --- title: Speeding up development work with Copilot Spaces shortTitle: Speed up development work -intro: 'Learn how to use {% data variables.product.prodname_copilot_spaces %} to help you with development work.' -permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.product.prodname_copilot_spaces_short %}.' +intro: 'Learn how to use {% data variables.copilot.copilot_spaces %} to help you with development work.' +permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.' versions: feature: copilot type: how_to @@ -12,7 +12,7 @@ topics: {% data reusables.copilot.copilot-spaces.preview-note %} -If you're starting a new feature, trying to understand a system, or picking up a task in a codebase you’re still learning, {% data variables.product.prodname_copilot_spaces %} can help you: +If you're starting a new feature, trying to understand a system, or picking up a task in a codebase you’re still learning, {% data variables.copilot.copilot_spaces %} can help you: * Stay focused by organizing the context you need in one place. * Get better help from {% data variables.product.prodname_copilot_short %} by grounding it in relevant code and documentation. @@ -20,7 +20,7 @@ If you're starting a new feature, trying to understand a system, or picking up a To create a space, go to [https://github.com/copilot/spaces](https://github.com/copilot/spaces), and click **Create space**. -Below are some examples of how to use {% data variables.product.prodname_copilot_spaces_short %} to help you with development work. +Below are some examples of how to use {% data variables.copilot.copilot_spaces_short %} to help you with development work. ## Developing a new feature @@ -39,7 +39,7 @@ When working on a specific feature, you can save time and produce higher-quality ## Defining the logic for a small, frequent task -When working on repetitive tasks like tracking telemetry events or handling event emissions, it’s useful to document the logic once and share it with others through {% data variables.product.prodname_copilot_spaces_short %}. This allows everyone to stay consistent and saves time when performing the task. {% data variables.product.prodname_copilot_short %} can assist by: +When working on repetitive tasks like tracking telemetry events or handling event emissions, it’s useful to document the logic once and share it with others through {% data variables.copilot.copilot_spaces_short %}. This allows everyone to stay consistent and saves time when performing the task. {% data variables.product.prodname_copilot_short %} can assist by: * Suggesting efficient patterns based on your previous work. * Helping write reusable functions or templates. @@ -61,7 +61,7 @@ In situations where people tend to ask similar questions, such as how authentica * Guide new team members on the best practices. **Instructions**: -> You contain the code and documentation associated with our authentication system. +> You contain the code and documentation associated with our authentication system. **Suggested prompt**: > How does SSO work? diff --git a/content/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions.md b/content/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions.md index 44e5983623..619ac1d1d6 100644 --- a/content/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions.md +++ b/content/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions.md @@ -60,7 +60,7 @@ References to matching code are only generated if {% data variables.product.prod {% webui %} -If you've allowed suggestions that match public code, then whenever a response from {% data variables.product.prodname_copilot_chat_short %} includes matching code, details of the matches will be included in the response. +If you've allowed suggestions that match public code, then whenever a response from {% data variables.copilot.copilot_chat_short %} includes matching code, details of the matches will be included in the response. {% endwebui %} @@ -78,7 +78,7 @@ This feature is called code referencing. {% data reusables.copilot.code-referencing-note %} -### Code referencing for {% data variables.product.prodname_copilot_chat_short %} +### Code referencing for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.code-referencing-in-chat %} @@ -87,7 +87,7 @@ This feature is called code referencing. {% webui %} > [!NOTE] -> Typically, matches to public code occur infrequently, so you should not expect to see code references in many {% data variables.product.prodname_copilot_chat_short %} responses. +> Typically, matches to public code occur infrequently, so you should not expect to see code references in many {% data variables.copilot.copilot_chat_short %} responses. {% endwebui %} @@ -97,7 +97,7 @@ This feature is called code referencing. {% data reusables.copilot.code-referencing-note %} -### Code referencing for {% data variables.product.prodname_copilot_chat_short %} +### Code referencing for {% data variables.copilot.copilot_chat_short %} {% data reusables.copilot.code-referencing-in-chat %} @@ -109,9 +109,9 @@ This feature is called code referencing. {% data reusables.copilot.code-referencing-note %} -### Code referencing for {% data variables.product.prodname_copilot_chat_short %} +### Code referencing for {% data variables.copilot.copilot_chat_short %} -When {% data variables.product.prodname_copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated below the suggested code, with a link to display details of the matched code in the output log. +When {% data variables.copilot.copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated below the suggested code, with a link to display details of the matched code in the output log. {% endvisualstudio %} @@ -223,7 +223,7 @@ You can find code references in the {% data variables.product.prodname_copilot % {% endvisualstudio %} -## View code references for {% data variables.product.prodname_copilot_chat_short %} +## View code references for {% data variables.copilot.copilot_chat_short %} {% jetbrains %} @@ -239,7 +239,7 @@ You can find code references in the {% data variables.product.prodname_copilot % {% visualstudio %} -If a response in {% data variables.product.prodname_copilot_chat_short %} includes matching code, this is below the suggested code by the following text: +If a response in {% data variables.copilot.copilot_chat_short %} includes matching code, this is below the suggested code by the following text: > Found similar code in public repos. **View matches** @@ -285,7 +285,7 @@ The details include: {% webui %} -When {% data variables.product.prodname_copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.prodname_dotcom %} repository, this is indicated beneath the code suggestion: +When {% data variables.copilot.copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.prodname_dotcom %} repository, this is indicated beneath the code suggestion: > < > Public code references from _n_ repositories @@ -295,7 +295,7 @@ To see details of the matching code: A list of {% data variables.product.github %} repositories containing matching code is displayed in a dropdown, together with licensing information, if found. - ![Screenshot of a code completion suggestion in {% data variables.product.prodname_copilot_chat_short %} with a link to view code references.](/assets/images/help/copilot/code-reference-dotcom.png) + ![Screenshot of a code completion suggestion in {% data variables.copilot.copilot_chat_short %} with a link to view code references.](/assets/images/help/copilot/code-reference-dotcom.png) 1. Click the name of a repository to display that repository on {% data variables.product.prodname_dotcom_the_website %}. diff --git a/content/copilot/using-github-copilot/getting-code-suggestions-in-your-ide-with-github-copilot.md b/content/copilot/using-github-copilot/getting-code-suggestions-in-your-ide-with-github-copilot.md index d70f5437ba..e767d4f107 100644 --- a/content/copilot/using-github-copilot/getting-code-suggestions-in-your-ide-with-github-copilot.md +++ b/content/copilot/using-github-copilot/getting-code-suggestions-in-your-ide-with-github-copilot.md @@ -39,7 +39,7 @@ The examples in this guide use Java, however other languages will work similarly ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in JetBrains, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in JetBrains, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} * **Compatible JetBrains IDE**. To use {% data variables.product.prodname_copilot %} in JetBrains, you must have a compatible JetBrains IDE installed. {% data variables.product.prodname_copilot %} is compatible with the following IDEs: @@ -141,7 +141,7 @@ The examples in this guide use C#, however other languages will work similarly. ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} {% data reusables.copilot.visual-studio-prerequisites %} @@ -195,7 +195,7 @@ Alternatively, you can show alternate suggestions by pressing Alt+ * Comment suggestions are currently in {% data variables.release-phases.public_preview %} and are subject to change. > * Comment suggestions are available in {% data variables.product.prodname_vs %} 17.14 Preview 2 and later. -{% data variables.product.prodname_copilot %} can suggest comments for your code, by analyzing the code you write and generating comments that describe what the code does. For {% data variables.product.prodname_copilot_free_short %} users, comment suggestions count towards your monthly {% data variables.product.prodname_copilot_chat_short %} usage, not your code suggestions usage. +{% data variables.product.prodname_copilot %} can suggest comments for your code, by analyzing the code you write and generating comments that describe what the code does. For {% data variables.copilot.copilot_free_short %} users, comment suggestions count towards your monthly {% data variables.copilot.copilot_chat_short %} usage, not your code suggestions usage. Comment suggestions are available in the following languages: @@ -258,7 +258,7 @@ The examples in this guide use JavaScript, however other languages will work sim ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} * **Sign in to {% data variables.product.github %} in {% data variables.product.prodname_vscode %}**. See [Set up {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/docs/copilot/setup) in the {% data variables.product.prodname_vscode_shortname %} documentation.. @@ -381,7 +381,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Vim/Neovim, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Vim/Neovim, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} * **Compatible version of Vim/Neovim**. To use {% data variables.product.prodname_copilot %} in Vim/Neovim you must have Vim version 9.0.0185 / Neovim version 0.6 or above and Node.js version 18 or above installed. For more information, see the [Vim](https://vimhelp.org/) / [Neovim documentation](https://neovim.io/doc/) and the [Node.js website](https://nodejs.org/en/). @@ -407,7 +407,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Azure Data Studio, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Azure Data Studio, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} * **Compatible version of Azure Data Studio**. To use {% data variables.product.prodname_copilot %} in Azure Data Studio, you must have Azure Data Studio version 1.44.0 or later installed. For more information, see the [Azure Data Studio download page](https://docs.microsoft.com/sql/azure-data-studio/download-azure-data-studio) in the Azure Data Studio documentation. @@ -503,7 +503,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Xcode, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Xcode, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} * **{% data variables.product.prodname_copilot %} extension for Xcode**. To use {% data variables.product.prodname_copilot %} for Xcode, you must install the {% data variables.product.prodname_copilot %} for Xcode extension. See [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment). @@ -538,7 +538,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro ## Prerequisites -* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Eclipse, you need either limited access through {% data variables.product.prodname_copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} +* **Access to {% data variables.product.prodname_copilot_short %}**. To use {% data variables.product.prodname_copilot %} in Eclipse, you need either limited access through {% data variables.copilot.copilot_free_short %} or a paid {% data variables.product.prodname_copilot_short %} plan for full access. {% data reusables.copilot.subscription-prerequisite %} * **{% data variables.product.prodname_copilot %} extension for Eclipse**.To use {% data variables.product.prodname_copilot %} in Eclipse, you must install the {% data variables.product.prodname_copilot %} extension. See [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment?tool=eclipse). @@ -590,5 +590,5 @@ If you don't want to accept an entire suggestion from {% data variables.product. * **Learn how to write effective prompts** - See [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot). * **Configure {% data variables.product.prodname_copilot_short %} in your editor** - You can enable or disable {% data variables.product.prodname_copilot %} from within your editor, and create your own preferred keyboard shortcuts for {% data variables.product.prodname_copilot_short %}. See [AUTOTITLE](/copilot/configuring-github-copilot/configuring-github-copilot-in-your-environment). -* **Get started with {% data variables.product.prodname_copilot_chat %}** - Learn how to ask {% data variables.product.prodname_copilot_short %} for information and assistance, using {% data variables.product.prodname_copilot_chat %}. See [AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion ghec %} and [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom){% endif %}. +* **Get started with {% data variables.copilot.copilot_chat %}** - Learn how to ask {% data variables.product.prodname_copilot_short %} for information and assistance, using {% data variables.copilot.copilot_chat %}. See [AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion ghec %} and [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom){% endif %}. * **Troubleshoot issues** - Learn more about how to troubleshoot common issues with {% data variables.product.prodname_copilot %}. See [AUTOTITLE](/copilot/troubleshooting-github-copilot). diff --git a/content/copilot/using-github-copilot/guides-on-using-github-copilot/choosing-the-right-ai-tool-for-your-task.md b/content/copilot/using-github-copilot/guides-on-using-github-copilot/choosing-the-right-ai-tool-for-your-task.md index 72f8091d25..a543e3e605 100644 --- a/content/copilot/using-github-copilot/guides-on-using-github-copilot/choosing-the-right-ai-tool-for-your-task.md +++ b/content/copilot/using-github-copilot/guides-on-using-github-copilot/choosing-the-right-ai-tool-for-your-task.md @@ -16,21 +16,21 @@ The use of AI tools is increasingly becoming a standard part of a software devel * **Planning**: * {% data variables.product.prodname_copilot_short %} can create issues to help track your ideas. - * {% data variables.product.prodname_copilot_chat_short %} can help you brainstorm and identify the best technologies for your project. + * {% data variables.copilot.copilot_chat_short %} can help you brainstorm and identify the best technologies for your project. * **Code creation**: * {% data variables.product.prodname_copilot_short %} code completion helps add code as you type. * {% data variables.copilot.next_edit_suggestions_caps %} ({% data variables.release-phases.public_preview %}) predicts the next edit you are likely to make and suggests a completion for it. - * {% data variables.product.prodname_copilot_chat_short %} can answer questions and offer suggestions in a conversational environment. + * {% data variables.copilot.copilot_chat_short %} can answer questions and offer suggestions in a conversational environment. * You can assign {% data variables.copilot.copilot_coding_agent %} to an open issue and it will automatically raise a pull request to address the necessary changes. * **Reviews**: * {% data variables.copilot.copilot_code-review_short %} gives you feedback in your favorite IDE, or as a pull request review on {% data variables.product.github %}. * **Testing**: - * {% data variables.product.prodname_copilot_chat_short %} can help you write and debug tests. + * {% data variables.copilot.copilot_chat_short %} can help you write and debug tests. * **Deployment**: - * {% data variables.product.prodname_copilot_chat_short %} can help you configure continuous integration and continuous deployment (CI/CD) pipelines. + * {% data variables.copilot.copilot_chat_short %} can help you configure continuous integration and continuous deployment (CI/CD) pipelines. * **Operation**: * {% data variables.copilot.copilot_coding_agent %} ({% data variables.release-phases.public_preview %}) can raise pull requests for open issues. - * {% data variables.product.prodname_copilot_chat_short %} can help with tasks you're working on yourself. + * {% data variables.copilot.copilot_chat_short %} can help with tasks you're working on yourself. ## Planning @@ -38,7 +38,7 @@ During the planning phase, you define the goals, scope, and requirements of your On {% data variables.product.github %}, use **{% data variables.product.prodname_copilot_short %}-powered issue creation** ({% data variables.release-phases.public_preview %}) to streamline the tracking of your ideas. Provide a short natural language prompt (or upload an image), and {% data variables.product.prodname_copilot_short %} will generate a structured issue for you. -Once you've chosen an issue to address, **{% data variables.product.prodname_copilot_chat_short %}** can help you brainstorm ideas for your project and learn about the various tools, libraries, and resources you might need. You can ask {% data variables.product.prodname_copilot_chat_short %} generalized questions about the project you're envisioning to get suggestions on a path forward. For example: +Once you've chosen an issue to address, **{% data variables.copilot.copilot_chat_short %}** can help you brainstorm ideas for your project and learn about the various tools, libraries, and resources you might need. You can ask {% data variables.copilot.copilot_chat_short %} generalized questions about the project you're envisioning to get suggestions on a path forward. For example: > I'd like to build an web app that helps users track their daily habits and provides personalized recommendations. Can you suggest features and technologies I could use? @@ -50,17 +50,17 @@ During the creation phase, you'll write and refine the code for your application With **{% data variables.copilot.next_edit_suggestions %}** ({% data variables.release-phases.public_preview %}), {% data variables.product.prodname_copilot_short %} predicts related edits based on the changes you’re actively making. For example, if you rename a variable or update a function’s parameters, it suggests corresponding updates throughout your code. This helps maintain consistency and reduces the chance of errors. -### Using {% data variables.product.prodname_copilot_chat_short %} in ask mode +### Using {% data variables.copilot.copilot_chat_short %} in ask mode -Use {% data variables.product.prodname_copilot_chat_short %} in **ask mode** as your pair programmer to get help with coding tasks, understand tricky concepts, and improve your code. You can ask it questions, get explanations, or request suggestions in real time. +Use {% data variables.copilot.copilot_chat_short %} in **ask mode** as your pair programmer to get help with coding tasks, understand tricky concepts, and improve your code. You can ask it questions, get explanations, or request suggestions in real time. > Can you explain what this JavaScript function does? I'm not sure why it uses a `forEach` loop instead of a `for` loop. > What’s the difference between `let`, `const`, and `var` in JavaScript? When should I use each one? -### Using {% data variables.product.prodname_copilot_chat_short %} in edit mode +### Using {% data variables.copilot.copilot_chat_short %} in edit mode -Use {% data variables.product.prodname_copilot_chat_short %} in **edit mode** when you want more granular control over the edits that {% data variables.product.prodname_copilot_short %} proposes. In edit mode, you choose which files {% data variables.product.prodname_copilot_short %} can make changes to, provide context to {% data variables.product.prodname_copilot_short %} with each iteration, and decide whether or not to accept the suggested edits. +Use {% data variables.copilot.copilot_chat_short %} in **edit mode** when you want more granular control over the edits that {% data variables.product.prodname_copilot_short %} proposes. In edit mode, you choose which files {% data variables.product.prodname_copilot_short %} can make changes to, provide context to {% data variables.product.prodname_copilot_short %} with each iteration, and decide whether or not to accept the suggested edits. > Refactor the `calculateTotal` function to improve readability and efficiency. @@ -68,9 +68,9 @@ Use {% data variables.product.prodname_copilot_chat_short %} in **edit mode** wh > Format this code to follow Python’s PEP 8 style guide. -### Using {% data variables.product.prodname_copilot_chat_short %} in agent mode +### Using {% data variables.copilot.copilot_chat_short %} in agent mode -In **agent mode**, {% data variables.product.prodname_copilot_chat_short %} can assist with automating repetitive tasks and managing your workflow directly within your project. Use it to create pull requests after you make code changes. You can also use it to run tests and linters in the background while you're working on your project. +In **agent mode**, {% data variables.copilot.copilot_chat_short %} can assist with automating repetitive tasks and managing your workflow directly within your project. Use it to create pull requests after you make code changes. You can also use it to run tests and linters in the background while you're working on your project. > Create a pull request for the recent changes in the `user-auth` module and include a summary of the updates. @@ -91,7 +91,7 @@ When you're ready to get feedback from others on the {% data variables.product.g The testing phase validates that your application works as intended. This phase involves writing and running tests to catch bugs, ensure functionality, and maintain code quality before deployment. -**{% data variables.product.prodname_copilot_chat_short %}** can assist by generating unit and integration tests, debugging failures, and suggesting additional test cases to ensure comprehensive coverage. Here are some example prompts: +**{% data variables.copilot.copilot_chat_short %}** can assist by generating unit and integration tests, debugging failures, and suggesting additional test cases to ensure comprehensive coverage. Here are some example prompts: > Write unit tests for this function to calculate the factorial of a number. Include edge cases like 0 and negative numbers. @@ -105,7 +105,7 @@ The testing phase validates that your application works as intended. This phase The deployment phase involves preparing your code for production and ensuring a smooth release. -**{% data variables.product.prodname_copilot_chat_short %}** can help you configure deployment scripts, set up CI/CD pipelines, and troubleshoot issues. Here are some example prompts: +**{% data variables.copilot.copilot_chat_short %}** can help you configure deployment scripts, set up CI/CD pipelines, and troubleshoot issues. Here are some example prompts: > Write a deployment script for a Node.js application using GitHub Actions to deploy to an AWS EC2 instance. @@ -119,7 +119,7 @@ During the operation phase, the focus is on maintaining and monitoring your appl You can use the **{% data variables.copilot.copilot_coding_agent %}** ({% data variables.release-phases.public_preview %}) as an autonomous agent that can help maintain and improve your application in production. Assign a {% data variables.product.github %} issue to {% data variables.product.prodname_copilot_short %}, and it will autonomously explore the repository, identify potential fixes, and create a pull request with the proposed changes. Then it will automatically request a review from you. -For issues you're tackling yourself, use **{% data variables.product.prodname_copilot_chat_short %}** for help analyzing logs, debugging issues, and suggesting optimizations. For example: +For issues you're tackling yourself, use **{% data variables.copilot.copilot_chat_short %}** for help analyzing logs, debugging issues, and suggesting optimizations. For example: > Analyze this error log and suggest possible causes for the issue. diff --git a/content/copilot/using-github-copilot/guides-on-using-github-copilot/modernizing-legacy-code-with-github-copilot.md b/content/copilot/using-github-copilot/guides-on-using-github-copilot/modernizing-legacy-code-with-github-copilot.md index d9f29f149d..c3d6ab2161 100644 --- a/content/copilot/using-github-copilot/guides-on-using-github-copilot/modernizing-legacy-code-with-github-copilot.md +++ b/content/copilot/using-github-copilot/guides-on-using-github-copilot/modernizing-legacy-code-with-github-copilot.md @@ -1,14 +1,14 @@ --- title: Modernizing legacy code with GitHub Copilot shortTitle: Modernize legacy code -intro: '{% data variables.product.prodname_copilot_chat_short %} helps modernize legacy code by suggesting refactors and creating tests to catch potential issues.' +intro: '{% data variables.copilot.copilot_chat_short %} helps modernize legacy code by suggesting refactors and creating tests to catch potential issues.' versions: feature: copilot topics: - Copilot --- -> [!NOTE] The responses shown in this article are examples. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. +> [!NOTE] The responses shown in this article are examples. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get different responses from the ones shown here. Legacy code is code that is old, outdated, or no longer supported by the original developers. It can be difficult to maintain and extend because it may not follow modern best practices, such as using consistent naming conventions or writing clear documentation. @@ -45,7 +45,7 @@ git clone https://github.com/continuous-copilot/modernize-legacy-cobol-app.git ## Step 2: Compile and run the program -You can either install a COBOL compiler in your preferred development environment (for example, the open source GnuCOBOL compiler), or use {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_github_codespaces %}. +You can either install a COBOL compiler in your preferred development environment (for example, the open source GnuCOBOL compiler), or use {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_github_codespaces %}. If you use MacOS, you can install GnuCOBOL using [Homebrew](https://brew.sh/): @@ -74,9 +74,9 @@ To run the program, use the following command: ## Step 3: Explain the files and code -The first step in modernizing the code is to understand how it works. You can ask {% data variables.product.prodname_copilot_chat_short %} to explain the code in each file. +The first step in modernizing the code is to understand how it works. You can ask {% data variables.copilot.copilot_chat_short %} to explain the code in each file. -Open the repository in your IDE then, in the {% data variables.product.prodname_copilot_chat_short %} panel, enter the following prompt. +Open the repository in your IDE then, in the {% data variables.copilot.copilot_chat_short %} panel, enter the following prompt. ### Example prompt 1 @@ -291,7 +291,7 @@ This Node.js code replicates the functionality of the COBOL main.cob file, provi You should review the suggested code thoroughly before using it. Once you're satisfied with the generated code, follow these steps to save it locally and complete the conversion: 1. In the temporary directory you created earlier, create a new file called `main.js`. -1. Copy the generated code from the {% data variables.product.prodname_copilot_chat_short %} panel and paste it into `main.js`. +1. Copy the generated code from the {% data variables.copilot.copilot_chat_short %} panel and paste it into `main.js`. 1. Save the file. 1. Use similar prompts to convert `operations.cob` and `data.cob` to Node.js. 1. Create corresponding JavaScript files, `operations.js` and `data.js`, in the same temporary directory. @@ -382,7 +382,7 @@ Now, the refactored Node.js application is in its own standalone project folder, ## Conclusion -In this example, we looked at an account management system written in COBOL and modernized it into Node.js. We used {% data variables.product.prodname_copilot_chat_short %} to explain the code, chart out the data flow, generate a test plan, and convert the code to Node.js. By following these steps, you can modernize your legacy code and make it easier to maintain and extend. Here are some additional tips for modernizing legacy code: +In this example, we looked at an account management system written in COBOL and modernized it into Node.js. We used {% data variables.copilot.copilot_chat_short %} to explain the code, chart out the data flow, generate a test plan, and convert the code to Node.js. By following these steps, you can modernize your legacy code and make it easier to maintain and extend. Here are some additional tips for modernizing legacy code: * **Prompting best practices are key**: The quality of your prompts determines the quality of {% data variables.product.prodname_copilot_short %}'s suggestions. Provide clear context, break down complex tasks into smaller steps, provide examples, and give {% data variables.product.prodname_copilot_short %} specific goals to work toward. This makes your workflow smoother and your results more precise * **Review the code before using it**: Make sure you understand the code that {% data variables.product.prodname_copilot_short %} provides before using it in your application. This will help you catch any potential issues and ensure that the code meets your requirements. diff --git a/content/copilot/using-github-copilot/guides-on-using-github-copilot/refactoring-code-with-github-copilot.md b/content/copilot/using-github-copilot/guides-on-using-github-copilot/refactoring-code-with-github-copilot.md index d8613691f4..f79a4025f3 100644 --- a/content/copilot/using-github-copilot/guides-on-using-github-copilot/refactoring-code-with-github-copilot.md +++ b/content/copilot/using-github-copilot/guides-on-using-github-copilot/refactoring-code-with-github-copilot.md @@ -16,7 +16,7 @@ Refactoring code is the process of restructuring existing code without changing This article gives you some ideas for using {% data variables.product.prodname_copilot_short %} to refactor code in your IDE. -> [!NOTE] Example responses are included in this article. {% data variables.product.prodname_copilot_chat %} may give you different responses from the ones shown here. +> [!NOTE] Example responses are included in this article. {% data variables.copilot.copilot_chat %} may give you different responses from the ones shown here. ## Understanding code @@ -45,12 +45,12 @@ for file in $(find . -type f -name "*.txt"); do done ``` -### Use the {% data variables.product.prodname_copilot_chat_short %} panel +### Use the {% data variables.copilot.copilot_chat_short %} panel {% data variables.product.prodname_copilot_short %} can tell you whether code, like the example bash script, can be optimized. 1. Select either the `for` loop or the entire contents of the file. -1. Open {% data variables.product.prodname_copilot_chat_short %} by clicking the chat icon in the activity bar or by using the keyboard shortcut: +1. Open {% data variables.copilot.copilot_chat_short %} by clicking the chat icon in the activity bar or by using the keyboard shortcut: * **{% data variables.product.prodname_vscode_shortname %} and {% data variables.product.prodname_vs %}:** Control+Command+i (Mac) / Ctrl+Alt+i (Windows/Linux) * **JetBrains:** Control+Shift+c @@ -63,7 +63,7 @@ done * **In {% data variables.product.prodname_vscode_shortname %} and JetBrains:** Hover over the suggestion in the chat panel and click the **Insert At Cursor** icon. - ![Screenshot of the 'Insert at cursor' icon in the {% data variables.product.prodname_copilot_chat_short %} panel.](/assets/images/help/copilot/insert-at-cursor.png) + ![Screenshot of the 'Insert at cursor' icon in the {% data variables.copilot.copilot_chat_short %} panel.](/assets/images/help/copilot/insert-at-cursor.png) * **In {% data variables.product.prodname_vs %}:** Click **Preview** then, in the comparison view, click **Accept**. diff --git a/content/copilot/using-github-copilot/guides-on-using-github-copilot/upgrading-java-projects-with-github-copilot.md b/content/copilot/using-github-copilot/guides-on-using-github-copilot/upgrading-java-projects-with-github-copilot.md index 5ea9d050f1..57c084e8f3 100644 --- a/content/copilot/using-github-copilot/guides-on-using-github-copilot/upgrading-java-projects-with-github-copilot.md +++ b/content/copilot/using-github-copilot/guides-on-using-github-copilot/upgrading-java-projects-with-github-copilot.md @@ -29,7 +29,7 @@ This solution supports both Maven and Gradle build tools and facilitates upgrade Before getting started you must have the following: -* Either a **{% data variables.product.prodname_copilot_for_business %}** or **{% data variables.product.prodname_copilot_enterprise %}** [subscription plan](/copilot/about-github-copilot/subscription-plans-for-github-copilot). +* Either a **{% data variables.copilot.copilot_for_business %}** or **{% data variables.copilot.copilot_enterprise %}** [subscription plan](/copilot/about-github-copilot/subscription-plans-for-github-copilot). * The latest version of [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/). * The "GitHub Copilot app modernization – upgrade for Java (preview)" extension installed in {% data variables.product.prodname_vscode %}. * Installed versions of both the source and target JDKs. @@ -49,11 +49,11 @@ To get started, you'll need to install the “GitHub Copilot app modernization 1. Search for “GitHub Copilot app modernization – upgrade for Java (preview)” and click “Download”. 1. Restart {% data variables.product.prodname_vscode %}. -### 2. Use {% data variables.product.prodname_copilot_chat %} in agent mode and generate the upgrade plan +### 2. Use {% data variables.copilot.copilot_chat %} in agent mode and generate the upgrade plan Now you have the extension, you can continue to use {% data variables.product.prodname_copilot %} in agent mode and create a plan for your upgrade. -1. In {% data variables.product.prodname_vscode %}, open the {% data variables.product.prodname_copilot_chat %} panel. +1. In {% data variables.product.prodname_vscode %}, open the {% data variables.copilot.copilot_chat %} panel. 1. At the bottom of the chat panel, select **Agent** from the mode dropdown. 1. Enter a prompt describing the upgrade path you need. For example: diff --git a/content/copilot/using-github-copilot/guides-on-using-github-copilot/using-copilot-to-migrate-a-project.md b/content/copilot/using-github-copilot/guides-on-using-github-copilot/using-copilot-to-migrate-a-project.md index 95b5fe6dfa..63e5576c7f 100644 --- a/content/copilot/using-github-copilot/guides-on-using-github-copilot/using-copilot-to-migrate-a-project.md +++ b/content/copilot/using-github-copilot/guides-on-using-github-copilot/using-copilot-to-migrate-a-project.md @@ -1,7 +1,7 @@ --- title: Using Copilot to migrate a project to another programming language allowTitleToDifferFromFilename: true -intro: '{% data variables.product.prodname_copilot_chat %} can help you move a project to a different language. This guide describes what''s involved in a migration process and gives an example of a PHP to Python migration.' +intro: '{% data variables.copilot.copilot_chat %} can help you move a project to a different language. This guide describes what''s involved in a migration process and gives an example of a PHP to Python migration.' topics: - Copilot versions: @@ -49,7 +49,7 @@ Consider the points before you start a migration process: Assuming you've already familiarized yourself with the existing project, a good way to start a migration is to open a branch of the repository in your editor and ask {% data variables.product.prodname_copilot_short %} for help. -1. In your editor, open the {% data variables.product.prodname_copilot_chat_short %} panel. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). +1. In your editor, open the {% data variables.copilot.copilot_chat_short %} panel. See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). 1. Ask {% data variables.product.prodname_copilot_short %} to outline the steps you need to take to migrate the project to the new language. For example, for a migration from PHP to Python, you could ask: @@ -68,7 +68,7 @@ Assuming you've already familiarized yourself with the existing project, a good If you think a change suggested by {% data variables.product.prodname_copilot_short %} is not right in some way, ask for an alternative suggestion. -1. As soon as you've migrated a component to a state that you can run, check that it works as expected. If it generates an error, copy the error into the {% data variables.product.prodname_copilot_chat_short %} view, and ask {% data variables.product.prodname_copilot_short %} to help you fix it. +1. As soon as you've migrated a component to a state that you can run, check that it works as expected. If it generates an error, copy the error into the {% data variables.copilot.copilot_chat_short %} view, and ask {% data variables.product.prodname_copilot_short %} to help you fix it. 1. After you've completed the initial conversion, use {% data variables.product.prodname_copilot_short %} to help you refactor the code in the new language. For more information, see [AUTOTITLE](/copilot/using-github-copilot/guides-on-using-github-copilot/refactoring-code-with-github-copilot). ## Example: migrating a PHP project to Python @@ -107,11 +107,11 @@ template └── template.php ``` -This example gives the prompts you can enter into {% data variables.product.prodname_copilot_chat_short %} to complete the migration, and the responses {% data variables.product.prodname_copilot_short %} returned for one instance of this migration. The {% data variables.copilot.copilot_gpt_4o %} model was used to generate these responses. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you will probably get slightly different responses to the ones shown here. +This example gives the prompts you can enter into {% data variables.copilot.copilot_chat_short %} to complete the migration, and the responses {% data variables.product.prodname_copilot_short %} returned for one instance of this migration. The {% data variables.copilot.copilot_gpt_4o %} model was used to generate these responses. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you will probably get slightly different responses to the ones shown here. During a migration process you are likely to get errors that you need to fix before moving ahead. {% data variables.product.prodname_copilot_short %} can help you with this. The example includes some errors and shows how you can get {% data variables.product.prodname_copilot_short %} to help you fix them. -Because the responses you'll get from {% data variables.product.prodname_copilot_chat_short %} are likely to be different to those shown here, you may encounter different errors. You may, therefore, find it easier to step through this example migration using the responses shown here, rather than those you get from {% data variables.product.prodname_copilot_short %} yourself. +Because the responses you'll get from {% data variables.copilot.copilot_chat_short %} are likely to be different to those shown here, you may encounter different errors. You may, therefore, find it easier to step through this example migration using the responses shown here, rather than those you get from {% data variables.product.prodname_copilot_short %} yourself. After completing this example migration you can then use the same methodology on your own project. @@ -129,7 +129,7 @@ After completing this example migration you can then use the same methodology on 1. Create a working branch in your repository and open it as a new workspace in {% data variables.product.prodname_vscode %}. 1. Familiarize yourself with the contents and architecture of the existing project. {% data variables.product.prodname_copilot_short %} can help you with this: - 1. Open the {% data variables.product.prodname_copilot_chat_short %} view. + 1. Open the {% data variables.copilot.copilot_chat_short %} view. 1. Enter a prompt such as: `@workspace Describe this project in detail, explaining what the various components do and how they interact.` @@ -189,7 +189,7 @@ After completing this example migration you can then use the same methodology on We'll take {% data variables.product.prodname_copilot_short %}'s advice and use Flask. -1. Returning to {% data variables.product.prodname_copilot_short %}'s high-level overview, the first step is to set up a Python environment and install the necessary packages. To find out how to do this, in {% data variables.product.prodname_copilot_chat_short %}, enter: +1. Returning to {% data variables.product.prodname_copilot_short %}'s high-level overview, the first step is to set up a Python environment and install the necessary packages. To find out how to do this, in {% data variables.copilot.copilot_chat_short %}, enter: `@workspace I want to use Flask. Tell me how to set up a virtual environment and install the necessary packages.` @@ -449,7 +449,7 @@ After completing this example migration you can then use the same methodology on When you do this you will see error messages in the browser. -1. Copy the initial `TemplateNotFound` error message to the {% data variables.product.prodname_copilot_chat_short %} view and ask how you can fix this. For example: +1. Copy the initial `TemplateNotFound` error message to the {% data variables.copilot.copilot_chat_short %} view and ask how you can fix this. For example: ``@workspace When I run `python3 app.py`, I get the following error in the browser: `jinja2.exceptions.TemplateNotFound: template.html`. How can I fix this?`` @@ -463,7 +463,7 @@ After completing this example migration you can then use the same methodology on 1. Assuming the Flask development server is still running, if you refresh the browser page at [http://127.0.0.1:5000/](http://127.0.0.1:5000/), you will now see a new error relating to the `get_config` function. - Copy this error message to the {% data variables.product.prodname_copilot_chat_short %} view and ask for help. + Copy this error message to the {% data variables.copilot.copilot_chat_short %} view and ask for help. ``@workspace When I run `python3 app.py`, I get the following error in the browser: `jinja2.exceptions.UndefinedError: 'get_config' is undefined.` How can I fix this?`` diff --git a/content/copilot/using-github-copilot/guides-on-using-github-copilot/writing-tests-with-github-copilot.md b/content/copilot/using-github-copilot/guides-on-using-github-copilot/writing-tests-with-github-copilot.md index 511210d135..24d6820fd8 100644 --- a/content/copilot/using-github-copilot/guides-on-using-github-copilot/writing-tests-with-github-copilot.md +++ b/content/copilot/using-github-copilot/guides-on-using-github-copilot/writing-tests-with-github-copilot.md @@ -21,9 +21,9 @@ Before getting started you must have the following: * {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode %}, or any JetBrains IDE. * The [{% data variables.product.prodname_copilot %} extension](/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment) installed in your IDE. -## Writing unit tests with {% data variables.product.prodname_copilot_chat_short %} +## Writing unit tests with {% data variables.copilot.copilot_chat_short %} -In this section, we’ll explore how to use {% data variables.product.prodname_copilot_chat %} to generate unit tests for a Python class. This example demonstrates how you can use {% data variables.product.prodname_copilot_short %} to create unit tests for a class like `BankAccount`. We will show you how to prompt {% data variables.product.prodname_copilot_short %} to generate tests, execute them, and verify the results. +In this section, we’ll explore how to use {% data variables.copilot.copilot_chat %} to generate unit tests for a Python class. This example demonstrates how you can use {% data variables.product.prodname_copilot_short %} to create unit tests for a class like `BankAccount`. We will show you how to prompt {% data variables.product.prodname_copilot_short %} to generate tests, execute them, and verify the results. ### Example class: `BankAccount` @@ -52,7 +52,7 @@ class BankAccount: return self.balance ``` -### Generating unit tests with {% data variables.product.prodname_copilot_chat_short %} +### Generating unit tests with {% data variables.copilot.copilot_chat_short %} You can prompt Copilot with a request to write tests that cover a range of scenarios. Be specific with your test requirements to get the best results. The following is an example prompt you can use to generate unit tests for the `BankAccount` class. @@ -315,9 +315,9 @@ Once Copilot has generated the test suite to your satisfaction, run the tests wi python -m unittest test_bank_account_integration.py ``` -## Using {% data variables.product.prodname_copilot_spaces %} to improve test suggestions +## Using {% data variables.copilot.copilot_spaces %} to improve test suggestions -{% data variables.product.prodname_copilot_spaces %} is a feature that allows you to organize and share task-specific context with {% data variables.product.prodname_copilot_short %}. This can help improve the relevance of the suggestions you receive. By providing {% data variables.product.prodname_copilot_short %} with more context about your project, you can get better test suggestions. +{% data variables.copilot.copilot_spaces %} is a feature that allows you to organize and share task-specific context with {% data variables.product.prodname_copilot_short %}. This can help improve the relevance of the suggestions you receive. By providing {% data variables.product.prodname_copilot_short %} with more context about your project, you can get better test suggestions. For example, you could create a space that includes: @@ -333,4 +333,4 @@ Or: > Write a unit test for the refund logic in `refund.js`, following the structure in the existing test suite. -For more information about using {% data variables.product.prodname_copilot_spaces %}, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). +For more information about using {% data variables.copilot.copilot_spaces %}, see [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). diff --git a/content/copilot/using-github-copilot/using-copilot-text-completion.md b/content/copilot/using-github-copilot/using-copilot-text-completion.md index 6d9a4b6778..9250b5be2a 100644 --- a/content/copilot/using-github-copilot/using-copilot-text-completion.md +++ b/content/copilot/using-github-copilot/using-copilot-text-completion.md @@ -1,26 +1,26 @@ --- title: Using Copilot text completion shortTitle: Text completion -intro: 'You can use {% data variables.product.prodname_copilot_autocomplete_pr %} to help you write pull request descriptions more quickly and accurately.' +intro: 'You can use {% data variables.copilot.copilot_autocomplete_pr %} to help you write pull request descriptions more quickly and accurately.' versions: feature: copilot-enterprise -permissions: 'Members of an enterprise with a subscription to [{% data variables.product.prodname_copilot_enterprise %}](/copilot/github-copilot-enterprise/overview/about-github-copilot-enterprise)' +permissions: 'Members of an enterprise with a subscription to [{% data variables.copilot.copilot_enterprise %}](/copilot/github-copilot-enterprise/overview/about-github-copilot-enterprise)' topics: - Copilot --- >[!NOTE] -> {% data variables.product.prodname_copilot_autocomplete_pr %} is currently in {% data variables.release-phases.public_preview %} and subject to change. To participate in the {% data variables.release-phases.public_preview %}, an administrator of your enterprise must opt in to the use of previews of {% data variables.product.prodname_copilot_short %} features. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom). +> {% data variables.copilot.copilot_autocomplete_pr %} is currently in {% data variables.release-phases.public_preview %} and subject to change. To participate in the {% data variables.release-phases.public_preview %}, an administrator of your enterprise must opt in to the use of previews of {% data variables.product.prodname_copilot_short %} features. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom). -## About {% data variables.product.prodname_copilot_autocomplete_pr %} +## About {% data variables.copilot.copilot_autocomplete_pr %} -With {% data variables.product.prodname_copilot_autocomplete_pr %}, you can use AI-generated autocompletions to help you write pull request descriptions quickly and accurately. Accurate descriptions help reviewers understand the changes you're proposing, and help you communicate the purpose of your pull request more effectively. +With {% data variables.copilot.copilot_autocomplete_pr %}, you can use AI-generated autocompletions to help you write pull request descriptions quickly and accurately. Accurate descriptions help reviewers understand the changes you're proposing, and help you communicate the purpose of your pull request more effectively. -When you are creating a new pull request, {% data variables.product.prodname_copilot_autocomplete_pr %} will scan through the pull request and provide suggestions as you write, based on the context of the pull request. +When you are creating a new pull request, {% data variables.copilot.copilot_autocomplete_pr %} will scan through the pull request and provide suggestions as you write, based on the context of the pull request. -## Using {% data variables.product.prodname_copilot_autocomplete_pr %} +## Using {% data variables.copilot.copilot_autocomplete_pr %} -You can use {% data variables.product.prodname_copilot_autocomplete_pr %} in the description of a new pull request you're creating. +You can use {% data variables.copilot.copilot_autocomplete_pr %} in the description of a new pull request you're creating. 1. On {% data variables.product.github %}, create a pull request. 1. In the description field, start typing your description. @@ -30,9 +30,9 @@ You can use {% data variables.product.prodname_copilot_autocomplete_pr %} in the * To ignore a suggestion, press `Esc` or continue typing. {% data variables.product.prodname_copilot_short %} will provide new suggestions as you type, based on the additional context. 1. When you're happy with the description, click **Create pull request**. -## Disabling or enabling {% data variables.product.prodname_copilot_autocomplete_pr %} +## Disabling or enabling {% data variables.copilot.copilot_autocomplete_pr %} -You can disable or enable {% data variables.product.prodname_copilot_autocomplete_pr %} for your pull request descriptions. Your preference will be saved for future pull requests. +You can disable or enable {% data variables.copilot.copilot_autocomplete_pr %} for your pull request descriptions. Your preference will be saved for future pull requests. 1. On {% data variables.product.github %}, create a pull request. 1. At the top of the description field, select {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} then hover over **Autocomplete ({% data variables.release-phases.public_preview_caps %})**, and click **Disabled** or **Enabled**. diff --git a/content/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat.md b/content/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat.md index 8f587d9ada..54e649f386 100644 --- a/content/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat.md +++ b/content/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat.md @@ -1,6 +1,6 @@ --- title: Using extensions to integrate external tools with Copilot Chat -intro: 'You can use {% data variables.product.prodname_copilot_extensions_short %} to interact with external tools in {% data variables.product.prodname_copilot_chat %}.' +intro: 'You can use {% data variables.copilot.copilot_extensions_short %} to interact with external tools in {% data variables.copilot.copilot_chat %}.' product: '{% data reusables.gated-features.copilot-extensions %}' versions: feature: copilot-extensions @@ -14,25 +14,25 @@ redirect_from: - /copilot/github-copilot-chat/github-copilot-extensions --- -## About {% data variables.product.prodname_copilot_extensions %} +## About {% data variables.copilot.copilot_extensions %} {% data reusables.copilot.copilot-extensions.copilot-extensions-intro %} -> [!NOTE] {% data variables.product.prodname_copilot_extensions %} are not the same as _the {% data variables.product.prodname_copilot %} extension_, which you install in your IDE to use default {% data variables.product.prodname_copilot_short %} functionality like code completion and {% data variables.product.prodname_copilot_chat %}. For more information on _the {% data variables.product.prodname_copilot %} extension_, see [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment). +> [!NOTE] {% data variables.copilot.copilot_extensions %} are not the same as _the {% data variables.product.prodname_copilot %} extension_, which you install in your IDE to use default {% data variables.product.prodname_copilot_short %} functionality like code completion and {% data variables.copilot.copilot_chat %}. For more information on _the {% data variables.product.prodname_copilot %} extension_, see [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment). -You can get started with {% data variables.product.prodname_copilot_extensions_short %} in one of two ways: -* Build your own {% data variables.product.prodname_copilot_extension_short %}. See [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). -* Install a {% data variables.product.prodname_copilot_extension_short %} from {% data variables.product.prodname_marketplace %}. +You can get started with {% data variables.copilot.copilot_extensions_short %} in one of two ways: +* Build your own {% data variables.copilot.copilot_extension_short %}. See [AUTOTITLE](/copilot/building-copilot-extensions/about-building-copilot-extensions). +* Install a {% data variables.copilot.copilot_extension_short %} from {% data variables.product.prodname_marketplace %}. -You can interact with your custom-built or installed extension in a {% data variables.product.prodname_copilot_chat_short %} conversation, asking questions and performing actions that combine the capabilities of the external tool and {% data variables.product.prodname_dotcom %}. For example, if you install the Sentry extension for {% data variables.product.prodname_copilot %}, you can use the extension to get information about Sentry issues, then create and assign related tracking issues on {% data variables.product.prodname_dotcom %}. +You can interact with your custom-built or installed extension in a {% data variables.copilot.copilot_chat_short %} conversation, asking questions and performing actions that combine the capabilities of the external tool and {% data variables.product.prodname_dotcom %}. For example, if you install the Sentry extension for {% data variables.product.prodname_copilot %}, you can use the extension to get information about Sentry issues, then create and assign related tracking issues on {% data variables.product.prodname_dotcom %}. -{% data variables.product.prodname_copilot_extensions_short %} provide several benefits, including: +{% data variables.copilot.copilot_extensions_short %} provide several benefits, including: * Interaction with external tools using natural language * Reduced context switching -* Customization of your {% data variables.product.prodname_copilot_chat_short %} experience for your developer flow +* Customization of your {% data variables.copilot.copilot_chat_short %} experience for your developer flow -{% data variables.product.prodname_copilot_extensions_short %} are included in all {% data variables.product.prodname_copilot_short %} subscriptions. +{% data variables.copilot.copilot_extensions_short %} are included in all {% data variables.product.prodname_copilot_short %} subscriptions. ### Supported clients and IDEs @@ -40,47 +40,47 @@ You can interact with your custom-built or installed extension in a {% data vari ## Prerequisites -**If you have a {% data variables.product.prodname_copilot_pro_short %} subscription**, you need to install a {% data variables.product.prodname_copilot_extension_short %} before you can use the extension in {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account). +**If you have a {% data variables.copilot.copilot_pro_short %} subscription**, you need to install a {% data variables.copilot.copilot_extension_short %} before you can use the extension in {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account). -**If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription:** - 1. An organization owner or enterprise owner needs to enable the {% data variables.product.prodname_copilot_extensions_short %} policy for your organization or enterprise. 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#setting-a-policy-for-github-copilot-extensions-in-your-organization) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#configuring-policies-for-github-copilot) in the {% data variables.product.prodname_ghe_cloud %} documentation. - 1. An organization owner needs to install {% data variables.product.prodname_copilot_extensions_short %} for your organization. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization). +**If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription:** + 1. An organization owner or enterprise owner needs to enable the {% data variables.copilot.copilot_extensions_short %} policy for your organization or enterprise. 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#setting-a-policy-for-github-copilot-extensions-in-your-organization) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#configuring-policies-for-github-copilot) in the {% data variables.product.prodname_ghe_cloud %} documentation. + 1. An organization owner needs to install {% data variables.copilot.copilot_extensions_short %} for your organization. See [AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization). -## Using {% data variables.product.prodname_copilot_extensions %} +## Using {% data variables.copilot.copilot_extensions %} -1. To start using a {% data variables.product.prodname_copilot_extension_short %}, open a supported {% data variables.product.prodname_copilot_chat_short %} interface. See [Supported clients and IDEs](#supported-clients-and-ides). -1. To see a list of all {% data variables.product.prodname_copilot_extensions_short %} available in your {% data variables.product.prodname_copilot_chat_short %} conversation, in the {% data variables.product.prodname_copilot_chat_short %} text box, type `@`. +1. To start using a {% data variables.copilot.copilot_extension_short %}, open a supported {% data variables.copilot.copilot_chat_short %} interface. See [Supported clients and IDEs](#supported-clients-and-ides). +1. To see a list of all {% data variables.copilot.copilot_extensions_short %} available in your {% data variables.copilot.copilot_chat_short %} conversation, in the {% data variables.copilot.copilot_chat_short %} text box, type `@`. - > [!NOTE] If you are using {% data variables.product.prodname_copilot_chat_short %} in an IDE, and you or your organization owner install a {% data variables.product.prodname_copilot_extension_short %} while your IDE is open, you need to restart your IDE to begin using the {% data variables.product.prodname_copilot_extension_short %}. + > [!NOTE] If you are using {% data variables.copilot.copilot_chat_short %} in an IDE, and you or your organization owner install a {% data variables.copilot.copilot_extension_short %} while your IDE is open, you need to restart your IDE to begin using the {% data variables.copilot.copilot_extension_short %}. -1. In the list of available {% data variables.product.prodname_copilot_extensions_short %}, click the one you want to use. -1. To begin interacting with the {% data variables.product.prodname_copilot_extension_short %}, in the {% data variables.product.prodname_copilot_chat_short %} text box, ask the extension to answer a question or perform an action, then press Enter. For each new request, be sure to include `@EXTENSION-NAME` at the beginning of your sentence. - * If you did not install the {% data variables.product.prodname_copilot_extension_short %} yourself, and it is your first time using the {% data variables.product.prodname_copilot_extension_short %}, you will be asked to authorize the extension. See [AUTOTITLE](/apps/using-github-apps/authorizing-github-apps). - * If you ask a {% data variables.product.prodname_copilot_extension_short %} to perform an action, you need to confirm the extension has your permission to act on your behalf before it will complete the task. After carefully reviewing the proposed action, in the confirmation dialog, click **Allow** or **Dismiss**. +1. In the list of available {% data variables.copilot.copilot_extensions_short %}, click the one you want to use. +1. To begin interacting with the {% data variables.copilot.copilot_extension_short %}, in the {% data variables.copilot.copilot_chat_short %} text box, ask the extension to answer a question or perform an action, then press Enter. For each new request, be sure to include `@EXTENSION-NAME` at the beginning of your sentence. + * If you did not install the {% data variables.copilot.copilot_extension_short %} yourself, and it is your first time using the {% data variables.copilot.copilot_extension_short %}, you will be asked to authorize the extension. See [AUTOTITLE](/apps/using-github-apps/authorizing-github-apps). + * If you ask a {% data variables.copilot.copilot_extension_short %} to perform an action, you need to confirm the extension has your permission to act on your behalf before it will complete the task. After carefully reviewing the proposed action, in the confirmation dialog, click **Allow** or **Dismiss**. -## Tips for using {% data variables.product.prodname_copilot_extensions %} +## Tips for using {% data variables.copilot.copilot_extensions %} -* When you are using a {% data variables.product.prodname_copilot_extension_short %}, consider how you would interact with the tool outside of {% data variables.product.prodname_copilot_chat_short %}, then use natural language to ask questions and assign tasks that integrate the capabilities of the tool with {% data variables.product.prodname_dotcom %}. For example, [Sentry](https://sentry.io/welcome/) is an application monitoring software with a {% data variables.product.prodname_copilot_extension_short %}. The following are some example prompts for the Sentry extension for {% data variables.product.prodname_copilot %}: +* When you are using a {% data variables.copilot.copilot_extension_short %}, consider how you would interact with the tool outside of {% data variables.copilot.copilot_chat_short %}, then use natural language to ask questions and assign tasks that integrate the capabilities of the tool with {% data variables.product.prodname_dotcom %}. For example, [Sentry](https://sentry.io/welcome/) is an application monitoring software with a {% data variables.copilot.copilot_extension_short %}. The following are some example prompts for the Sentry extension for {% data variables.product.prodname_copilot %}: * `@sentry list my most recent issues` * `@sentry tell me more about issue ISSUE-ID-OR-ISSUE-LINK` * `@sentry create a {% data variables.product.prodname_dotcom %} issue for the most recent Sentry issue and assign it to @DEVELOPER` - For information on the best ways to use a specific {% data variables.product.prodname_copilot_extension_short %}, read the description of the extension on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true). -* Interactions with one {% data variables.product.prodname_copilot_extension_short %} will never be shared with another {% data variables.product.prodname_copilot_extension_short %}. To interact with different {% data variables.product.prodname_copilot_extensions_short %} in an IDE, change the `@EXTENSION-NAME` at the beginning of each sentence. Interactions with different extensions will appear in the same {% data variables.product.prodname_copilot_chat_short %} window, but the conversations themselves are automatically separated. + For information on the best ways to use a specific {% data variables.copilot.copilot_extension_short %}, read the description of the extension on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true). +* Interactions with one {% data variables.copilot.copilot_extension_short %} will never be shared with another {% data variables.copilot.copilot_extension_short %}. To interact with different {% data variables.copilot.copilot_extensions_short %} in an IDE, change the `@EXTENSION-NAME` at the beginning of each sentence. Interactions with different extensions will appear in the same {% data variables.copilot.copilot_chat_short %} window, but the conversations themselves are automatically separated. - {% ifversion ghec %} To interact with different {% data variables.product.prodname_copilot_extensions_short %} on {% data variables.product.prodname_dotcom_the_website %}, you need to start a new conversation for each extension by clicking {% octicon "plus" aria-label="New conversation" %} at the top of the {% data variables.product.prodname_copilot_chat_short %} window.{% endif %} + {% ifversion ghec %} To interact with different {% data variables.copilot.copilot_extensions_short %} on {% data variables.product.prodname_dotcom_the_website %}, you need to start a new conversation for each extension by clicking {% octicon "plus" aria-label="New conversation" %} at the top of the {% data variables.copilot.copilot_chat_short %} window.{% endif %} ## Additional resources -For questions and issues related to {% data variables.product.prodname_copilot_extensions %}, please use the following resources: +For questions and issues related to {% data variables.copilot.copilot_extensions %}, please use the following resources: * **General issues for users and builders:** Visit the [{% data variables.product.github %} Support Portal](https://support.github.com/). * **Requests or feedback for {% data variables.product.github %}:** Use the [{% data variables.product.github %} Community Discussion Thread](https://gh.io/community-feedback). * **Requests or feedback for third-party extension publishers:** File an issue in the [User Feedback Repo](https://github.com/copilot-extensions/user-feedback) and add a label with the extension's slug name. * **{% data variables.product.github %} Technology Partners:** Email the partnerships team directly for assistance. -* **{% data variables.product.prodname_copilot_extensions_vsc %}:** For more information on this type of {% data variables.product.prodname_copilot_extension_short %}, see [Chat extensions](https://code.visualstudio.com/api/extension-guides/chat) in the {% data variables.product.prodname_vscode %} documentation. +* **{% data variables.copilot.copilot_extensions_vsc %}:** For more information on this type of {% data variables.copilot.copilot_extension_short %}, see [Chat extensions](https://code.visualstudio.com/api/extension-guides/chat) in the {% data variables.product.prodname_vscode %} documentation. -> [!NOTE] {% data variables.contact.github_support %} is not able to answer questions regarding {% data variables.product.prodname_copilot_extensions_vsc %}, as this implementation path is owned and maintained by the {% data variables.product.prodname_vscode_shortname %} team. +> [!NOTE] {% data variables.contact.github_support %} is not able to answer questions regarding {% data variables.copilot.copilot_extensions_vsc %}, as this implementation path is owned and maintained by the {% data variables.product.prodname_vscode_shortname %} team. ## Further reading diff --git a/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/creating-a-pull-request-summary-with-github-copilot.md b/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/creating-a-pull-request-summary-with-github-copilot.md index 25a60d18d4..8645189a95 100644 --- a/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/creating-a-pull-request-summary-with-github-copilot.md +++ b/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/creating-a-pull-request-summary-with-github-copilot.md @@ -13,7 +13,7 @@ redirect_from: - /copilot/github-copilot-enterprise/copilot-pull-request-summaries --- -## About {% data variables.product.prodname_copilot_for_prs %} +## About {% data variables.copilot.copilot_for_prs %} You can use {% data variables.product.prodname_copilot %} to generate a summary of a pull request on {% data variables.product.github %}. You can use the summary to help reviewers understand your changes, or to quickly understand the changes in a pull request you're reviewing. @@ -23,7 +23,7 @@ You can use {% data variables.product.prodname_copilot %} to generate a summary * In the description of an existing pull request, by editing the opening comment * In a comment on the main timeline of a pull request -To learn more about {% data variables.product.prodname_copilot_for_prs %} and how to use the feature most effectively, see [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-pull-request-summaries/about-copilot-pull-request-summaries). +To learn more about {% data variables.copilot.copilot_for_prs %} and how to use the feature most effectively, see [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-pull-request-summaries/about-copilot-pull-request-summaries). ## Creating a summary for a pull request diff --git a/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request.md b/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request.md index f1303ba57a..7b1fc067f3 100644 --- a/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request.md +++ b/content/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request.md @@ -1,7 +1,7 @@ --- title: Using Copilot to help you work on a pull request shortTitle: Work on a PR -intro: 'You can iterate, validate, and integrate suggested changes to code by using {% data variables.product.prodname_copilot_workspace %}.' +intro: 'You can iterate, validate, and integrate suggested changes to code by using {% data variables.copilot.copilot_workspace %}.' product: '{% data reusables.gated-features.copilot-free-availability %}' versions: feature: copilot-hadron @@ -9,58 +9,58 @@ topics: - Copilot --- -> [!NOTE] {% data variables.product.prodname_copilot_workspace %} is in limited {% data variables.release-phases.public_preview %}. The waitlist for admission to this preview is currently closed. +> [!NOTE] {% data variables.copilot.copilot_workspace %} is in limited {% data variables.release-phases.public_preview %}. The waitlist for admission to this preview is currently closed. ## About using {% data variables.product.prodname_copilot_short %} to help you work on your pull requests -After you create a pull request, you can continue working on the PR on the {% data variables.product.github %} website. This article is about {% data variables.product.prodname_copilot_workspace %}, which provides a {% data variables.product.prodname_copilot_short %}-enabled environment for: +After you create a pull request, you can continue working on the PR on the {% data variables.product.github %} website. This article is about {% data variables.copilot.copilot_workspace %}, which provides a {% data variables.product.prodname_copilot_short %}-enabled environment for: * **Refining** your pull requests * **Validating** changes * **Integrating** suggestions from reviewers -{% data variables.product.prodname_copilot_workspace %} enables you to work on your pull requests in one place - on {% data variables.product.github %} - from pull request creation to merge. +{% data variables.copilot.copilot_workspace %} enables you to work on your pull requests in one place - on {% data variables.product.github %} - from pull request creation to merge. {% data variables.product.prodname_copilot_short %} can help with pull requests in other ways too. These are explained in separate articles. {% data variables.product.prodname_copilot_short %} can: * Write a pull request summary for you - see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/creating-a-pull-request-summary-with-github-copilot). * Review a pull request for you - see [AUTOTITLE](/copilot/using-github-copilot/code-review/using-copilot-code-review). * Suggest fixes for coding problems identified by {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} - see [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/responsible-use-autofix-code-scanning). -### Benefits of {% data variables.product.prodname_copilot_workspace %} +### Benefits of {% data variables.copilot.copilot_workspace %} -{% data variables.product.prodname_copilot_workspace %}: +{% data variables.copilot.copilot_workspace %}: * Allows you to work on a pull request without having to switch back and forward between the {% data variables.product.github %} website and your IDE. -* Gives you easy access to view/test/modify/apply coding suggestions, from {% data variables.product.prodname_copilot_short %} code reviews and {% data variables.product.prodname_copilot_autofix_short %}, as well as reviews by human reviewers. +* Gives you easy access to view/test/modify/apply coding suggestions, from {% data variables.product.prodname_copilot_short %} code reviews and {% data variables.copilot.copilot_autofix_short %}, as well as reviews by human reviewers. * Gives you {% data variables.product.prodname_copilot_short %} code completion suggestions on {% data variables.product.github %}. Previously these were only available in an IDE. * Shows you a list of files changed by the pull request, within the browser-based editor, but also allows you to find and edit any file from across the repo. -* Enables you to build, test, and run your code directly from the {% data variables.product.prodname_copilot_workspace_short %} environment on {% data variables.product.github %}. +* Enables you to build, test, and run your code directly from the {% data variables.copilot.copilot_workspace_short %} environment on {% data variables.product.github %}. ## Prerequisites -Using {% data variables.product.prodname_copilot_workspace %} requires an existing pull request on the {% data variables.product.github %} website and either of the following: +Using {% data variables.copilot.copilot_workspace %} requires an existing pull request on the {% data variables.product.github %} website and either of the following: * Access to this {% data variables.release-phases.public_preview %} from the waitlist (now closed). * Access to {% data variables.product.prodname_GHAS %} (GHAS) features on a private repository owned by an organization on a {% data variables.product.prodname_team %} or {% data variables.product.prodname_enterprise %} plan. See [AUTOTITLE](/get-started/learning-about-github/about-github-advanced-security). -Without access to {% data variables.product.prodname_copilot_workspace %} you can still edit the files in pull requests by going to the **Files changed** tab, clicking the ellipsis (**...**) next to the file you want to edit, and then clicking **Edit file**. +Without access to {% data variables.copilot.copilot_workspace %} you can still edit the files in pull requests by going to the **Files changed** tab, clicking the ellipsis (**...**) next to the file you want to edit, and then clicking **Edit file**. ## Editing files in a pull request -To work on a pull request in {% data variables.product.prodname_copilot_workspace %}: +To work on a pull request in {% data variables.copilot.copilot_workspace %}: -1. Click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} Open in {% data variables.product.prodname_copilot_workspace_short %}** button on the right side of the main page of a pull request. +1. Click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} Open in {% data variables.copilot.copilot_workspace_short %}** button on the right side of the main page of a pull request. - {% data variables.product.prodname_copilot_workspace %} opens, displaying an overview of the pull request. + {% data variables.copilot.copilot_workspace %} opens, displaying an overview of the pull request. - At the left of the {% data variables.product.prodname_copilot_workspace %} window is a list of the files changed by the pull request. + At the left of the {% data variables.copilot.copilot_workspace %} window is a list of the files changed by the pull request. - ![Screenshot of the list of files in a PR, at the left of {% data variables.product.prodname_copilot_workspace %}.](/assets/images/help/copilot/workspace-files-in-pr.png) + ![Screenshot of the list of files in a PR, at the left of {% data variables.copilot.copilot_workspace %}.](/assets/images/help/copilot/workspace-files-in-pr.png) 1. To work on a file that is not currently changed by this pull request, click **Files in this pull request** and, from the dropdown, select **All files in this repository**. -1. Click a file in the list to open the file in the {% data variables.product.prodname_copilot_workspace_short %} editor. +1. Click a file in the list to open the file in the {% data variables.copilot.copilot_workspace_short %} editor. - The file is displayed in a diff view. You can change the view if required. See [Changing the {% data variables.product.prodname_copilot_workspace_short %} options](#changing-the-workspace-options) later in this article. + The file is displayed in a diff view. You can change the view if required. See [Changing the {% data variables.copilot.copilot_workspace_short %} options](#changing-the-workspace-options) later in this article. You can open and change multiple files before committing your changes. @@ -78,17 +78,17 @@ To work on a pull request in {% data variables.product.prodname_copilot_workspac 1. Click **Commit changes**. - Alternatively, click **Reset all changes** to return the files to their current state in the pull request, losing the changes you made in the {% data variables.product.prodname_copilot_workspace_short %} editor panel. Resetting your changes cannot be undone. + Alternatively, click **Reset all changes** to return the files to their current state in the pull request, losing the changes you made in the {% data variables.copilot.copilot_workspace_short %} editor panel. Resetting your changes cannot be undone. ## Using {% data variables.product.prodname_copilot_short %} to work on pull request comments -You can use {% data variables.product.prodname_copilot_workspace %} to work through all comments on your pull request, one after the other, and then commit any changes you choose to make in a single commit. +You can use {% data variables.copilot.copilot_workspace %} to work through all comments on your pull request, one after the other, and then commit any changes you choose to make in a single commit. -1. On a comment that includes a code change suggestion, click **Open in {% data variables.product.prodname_copilot_workspace_short %}**. +1. On a comment that includes a code change suggestion, click **Open in {% data variables.copilot.copilot_workspace_short %}**. ![Screenshot of a coding suggestion by {% data variables.copilot.copilot_code-review_short %}.](/assets/images/help/copilot/workspace-copilot-review-suggestion.png) - {% data variables.product.prodname_copilot_workspace %} opens, displaying the suggested change in the Suggestions panel on the right of the {% data variables.product.prodname_copilot_workspace_short %} window. + {% data variables.copilot.copilot_workspace %} opens, displaying the suggested change in the Suggestions panel on the right of the {% data variables.copilot.copilot_workspace_short %} window. 1. Review the suggested change, then click one of the two buttons at the bottom of the Suggestions panel: @@ -111,11 +111,11 @@ You can use {% data variables.product.prodname_copilot_workspace %} to work thro 1. Optionally, if you decide you don't want to commit all of the applied changes in a single commit, clear the check box beside the files whose changes you don't want to commit. When you click **Commit changes**, the changes you applied to those files will remain applied but uncommitted, and you can add them to the pull request in a separate commit. 1. Click **Commit changes**. - Alternatively, click **Reset all changes** to return the suggestions to their initial state, losing the apply or dismiss choices you made, and losing any changes you made by editing files directly in the {% data variables.product.prodname_copilot_workspace_short %} editor panel. Resetting your changes cannot be undone. + Alternatively, click **Reset all changes** to return the suggestions to their initial state, losing the apply or dismiss choices you made, and losing any changes you made by editing files directly in the {% data variables.copilot.copilot_workspace_short %} editor panel. Resetting your changes cannot be undone. ## Chatting with {% data variables.product.prodname_copilot_short %} about a pull request -1. At the top of the {% data variables.product.prodname_copilot_workspace_short %} window, click the {% octicon "copilot" aria-label="Toggle {% data variables.product.prodname_copilot_short %} button. +1. At the top of the {% data variables.copilot.copilot_workspace_short %} window, click the {% octicon "copilot" aria-label="Toggle {% data variables.product.prodname_copilot_short %} button. 1. At the bottom of the {% data variables.product.prodname_copilot_short %} panel, type a question in the "Ask {% data variables.product.prodname_copilot_short %}" box then press Enter. You can ask questions about: @@ -126,15 +126,15 @@ You can use {% data variables.product.prodname_copilot_workspace %} to work thro For more information, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom). -> [!NOTE] Currently not all {% data variables.product.prodname_copilot_chat_short %} features are available in the {% data variables.release-phases.public_preview %} of {% data variables.product.prodname_copilot_workspace %}. +> [!NOTE] Currently not all {% data variables.copilot.copilot_chat_short %} features are available in the {% data variables.release-phases.public_preview %} of {% data variables.copilot.copilot_workspace %}. ## Verifying your changes -{% data variables.product.prodname_copilot_workspace_short %} includes a built-in terminal and a quick way to build, run, and test your code. +{% data variables.copilot.copilot_workspace_short %} includes a built-in terminal and a quick way to build, run, and test your code. ### Opening the terminal -To open the terminal, click {% octicon "terminal" aria-label="Toggle console panel" %} at the top right of the {% data variables.product.prodname_copilot_workspace_short %} editor panel. +To open the terminal, click {% octicon "terminal" aria-label="Toggle console panel" %} at the top right of the {% data variables.copilot.copilot_workspace_short %} editor panel. > [!NOTE] The terminal requires a codespace to be running. If you don't see the {% octicon "terminal" aria-label="Toggle console panel" %} icon, you may need to wait a few seconds for the codespace to start. @@ -144,9 +144,9 @@ You can type commands directly into the terminal, or you can use quick commands #### Configuring personal quick commands -You can configure **Build**, **Run**, and **Test** commands that you can use when you work on a specific project in {% data variables.product.prodname_copilot_workspace %}. If commands have already been configured for the repository, you can replace them with alternative commands for your own personal use. +You can configure **Build**, **Run**, and **Test** commands that you can use when you work on a specific project in {% data variables.copilot.copilot_workspace %}. If commands have already been configured for the repository, you can replace them with alternative commands for your own personal use. -1. At the top of the {% data variables.product.prodname_copilot_workspace_short %} window, click **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Configure**. +1. At the top of the {% data variables.copilot.copilot_workspace_short %} window, click **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Configure**. If **Build**, **Run**, and **Test** quick commands have already been defined, the **{% octicon "play" aria-hidden="true" aria-label="play" %} Build** button is displayed instead of **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Configure**. Click the dropdown arrow beside the **{% octicon "play" aria-hidden="true" aria-label="play" %} Build** button and then click **{% octicon "gear" aria-hidden="true" aria-label="gear" %} Configure** from the dropdown menu. @@ -157,7 +157,7 @@ You can configure **Build**, **Run**, and **Test** commands that you can use whe #### Configuring quick commands for your repository -You can set default **Build**, **Run**, and **Test** commands for everyone who uses {% data variables.product.prodname_copilot_workspace %} to work on pull requests for your repository. +You can set default **Build**, **Run**, and **Test** commands for everyone who uses {% data variables.copilot.copilot_workspace %} to work on pull requests for your repository. 1. Create or edit a file in the root of your repository called `.devcontainer/devcontainer.json`. @@ -177,9 +177,9 @@ You can set default **Build**, **Run**, and **Test** commands for everyone who u 1. Click **Save**. -#### Using {% data variables.product.prodname_copilot_workspace_short %} quick commands +#### Using {% data variables.copilot.copilot_workspace_short %} quick commands -1. To run the first of the defined quick commands (typically **Build**), click the button at the top of the {% data variables.product.prodname_copilot_workspace_short %} window. +1. To run the first of the defined quick commands (typically **Build**), click the button at the top of the {% data variables.copilot.copilot_workspace_short %} window. 1. To run a different quick command, click the dropdown arrow beside the button and then click the command you want to run from the dropdown menu. ![Screenshot of the "Commands" dropdown menu with the "Run" option highlighted with a dark orange outline.](/assets/images/help/copilot/workspace-run-command.png) @@ -190,17 +190,17 @@ You can set default **Build**, **Run**, and **Test** commands for everyone who u #### Previewing a web application -If your run command starts a web server, the {% octicon "globe" aria-label="Open preview" %} button is displayed at the top of the {% data variables.product.prodname_copilot_workspace_short %} window. +If your run command starts a web server, the {% octicon "globe" aria-label="Open preview" %} button is displayed at the top of the {% data variables.copilot.copilot_workspace_short %} window. Click this button to preview the server output in a new tab of your browser. -## Changing the {% data variables.product.prodname_copilot_workspace_short %} options +## Changing the {% data variables.copilot.copilot_workspace_short %} options -You can change how files are displayed in {% data variables.product.prodname_copilot_workspace %}. +You can change how files are displayed in {% data variables.copilot.copilot_workspace %}. ### Changing the diff view -1. Click the compare picker icon ({% octicon "git-compare" aria-hidden="true" aria-label="git-compare" %}), at the top right of the {% data variables.product.prodname_copilot_workspace_short %} editor panel. +1. Click the compare picker icon ({% octicon "git-compare" aria-hidden="true" aria-label="git-compare" %}), at the top right of the {% data variables.copilot.copilot_workspace_short %} editor panel. 1. Choose a view option: * **Unified** - Shows changes in a single view, with added lines highlighted in green and removed lines highlighted in red. @@ -209,5 +209,5 @@ You can change how files are displayed in {% data variables.product.prodname_cop ### Wrapping long lines -1. Click the ellipsis (**...**), at the top right of the {% data variables.product.prodname_copilot_workspace_short %} editor panel. +1. Click the ellipsis (**...**), at the top right of the {% data variables.copilot.copilot_workspace_short %} editor panel. 1. Click **Wrap lines** to toggle line wrapping on or off. diff --git a/content/copilot/using-github-copilot/using-github-copilot-in-the-command-line.md b/content/copilot/using-github-copilot/using-github-copilot-in-the-command-line.md index cdcd18bb44..ab2c87ebfe 100644 --- a/content/copilot/using-github-copilot/using-github-copilot-in-the-command-line.md +++ b/content/copilot/using-github-copilot/using-github-copilot-in-the-command-line.md @@ -16,13 +16,13 @@ redirect_from: * **Access to {% data variables.product.prodname_copilot %}**. See [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot#getting-access-to-copilot). * **{% data variables.product.prodname_cli %} installed**. {% data reusables.cli.cli-installation %} -* **{% data variables.product.prodname_copilot_cli_short %} extension installed**. See [AUTOTITLE](/copilot/github-copilot-in-the-cli/installing-github-copilot-in-the-cli). +* **{% data variables.copilot.copilot_cli_short %} extension installed**. See [AUTOTITLE](/copilot/github-copilot-in-the-cli/installing-github-copilot-in-the-cli). -If you have access to {% data variables.product.prodname_copilot %} via your organization or enterprise, you cannot use {% data variables.product.prodname_copilot_cli_short %} if your organization owner or enterprise administrator has disabled {% data variables.product.prodname_copilot_cli_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization). +If you have access to {% data variables.product.prodname_copilot %} via your organization or enterprise, you cannot use {% data variables.copilot.copilot_cli_short %} if your organization owner or enterprise administrator has disabled {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization). ## Getting command explanations -To ask {% data variables.product.prodname_copilot_cli_short %} to explain a command, run `gh copilot explain` followed by the command that you want explained. For example: +To ask {% data variables.copilot.copilot_cli_short %} to explain a command, run `gh copilot explain` followed by the command that you want explained. For example: ```shell copy gh copilot explain "sudo apt-get" @@ -30,25 +30,25 @@ gh copilot explain "sudo apt-get" ## Getting command suggestions -To ask {% data variables.product.prodname_copilot_cli_short %} to suggest a command, run `gh copilot suggest` followed by the command that you want. For example: +To ask {% data variables.copilot.copilot_cli_short %} to suggest a command, run `gh copilot suggest` followed by the command that you want. For example: ```shell copy gh copilot suggest "Undo the last commit" ``` -{% data variables.product.prodname_copilot_cli_short %} will start an interactive session to get more information about what you want. +{% data variables.copilot.copilot_cli_short %} will start an interactive session to get more information about what you want. -If you choose the **Execute command** option after {% data variables.product.prodname_copilot_cli_short %} suggests a command, {% data variables.product.prodname_copilot_cli_short %} will copy the command to your clipboard and exit the interactive session. Then you can manually paste the command into your CLI. +If you choose the **Execute command** option after {% data variables.copilot.copilot_cli_short %} suggests a command, {% data variables.copilot.copilot_cli_short %} will copy the command to your clipboard and exit the interactive session. Then you can manually paste the command into your CLI. -If you want {% data variables.product.prodname_copilot_cli_short %} to be able to execute commands on your behalf, you must set up the `ghcs` alias. See [AUTOTITLE](/copilot/github-copilot-in-the-cli/configuring-github-copilot-in-the-cli#setting-up-aliases). +If you want {% data variables.copilot.copilot_cli_short %} to be able to execute commands on your behalf, you must set up the `ghcs` alias. See [AUTOTITLE](/copilot/github-copilot-in-the-cli/configuring-github-copilot-in-the-cli#setting-up-aliases). ## Sharing feedback -To send feedback to {% data variables.product.company_short %} about the quality of a suggestion, select the **Rate response** option in {% data variables.product.prodname_copilot_cli_short %}. +To send feedback to {% data variables.product.company_short %} about the quality of a suggestion, select the **Rate response** option in {% data variables.copilot.copilot_cli_short %}. -You can also open an issue in the [{% data variables.product.prodname_copilot_cli_short %} extension repository](https://github.com/github/gh-copilot). +You can also open an issue in the [{% data variables.copilot.copilot_cli_short %} extension repository](https://github.com/github/gh-copilot). ## Further reading -* [{% data variables.product.prodname_copilot_cli_short %} extension README](https://github.com/github/gh-copilot?tab=readme-ov-file) +* [{% data variables.copilot.copilot_cli_short %} extension README](https://github.com/github/gh-copilot?tab=readme-ov-file) * [AUTOTITLE](/copilot/github-copilot-in-the-cli/configuring-github-copilot-in-the-cli) diff --git a/content/copilot/using-github-copilot/using-github-copilot-to-create-issues.md b/content/copilot/using-github-copilot/using-github-copilot-to-create-issues.md index ab62b04255..10195cdaa0 100644 --- a/content/copilot/using-github-copilot/using-github-copilot-to-create-issues.md +++ b/content/copilot/using-github-copilot/using-github-copilot-to-create-issues.md @@ -19,9 +19,9 @@ You stay in control: review and refine what {% data variables.product.prodname_c ## Creating an issue with {% data variables.product.prodname_copilot_short %} -You can create issues from {% data variables.product.prodname_copilot_chat_short %}'s immersive view. +You can create issues from {% data variables.copilot.copilot_chat_short %}'s immersive view. -1. Go to the immersive view of {% data variables.product.prodname_copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)). +1. Go to the immersive view of {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)). 1. At the bottom of the page, in the "Ask {% data variables.product.prodname_copilot_short %}" box, describe what you want to file. Specify the repository you would like to create your issue in using the org/repository format. If you do not specify a repository, {% data variables.product.prodname_copilot_short %} will infer the repository based on the repository you last created an issue in. You can try: * "Create a feature request to add fuzzy matching to search." diff --git a/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md b/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md index 867262599f..8c3a5e54cf 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md @@ -30,7 +30,7 @@ For more information about participation in discussions, see [AUTOTITLE](/discus {% ifversion copilot %} -> [!TIP] You can also use {% data variables.product.prodname_copilot_chat_short %} to generate ideas, outlines, or drafts for discussions, based on your pull requests and issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). +> [!TIP] You can also use {% data variables.copilot.copilot_chat_short %} to generate ideas, outlines, or drafts for discussions, based on your pull requests and issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). {% endif %} diff --git a/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md b/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md index 9de98743da..e42f622d8f 100644 --- a/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md +++ b/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md @@ -25,7 +25,7 @@ In addition to starting or viewing discussions and polls, you can: {% ifversion copilot %} -> [!TIP] You can also use {% data variables.product.prodname_copilot_chat_short %} to generate ideas, outlines, or drafts for discussions based on your recent pull requests and issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). +> [!TIP] You can also use {% data variables.copilot.copilot_chat_short %} to generate ideas, outlines, or drafts for discussions based on your recent pull requests and issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). {% endif %} diff --git a/content/education/about-github-education/github-education-for-students/about-github-education-for-students.md b/content/education/about-github-education/github-education-for-students/about-github-education-for-students.md index 5d84db6932..1050e80dfe 100644 --- a/content/education/about-github-education/github-education-for-students/about-github-education-for-students.md +++ b/content/education/about-github-education/github-education-for-students/about-github-education-for-students.md @@ -38,7 +38,7 @@ Once you are a verified {% data variables.product.prodname_global_campus %} stud * Discover student-created repositories from {% data variables.product.prodname_community_exchange %}. For more information, see [AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange). {% data variables.product.prodname_global_campus %} students also receive the following {% data variables.product.prodname_dotcom %} benefits. -* **{% data variables.product.prodname_copilot %}:** Verified students receive a free subscription for {% data variables.product.prodname_copilot_pro %}. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer). +* **{% data variables.product.prodname_copilot %}:** Verified students receive a free subscription for {% data variables.copilot.copilot_pro %}. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer). * **{% data variables.product.prodname_github_codespaces %}:** {% data reusables.education.student-codespaces-benefit %} For more information on getting started with {% data variables.product.prodname_github_codespaces %}, see [AUTOTITLE](/codespaces/quickstart). > [!NOTE] diff --git a/content/education/about-github-education/github-education-for-teachers/about-github-education-for-teachers.md b/content/education/about-github-education/github-education-for-teachers/about-github-education-for-teachers.md index e0af02f64c..80c8a0c69a 100644 --- a/content/education/about-github-education/github-education-for-teachers/about-github-education-for-teachers.md +++ b/content/education/about-github-education/github-education-for-teachers/about-github-education-for-teachers.md @@ -32,7 +32,7 @@ Before applying for an individual discount, check if your learning community is * Stay in the know on what the student community is interested in by rewatching recent [Campus TV](https://www.twitch.tv/githubeducation) episodes. Campus TV is created by {% data variables.product.prodname_dotcom %} and student community leaders and can be watched live or on demand. * Request a {% data variables.product.prodname_dotcom %} swag bag with educational materials and goodies for your students. -A free subscription for {% data variables.product.prodname_copilot_pro %} is available to verified teachers with {% data variables.product.prodname_education %}. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer). +A free subscription for {% data variables.copilot.copilot_pro %} is available to verified teachers with {% data variables.product.prodname_education %}. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/getting-started-with-copilot-on-your-personal-account/getting-free-access-to-copilot-pro-as-a-student-teacher-or-maintainer). ## Further reading diff --git a/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md b/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md index b69e7548e7..b62e21d6a4 100644 --- a/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md +++ b/content/enterprise-onboarding/getting-started-with-your-enterprise/setting-up-a-trial-of-github-enterprise.md @@ -23,7 +23,7 @@ To set up a trial, you must be signed in to a personal account. If you don't hav The trial lasts for **{% data reusables.enterprise.ghec-trial-length %} days** and includes the following features. * Access to **most** {% data variables.product.prodname_ghe_cloud %} features. -* {% data variables.product.prodname_copilot_for_business %} ({% data variables.product.prodname_dotcom_the_website %} trials only) +* {% data variables.copilot.copilot_for_business %} ({% data variables.product.prodname_dotcom_the_website %} trials only) * {% data variables.product.prodname_GH_cs_and_sp %} ({% data variables.product.prodname_dotcom_the_website %} trials only) * Access to the **new billing platform**. See [AUTOTITLE](/billing/using-the-new-billing-platform/about-the-new-billing-platform-for-enterprises). * An **enterprise account**, which allows you to manage multiple organizations. See [AUTOTITLE](/enterprise-cloud@latest/get-started/learning-about-github/types-of-github-accounts). @@ -32,7 +32,7 @@ The trial lasts for **{% data reusables.enterprise.ghec-trial-length %} days** a ## Features not included in the trial * {% data variables.product.prodname_github_codespaces %} -* {% data variables.product.prodname_copilot_enterprise %} +* {% data variables.copilot.copilot_enterprise %} * {% data variables.product.prodname_sponsors %} * Paid {% data variables.product.prodname_marketplace %} apps * {% data variables.product.prodname_github_connect %} @@ -43,7 +43,7 @@ If you invite an existing organization into your trial enterprise, **all of thes ## Do I need to provide a payment method? -You do not need to provide a payment method to start a trial. If you want to use {% data variables.product.prodname_copilot_business_short %} during the trial, you need to provide a credit card. You **won't** be charged for using {% data variables.product.prodname_copilot_business_short %} during the trial. +You do not need to provide a payment method to start a trial. If you want to use {% data variables.copilot.copilot_business_short %} during the trial, you need to provide a credit card. You **won't** be charged for using {% data variables.copilot.copilot_business_short %} during the trial. ## Setting up a trial @@ -68,15 +68,15 @@ You can find full instructions on setting up {% data variables.product.prodname_ You can find information about planning a trial of {% data variables.product.prodname_cs_and_sp %} and exploring the additional options available with {% data variables.product.prodname_ghe_cloud %} in the [AUTOTITLE](/code-security/trialing-github-advanced-security) articles. -### Setting up {% data variables.product.prodname_copilot_for_business %} +### Setting up {% data variables.copilot.copilot_for_business %} -Setting up your {% data variables.product.prodname_copilot_for_business %} trial involves three phases, and each phase must be completed by different people. +Setting up your {% data variables.copilot.copilot_for_business %} trial involves three phases, and each phase must be completed by different people. -* As an **enterprise owner**, you must first configure {% data variables.product.prodname_copilot_for_business %} for your enterprise. This phase involves setting policies for the use of {% data variables.product.prodname_copilot_for_business %} in your enterprise, and deciding which organizations in your enterprise can use {% data variables.product.prodname_copilot_for_business %}. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise). +* As an **enterprise owner**, you must first configure {% data variables.copilot.copilot_for_business %} for your enterprise. This phase involves setting policies for the use of {% data variables.copilot.copilot_for_business %} in your enterprise, and deciding which organizations in your enterprise can use {% data variables.copilot.copilot_for_business %}. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise). -* Next, **organization owners** can enable {% data variables.product.prodname_copilot_for_business %} for their organizations. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization). +* Next, **organization owners** can enable {% data variables.copilot.copilot_for_business %} for their organizations. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization). -* If your **personal account** has been granted a seat in an organization that has enabled {% data variables.product.prodname_copilot_for_business %}, you can now enable {% data variables.product.prodname_copilot_for_business %} for your personal account. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself). +* If your **personal account** has been granted a seat in an organization that has enabled {% data variables.copilot.copilot_for_business %}, you can now enable {% data variables.copilot.copilot_for_business %} for your personal account. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself). ## During the trial diff --git a/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md b/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md index af8f46c03c..6514ab6919 100644 --- a/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md +++ b/content/get-started/exploring-projects-on-github/using-github-copilot-to-explore-projects.md @@ -9,7 +9,7 @@ topics: shortTitle: Use Copilot to explore projects --- -In this guide, you’ll learn how to use {% data variables.product.prodname_copilot_chat_dotcom_short %} to understand a repository’s purpose, examine files, and dive into specific lines of code. By following these steps, you’ll gain insights into any project faster—making onboarding, code review, and project exploration easier and more efficient. +In this guide, you’ll learn how to use {% data variables.copilot.copilot_chat_dotcom_short %} to understand a repository’s purpose, examine files, and dive into specific lines of code. By following these steps, you’ll gain insights into any project faster—making onboarding, code review, and project exploration easier and more efficient. ## Prerequisites diff --git a/content/get-started/learning-about-github/about-github-advanced-security.md b/content/get-started/learning-about-github/about-github-advanced-security.md index b98ed75fba..2ac805bed7 100644 --- a/content/get-started/learning-about-github/about-github-advanced-security.md +++ b/content/get-started/learning-about-github/about-github-advanced-security.md @@ -44,7 +44,7 @@ You get the following features with {% data variables.product.prodname_GH_code_s * **{% data variables.product.prodname_codeql_cli %}**: Run {% data variables.product.prodname_codeql %} processes locally on software projects or to generate {% data variables.product.prodname_code_scanning %} results for upload to {% data variables.product.github %}.{% ifversion code-scanning-autofix %} -* **{% data variables.product.prodname_copilot_autofix_short %}**: Get automatically generated fixes for {% data variables.product.prodname_code_scanning %} alerts.{% endif %}{% ifversion security-campaigns %} +* **{% data variables.copilot.copilot_autofix_short %}**: Get automatically generated fixes for {% data variables.product.prodname_code_scanning %} alerts.{% endif %}{% ifversion security-campaigns %} * **Security campaigns**: Reduce security debt at scale.{% endif %} @@ -65,7 +65,7 @@ The table below summarizes the availability of {% data variables.product.prodnam | {% data variables.product.prodname_code_scanning_caps %} | {% octicon "check" aria-label="Yes" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | | {% data variables.product.prodname_codeql_cli %} | {% octicon "check" aria-label="Yes" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | |{% ifversion code-scanning-autofix %}| -| {% data variables.product.prodname_copilot_autofix_short %} | {% octicon "check" aria-label="Yes" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | +| {% data variables.copilot.copilot_autofix_short %} | {% octicon "check" aria-label="Yes" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | |{% endif %}| |{% ifversion security-campaigns %}| | Security campaigns | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | @@ -154,9 +154,9 @@ If you are on a {% data variables.product.prodname_team %} or {% data variables. {% ifversion copilot-chat-ghas-alerts %} -## Leveraging {% data variables.product.prodname_copilot_chat %} to understand security alerts +## Leveraging {% data variables.copilot.copilot_chat %} to understand security alerts -Additionally, with a {% data variables.product.prodname_copilot_enterprise %} license, you can ask {% data variables.product.prodname_copilot_chat %} for help to better understand security alerts in repositories in your organization ({% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_secret_scanning %}, and {% data variables.product.prodname_dependabot_alerts %}). See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). +Additionally, with a {% data variables.copilot.copilot_enterprise %} license, you can ask {% data variables.copilot.copilot_chat %} for help to better understand security alerts in repositories in your organization ({% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_secret_scanning %}, and {% data variables.product.prodname_dependabot_alerts %}). See [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#asking-questions-about-alerts-from-github-advanced-security-features). {% endif %} {% ifversion github-certification %} diff --git a/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md b/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md index 970a26c33b..e91ee9b9c6 100644 --- a/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md +++ b/content/get-started/learning-to-code/finding-and-fixing-your-first-code-vulnerability.md @@ -54,7 +54,7 @@ Below the file preview, {% data variables.product.prodname_code_scanning %} prov In our case, the recommendation is to sanitize user input before using it. This means we need to check the input for malicious code, then clean it up if necessary. -> [!TIP] If you don't fully understand the recommended fix, try [asking {% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot) to explain it. +> [!TIP] If you don't fully understand the recommended fix, try [asking {% data variables.copilot.copilot_chat_short %}](https://github.com/copilot) to explain it. ### Timeline @@ -64,9 +64,9 @@ Finally, you can see the timeline of the alert at the bottom of the page. Our ti ## Fixing a vulnerability automatically -To secure our project quickly and easily, let's use {% data variables.product.prodname_copilot_autofix %} for {% data variables.product.prodname_code_scanning %}. +To secure our project quickly and easily, let's use {% data variables.copilot.copilot_autofix %} for {% data variables.product.prodname_code_scanning %}. -1. Below the alert title, in the box suggesting you "Speed up the remediation of this alert using {% data variables.product.prodname_copilot_autofix_short %} for {% data variables.product.prodname_codeql %}", click {% octicon "shield-check" aria-hidden="true" %} **Generate fix**. +1. Below the alert title, in the box suggesting you "Speed up the remediation of this alert using {% data variables.copilot.copilot_autofix_short %} for {% data variables.product.prodname_codeql %}", click {% octicon "shield-check" aria-hidden="true" %} **Generate fix**. 1. After {% data variables.product.prodname_copilot_short %} generates the fix suggestion, it will describe the changes it is suggesting, render a preview of the changes, and call out any added dependencies. Take a moment to read through {% data variables.product.prodname_copilot_short %}'s work. 1. To create a pull request with the fix, click **Commit to new branch**, then click **Commit change**. 1. Once the draft pull request is created, at the bottom of the page, click **Ready for review** to make it mergeable. diff --git a/content/get-started/learning-to-code/finding-and-understanding-example-code.md b/content/get-started/learning-to-code/finding-and-understanding-example-code.md index 2ef11e8ace..1fe3da1a92 100644 --- a/content/get-started/learning-to-code/finding-and-understanding-example-code.md +++ b/content/get-started/learning-to-code/finding-and-understanding-example-code.md @@ -17,7 +17,7 @@ Learning from projects on {% data variables.product.github %} is a great way of However, with millions of publicly available repositories on {% data variables.product.github %}, finding code that applies to your project can be overwhelming. Even after you find the perfect repository, it can be difficult to navigate the codebase to find useful examples. -Instead of trying to understand an entire project, a better approach is to pick a single feature or function and see how it works. We can use {% data variables.product.prodname_copilot_chat_short %} and {% data variables.product.github %}'s search functionality to locate a feature and follow it through the codebase. This is a great way to learn as we can see how the feature works all the way from the backend to the frontend. +Instead of trying to understand an entire project, a better approach is to pick a single feature or function and see how it works. We can use {% data variables.copilot.copilot_chat_short %} and {% data variables.product.github %}'s search functionality to locate a feature and follow it through the codebase. This is a great way to learn as we can see how the feature works all the way from the backend to the frontend. In this guide, you'll learn how to do both by following an **example scenario**: learning how to load and display data from files on a Jekyll website. Then, you can apply the tips and techniques to other projects and programming languages. @@ -25,11 +25,11 @@ In this guide, you'll learn how to do both by following an **example scenario**: The first step is to find the right project to learn from. -### Use {% data variables.product.prodname_copilot_chat_short %} to identify a repository +### Use {% data variables.copilot.copilot_chat_short %} to identify a repository -The fastest way to find a project with code that you can learn from is to ask [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot) to find repositories that match your criteria. +The fastest way to find a project with code that you can learn from is to ask [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot) to find repositories that match your criteria. -Open [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot) and start a general purpose chat. Then ask: +Open [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot) and start a general purpose chat. Then ask: > Can you find some popular repositories that use Jekyll to display data from files in the repository? @@ -67,11 +67,11 @@ It's always a good idea to read the **README.md** file, which is the front page In the [`github/choosealicense.com`](https://github.com/github/choosealicense.com) repository, the README.md file explains where the license files live (`/_licenses`), the attributes each license can have, and how to get the website running on your computer. -### Using {% data variables.product.prodname_copilot_chat_short %} +### Using {% data variables.copilot.copilot_chat_short %} If the README.md file doesn't give you all the answers, you can ask {% data variables.product.prodname_copilot_short %} to help you navigate the repository and locate functionality. -To open {% data variables.product.prodname_copilot_chat_short %}, click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** {% data variables.product.prodname_copilot %} icon next to the search bar and ask your question. For example: +To open {% data variables.copilot.copilot_chat_short %}, click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** {% data variables.product.prodname_copilot %} icon next to the search bar and ask your question. For example: >What is the main landing page for this Jekyll website? @@ -111,7 +111,7 @@ Now we can click on the result and dig deeper! [`licenses.html`](https://github. Now that we've found the specific code we're interested in, we can move on to understanding it. -### Asking {% data variables.product.prodname_copilot_chat_short %} about the code +### Asking {% data variables.copilot.copilot_chat_short %} about the code You can use {% data variables.product.prodname_copilot_short %} to learn more about a file or even specific lines of code. {% data variables.product.prodname_copilot_short %} will combine information about the programming language with the context from the repository to answer your questions in great detail. @@ -122,7 +122,7 @@ Let's ask {% data variables.product.prodname_copilot_short %} to explain what's {% data variables.product.prodname_copilot_short %} will explain that the line is including the `license-overview.html` file and passing along `"agpl-3.0"` as the `license-id` to display. >[!TIP] ->If you don't understand a response from {% data variables.product.prodname_copilot_chat_short %}, you can always ask it to simplify the answer or expand on a particular part of it. +>If you don't understand a response from {% data variables.copilot.copilot_chat_short %}, you can always ask it to simplify the answer or expand on a particular part of it. ### Reading comments diff --git a/content/get-started/learning-to-code/getting-started-with-git.md b/content/get-started/learning-to-code/getting-started-with-git.md index deabb1e39b..18019b7e6e 100644 --- a/content/get-started/learning-to-code/getting-started-with-git.md +++ b/content/get-started/learning-to-code/getting-started-with-git.md @@ -129,7 +129,7 @@ Before you start working with the command line, you need to set up a few tools. ``` Choose to authenticate with **{% data variables.product.prodname_dotcom_the_website %}**, then follow the on-screen prompts. -1. Install {% data variables.product.prodname_copilot_cli %}, a powerful extension for the {% data variables.product.prodname_cli %} that helps you find and understand commands, by running the following command: +1. Install {% data variables.copilot.copilot_cli %}, a powerful extension for the {% data variables.product.prodname_cli %} that helps you find and understand commands, by running the following command: ```shell copy gh extension install github/gh-copilot diff --git a/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md b/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md index f1be19fe9d..9faa6c3e88 100644 --- a/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md +++ b/content/get-started/learning-to-code/learning-to-debug-with-github-copilot.md @@ -69,7 +69,7 @@ Unfortunately, we get some error text in our terminal ending with the following #### Debugging the file -To understand what this error means, [open {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}](vscode://GitHub.Copilot-Chat), then paste and send the following prompt: +To understand what this error means, [open {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}](vscode://GitHub.Copilot-Chat), then paste and send the following prompt: ```text copy Explain in depth why my code produces the following error and how I can fix it: @@ -111,7 +111,7 @@ Unfortunately, the code isn't working as expected. We want it to return `720`, t #### Debugging the file -To understand what went wrong, [open {% data variables.product.prodname_copilot_chat_short %}](vscode://GitHub.Copilot-Chat) and send the following prompt: +To understand what went wrong, [open {% data variables.copilot.copilot_chat_short %}](vscode://GitHub.Copilot-Chat) and send the following prompt: ```text copy Why is the output of this code so much higher than expected? Please explain in depth and suggest a solution. @@ -139,4 +139,4 @@ With these tactics, you're well equipped to start squashing bugs in your project ## Next steps -As you continue coding, you'll likely encounter specific problem scenarios and errors that are difficult to debug. For a list of potential issues and example {% data variables.product.prodname_copilot_chat_short %} prompts to fix them, see [AUTOTITLE](/copilot/copilot-chat-cookbook/debugging-errors). +As you continue coding, you'll likely encounter specific problem scenarios and errors that are difficult to debug. For a list of potential issues and example {% data variables.copilot.copilot_chat_short %} prompts to fix them, see [AUTOTITLE](/copilot/copilot-chat-cookbook/debugging-errors). diff --git a/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md b/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md index a207086a56..12b1df37b9 100644 --- a/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md +++ b/content/get-started/learning-to-code/reusing-other-peoples-code-in-your-projects.md @@ -66,7 +66,7 @@ Now, you're ready to paste the code snippet into your project. While you'll some Let's say we want to quickly calculate the factorials of 5, 7, 9, and 10. Instead of copying and pasting the entire program for each number, we can move our calculator into a **function** that takes a number as an argument. -Use [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot) to suggest and explain an implementation. Paste our current code into the chat window, followed by this prompt: +Use [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot) to suggest and explain an implementation. Paste our current code into the chat window, followed by this prompt: ```text copy Wrap the Python code above in a function. @@ -122,9 +122,9 @@ print(calculate_factorial(10)) ### 1. Finding a library -Once you know what functionality you want to add to your project, you can search for a library with relevant code. {% data variables.product.prodname_copilot_chat_short %} is an easy way to search for libraries, since you can use natural language to describe exactly what you're looking for. +Once you know what functionality you want to add to your project, you can search for a library with relevant code. {% data variables.copilot.copilot_chat_short %} is an easy way to search for libraries, since you can use natural language to describe exactly what you're looking for. -Finding a factorial is a pretty common function, and there's a good chance someone included that function in an existing library. Open [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot), then ask: +Finding a factorial is a pretty common function, and there's a good chance someone included that function in an existing library. Open [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot), then ask: ```text copy Is there a Python library with a function for calculating a factorial? @@ -142,7 +142,7 @@ Thankfully, there are some steps you can take to best protect your project. Let' Popular libraries are more likely to be secure, because they are actively maintained and used by many developers. One good marker of popularity is the number of **stars** a repository has. If you can't find the {% data variables.product.github %} repository for a dependency, you can ask {% data variables.product.prodname_copilot_short %} for help. -Open [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot), then ask: +Open [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot), then ask: ```text copy Find the GitHub repository containing the code for the math module in Python. @@ -162,7 +162,7 @@ Turn {% data variables.product.prodname_dependabot_alerts %} on for your reposit Now you're ready to import the library into your project, then use its contents in your code. You can read the documentation for the library to learn how to do it yourself, or you can ask {% data variables.product.prodname_copilot_short %} to suggest and explain an implementation for you. -Open [{% data variables.product.prodname_copilot_chat_short %}](https://github.com/copilot), then ask: +Open [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot), then ask: ```text copy How do I use the factorial function of the math module in my Python project? diff --git a/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md b/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md index 66a1753cec..158bc38055 100644 --- a/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md +++ b/content/get-started/learning-to-code/setting-up-copilot-for-learning-to-code.md @@ -39,7 +39,7 @@ First, let's disable code completion. This will give you the opportunity to deep ## Step 2: Add learning instructions -Now, let's provide {% data variables.product.prodname_copilot_chat_short %} with instructions to act like a tutor that supports your learning. +Now, let's provide {% data variables.copilot.copilot_chat_short %} with instructions to act like a tutor that supports your learning. 1. In the root folder of your project, create a file called `copilot-instructions.md`. 1. Add the following text, or customize it for your personal learning goals: @@ -54,16 +54,16 @@ Now, let's provide {% data variables.product.prodname_copilot_chat_short %} with At the end of every response, add "Always check the correctness of AI-generated responses." ``` -1. Save the file. {% data variables.product.prodname_copilot_short %} will use these instructions when you ask questions in {% data variables.product.prodname_copilot_chat_short %}. +1. Save the file. {% data variables.product.prodname_copilot_short %} will use these instructions when you ask questions in {% data variables.copilot.copilot_chat_short %}. -## Step 3: Use {% data variables.product.prodname_copilot_chat_short %} to learn +## Step 3: Use {% data variables.copilot.copilot_chat_short %} to learn You're ready to start building real coding skills with {% data variables.product.prodname_copilot_short %}'s help! -Throughout your work on the project, engage in a long-running conversation with **{% data variables.product.prodname_copilot_chat_short %}**. Treat it as your **personal tutor**, asking questions as they arise and using it to navigate challenges or clarify concepts. +Throughout your work on the project, engage in a long-running conversation with **{% data variables.copilot.copilot_chat_short %}**. Treat it as your **personal tutor**, asking questions as they arise and using it to navigate challenges or clarify concepts. -Open {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %} {% octicon "link-external" height:16 aria-label="link-external" %} +Open {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %} {% octicon "link-external" height:16 aria-label="link-external" %}

-{% data variables.product.prodname_copilot_chat_short %} is especially helpful for debugging your code. For step-by-step guidance, see [AUTOTITLE](/get-started/learning-to-code/learning-to-debug-with-github-copilot). +{% data variables.copilot.copilot_chat_short %} is especially helpful for debugging your code. For step-by-step guidance, see [AUTOTITLE](/get-started/learning-to-code/learning-to-debug-with-github-copilot). diff --git a/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md b/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md index 433b937ebf..0c6bee2173 100644 --- a/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md +++ b/content/get-started/onboarding/getting-started-with-the-github-enterprise-cloud-trial.md @@ -28,18 +28,18 @@ You can find full instructions on setting up {% data variables.product.prodname_ You can find information about planning a trial of {% data variables.product.prodname_GHAS %} and exploring the additional options available with {% data variables.product.prodname_ghe_cloud %} in the [AUTOTITLE](/code-security/trialing-github-advanced-security) articles. -## Part 4: Setting up {% data variables.product.prodname_copilot_for_business %} +## Part 4: Setting up {% data variables.copilot.copilot_for_business %} -Setting up your {% data variables.product.prodname_copilot_for_business %} trial involves three phases, and each phase must be completed by different people. +Setting up your {% data variables.copilot.copilot_for_business %} trial involves three phases, and each phase must be completed by different people. -### 1. Configuring {% data variables.product.prodname_copilot_for_business %} for your enterprise +### 1. Configuring {% data variables.copilot.copilot_for_business %} for your enterprise -As an **enterprise owner**, you must first configure {% data variables.product.prodname_copilot_for_business %} for your enterprise. This phase involves setting policies for the use of {% data variables.product.prodname_copilot_for_business %} in your enterprise, and deciding which organizations in your enterprise can use {% data variables.product.prodname_copilot_for_business %}. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise). +As an **enterprise owner**, you must first configure {% data variables.copilot.copilot_for_business %} for your enterprise. This phase involves setting policies for the use of {% data variables.copilot.copilot_for_business %} in your enterprise, and deciding which organizations in your enterprise can use {% data variables.copilot.copilot_for_business %}. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise). -### 2. Enabling {% data variables.product.prodname_copilot_for_business %} for your organization +### 2. Enabling {% data variables.copilot.copilot_for_business %} for your organization -Next, **organization owners** can enable {% data variables.product.prodname_copilot_for_business %} for their organizations. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization). +Next, **organization owners** can enable {% data variables.copilot.copilot_for_business %} for their organizations. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization). -### 3. Enabling {% data variables.product.prodname_copilot_for_business %} for individual users +### 3. Enabling {% data variables.copilot.copilot_for_business %} for individual users -If your **personal account** has been granted a seat in an organization that has enabled {% data variables.product.prodname_copilot_for_business %}, you can now enable {% data variables.product.prodname_copilot_for_business %} for your personal account. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself). +If your **personal account** has been granted a seat in an organization that has enabled {% data variables.copilot.copilot_for_business %}, you can now enable {% data variables.copilot.copilot_for_business %} for your personal account. For detailed instructions, see [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself). diff --git a/content/get-started/using-github/communicating-on-github.md b/content/get-started/using-github/communicating-on-github.md index f6eeefc74e..6d79432390 100644 --- a/content/get-started/using-github/communicating-on-github.md +++ b/content/get-started/using-github/communicating-on-github.md @@ -26,7 +26,7 @@ You can create and participate in issues, pull requests, and team discussions, d {% ifversion copilot %} -> [!TIP] You can also use {% data variables.product.prodname_copilot_chat_short %} to generate ideas, outlines, or drafts for discussions, based on your pull requests and issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). +> [!TIP] You can also use {% data variables.copilot.copilot_chat_short %} to generate ideas, outlines, or drafts for discussions, based on your pull requests and issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). {% endif %} diff --git a/content/get-started/using-github/github-mobile.md b/content/get-started/using-github/github-mobile.md index 37f780d770..72cc268056 100644 --- a/content/get-started/using-github/github-mobile.md +++ b/content/get-started/using-github/github-mobile.md @@ -30,15 +30,15 @@ With {% data variables.product.prodname_mobile %} you can: {% ifversion mobile-code-search %}- Search through code in a specific repository{% endif %} {% ifversion fpt or ghec %}- Secure your GitHub.com account with two-factor authentication * Verify your sign in attempts on unrecognized devices{% endif %} -{% ifversion copilot-chat-for-mobile %}- Use {% data variables.product.prodname_copilot_chat %} to ask and receive answers to coding-related questions{% endif %} +{% ifversion copilot-chat-for-mobile %}- Use {% data variables.copilot.copilot_chat %} to ask and receive answers to coding-related questions{% endif %} The following documentation contains more information about using {% data variables.product.company_short %} features on {% data variables.product.prodname_mobile %}. * For more information about notifications for {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#enabling-push-notifications-with-github-mobile). {% ifversion mobile-code-search %}- For more information about using {% data variables.product.prodname_dotcom %} code search on {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/search-github/github-code-search/using-github-code-search#using-github-code-search-on-github-mobile).{% endif %} {% ifversion fpt or ghec %}- For more information on two-factor authentication using {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) and [Authenticating using {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication#verifying-with-github-mobile). {% endif %} -{% ifversion copilot-chat-for-mobile %}- For more information about using {% data variables.product.prodname_copilot_mobile %}, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile).{% endif %} -{% ifversion copilot-chat-for-mobile %}- For more information about using {% data variables.product.prodname_copilot_extensions %} in {% data variables.product.prodname_mobile %}, see [Extending {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_mobile %}](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile#extending-copilot-chat-in-github-mobile).{% endif %} +{% ifversion copilot-chat-for-mobile %}- For more information about using {% data variables.copilot.copilot_mobile %}, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile).{% endif %} +{% ifversion copilot-chat-for-mobile %}- For more information about using {% data variables.copilot.copilot_extensions %} in {% data variables.product.prodname_mobile %}, see [Extending {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_mobile %}](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile#extending-copilot-chat-in-github-mobile).{% endif %} ## Installing {% data variables.product.prodname_mobile %} diff --git a/content/github-models/github-models-at-scale/manage-models-at-scale.md b/content/github-models/github-models-at-scale/manage-models-at-scale.md index 85caa2887b..009d0b3c6e 100644 --- a/content/github-models/github-models-at-scale/manage-models-at-scale.md +++ b/content/github-models/github-models-at-scale/manage-models-at-scale.md @@ -30,7 +30,7 @@ While {% data variables.product.prodname_github_models %} for organizations and * {% data variables.product.prodname_emus %} organizations * {% data variables.product.prodname_github_models %} extension for {% data variables.product.prodname_cli %} -* {% data variables.product.prodname_github_models %} extension for {% data variables.product.prodname_copilot_chat %} +* {% data variables.product.prodname_github_models %} extension for {% data variables.copilot.copilot_chat %} * {% data variables.product.prodname_github_models %} VS Code extension * Playground for {% data variables.product.prodname_github_models %} in the {% data variables.product.prodname_marketplace %} at https://github.com/marketplace/models. diff --git a/content/github-models/github-models-at-scale/use-models-at-scale.md b/content/github-models/github-models-at-scale/use-models-at-scale.md index 0500a3d20c..837fd3b1b1 100644 --- a/content/github-models/github-models-at-scale/use-models-at-scale.md +++ b/content/github-models/github-models-at-scale/use-models-at-scale.md @@ -65,7 +65,7 @@ To more efficiently manage resources across all teams, you can leverage the {% d You can also use these extensions to run inference requests and manage prompts: * {% data variables.product.prodname_github_models %} extension for {% data variables.product.prodname_cli %} -* {% data variables.product.prodname_github_models %} extension for {% data variables.product.prodname_copilot_chat %} +* {% data variables.product.prodname_github_models %} extension for {% data variables.copilot.copilot_chat %} * {% data variables.product.prodname_github_models %} VS Code extension ### Monitor, iterate, and integrate diff --git a/content/github-models/use-github-models/integrating-ai-models-into-your-development-workflow.md b/content/github-models/use-github-models/integrating-ai-models-into-your-development-workflow.md index 045ea1b4b8..f5901cf476 100644 --- a/content/github-models/use-github-models/integrating-ai-models-into-your-development-workflow.md +++ b/content/github-models/use-github-models/integrating-ai-models-into-your-development-workflow.md @@ -8,28 +8,28 @@ redirect_from: - /github-models/integrating-ai-models-into-your-development-workflow --- -With {% data variables.product.prodname_github_models %} extensions, you can call specific AI models from both {% data variables.product.prodname_copilot_chat_short %} and {% data variables.product.prodname_cli %}. These extensions integrate directly into your development workflow, allowing you to prompt models without context switching. +With {% data variables.product.prodname_github_models %} extensions, you can call specific AI models from both {% data variables.copilot.copilot_chat_short %} and {% data variables.product.prodname_cli %}. These extensions integrate directly into your development workflow, allowing you to prompt models without context switching. -## Using AI models in {% data variables.product.prodname_copilot_chat_short %} +## Using AI models in {% data variables.copilot.copilot_chat_short %} -If you have a {% data variables.product.prodname_copilot_short %} subscription, you can work with AI models in {% data variables.product.prodname_copilot_chat_short %} in two different ways: -* Using the {% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %}. With this extension, you can ask for model recommendations based on certain criteria and chat with specific models. See [Using the {% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %}](#using-the-github-models-copilot-extension). -* Using multiple model support in {% data variables.product.prodname_copilot_chat_short %}. With multi-model {% data variables.product.prodname_copilot_chat_short %}, you can choose a specific model to use for a conversation, then prompt {% data variables.product.prodname_copilot_chat_short %} as usual. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). +If you have a {% data variables.product.prodname_copilot_short %} subscription, you can work with AI models in {% data variables.copilot.copilot_chat_short %} in two different ways: +* Using the {% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %}. With this extension, you can ask for model recommendations based on certain criteria and chat with specific models. See [Using the {% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %}](#using-the-github-models-copilot-extension). +* Using multiple model support in {% data variables.copilot.copilot_chat_short %}. With multi-model {% data variables.copilot.copilot_chat_short %}, you can choose a specific model to use for a conversation, then prompt {% data variables.copilot.copilot_chat_short %} as usual. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). -### Using the {% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %} +### Using the {% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %} -> [!NOTE] The {% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. +> [!NOTE] The {% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %} is in {% data variables.release-phases.public_preview %} and is subject to change. -1. Install the [{% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %}](https://github.com/marketplace/models-github). - * If you have a {% data variables.product.prodname_copilot_pro_short %} subscription, you can install the extension on your personal account. - * If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription: - * An organization owner or enterprise owner needs to enable the {% data variables.product.prodname_copilot_extensions_short %} policy for your organization or enterprise. +1. Install the [{% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %}](https://github.com/marketplace/models-github). + * If you have a {% data variables.copilot.copilot_pro_short %} subscription, you can install the extension on your personal account. + * If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription: + * An organization owner or enterprise owner needs to enable the {% data variables.copilot.copilot_extensions_short %} policy for your organization or enterprise. * An organization owner needs to install the extension for your organization. -1. Open any implementation of {% data variables.product.prodname_copilot_chat_short %} that supports {% data variables.product.prodname_copilot_extensions %}. For a list of supported {% data variables.product.prodname_copilot_chat_short %} implementations, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat#supported-clients-and-ides). -1. In the chat window, type `@models YOUR-PROMPT`, then send your prompt. There are several use cases for the {% data variables.product.prodname_github_models %} {% data variables.product.prodname_copilot_extension_short %}, including: +1. Open any implementation of {% data variables.copilot.copilot_chat_short %} that supports {% data variables.copilot.copilot_extensions %}. For a list of supported {% data variables.copilot.copilot_chat_short %} implementations, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat#supported-clients-and-ides). +1. In the chat window, type `@models YOUR-PROMPT`, then send your prompt. There are several use cases for the {% data variables.product.prodname_github_models %} {% data variables.copilot.copilot_extension_short %}, including: * Recommending a particular model based on context and criteria you provide. For example, you can ask for a low-cost OpenAI model that supports function calling. - * Executing prompts using a particular model. This is especially useful when you want to use a model that is not currently available in multi-model {% data variables.product.prodname_copilot_chat_short %}. + * Executing prompts using a particular model. This is especially useful when you want to use a model that is not currently available in multi-model {% data variables.copilot.copilot_chat_short %}. * Listing models currently available through {% data variables.product.prodname_github_models %} ## Using AI models with {% data variables.product.prodname_actions %} diff --git a/content/issues/tracking-your-work-with-issues/about-issues.md b/content/issues/tracking-your-work-with-issues/about-issues.md index 51a0a6428e..8461a4aa91 100644 --- a/content/issues/tracking-your-work-with-issues/about-issues.md +++ b/content/issues/tracking-your-work-with-issues/about-issues.md @@ -23,7 +23,7 @@ Issues can be created in a variety of ways, so you can choose the most convenien {% ifversion copilot %} -> [!TIP] You can also use {% data variables.product.prodname_copilot_chat_short %} to generate ideas, outlines, or drafts for discussions or blog posts, based on your issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). +> [!TIP] You can also use {% data variables.copilot.copilot_chat_short %} to generate ideas, outlines, or drafts for discussions or blog posts, based on your issues. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). {% endif %} diff --git a/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md b/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md index a180bcceea..8b30bac9b7 100644 --- a/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md +++ b/content/issues/tracking-your-work-with-issues/using-issues/creating-an-issue.md @@ -163,16 +163,16 @@ You can also use URL query parameters to fill custom text fields that you have d {% ifversion copilot %} -## Creating an issue with {% data variables.product.prodname_copilot_chat_short %} on {% data variables.product.github %} +## Creating an issue with {% data variables.copilot.copilot_chat_short %} on {% data variables.product.github %} > [!NOTE] > This feature is in {% data variables.release-phases.public_preview %} and subject to change. Creating issues manually can be repetitive and time-consuming. With {% data variables.product.prodname_copilot_short %}, you can create issues faster by prompting in natural language, or even by uploading a screenshot. {% data variables.product.prodname_copilot_short %} fills out the title, body, labels, assignees, and more, using your repository’s templates and structure. See [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-to-create-issues). -## Creating an issue from {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %} +## Creating an issue from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %} -You can also create an issue directly from {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}, using the Model Context Protocol (MCP). See [AUTOTITLE](/copilot/customizing-copilot/extending-copilot-chat-with-mcp). +You can also create an issue directly from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}, using the Model Context Protocol (MCP). See [AUTOTITLE](/copilot/customizing-copilot/extending-copilot-chat-with-mcp). {% endif %} diff --git a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md index 077ddf1140..fb777b1e3a 100644 --- a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md +++ b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md @@ -52,7 +52,7 @@ To search for specific events, use the `action` qualifier in your query. Actions | {% endif %} | | {% ifversion fpt or ghec %} | | `codespaces` | Contains all activities related to your organization's codespaces. | -| `copilot` | Contains all activities related to your {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} subscription. +| `copilot` | Contains all activities related to your {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} subscription. | {% endif %} | | `dependabot_alerts` | Contains organization-level configuration activities for {% data variables.product.prodname_dependabot_alerts %} in existing repositories. For more information, see [AUTOTITLE](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts). | `dependabot_alerts_new_repos` | Contains organization-level configuration activities for {% data variables.product.prodname_dependabot_alerts %} in new repositories created in the organization. diff --git a/content/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization.md b/content/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization.md index c38208277e..9304139e82 100644 --- a/content/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization.md +++ b/content/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization.md @@ -39,7 +39,7 @@ Billing managers **are not** able to: * See private members of your organization * Be seen in the list of organization members * Purchase, edit, or cancel subscriptions for {% data variables.product.prodname_marketplace %} apps -* Purchase, edit, or cancel subscriptions for {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} +* Purchase, edit, or cancel subscriptions for {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} > [!TIP] > If your organization [requires members, billing managers, and outside collaborators to use two-factor authentication](/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization), the user must enable two-factor authentication before they can accept your invitation to become a billing manager for the organization. diff --git a/content/pull-requests/collaborating-with-pull-requests/getting-started/helping-others-review-your-changes.md b/content/pull-requests/collaborating-with-pull-requests/getting-started/helping-others-review-your-changes.md index 53f0999950..73dd181870 100644 --- a/content/pull-requests/collaborating-with-pull-requests/getting-started/helping-others-review-your-changes.md +++ b/content/pull-requests/collaborating-with-pull-requests/getting-started/helping-others-review-your-changes.md @@ -45,7 +45,7 @@ There are various tools available that can help you review your pull request for * Check the dependency diff to see if your pull request is introducing vulnerable dependencies. See [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request). * Check the {% data variables.product.prodname_advisory_database %} to find additional context and information on vulnerable dependencies. * Investigate and resolve any failing security checks or workflows, such as the dependency review action or the {% data variables.product.prodname_code_scanning %} results check. See [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review#about-the-dependency-review-action) and [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests#about-code-scanning-as-a-pull-request-check).{% ifversion code-scanning-autofix %} -* If your repository has set up {% data variables.product.prodname_code_scanning %} as a pull request check, use {% data variables.product.prodname_copilot_autofix %} to suggest fixes for security vulnerabilities in your code. See [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests#working-with-copilot-autofix-suggestions-for-alerts-on-a-pull-request).{% endif %} +* If your repository has set up {% data variables.product.prodname_code_scanning %} as a pull request check, use {% data variables.copilot.copilot_autofix %} to suggest fixes for security vulnerabilities in your code. See [AUTOTITLE](/code-security/code-scanning/managing-code-scanning-alerts/triaging-code-scanning-alerts-in-pull-requests#working-with-copilot-autofix-suggestions-for-alerts-on-a-pull-request).{% endif %} ## Keeping your team informed @@ -77,7 +77,7 @@ You can use {% data variables.product.prodname_copilot_short %} to generate a su 1. Add any additional context that will help people viewing your pull request. 1. When you're happy with the description, click **Create pull request** on a new pull request, or **Update comment** if you're editing an existing description. -> [!TIP] You can also use {% data variables.product.prodname_copilot_chat_short %} to turn your work into a discussion or blog post. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). +> [!TIP] You can also use {% data variables.copilot.copilot_chat_short %} to turn your work into a discussion or blog post. See [AUTOTITLE](/copilot/copilot-chat-cookbook/documenting-code/writing-discussions-or-blog-posts). {% endif %} diff --git a/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request.md index 6e8ccc8d91..d02d9a44d6 100644 --- a/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request.md @@ -187,9 +187,9 @@ You can also make changes to files on the {% data variables.product.github %} we {% ifversion copilot-hadron %} -If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.product.prodname_copilot_workspace %}, clicking **Edit** on a file on the "Files changed" tab will open the file in a {% data variables.product.prodname_copilot_workspace %} on {% data variables.product.prodname_dotcom %}. In a {% data variables.product.prodname_copilot_workspace %}, you can still make changes to the file but also make changes to other files in the repository, group your changes into a single commit, and take advantage of {% data variables.product.prodname_copilot_short %} code completion. +If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.copilot.copilot_workspace %}, clicking **Edit** on a file on the "Files changed" tab will open the file in a {% data variables.copilot.copilot_workspace %} on {% data variables.product.prodname_dotcom %}. In a {% data variables.copilot.copilot_workspace %}, you can still make changes to the file but also make changes to other files in the repository, group your changes into a single commit, and take advantage of {% data variables.product.prodname_copilot_short %} code completion. -You can access {% data variables.product.prodname_copilot_workspace %} by choosing to edit an individual file or by clicking **Open in {% data variables.product.prodname_copilot_workspace_short %}** in your pull request's right sidebar. For more information about {% data variables.product.prodname_copilot_workspace %} and joining the {% data variables.release-phases.public_preview %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). +You can access {% data variables.copilot.copilot_workspace %} by choosing to edit an individual file or by clicking **Open in {% data variables.copilot.copilot_workspace_short %}** in your pull request's right sidebar. For more information about {% data variables.copilot.copilot_workspace %} and joining the {% data variables.release-phases.public_preview %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). {% endif %} diff --git a/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review.md b/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review.md index 93566571d8..5937dbfb44 100644 --- a/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review.md +++ b/content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review.md @@ -52,7 +52,7 @@ You can request a review from either a suggested or specific person. Suggested r ## Requesting a review from {% data variables.product.prodname_copilot %} >[!NOTE] ->{% data variables.product.prodname_copilot_workspace %} is currently in {% data variables.release-phases.public_preview %}. For information about joining the {% data variables.release-phases.public_preview %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). +>{% data variables.copilot.copilot_workspace %} is currently in {% data variables.release-phases.public_preview %}. For information about joining the {% data variables.release-phases.public_preview %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). You can also request that {% data variables.product.prodname_copilot_short %} reviews your code and provides feedback and suggested changes on your work. See [AUTOTITLE](/copilot/using-github-copilot/code-review/using-copilot-code-review). diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request.md index 7789ee607b..9662e3bb04 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request.md @@ -23,9 +23,9 @@ To quickly incorporate more than one suggested change into a single commit, you {% ifversion copilot-hadron %} >[!NOTE] ->If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.product.prodname_copilot_workspace %}, suggested changes from people on your team, {% data variables.product.prodname_copilot_short %}, or {% data variables.product.prodname_copilot_autofix %} can all be applied and edited in {% data variables.product.prodname_copilot_workspace %}. Click **Open in {% data variables.product.prodname_copilot_workspace_short %}** on a suggested change to get started. +>If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.copilot.copilot_workspace %}, suggested changes from people on your team, {% data variables.product.prodname_copilot_short %}, or {% data variables.copilot.copilot_autofix %} can all be applied and edited in {% data variables.copilot.copilot_workspace %}. Click **Open in {% data variables.copilot.copilot_workspace_short %}** on a suggested change to get started. > ->For more information about {% data variables.product.prodname_copilot_workspace %} and joining the {% data variables.release-phases.public_preview %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). +>For more information about {% data variables.copilot.copilot_workspace %} and joining the {% data variables.release-phases.public_preview %}, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). {% endif %} diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 34d95c097b..33ca3366e9 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -40,7 +40,7 @@ You can change the format of the diff view in this tab by clicking {% octicon "g You can also choose to hide whitespace differences. The choice you make only applies to this pull request and will be remembered the next time you visit this page. 1. Optionally, filter the files to show only the files you want to review or use the file tree to navigate to a specific file. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/filtering-files-in-a-pull-request). {%- ifversion ghec %} -1. Optionally, if you have access to {% data variables.product.prodname_copilot_enterprise %}, you can ask {% data variables.product.prodname_copilot_short %} about the changes in a file in a pull request by clicking {% octicon "kebab-horizontal" aria-label="Show options" %} at the top right of the file, clicking **Ask {% data variables.product.prodname_copilot_short %} about this diff**, then typing a request such as "Explain these changes." For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-questions-about-a-specific-pull-request). +1. Optionally, if you have access to {% data variables.copilot.copilot_enterprise %}, you can ask {% data variables.product.prodname_copilot_short %} about the changes in a file in a pull request by clicking {% octicon "kebab-horizontal" aria-label="Show options" %} at the top right of the file, clicking **Ask {% data variables.product.prodname_copilot_short %} about this diff**, then typing a request such as "Explain these changes." For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-questions-about-a-specific-pull-request). {%- endif %} {% data reusables.repositories.start-line-comment %} {% data reusables.repositories.multiple-lines-comment %} diff --git a/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md b/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md index 9d5451b110..949c81f99b 100644 --- a/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md +++ b/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md @@ -65,9 +65,9 @@ If you create an invalid URL using query parameters, or if you don’t have the {% ifversion copilot %} -## Creating a new repository from {% data variables.product.prodname_copilot_chat_short %} +## Creating a new repository from {% data variables.copilot.copilot_chat_short %} -You can create a new repository from {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} with the Model Context Protocol (MCP). For more information, see [AUTOTITLE](/copilot/customizing-copilot/extending-copilot-chat-with-mcp). +You can create a new repository from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %} with the Model Context Protocol (MCP). For more information, see [AUTOTITLE](/copilot/customizing-copilot/extending-copilot-chat-with-mcp). {% endif %} ## Further reading diff --git a/content/rest/copilot/copilot-user-management.md b/content/rest/copilot/copilot-user-management.md index f7dc2b277d..7fd1ddcdbd 100644 --- a/content/rest/copilot/copilot-user-management.md +++ b/content/rest/copilot/copilot-user-management.md @@ -1,7 +1,7 @@ --- title: REST API endpoints for Copilot user management shortTitle: Copilot user management -intro: 'Use the REST API to manage the {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} subscription for your organization.' +intro: 'Use the REST API to manage the {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} subscription for your organization.' versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 fpt: '*' ghec: '*' diff --git a/content/rest/copilot/index.md b/content/rest/copilot/index.md index 7f393aec9a..0ed3ee053d 100644 --- a/content/rest/copilot/index.md +++ b/content/rest/copilot/index.md @@ -3,7 +3,7 @@ title: REST API endpoints for Copilot shortTitle: Copilot intro: >- Use the REST API to manage the {% data - variables.product.prodname_copilot_for_business %} subscription for your + variables.copilot.copilot_for_business %} subscription for your organization. topics: - API diff --git a/content/search-github/github-code-search/using-github-code-search.md b/content/search-github/github-code-search/using-github-code-search.md index d1d2a38404..80bce4cef8 100644 --- a/content/search-github/github-code-search/using-github-code-search.md +++ b/content/search-github/github-code-search/using-github-code-search.md @@ -59,7 +59,7 @@ You can use {% data variables.product.prodname_copilot %} to ask questions about ![Screenshot of the main search box on {% data variables.product.prodname_dotcom %}. The drop-down option "Ask {% data variables.product.prodname_copilot_short %}" is highlighted with an orange outline.](/assets/images/help/copilot/ask-copilot-from-search-bar.png) - The {% data variables.product.prodname_copilot_chat %} panel is displayed and {% data variables.product.prodname_copilot_short %} responds to your request. + The {% data variables.copilot.copilot_chat %} panel is displayed and {% data variables.product.prodname_copilot_short %} responds to your request. {% data reusables.copilot.stop-response-generation %} diff --git a/content/support/contacting-github-support/creating-a-support-ticket.md b/content/support/contacting-github-support/creating-a-support-ticket.md index d11db7d427..7416abd3e6 100644 --- a/content/support/contacting-github-support/creating-a-support-ticket.md +++ b/content/support/contacting-github-support/creating-a-support-ticket.md @@ -78,7 +78,7 @@ Especially for tickets with {% data variables.product.support_ticket_priority_ur ## Creating a support ticket{% ifversion ghes %} using the {% data variables.contact.enterprise_portal %}{% endif %} > [!NOTE] -> Before you submit a ticket, you have the option of using {% data variables.product.prodname_copilot_in_support %} to receive an immediate response to your question. If {% data variables.product.prodname_copilot_in_support %} is unable to resolve your issue, you can continue submitting your ticket. For more information, see [AUTOTITLE](/support/learning-about-github-support/about-copilot-in-github-support). +> Before you submit a ticket, you have the option of using {% data variables.copilot.copilot_in_support %} to receive an immediate response to your question. If {% data variables.copilot.copilot_in_support %} is unable to resolve your issue, you can continue submitting your ticket. For more information, see [AUTOTITLE](/support/learning-about-github-support/about-copilot-in-github-support). 1. Navigate to the {% data variables.contact.contact_landing_page_portal %} and choose one of the following options: diff --git a/content/support/contacting-github-support/using-copilot-in-github-support.md b/content/support/contacting-github-support/using-copilot-in-github-support.md index e7fd9d97dd..a2ef8b778a 100644 --- a/content/support/contacting-github-support/using-copilot-in-github-support.md +++ b/content/support/contacting-github-support/using-copilot-in-github-support.md @@ -1,6 +1,6 @@ --- title: Using Copilot in GitHub Support -intro: 'You can use {% data variables.product.prodname_copilot_in_support %} to find an answer to your question before submitting a support ticket.' +intro: 'You can use {% data variables.copilot.copilot_in_support %} to find an answer to your question before submitting a support ticket.' topics: - Support redirect_from: @@ -12,35 +12,35 @@ versions: shortTitle: Using Copilot in GitHub Support --- -## About {% data variables.product.prodname_copilot_in_support %} +## About {% data variables.copilot.copilot_in_support %} -{% data variables.product.prodname_copilot_in_support %} is an AI-powered feature within the {% data variables.contact.github_support %} portal that helps you find answers to your support queries before submitting a ticket. {% data variables.product.prodname_copilot_in_support %} uses a large language model trained on publicly available {% data variables.product.prodname_dotcom %} documentation. +{% data variables.copilot.copilot_in_support %} is an AI-powered feature within the {% data variables.contact.github_support %} portal that helps you find answers to your support queries before submitting a ticket. {% data variables.copilot.copilot_in_support %} uses a large language model trained on publicly available {% data variables.product.prodname_dotcom %} documentation. -You can use {% data variables.product.prodname_copilot_in_support %} to find answers to questions about a wide range of {% data variables.product.prodname_dotcom %}'s products and features. {% data variables.product.prodname_copilot_in_support %} is not able to answer questions about billing, account access, or other account-specific issues. If {% data variables.product.prodname_copilot_in_support %} is not able to answer your question, you can submit a ticket to {% data variables.contact.github_support %} or you can speak to {% data variables.product.prodname_dotcom %} users and staff on the {% data variables.contact.community_support_forum %}. +You can use {% data variables.copilot.copilot_in_support %} to find answers to questions about a wide range of {% data variables.product.prodname_dotcom %}'s products and features. {% data variables.copilot.copilot_in_support %} is not able to answer questions about billing, account access, or other account-specific issues. If {% data variables.copilot.copilot_in_support %} is not able to answer your question, you can submit a ticket to {% data variables.contact.github_support %} or you can speak to {% data variables.product.prodname_dotcom %} users and staff on the {% data variables.contact.community_support_forum %}. For more information about {% data variables.contact.github_support %}, see [AUTOTITLE](/support/learning-about-github-support/about-github-support). -## Using {% data variables.product.prodname_copilot_in_support %} +## Using {% data variables.copilot.copilot_in_support %} -Before submitting a ticket, use {% data variables.product.prodname_copilot_in_support %} to find an answer to your question. +Before submitting a ticket, use {% data variables.copilot.copilot_in_support %} to find an answer to your question. 1. Navigate to the "Get help with {% data variables.product.prodname_dotcom %}" form by clicking **Contact us** on the {% data variables.contact.contact_support_portal %}. 1. Fill out the form. -1. Under "How can we help you?", select **Chat with {% data variables.product.prodname_copilot_in_support %}**. +1. Under "How can we help you?", select **Chat with {% data variables.copilot.copilot_in_support %}**. - ![Screenshot of the "How can we help you?" form. "Chat with {% data variables.product.prodname_copilot_in_support %}" is highlighted in orange.](/assets/images/help/copilot/chat-with-copilot-in-support.png) + ![Screenshot of the "How can we help you?" form. "Chat with {% data variables.copilot.copilot_in_support %}" is highlighted in orange.](/assets/images/help/copilot/chat-with-copilot-in-support.png) 1. Click **Start chat**. {% data variables.product.prodname_copilot_short %} will respond to what you entered in the form. -If {% data variables.product.prodname_copilot_in_support %} solves your problem, click **My problem is solved!** or navigate away from the page. If {% data variables.product.prodname_copilot_in_support %} is not able to solve your issue, click **Create a ticket** and a ticket will be created that contains a summary of your conversation with {% data variables.product.prodname_copilot_short %} and a full transcript as an attachment to the comment. +If {% data variables.copilot.copilot_in_support %} solves your problem, click **My problem is solved!** or navigate away from the page. If {% data variables.copilot.copilot_in_support %} is not able to solve your issue, click **Create a ticket** and a ticket will be created that contains a summary of your conversation with {% data variables.product.prodname_copilot_short %} and a full transcript as an attachment to the comment. ## Best practices -When you chat with {% data variables.product.prodname_copilot_in_support %}, remember to provide comprehensive context in your question. Clearly state the specific area where you need assistance and include all relevant details, like error messages you've received, or the steps you've already taken. Describe your issue as if you were explaining it to a colleague or {% data variables.contact.github_support %}. If {% data variables.product.prodname_copilot_short %} misunderstands your query and gives an irrelevant answer, let it know about the error, and it will do its best to provide accurate information. You can even ask {% data variables.product.prodname_copilot_short %} to format its response in bullet points or any other readable format you prefer. +When you chat with {% data variables.copilot.copilot_in_support %}, remember to provide comprehensive context in your question. Clearly state the specific area where you need assistance and include all relevant details, like error messages you've received, or the steps you've already taken. Describe your issue as if you were explaining it to a colleague or {% data variables.contact.github_support %}. If {% data variables.product.prodname_copilot_short %} misunderstands your query and gives an irrelevant answer, let it know about the error, and it will do its best to provide accurate information. You can even ask {% data variables.product.prodname_copilot_short %} to format its response in bullet points or any other readable format you prefer. -## Sharing feedback about {% data variables.product.prodname_copilot_in_support %} +## Sharing feedback about {% data variables.copilot.copilot_in_support %} -We greatly value your feedback. As we continuously improve {% data variables.product.prodname_copilot_in_support %}, we value knowing which answers were helpful and which were not. To let us know, just click {% octicon "thumbsdown" aria-label="The thumbs down icon" %} accompanying the last response from {% data variables.product.prodname_copilot_short %}. +We greatly value your feedback. As we continuously improve {% data variables.copilot.copilot_in_support %}, we value knowing which answers were helpful and which were not. To let us know, just click {% octicon "thumbsdown" aria-label="The thumbs down icon" %} accompanying the last response from {% data variables.product.prodname_copilot_short %}. ## Further reading diff --git a/content/support/learning-about-github-support/about-copilot-in-github-support.md b/content/support/learning-about-github-support/about-copilot-in-github-support.md index 245f1364bc..2539643e6b 100644 --- a/content/support/learning-about-github-support/about-copilot-in-github-support.md +++ b/content/support/learning-about-github-support/about-copilot-in-github-support.md @@ -1,6 +1,6 @@ --- title: About Copilot in GitHub Support -intro: '{% data variables.product.prodname_copilot_in_support %} can help you by providing answers to a wide range of questions about {% data variables.product.prodname_dotcom %}''s products and features.' +intro: '{% data variables.copilot.copilot_in_support %} can help you by providing answers to a wide range of questions about {% data variables.product.prodname_dotcom %}''s products and features.' versions: fpt: '*' ghec: '*' @@ -11,57 +11,57 @@ shortTitle: About Copilot in GitHub Support type: rai --- -## About {% data variables.product.prodname_copilot_in_support %} +## About {% data variables.copilot.copilot_in_support %} -{% data variables.product.prodname_copilot_in_support %} is a new conversational AI tool built to offer immediate assistance within the {% data variables.contact.github_support %} portal, allowing you to tackle issues without waiting for a response from {% data variables.contact.github_support %}. {% data variables.product.prodname_copilot_in_support %} uses a large language model, trained on publicly available {% data variables.product.prodname_dotcom %} documentation, to provide a conversational way to get help for your {% data variables.product.prodname_dotcom %} inquiries without having to wait for customer support to respond to your inquiry. +{% data variables.copilot.copilot_in_support %} is a new conversational AI tool built to offer immediate assistance within the {% data variables.contact.github_support %} portal, allowing you to tackle issues without waiting for a response from {% data variables.contact.github_support %}. {% data variables.copilot.copilot_in_support %} uses a large language model, trained on publicly available {% data variables.product.prodname_dotcom %} documentation, to provide a conversational way to get help for your {% data variables.product.prodname_dotcom %} inquiries without having to wait for customer support to respond to your inquiry. -The primary supported language for {% data variables.product.prodname_copilot_in_support %} is English. +The primary supported language for {% data variables.copilot.copilot_in_support %} is English. -## How {% data variables.product.prodname_copilot_in_support %} works +## How {% data variables.copilot.copilot_in_support %} works -{% data variables.product.prodname_copilot_in_support %}'s functionality can be broken down into a few steps. +{% data variables.copilot.copilot_in_support %}'s functionality can be broken down into a few steps. ### Input processing -The input prompt from the user is pre-processed by {% data variables.product.prodname_copilot_in_support %} to determine whether it falls within the feature's remit and, if it does, sent to a large language model to generate a response based on the input. User input should take the form of a plain language description of their query. The system is only intended to respond to {% data variables.product.prodname_dotcom %}-related questions. +The input prompt from the user is pre-processed by {% data variables.copilot.copilot_in_support %} to determine whether it falls within the feature's remit and, if it does, sent to a large language model to generate a response based on the input. User input should take the form of a plain language description of their query. The system is only intended to respond to {% data variables.product.prodname_dotcom %}-related questions. ### Language model analysis -The input prompt is then passed through the {% data variables.product.prodname_copilot_in_support %} language model, which analyzes the input prompt. +The input prompt is then passed through the {% data variables.copilot.copilot_in_support %} language model, which analyzes the input prompt. ### Response generation -The language model generates a response based on its analysis of your input. This response will take the form of a plain language answer to your query. Depending on your question, {% data variables.product.prodname_copilot_in_support %} may include steps you can take to try to resolve the issue. +The language model generates a response based on its analysis of your input. This response will take the form of a plain language answer to your query. Depending on your question, {% data variables.copilot.copilot_in_support %} may include steps you can take to try to resolve the issue. ### Output formatting -The response generated by {% data variables.product.prodname_copilot_in_support %} is formatted and presented to the user. {% data variables.product.prodname_copilot_in_support %} may use indentation and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to relevant content in {% data variables.product.prodname_dotcom %} documentation that the model used to generate its response will also be provided. +The response generated by {% data variables.copilot.copilot_in_support %} is formatted and presented to the user. {% data variables.copilot.copilot_in_support %} may use indentation and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to relevant content in {% data variables.product.prodname_dotcom %} documentation that the model used to generate its response will also be provided. -## Limitations of {% data variables.product.prodname_copilot_in_support %} +## Limitations of {% data variables.copilot.copilot_in_support %} -Depending on factors such as your input prompt and the complexity of your issue, you may experience different levels of performance when using {% data variables.product.prodname_copilot_in_support %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.product.prodname_copilot_in_support %}. +Depending on factors such as your input prompt and the complexity of your issue, you may experience different levels of performance when using {% data variables.copilot.copilot_in_support %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.copilot.copilot_in_support %}. ### Limited scope -{% data variables.product.prodname_copilot_in_support %} is only intended to answer questions related to {% data variables.product.prodname_dotcom %}'s products. {% data variables.product.prodname_copilot_in_support %} is not designed to provide general programming assistance. In addition, it may not be able to help with more complex issues related to your {% data variables.product.prodname_dotcom %} account, for example, resolving billing issues. If {% data variables.product.prodname_copilot_in_support %} cannot help with a GitHub-related issue, you will be prompted to open a ticket with our support team. +{% data variables.copilot.copilot_in_support %} is only intended to answer questions related to {% data variables.product.prodname_dotcom %}'s products. {% data variables.copilot.copilot_in_support %} is not designed to provide general programming assistance. In addition, it may not be able to help with more complex issues related to your {% data variables.product.prodname_dotcom %} account, for example, resolving billing issues. If {% data variables.copilot.copilot_in_support %} cannot help with a GitHub-related issue, you will be prompted to open a ticket with our support team. ### Inaccurate responses -The responses you receive from {% data variables.product.prodname_copilot_in_support %} are generated by AI without human intervention and, as such, may not always be accurate. Ensure the answer you have received is accurate by checking the official {% data variables.product.prodname_dotcom %} documentation. +The responses you receive from {% data variables.copilot.copilot_in_support %} are generated by AI without human intervention and, as such, may not always be accurate. Ensure the answer you have received is accurate by checking the official {% data variables.product.prodname_dotcom %} documentation. ### Information only assistance -Currently, {% data variables.product.prodname_copilot_in_support %} cannot take action on your behalf, for example, by changing your settings. {% data variables.product.prodname_copilot_in_support %} can only provide steps for you to configure or troubleshoot a {% data variables.product.prodname_dotcom %} product based on {% data variables.product.prodname_dotcom %} official documentation. +Currently, {% data variables.copilot.copilot_in_support %} cannot take action on your behalf, for example, by changing your settings. {% data variables.copilot.copilot_in_support %} can only provide steps for you to configure or troubleshoot a {% data variables.product.prodname_dotcom %} product based on {% data variables.product.prodname_dotcom %} official documentation. ## Best practices and use cases -{% data variables.product.prodname_copilot_in_support %} is intended to answer your query related to {% data variables.product.prodname_dotcom %} products from {% data variables.product.prodname_dotcom %} documentation. More information provided in your input increases {% data variables.product.prodname_copilot_in_support %}'s likelihood of providing a relevant and helpful response that may also include best practices, tips, and solutions. {% data variables.product.prodname_copilot_in_support %} consolidates information from multiple {% data variables.product.prodname_dotcom %} documents into a tailored response, and may reduce the time required to answer your question. If you have a follow-up question or another {% data variables.product.prodname_dotcom %}-related query, you can continue using {% data variables.product.prodname_copilot_in_support %}. +{% data variables.copilot.copilot_in_support %} is intended to answer your query related to {% data variables.product.prodname_dotcom %} products from {% data variables.product.prodname_dotcom %} documentation. More information provided in your input increases {% data variables.copilot.copilot_in_support %}'s likelihood of providing a relevant and helpful response that may also include best practices, tips, and solutions. {% data variables.copilot.copilot_in_support %} consolidates information from multiple {% data variables.product.prodname_dotcom %} documents into a tailored response, and may reduce the time required to answer your question. If you have a follow-up question or another {% data variables.product.prodname_dotcom %}-related query, you can continue using {% data variables.copilot.copilot_in_support %}. -{% data variables.product.prodname_copilot_in_support %} also includes links to any documentation it uses when crafting an answer so that you're able to review the material or bookmark it for future reference. As with every large language model, it can make mistakes so please review the information provided to ensure it is free of errors. +{% data variables.copilot.copilot_in_support %} also includes links to any documentation it uses when crafting an answer so that you're able to review the material or bookmark it for future reference. As with every large language model, it can make mistakes so please review the information provided to ensure it is free of errors. -## Sharing feedback about {% data variables.product.prodname_copilot_in_support %} +## Sharing feedback about {% data variables.copilot.copilot_in_support %} -We greatly value your feedback. As we continuously improve {% data variables.product.prodname_copilot_in_support %}, we value knowing which answers were helpful and which were not. To let us know, just click the thumbs down under the corresponding response from {% data variables.product.prodname_copilot_short %}. +We greatly value your feedback. As we continuously improve {% data variables.copilot.copilot_in_support %}, we value knowing which answers were helpful and which were not. To let us know, just click the thumbs down under the corresponding response from {% data variables.product.prodname_copilot_short %}. ## Further reading diff --git a/content/support/learning-about-github-support/about-github-support.md b/content/support/learning-about-github-support/about-github-support.md index 6538d03359..0f3ec71449 100644 --- a/content/support/learning-about-github-support/about-github-support.md +++ b/content/support/learning-about-github-support/about-github-support.md @@ -109,9 +109,9 @@ Enterprise owners can also add support entitlements to members of organizations {% endif %} -## About {% data variables.product.prodname_copilot_in_support %} +## About {% data variables.copilot.copilot_in_support %} -You can receive answers to questions relating to {% data variables.product.github %}'s products and features before submitting a support ticket by using {% data variables.product.prodname_copilot_in_support %}. {% data variables.product.prodname_copilot_in_support %} is an AI-powered tool that uses a large language model to find answers to a wide variety of support queries. If {% data variables.product.prodname_copilot_in_support %} cannot answer your question, You can proceed with submitting your ticket to {% data variables.contact.github_support %}. For more information, see [AUTOTITLE](/support/learning-about-github-support/about-copilot-in-github-support). +You can receive answers to questions relating to {% data variables.product.github %}'s products and features before submitting a support ticket by using {% data variables.copilot.copilot_in_support %}. {% data variables.copilot.copilot_in_support %} is an AI-powered tool that uses a large language model to find answers to a wide variety of support queries. If {% data variables.copilot.copilot_in_support %} cannot answer your question, You can proceed with submitting your ticket to {% data variables.contact.github_support %}. For more information, see [AUTOTITLE](/support/learning-about-github-support/about-copilot-in-github-support). {% ifversion fpt or ghec %} diff --git a/data/reusables/code-scanning/codeql-query-tables/actions.md b/data/reusables/code-scanning/codeql-query-tables/actions.md index e253dca9dd..19608e8e04 100644 --- a/data/reusables/code-scanning/codeql-query-tables/actions.md +++ b/data/reusables/code-scanning/codeql-query-tables/actions.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [Artifact poisoning](https://codeql.github.com/codeql-query-help/actions/actions-artifact-poisoning-critical/) | 829 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Cache Poisoning via caching of untrusted files](https://codeql.github.com/codeql-query-help/actions/actions-cache-poisoning-direct-cache/) | 349 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/cpp.md b/data/reusables/code-scanning/codeql-query-tables/cpp.md index edcaf1a60d..b2377b166a 100644 --- a/data/reusables/code-scanning/codeql-query-tables/cpp.md +++ b/data/reusables/code-scanning/codeql-query-tables/cpp.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [Bad check for overflow of integer addition](https://codeql.github.com/codeql-query-help/cpp/cpp-bad-addition-overflow-check/) | 190, 192 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Badly bounded write](https://codeql.github.com/codeql-query-help/cpp/cpp-badly-bounded-write/) | 120, 787, 805 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/csharp.md b/data/reusables/code-scanning/codeql-query-tables/csharp.md index b44d01241c..b707990696 100644 --- a/data/reusables/code-scanning/codeql-query-tables/csharp.md +++ b/data/reusables/code-scanning/codeql-query-tables/csharp.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | ['requireSSL' attribute is not set to true](https://codeql.github.com/codeql-query-help/csharp/cs-web-requiressl-not-set/) | 319, 614 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Arbitrary file access during archive extraction ("Zip Slip")](https://codeql.github.com/codeql-query-help/csharp/cs-zipslip/) | 022 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/go.md b/data/reusables/code-scanning/codeql-query-tables/go.md index 2c8a20f5ad..9e64ab1176 100644 --- a/data/reusables/code-scanning/codeql-query-tables/go.md +++ b/data/reusables/code-scanning/codeql-query-tables/go.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [Arbitrary file access during archive extraction ("Zip Slip")](https://codeql.github.com/codeql-query-help/go/go-zipslip/) | 022 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Arbitrary file write extracting an archive containing symbolic links](https://codeql.github.com/codeql-query-help/go/go-unsafe-unzip-symlink/) | 022 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/java.md b/data/reusables/code-scanning/codeql-query-tables/java.md index 5b26be51fc..25ab8a7bdf 100644 --- a/data/reusables/code-scanning/codeql-query-tables/java.md +++ b/data/reusables/code-scanning/codeql-query-tables/java.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [`TrustManager` that accepts all certificates](https://codeql.github.com/codeql-query-help/java/java-insecure-trustmanager/) | 295 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Android `WebView` that accepts all certificates](https://codeql.github.com/codeql-query-help/java/java-improper-webview-certificate-validation/) | 295 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/javascript.md b/data/reusables/code-scanning/codeql-query-tables/javascript.md index 35d5279faa..f5bbc47d2a 100644 --- a/data/reusables/code-scanning/codeql-query-tables/javascript.md +++ b/data/reusables/code-scanning/codeql-query-tables/javascript.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [Arbitrary file access during archive extraction ("Zip Slip")](https://codeql.github.com/codeql-query-help/javascript/js-zipslip/) | 022 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Bad HTML filtering regexp](https://codeql.github.com/codeql-query-help/javascript/js-bad-tag-filter/) | 020, 080, 116, 184, 185, 186 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/python.md b/data/reusables/code-scanning/codeql-query-tables/python.md index 80e5b1e092..a30de7580a 100644 --- a/data/reusables/code-scanning/codeql-query-tables/python.md +++ b/data/reusables/code-scanning/codeql-query-tables/python.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | ['input' function used in Python 2](https://codeql.github.com/codeql-query-help/python/py-use-of-input/) | 094, 095 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Accepting unknown SSH host keys when using Paramiko](https://codeql.github.com/codeql-query-help/python/py-paramiko-missing-host-key-validation/) | 295 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/ruby.md b/data/reusables/code-scanning/codeql-query-tables/ruby.md index 459bd97aad..6ceb80d986 100644 --- a/data/reusables/code-scanning/codeql-query-tables/ruby.md +++ b/data/reusables/code-scanning/codeql-query-tables/ruby.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [Bad HTML filtering regexp](https://codeql.github.com/codeql-query-help/ruby/rb-bad-tag-filter/) | 116, 020, 185, 186 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Badly anchored regular expression](https://codeql.github.com/codeql-query-help/ruby/rb-regex-badly-anchored-regexp/) | 020 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/code-scanning/codeql-query-tables/swift.md b/data/reusables/code-scanning/codeql-query-tables/swift.md index 6ac6809da5..e814949dae 100644 --- a/data/reusables/code-scanning/codeql-query-tables/swift.md +++ b/data/reusables/code-scanning/codeql-query-tables/swift.md @@ -1,6 +1,6 @@ {% rowheaders %} -| Query name | Related CWEs | Default | Extended | {% data variables.product.prodname_copilot_autofix_short %} | +| Query name | Related CWEs | Default | Extended | {% data variables.copilot.copilot_autofix_short %} | | --- | --- | --- | --- | --- | | [Bad HTML filtering regexp](https://codeql.github.com/codeql-query-help/swift/swift-bad-tag-filter/) | 116, 020, 185, 186 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | [Cleartext logging of sensitive information](https://codeql.github.com/codeql-query-help/swift/swift-cleartext-logging/) | 312, 359, 532 | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/copilot-business-for-non-ghe/assign-licenses.md b/data/reusables/copilot-business-for-non-ghe/assign-licenses.md index ff24c468b1..dbce2dee8f 100644 --- a/data/reusables/copilot-business-for-non-ghe/assign-licenses.md +++ b/data/reusables/copilot-business-for-non-ghe/assign-licenses.md @@ -2,9 +2,9 @@ When you have created a team in the enterprise, you can assign licenses to all m {% data reusables.billing.enterprise-billing-menu %} 1. Under **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**, click **Licensing**. -1. In the "{% data variables.product.prodname_copilot_business_short %}" section, click **Manage seats**. +1. In the "{% data variables.copilot.copilot_business_short %}" section, click **Manage seats**. - ![Screenshot of the "{% data variables.product.prodname_copilot_business_short %}" section. A button, labeled "Manage seats", is highlighted with an orange outline.](/assets/images/help/copilot/copilot-business-manage-seats.png) + ![Screenshot of the "{% data variables.copilot.copilot_business_short %}" section. A button, labeled "Manage seats", is highlighted with an orange outline.](/assets/images/help/copilot/copilot-business-manage-seats.png) 1. Click **Add teams**. 1. In the dialog, select the teams you want to add, review how your bill will be affected, then click **Add teams**. diff --git a/data/reusables/copilot-business-for-non-ghe/enable-copilot.md b/data/reusables/copilot-business-for-non-ghe/enable-copilot.md index af28fff45a..949b380923 100644 --- a/data/reusables/copilot-business-for-non-ghe/enable-copilot.md +++ b/data/reusables/copilot-business-for-non-ghe/enable-copilot.md @@ -4,4 +4,4 @@ Before you can assign licenses, an **enterprise owner** must enable {% data vari {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.copilot-tab %} 1. Under "{% data variables.product.prodname_copilot %} policies", click **Allowed**, then click **Save**. -1. Review the policies for suggestions matching public code and {% data variables.product.prodname_copilot_chat_short %}, and update the dropdown menus to enable or disable the features as required. +1. Review the policies for suggestions matching public code and {% data variables.copilot.copilot_chat_short %}, and update the dropdown menus to enable or disable the features as required. diff --git a/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md b/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md index 36dba45cf7..d32d2bc072 100644 --- a/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md +++ b/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md @@ -1,4 +1,4 @@ -For next steps that apply to any enterprise using {% data variables.product.prodname_copilot_business_short %}, see [AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise). The step for granting access to organizations does not apply. +For next steps that apply to any enterprise using {% data variables.copilot.copilot_business_short %}, see [AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise). The step for granting access to organizations does not apply. The following sections contain specific information for your enterprise. diff --git a/data/reusables/copilot/about-code-referencing.md b/data/reusables/copilot/about-code-referencing.md index f0db327002..19be362ec7 100644 --- a/data/reusables/copilot/about-code-referencing.md +++ b/data/reusables/copilot/about-code-referencing.md @@ -1,4 +1,4 @@ If you've allowed suggestions that match public code, {% data variables.product.prodname_copilot %} can provide you with details of the code that a suggestion matches. This happens: * When you accept a code completion suggestion in the editor. -* When a response in {% data variables.product.prodname_copilot_chat_short %} includes matching code. +* When a response in {% data variables.copilot.copilot_chat_short %} includes matching code. diff --git a/data/reusables/copilot/about-copilot-enhancements.md b/data/reusables/copilot/about-copilot-enhancements.md index 221259049b..000c11335c 100644 --- a/data/reusables/copilot/about-copilot-enhancements.md +++ b/data/reusables/copilot/about-copilot-enhancements.md @@ -1,3 +1,3 @@ ## About {% data variables.product.prodname_copilot %} enhancements -You can enhance your experience of {% data variables.product.prodname_copilot_chat_short %} with a variety of commands and options. Finding the right command or option for the task you are working on can help you achieve your goals more efficiently. This cheat sheet provides a quick reference to the most common commands and options for using {% data variables.product.prodname_copilot_chat_short %}. +You can enhance your experience of {% data variables.copilot.copilot_chat_short %} with a variety of commands and options. Finding the right command or option for the task you are working on can help you achieve your goals more efficiently. This cheat sheet provides a quick reference to the most common commands and options for using {% data variables.copilot.copilot_chat_short %}. diff --git a/data/reusables/copilot/ce-product-callout.md b/data/reusables/copilot/ce-product-callout.md index 8f2994554e..9597e035ef 100644 --- a/data/reusables/copilot/ce-product-callout.md +++ b/data/reusables/copilot/ce-product-callout.md @@ -1 +1 @@ -Organizations with a {% data variables.product.prodname_copilot_enterprise_short %} plan +Organizations with a {% data variables.copilot.copilot_enterprise_short %} plan diff --git a/data/reusables/copilot/chat-about-specific-lines.md b/data/reusables/copilot/chat-about-specific-lines.md index 1b10533821..7e453e981d 100644 --- a/data/reusables/copilot/chat-about-specific-lines.md +++ b/data/reusables/copilot/chat-about-specific-lines.md @@ -7,7 +7,7 @@ * To ask a question about **specific lines** within the file: 1. Click the line number for the first line you want to ask about, hold down Shift, then click the line number for the last line you want to select. - 1. To ask your own question about the selected lines, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) to the right of your selection, then type your question in the {% data variables.product.prodname_copilot_chat %} panel. + 1. To ask your own question about the selected lines, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) to the right of your selection, then type your question in the {% data variables.copilot.copilot_chat %} panel. 1. To ask a predefined question, click the drop-down menu beside the {% data variables.product.prodname_copilot_short %} icon, then choose one of the options. ![Screenshot of the {% data variables.product.prodname_copilot_short %} buttons, highlighted with a dark orange outline, to the right of some selected code.](/assets/images/help/copilot/copilot-buttons-inline-code.png) diff --git a/data/reusables/copilot/chat-access-denied.md b/data/reusables/copilot/chat-access-denied.md index 9353a5333e..7fc61553e2 100644 --- a/data/reusables/copilot/chat-access-denied.md +++ b/data/reusables/copilot/chat-access-denied.md @@ -1 +1 @@ -If you have access to {% data variables.product.prodname_copilot %} via your organization{% ifversion ghec %} or enterprise{% endif %}, you won't be able to use {% data variables.product.prodname_copilot_chat %} if your organization owner{% ifversion ghec %} or enterprise administrator{% endif %} has disabled chat. See [AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization). +If you have access to {% data variables.product.prodname_copilot %} via your organization{% ifversion ghec %} or enterprise{% endif %}, you won't be able to use {% data variables.copilot.copilot_chat %} if your organization owner{% ifversion ghec %} or enterprise administrator{% endif %} has disabled chat. See [AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization). diff --git a/data/reusables/copilot/chat-model-limitations-ide.md b/data/reusables/copilot/chat-model-limitations-ide.md index ae7884fd9d..e4a8889baf 100644 --- a/data/reusables/copilot/chat-model-limitations-ide.md +++ b/data/reusables/copilot/chat-model-limitations-ide.md @@ -1,4 +1,4 @@ > [!NOTE] > -> * If you use {% data variables.product.prodname_copilot_extensions_short %}, they may override the model you select. +> * If you use {% data variables.copilot.copilot_extensions_short %}, they may override the model you select. > * Experimental pre-release versions of the models may not interact with all filters correctly, including the duplication detection filter. diff --git a/data/reusables/copilot/claude-opus-public-preview-note.md b/data/reusables/copilot/claude-opus-public-preview-note.md index 337f92233c..4c19e6a90a 100644 --- a/data/reusables/copilot/claude-opus-public-preview-note.md +++ b/data/reusables/copilot/claude-opus-public-preview-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> {% data variables.copilot.copilot_claude_opus %} in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. +> {% data variables.copilot.copilot_claude_opus %} in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/claude-public-preview-note.md b/data/reusables/copilot/claude-public-preview-note.md index 73cbe34e8d..a85f1739dd 100644 --- a/data/reusables/copilot/claude-public-preview-note.md +++ b/data/reusables/copilot/claude-public-preview-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> {% data variables.copilot.copilot_claude_opus %} and {% data variables.copilot.copilot_claude_sonnet_40 %} in {% data variables.product.prodname_copilot_chat_short %} are currently in {% data variables.release-phases.public_preview %} and subject to change. +> {% data variables.copilot.copilot_claude_opus %} and {% data variables.copilot.copilot_claude_sonnet_40 %} in {% data variables.copilot.copilot_chat_short %} are currently in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/claude-sonnet-40-public-preview-note.md b/data/reusables/copilot/claude-sonnet-40-public-preview-note.md index fd56e6962e..3e81a35b69 100644 --- a/data/reusables/copilot/claude-sonnet-40-public-preview-note.md +++ b/data/reusables/copilot/claude-sonnet-40-public-preview-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> {% data variables.copilot.copilot_claude_sonnet_40 %} in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. +> {% data variables.copilot.copilot_claude_sonnet_40 %} in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/code-referencing-in-chat.md b/data/reusables/copilot/code-referencing-in-chat.md index ce3d1bbbc1..5644bd0ebe 100644 --- a/data/reusables/copilot/code-referencing-in-chat.md +++ b/data/reusables/copilot/code-referencing-in-chat.md @@ -1 +1 @@ -When {% data variables.product.prodname_copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated at the end of the response with a link to display details of the matched code in the editor. +When {% data variables.copilot.copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated at the end of the response with a link to display details of the matched code in the editor. diff --git a/data/reusables/copilot/code-review/custom-coding-guidelines-prerequisites.md b/data/reusables/copilot/code-review/custom-coding-guidelines-prerequisites.md index 61a4e8fae2..70057ab48a 100644 --- a/data/reusables/copilot/code-review/custom-coding-guidelines-prerequisites.md +++ b/data/reusables/copilot/code-review/custom-coding-guidelines-prerequisites.md @@ -1 +1 @@ -> [!NOTE] The custom coding guidelines feature is only available with the {% data variables.product.prodname_copilot_enterprise_short %} plan, and is currently limited to selected customers. +> [!NOTE] The custom coding guidelines feature is only available with the {% data variables.copilot.copilot_enterprise_short %} plan, and is currently limited to selected customers. diff --git a/data/reusables/copilot/coding-agent-settings.md b/data/reusables/copilot/coding-agent-settings.md index 42342391c9..f68fdb93d0 100644 --- a/data/reusables/copilot/coding-agent-settings.md +++ b/data/reusables/copilot/coding-agent-settings.md @@ -1 +1 @@ -1. In the sidebar, under "Code, planning, and automation", click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**, and then click **{% data variables.copilot.coding_agent_UI %}**. +1. In the sidebar, under "Code, planning, and automation", click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**, and then click **{% data variables.copilot.copilot_agent_short %}**. diff --git a/data/reusables/copilot/coding-agent/use-chat-participant-in-vsc.md b/data/reusables/copilot/coding-agent/use-chat-participant-in-vsc.md index b7651d428f..a2b2566662 100644 --- a/data/reusables/copilot/coding-agent/use-chat-participant-in-vsc.md +++ b/data/reusables/copilot/coding-agent/use-chat-participant-in-vsc.md @@ -1 +1 @@ -In {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_vs %}, and JetBrains IDEs, you must mention the `@github` chat participant in your prompt. You can omit this in {% data variables.product.prodname_copilot_chat_short %} on {% data variables.product.prodname_dotcom_the_website %}. +In {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_vs %}, and JetBrains IDEs, you must mention the `@github` chat participant in your prompt. You can omit this in {% data variables.copilot.copilot_chat_short %} on {% data variables.product.prodname_dotcom_the_website %}. diff --git a/data/reusables/copilot/copilot-edits/about-copilot-edits.md b/data/reusables/copilot/copilot-edits/about-copilot-edits.md index 1bddf3d7f9..4ba5780550 100644 --- a/data/reusables/copilot/copilot-edits/about-copilot-edits.md +++ b/data/reusables/copilot/copilot-edits/about-copilot-edits.md @@ -1,4 +1,4 @@ -Use {% data variables.product.prodname_copilot_edits_short %} to make changes across multiple files directly from a single {% data variables.product.prodname_copilot_chat_short %} prompt. {% data variables.product.prodname_copilot_edits_short %} has the following modes: +Use {% data variables.copilot.copilot_edits_short %} to make changes across multiple files directly from a single {% data variables.copilot.copilot_chat_short %} prompt. {% data variables.copilot.copilot_edits_short %} has the following modes: * {% data reusables.copilot.copilot-edits.edit-mode-description %} Edit mode is only available in {% data variables.product.prodname_vscode %} and JetBrains IDEs. * {% data reusables.copilot.copilot-edits.agent-mode-description %} Agent mode is only available in {% data variables.product.prodname_vscode %} and {% data variables.product.prodname_vs %}. diff --git a/data/reusables/copilot/copilot-edits/agent-mode-requests.md b/data/reusables/copilot/copilot-edits/agent-mode-requests.md index c11becd958..e7e0dc9c0d 100644 --- a/data/reusables/copilot/copilot-edits/agent-mode-requests.md +++ b/data/reusables/copilot/copilot-edits/agent-mode-requests.md @@ -1 +1 @@ -When you use {% data variables.product.prodname_copilot_agent_short %} mode, {% data variables.product.prodname_copilot_short %} may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions {% data variables.product.prodname_copilot_short %} takes on your behalf. The total premium requests used will depend on the complexity of the task, the number of steps involved, and the model selected. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/monitoring-usage-and-entitlements/avoiding-unexpected-copilot-costs). +When you use {% data variables.copilot.copilot_agent_short %} mode, {% data variables.product.prodname_copilot_short %} may make multiple premium requests to complete a single task. This includes both user-initiated prompts and follow-up actions {% data variables.product.prodname_copilot_short %} takes on your behalf. The total premium requests used will depend on the complexity of the task, the number of steps involved, and the model selected. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/monitoring-usage-and-entitlements/avoiding-unexpected-copilot-costs). diff --git a/data/reusables/copilot/copilot-extensions/about-extensions-permissions.md b/data/reusables/copilot/copilot-extensions/about-extensions-permissions.md index 0e3588f2cf..e508f11a3d 100644 --- a/data/reusables/copilot/copilot-extensions/about-extensions-permissions.md +++ b/data/reusables/copilot/copilot-extensions/about-extensions-permissions.md @@ -1,6 +1,6 @@ Permissions vary by extension, depending on the level of authorization that the extension requires in order to respond to your query. You can view the required permissions on the extension’s installation page, located after the billing information step and before the install and authorize step. -**For developers**: At a minimum, the **{% data variables.product.prodname_copilot_chat_short %}** permissions must be set to "Read-only". Additional permissions may include executing write actions on other surfaces and authorizing read access to repository and organization level data in {% data variables.product.github %}. +**For developers**: At a minimum, the **{% data variables.copilot.copilot_chat_short %}** permissions must be set to "Read-only". Additional permissions may include executing write actions on other surfaces and authorizing read access to repository and organization level data in {% data variables.product.github %}. **For builders**: In addition to the above, you may also request local context from a user’s editor to further tailor responses. To do so, the **{% data variables.product.prodname_copilot_short %} Editor Context** permissions must be set to "Read-only". Users will be notified to provide the required authorization. diff --git a/data/reusables/copilot/copilot-extensions/account-permissions.md b/data/reusables/copilot/copilot-extensions/account-permissions.md index e5db65d9d8..bcf7ae3531 100644 --- a/data/reusables/copilot/copilot-extensions/account-permissions.md +++ b/data/reusables/copilot/copilot-extensions/account-permissions.md @@ -1,3 +1,3 @@ -1. In the "{% data variables.product.prodname_copilot_chat %}" row, select the **Access:** dropdown menu, then click **Read-only**. +1. In the "{% data variables.copilot.copilot_chat %}" row, select the **Access:** dropdown menu, then click **Read-only**. 1. To enable context passing, in the "{% data variables.product.prodname_copilot_short %} Editor Context" row, select the **Access:** dropdown menu, then click **Read-only**. For more information about context passing, see [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/context-passing-for-your-agent). 1. Click **Save changes**. diff --git a/data/reusables/copilot/copilot-extensions/agents-copilot-platform-prerequisites.md b/data/reusables/copilot/copilot-extensions/agents-copilot-platform-prerequisites.md index b391146150..0e3856998d 100644 --- a/data/reusables/copilot/copilot-extensions/agents-copilot-platform-prerequisites.md +++ b/data/reusables/copilot/copilot-extensions/agents-copilot-platform-prerequisites.md @@ -1 +1 @@ -Before you configure your {% data variables.product.prodname_copilot_agent_short %} to communicate with {% data variables.product.github %}, you should understand how your {% data variables.product.prodname_copilot_agent_short %} communicates with the {% data variables.product.prodname_copilot_short %} platform. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform). +Before you configure your {% data variables.copilot.copilot_agent_short %} to communicate with {% data variables.product.github %}, you should understand how your {% data variables.copilot.copilot_agent_short %} communicates with the {% data variables.product.prodname_copilot_short %} platform. See [AUTOTITLE](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-the-copilot-platform). diff --git a/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md b/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md index 657664cdd0..f2795fc67e 100644 --- a/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md +++ b/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md @@ -1 +1 @@ -{% data variables.product.prodname_copilot_extensions %} are **a type of {% data variables.product.prodname_github_app %} that integrates the power of external tools into {% data variables.product.prodname_copilot_chat %}**. {% data variables.product.prodname_copilot_extensions_short %} can be developed by anyone, for private or public use, and can be shared with others through the {% data variables.product.prodname_marketplace %}. +{% data variables.copilot.copilot_extensions %} are **a type of {% data variables.product.prodname_github_app %} that integrates the power of external tools into {% data variables.copilot.copilot_chat %}**. {% data variables.copilot.copilot_extensions_short %} can be developed by anyone, for private or public use, and can be shared with others through the {% data variables.product.prodname_marketplace %}. diff --git a/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md b/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md index 19e500aceb..0b0c6527f2 100644 --- a/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md +++ b/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md @@ -1 +1 @@ -{% data variables.product.prodname_copilot_extensions_short %} are a type of {% data variables.product.prodname_github_app %} that you can install on your {% data variables.product.prodname_dotcom %} account, to add additional capabilities to {% data variables.product.prodname_copilot_short %}. +{% data variables.copilot.copilot_extensions_short %} are a type of {% data variables.product.prodname_github_app %} that you can install on your {% data variables.product.prodname_dotcom %} account, to add additional capabilities to {% data variables.product.prodname_copilot_short %}. diff --git a/data/reusables/copilot/copilot-extensions/differences-between-agents-and-skillsets-1.md b/data/reusables/copilot/copilot-extensions/differences-between-agents-and-skillsets-1.md index bc331bfa22..e06ab31ffc 100644 --- a/data/reusables/copilot/copilot-extensions/differences-between-agents-and-skillsets-1.md +++ b/data/reusables/copilot/copilot-extensions/differences-between-agents-and-skillsets-1.md @@ -1,2 +1,2 @@ -Skillsets and agents are the two ways to extend {% data variables.product.prodname_copilot_short %}'s capabilities and context through the {% data variables.product.prodname_copilot_extensibility_platform_short %}. They let you integrate external services and APIs into {% data variables.product.prodname_copilot_chat_short %}, but each one serves different use cases and offers different levels of control and complexity: +Skillsets and agents are the two ways to extend {% data variables.product.prodname_copilot_short %}'s capabilities and context through the {% data variables.copilot.copilot_extensibility_platform_short %}. They let you integrate external services and APIs into {% data variables.copilot.copilot_chat_short %}, but each one serves different use cases and offers different levels of control and complexity: * **Skillsets** are lightweight and streamlined, designed for developers who need {% data variables.product.prodname_copilot_short %} to perform specific tasks (e.g., data retrieval or simple operations) with minimal setup. They handle routing, prompt crafting, function evaluation, and response generation automatically, making them ideal for quick and straightforward integrations. diff --git a/data/reusables/copilot/copilot-extensions/extending-copilot-chat.md b/data/reusables/copilot/copilot-extensions/extending-copilot-chat.md index b5c6e388d0..fac972bda0 100644 --- a/data/reusables/copilot/copilot-extensions/extending-copilot-chat.md +++ b/data/reusables/copilot/copilot-extensions/extending-copilot-chat.md @@ -1,4 +1,4 @@ -{% data variables.product.prodname_copilot_extensions %} integrate the power of external tools into {% data variables.product.prodname_copilot_chat_short %}, helping you reduce context switching and receive responses with domain-specific context. You can install {% data variables.product.prodname_copilot_extensions_short %} from the {% data variables.product.prodname_marketplace %} or build private ones within your organization, then type `@` in a chat window to see a list of your available extensions. To use an extension, select the extension from the list or type the full slug name, then type your prompt. +{% data variables.copilot.copilot_extensions %} integrate the power of external tools into {% data variables.copilot.copilot_chat_short %}, helping you reduce context switching and receive responses with domain-specific context. You can install {% data variables.copilot.copilot_extensions_short %} from the {% data variables.product.prodname_marketplace %} or build private ones within your organization, then type `@` in a chat window to see a list of your available extensions. To use an extension, select the extension from the list or type the full slug name, then type your prompt. To learn more, see [AUTOTITLE](/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat). diff --git a/data/reusables/copilot/copilot-extensions/extension-specific-onboarding-steps.md b/data/reusables/copilot/copilot-extensions/extension-specific-onboarding-steps.md index a00f1d65f3..6f96ffa461 100644 --- a/data/reusables/copilot/copilot-extensions/extension-specific-onboarding-steps.md +++ b/data/reusables/copilot/copilot-extensions/extension-specific-onboarding-steps.md @@ -1 +1 @@ -1. After installing a {% data variables.product.prodname_copilot_extension_short %}, you need to complete the authentication and onboarding steps unique to that extension. Visit the extension's marketplace listing page or the developer's documentation to complete the necessary steps. +1. After installing a {% data variables.copilot.copilot_extension_short %}, you need to complete the authentication and onboarding steps unique to that extension. Visit the extension's marketplace listing page or the developer's documentation to complete the necessary steps. diff --git a/data/reusables/copilot/copilot-extensions/supported-clients-and-ides-table.md b/data/reusables/copilot/copilot-extensions/supported-clients-and-ides-table.md index 7664394589..9fcae8d6a4 100644 --- a/data/reusables/copilot/copilot-extensions/supported-clients-and-ides-table.md +++ b/data/reusables/copilot/copilot-extensions/supported-clients-and-ides-table.md @@ -1,4 +1,4 @@ -| Clients and IDEs | {% data variables.product.prodname_copilot_extensions %} support | +| Clients and IDEs | {% data variables.copilot.copilot_extensions %} support | |----------------------------------------------------------|:----------------------------------------------------------------:| | {% data variables.product.prodname_vscode %} | {% octicon "check" aria-label="Supported" %} | | {% data variables.product.prodname_vs %} | {% octicon "check" aria-label="Supported" %} | @@ -7,5 +7,5 @@ | JetBrains IDEs | {% octicon "check" aria-label="Supported" %} | | {% data variables.product.prodname_github_codespaces %} | {% octicon "x" aria-label="Unsupported" %} | | Vim/Neovim | {% octicon "x" aria-label="Unsupported" %} | -| {% data variables.product.prodname_copilot_cli_short %} | {% octicon "x" aria-label="Unsupported" %} | +| {% data variables.copilot.copilot_cli_short %} | {% octicon "x" aria-label="Unsupported" %} | | Xcode | {% octicon "x" aria-label="Unsupported" %} | diff --git a/data/reusables/copilot/copilot-one-account-short.md b/data/reusables/copilot/copilot-one-account-short.md index 2ffdbbe435..00e64db64d 100644 --- a/data/reusables/copilot/copilot-one-account-short.md +++ b/data/reusables/copilot/copilot-one-account-short.md @@ -1 +1 @@ -If you have an active {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan, and are then assigned a seat as part of a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, your personal {% data variables.product.prodname_copilot_short %} plan will be automatically canceled. +If you have an active {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, and are then assigned a seat as part of a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, your personal {% data variables.product.prodname_copilot_short %} plan will be automatically canceled. diff --git a/data/reusables/copilot/copilot-one-account.md b/data/reusables/copilot/copilot-one-account.md index 18a58aa64b..7be60b1917 100644 --- a/data/reusables/copilot/copilot-one-account.md +++ b/data/reusables/copilot/copilot-one-account.md @@ -1 +1 @@ -If you have an active {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} plan, and are then assigned a seat as part of a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, your personal {% data variables.product.prodname_copilot_short %} plan will be automatically canceled. You will receive a prorated refund for any remaining portion of your personal plan's current billing cycle. You will then be able to continue using {% data variables.product.prodname_copilot_short %} according to the policies set by your company. +If you have an active {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, and are then assigned a seat as part of a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, your personal {% data variables.product.prodname_copilot_short %} plan will be automatically canceled. You will receive a prorated refund for any remaining portion of your personal plan's current billing cycle. You will then be able to continue using {% data variables.product.prodname_copilot_short %} according to the policies set by your company. diff --git a/data/reusables/copilot/copilot-spaces/preview-note.md b/data/reusables/copilot/copilot-spaces/preview-note.md index 6c580a7b65..ea5a2e5591 100644 --- a/data/reusables/copilot/copilot-spaces/preview-note.md +++ b/data/reusables/copilot/copilot-spaces/preview-note.md @@ -1 +1 @@ ->[!NOTE] {% data variables.product.prodname_copilot_spaces %} is in {% data variables.release-phases.public_preview %} and subject to change. +>[!NOTE] {% data variables.copilot.copilot_spaces %} is in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/custom-instructions-interactions-note.md b/data/reusables/copilot/custom-instructions-interactions-note.md index ae3037171f..12d4a85ea3 100644 --- a/data/reusables/copilot/custom-instructions-interactions-note.md +++ b/data/reusables/copilot/custom-instructions-interactions-note.md @@ -1,3 +1,3 @@ > [!NOTE] -> * It is possible for multiple types of custom instructions to apply to a conversation. Personal instructions take the highest priority, followed by repository instructions, with organization instructions prioritized last. However, all sets of relevant instructions are still combined and provided to {% data variables.product.prodname_copilot_chat_short %}. +> * It is possible for multiple types of custom instructions to apply to a conversation. Personal instructions take the highest priority, followed by repository instructions, with organization instructions prioritized last. However, all sets of relevant instructions are still combined and provided to {% data variables.copilot.copilot_chat_short %}. > * Whenever possible, you should avoid providing conflicting sets of instructions. If you are concerned about response quality, you can also choose to temporarily disable repository instructions. See [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot?tool=webui#enabling-or-disabling-repository-custom-instructions). diff --git a/data/reusables/copilot/custom-instructions-reference.md b/data/reusables/copilot/custom-instructions-reference.md index e034c1d696..6f6e46ac3b 100644 --- a/data/reusables/copilot/custom-instructions-reference.md +++ b/data/reusables/copilot/custom-instructions-reference.md @@ -1,3 +1,3 @@ -The instructions in the `.github/copilot-instructions.md` file are available for use by {% data variables.product.prodname_copilot_chat_short %} as soon as you save the file. The complete set of instructions will be automatically attached to requests that you submit in either the {% data variables.product.prodname_copilot_chat_short %} view, or in inline chat. +The instructions in the `.github/copilot-instructions.md` file are available for use by {% data variables.copilot.copilot_chat_short %} as soon as you save the file. The complete set of instructions will be automatically attached to requests that you submit in either the {% data variables.copilot.copilot_chat_short %} view, or in inline chat. Custom instructions are not visible in the Chat view or inline chat, but you can verify that they are being used by {% data variables.product.prodname_copilot_short %} by looking at the References list of a response in the Chat view. If custom instructions were added to the prompt that was sent to the model, the `.github/copilot-instructions.md` file is listed as a reference. You can click the reference to open the file. diff --git a/data/reusables/copilot/differences-cfi-cfb-table.md b/data/reusables/copilot/differences-cfi-cfb-table.md index 8f99143c8e..737aa4ec83 100644 --- a/data/reusables/copilot/differences-cfi-cfb-table.md +++ b/data/reusables/copilot/differences-cfi-cfb-table.md @@ -1,6 +1,6 @@ {% rowheaders %} -| | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | | Pricing | Not applicable | {% data variables.copilot.cfi_price_per_month %} per month, or
{% data variables.copilot.cfi_price_per_year %} per year
(free for some users) | {% data variables.copilot.cpp_price_per_month %} per month, or
{% data variables.copilot.cpp_price_per_year %} per year
| {% data variables.copilot.cfb_price_per_month %} per granted seat per month | {% data variables.copilot.ce_price_per_month %} per granted seat per month | | Premium requests | 50 per month | 300 per month | 1500 per month | 300 per user per month | 1000 per user per month | @@ -12,12 +12,12 @@ {% rowheaders %} -| Agents | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| Agents | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | | {% data variables.copilot.copilot_coding_agent %} ({% data variables.release-phases.public_preview %}) | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | | Agent mode in {% data variables.product.prodname_vscode_shortname %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | {% data variables.product.prodname_copilot_short %} code review | Only "Review selection" in {% data variables.product.prodname_vscode_shortname %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_extensions_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_extensions_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% endrowheaders %} @@ -25,16 +25,16 @@ {% rowheaders %} -| Chat | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| Chat | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | -| {% data variables.product.prodname_copilot_chat_short %} in IDEs[^1] [^2] | 50 messages per month | Unlimited with base model | Unlimited with base model | Unlimited with base model | Unlimited with base model | +| {% data variables.copilot.copilot_chat_short %} in IDEs[^1] [^2] | 50 messages per month | Unlimited with base model | Unlimited with base model | Unlimited with base model | Unlimited with base model | | Inline chat | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | Slash commands | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_mobile_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_chat_dotcom_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_windows_terminal %} | {% octicon "check" aria-label="Included" %} |{% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_mobile_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_chat_dotcom_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_windows_terminal %} | {% octicon "check" aria-label="Included" %} |{% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | Increased {% data variables.product.prodname_github_models %} rate limits[^3] | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_chat_short %} skills in IDEs[^4] | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_chat_short %} skills in IDEs[^4] | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% endrowheaders %} @@ -42,7 +42,7 @@ {% rowheaders %} -| Available models in chat | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| Available models in chat | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | |----------------------------------------------------------------|----------------------------------------------------------|---------------------------------------------------------| --- |--------------------------------------------------------------| --- | | {% data variables.copilot.copilot_claude_sonnet_35 %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | {% data variables.copilot.copilot_claude_sonnet_37 %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | @@ -65,7 +65,7 @@ {% rowheaders %} -| Code completion | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| Code completion | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | | Real-time code suggestions with the base model[^5] | 2000 completions per month | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | {% data variables.copilot.next_edit_suggestions_caps %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | @@ -76,7 +76,7 @@ {% rowheaders %} -| Customization | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| Customization | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | | Repository and personal custom instructions | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | Organization custom instructions ({% data variables.release-phases.public_preview %}) | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | @@ -93,19 +93,19 @@ {% rowheaders %} -| | {% data variables.product.prodname_copilot_free_short %} | {% data variables.product.prodname_copilot_pro_short %} | {% data variables.product.prodname_copilot_pro_plus_short %} | {% data variables.product.prodname_copilot_business_short %} | {% data variables.product.prodname_copilot_enterprise_short %} | +| | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | -| {% data variables.product.prodname_copilot_for_prs %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_for_prs %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | Audit logs | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} |{% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | {% data variables.product.prodname_copilot_short %} knowledge bases |{% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | | Fine tuning a custom large language model (limited {% data variables.release-phases.public_preview %})[^6] | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | -| {% data variables.product.prodname_copilot_cli_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_cli_short %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% endrowheaders %} -[^1]: {% data variables.product.prodname_copilot_chat_short %} in IDEs is available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, Eclipse, and Xcode. +[^1]: {% data variables.copilot.copilot_chat_short %} in IDEs is available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, Eclipse, and Xcode. [^2]: Response times may vary during periods of high usage. [^3]: For details about the increased rate limits, see [AUTOTITLE](/github-models/prototyping-with-ai-models). -[^4]: {% data variables.product.prodname_copilot_chat_short %} skills in IDEs is available in {% data variables.product.prodname_vscode %} and {% data variables.product.prodname_vs %}. +[^4]: {% data variables.copilot.copilot_chat_short %} skills in IDEs is available in {% data variables.product.prodname_vscode %} and {% data variables.product.prodname_vs %}. [^5]: Code completion in IDEs is available in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, Azure Data Studio, Xcode, Vim/Neovim, and Eclipse. [^6]: For details about fine tuning the model, see [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/customizing-copilot-for-your-organization/creating-a-custom-model-for-github-copilot). diff --git a/data/reusables/copilot/disable-copilot-organization.md b/data/reusables/copilot/disable-copilot-organization.md index eb1d941049..446bcff316 100644 --- a/data/reusables/copilot/disable-copilot-organization.md +++ b/data/reusables/copilot/disable-copilot-organization.md @@ -4,5 +4,5 @@ >[!IMPORTANT] If you have not configured all policies for {% data variables.product.prodname_copilot_short %}, you will not be able to complete the following steps. If that is the case, click **Go to policies** and ensure all policies are configured before proceeding. -1. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," to revoke {% data variables.product.prodname_copilot %} access for all users in your organization, select **Disabled**. +1. Under {% ifversion ghec %}"{% data variables.copilot.copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.copilot.copilot_business_short %} is active in your organization," to revoke {% data variables.product.prodname_copilot %} access for all users in your organization, select **Disabled**. 1. In the "Remove {% data variables.product.prodname_copilot_short %} access" dialog, click **Confirm and remove seats**. diff --git a/data/reusables/copilot/dotcom-settings.md b/data/reusables/copilot/dotcom-settings.md index fd5214663d..3069bd34ec 100644 --- a/data/reusables/copilot/dotcom-settings.md +++ b/data/reusables/copilot/dotcom-settings.md @@ -1,6 +1,6 @@ ## Configuring {% data variables.product.prodname_copilot_short %} settings on {% data variables.product.prodname_dotcom_the_website %} -If you are using a {% data variables.product.prodname_copilot_pro_short %} plan, you can choose to allow or block code completion suggestions that match publicly available code. {% ifversion fpt %}You can also allow or block the collection and retention of the prompts you enter and {% data variables.product.prodname_copilot_short %}'s suggestions.{% endif %} You configure this in your personal settings on {% data variables.product.prodname_dotcom_the_website %}. See [AUTOTITLE](/copilot/configuring-github-copilot/configuring-your-personal-github-copilot-settings-on-githubcom). +If you are using a {% data variables.copilot.copilot_pro_short %} plan, you can choose to allow or block code completion suggestions that match publicly available code. {% ifversion fpt %}You can also allow or block the collection and retention of the prompts you enter and {% data variables.product.prodname_copilot_short %}'s suggestions.{% endif %} You configure this in your personal settings on {% data variables.product.prodname_dotcom_the_website %}. See [AUTOTITLE](/copilot/configuring-github-copilot/configuring-your-personal-github-copilot-settings-on-githubcom). ## Authenticating to an account on {% data variables.enterprise.data_residency_site %} diff --git a/data/reusables/copilot/editor-preview-settings.md b/data/reusables/copilot/editor-preview-settings.md index 881878af33..2ab1fe6877 100644 --- a/data/reusables/copilot/editor-preview-settings.md +++ b/data/reusables/copilot/editor-preview-settings.md @@ -1 +1 @@ -If you're using a {% data variables.product.prodname_copilot_business_short %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} plan, the organization{% ifversion ghec %} or enterprise{% endif %} that provides your plan must enable the **Editor preview features** setting. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization){% ifversion ghec %} or [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#configuring-policies-for-github-copilot){% endif %}. +If you're using a {% data variables.copilot.copilot_business_short %}{% ifversion ghec %} or {% data variables.copilot.copilot_enterprise_short %}{% endif %} plan, the organization{% ifversion ghec %} or enterprise{% endif %} that provides your plan must enable the **Editor preview features** setting. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization){% ifversion ghec %} or [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#configuring-policies-for-github-copilot){% endif %}. diff --git a/data/reusables/copilot/example-prompts/response-is-an-example.md b/data/reusables/copilot/example-prompts/response-is-an-example.md index 5e9c5463c2..3a64abc99e 100644 --- a/data/reusables/copilot/example-prompts/response-is-an-example.md +++ b/data/reusables/copilot/example-prompts/response-is-an-example.md @@ -1 +1 @@ -> [!NOTE] The following response is an example. {% data variables.product.prodname_copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one shown here. +> [!NOTE] The following response is an example. {% data variables.copilot.copilot_chat_short %} responses are non-deterministic, so you may get a different response from the one shown here. diff --git a/data/reusables/copilot/gemini-25-pro-public-preview-note.md b/data/reusables/copilot/gemini-25-pro-public-preview-note.md index acbeb0ff54..b743eefbbd 100644 --- a/data/reusables/copilot/gemini-25-pro-public-preview-note.md +++ b/data/reusables/copilot/gemini-25-pro-public-preview-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> {% data variables.copilot.copilot_gemini_25_pro %} in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. +> {% data variables.copilot.copilot_gemini_25_pro %} in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/go-to-copilot-page.md b/data/reusables/copilot/go-to-copilot-page.md index e1e365a694..c0cd880112 100644 --- a/data/reusables/copilot/go-to-copilot-page.md +++ b/data/reusables/copilot/go-to-copilot-page.md @@ -1,6 +1,6 @@ 1. In the top right of any page on {% data variables.product.github %}, click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** {% data variables.product.prodname_copilot %} icon next to the search bar. - The {% data variables.product.prodname_copilot_chat %} panel is displayed. To resize the panel, click and drag the top or left edge. + The {% data variables.copilot.copilot_chat %} panel is displayed. To resize the panel, click and drag the top or left edge. 1. If the panel contains a previous conversation you had with {% data variables.product.prodname_copilot_short %}, click the "New conversation" icon (a plus sign) at the top right of the panel. diff --git a/data/reusables/copilot/mcp-overview-other-ides.md b/data/reusables/copilot/mcp-overview-other-ides.md index fc3d6cac9d..1771366473 100644 --- a/data/reusables/copilot/mcp-overview-other-ides.md +++ b/data/reusables/copilot/mcp-overview-other-ides.md @@ -1,5 +1,5 @@ The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to connect AI models to different data sources and tools, enabling them to work together more effectively. -You can use MCP to extend the capabilities of {% data variables.product.prodname_copilot_chat_short %} by integrating it with a wide range of existing tools and services. You can also use MCP to create new tools and services that work with {% data variables.product.prodname_copilot_chat_short %}, allowing you to customize and enhance your experience. +You can use MCP to extend the capabilities of {% data variables.copilot.copilot_chat_short %} by integrating it with a wide range of existing tools and services. You can also use MCP to create new tools and services that work with {% data variables.copilot.copilot_chat_short %}, allowing you to customize and enhance your experience. For more information on MCP, see [the official MCP documentation](https://modelcontextprotocol.io/introduction). diff --git a/data/reusables/copilot/model-picker-enable-alternative-models.md b/data/reusables/copilot/model-picker-enable-alternative-models.md index 479c1d45a1..5edcb55816 100644 --- a/data/reusables/copilot/model-picker-enable-alternative-models.md +++ b/data/reusables/copilot/model-picker-enable-alternative-models.md @@ -1 +1 @@ -If you access {% data variables.product.prodname_copilot_chat_short %} through a {% data variables.product.prodname_copilot_business_short %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} subscription, your organization{% ifversion ghec %} or enterprise{% endif %} must grant members the ability to switch to a different model. 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){% ifversion ghec %} or [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-access-to-alternative-ai-models){% endif %}. +If you access {% data variables.copilot.copilot_chat_short %} through a {% data variables.copilot.copilot_business_short %}{% ifversion ghec %} or {% data variables.copilot.copilot_enterprise_short %}{% endif %} subscription, your organization{% ifversion ghec %} or enterprise{% endif %} must grant members the ability to switch to a different model. 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){% ifversion ghec %} or [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-access-to-alternative-ai-models){% endif %}. diff --git a/data/reusables/copilot/o3-public-preview-note.md b/data/reusables/copilot/o3-public-preview-note.md index b2bf86abd2..ffde38e054 100644 --- a/data/reusables/copilot/o3-public-preview-note.md +++ b/data/reusables/copilot/o3-public-preview-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> {% data variables.copilot.copilot_o3 %} in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. +> {% data variables.copilot.copilot_o3 %} in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/o4-mini-public-preview-note.md b/data/reusables/copilot/o4-mini-public-preview-note.md index 9c2029286f..5b9c6ebda2 100644 --- a/data/reusables/copilot/o4-mini-public-preview-note.md +++ b/data/reusables/copilot/o4-mini-public-preview-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> {% data variables.copilot.copilot_o4_mini %} in {% data variables.product.prodname_copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. +> {% data variables.copilot.copilot_o4_mini %} in {% data variables.copilot.copilot_chat_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. diff --git a/data/reusables/copilot/open-copilot.md b/data/reusables/copilot/open-copilot.md index 410bd55260..f5771a0e33 100644 --- a/data/reusables/copilot/open-copilot.md +++ b/data/reusables/copilot/open-copilot.md @@ -1,5 +1,5 @@ 1. In the top right of any page on {% data variables.product.github %}, click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** {% data variables.product.prodname_copilot %} icon next to the search bar. - The {% data variables.product.prodname_copilot_chat %} panel is displayed. To resize the panel, click and drag the top or left edge. + The {% data variables.copilot.copilot_chat %} panel is displayed. To resize the panel, click and drag the top or left edge. 1. If the panel contains a previous conversation you had with {% data variables.product.prodname_copilot_short %}, click the {% octicon "plus" aria-hidden="true" aria-label="plus" %} plus sign icon at the top right of the {% data variables.product.prodname_copilot_short %} panel to start a new conversation. diff --git a/data/reusables/copilot/organization-instructions-note.md b/data/reusables/copilot/organization-instructions-note.md index 49caecf881..8cfa66557c 100644 --- a/data/reusables/copilot/organization-instructions-note.md +++ b/data/reusables/copilot/organization-instructions-note.md @@ -1,4 +1,4 @@ > [!NOTE] > This feature is currently in {% data variables.release-phases.public_preview %} and is subject to change. > -> Organization custom instructions are currently only supported for {% data variables.product.prodname_copilot_chat_dotcom %}. +> Organization custom instructions are currently only supported for {% data variables.copilot.copilot_chat_dotcom %}. diff --git a/data/reusables/copilot/personal-instructions-note.md b/data/reusables/copilot/personal-instructions-note.md index f93d67112e..3e6ccde45e 100644 --- a/data/reusables/copilot/personal-instructions-note.md +++ b/data/reusables/copilot/personal-instructions-note.md @@ -1 +1 @@ -> [!NOTE] Personal custom instructions are currently only supported for {% data variables.product.prodname_copilot_chat_dotcom %}. +> [!NOTE] Personal custom instructions are currently only supported for {% data variables.copilot.copilot_chat_dotcom %}. diff --git a/data/reusables/copilot/policies-for-dotcom.md b/data/reusables/copilot/policies-for-dotcom.md index df9e74a02f..89beb382a9 100644 --- a/data/reusables/copilot/policies-for-dotcom.md +++ b/data/reusables/copilot/policies-for-dotcom.md @@ -2,4 +2,4 @@ * **Opt in to preview features:** If enabled, users can test new {% data variables.product.prodname_copilot_short %} features that are not yet generally available. Be aware that previews of features may have flaws, and the features may be changed or discontinued at any time. Current previews of {% data variables.product.prodname_copilot_short %} features include: * Experimental languages in {% data variables.product.prodname_copilot_short %} code review. See [AUTOTITLE](/copilot/using-github-copilot/code-review/using-copilot-code-review). - * {% data variables.product.prodname_copilot_spaces %}. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). + * {% data variables.copilot.copilot_spaces %}. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces). diff --git a/data/reusables/copilot/premium-requests-for-enterprises.md b/data/reusables/copilot/premium-requests-for-enterprises.md index 1e9927f179..91a1ffc9a8 100644 --- a/data/reusables/copilot/premium-requests-for-enterprises.md +++ b/data/reusables/copilot/premium-requests-for-enterprises.md @@ -1,9 +1,9 @@ Each {% data variables.product.prodname_copilot_short %} plan includes a per-user allowance for premium requests: -* 300 requests per user per month for {% data variables.product.prodname_copilot_business_short %} -* 1000 requests per user per month for {% data variables.product.prodname_copilot_enterprise_short %} +* 300 requests per user per month for {% data variables.copilot.copilot_business_short %} +* 1000 requests per user per month for {% data variables.copilot.copilot_enterprise_short %} -{% data variables.product.prodname_copilot_chat_short %}, {% data variables.product.prodname_copilot_agent_short %} mode, {% data variables.copilot.copilot_coding_agent %}, {% data variables.product.prodname_copilot_short %} code review, and {% data variables.product.prodname_copilot_extensions_short %} use premium requests, with usage varying by model. +{% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_agent_short %} mode, {% data variables.copilot.copilot_coding_agent %}, {% data variables.product.prodname_copilot_short %} code review, and {% data variables.copilot.copilot_extensions_short %} use premium requests, with usage varying by model. > [!TIP] > {% data variables.copilot.copilot_coding_agent %} uses {% data variables.product.prodname_actions %} in addition to premium requests. For more information, see [AUTOTITLE](/billing/managing-billing-for-your-products/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions). diff --git a/data/reusables/copilot/premium-requests-mobile.md b/data/reusables/copilot/premium-requests-mobile.md index d754345288..4b7ac35014 100644 --- a/data/reusables/copilot/premium-requests-mobile.md +++ b/data/reusables/copilot/premium-requests-mobile.md @@ -1 +1 @@ -> [!NOTE] The option to purchase additional premium requests is not available to users who subscribe, or have subscribed, to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} through {% data variables.product.prodname_mobile %} on iOS or Android. +> [!NOTE] The option to purchase additional premium requests is not available to users who subscribe, or have subscribed, to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} through {% data variables.product.prodname_mobile %} on iOS or Android. diff --git a/data/reusables/copilot/quickstart-nextsteps1.md b/data/reusables/copilot/quickstart-nextsteps1.md index b95514a530..77e4c5a5f8 100644 --- a/data/reusables/copilot/quickstart-nextsteps1.md +++ b/data/reusables/copilot/quickstart-nextsteps1.md @@ -1,3 +1,3 @@ * **Find out more about {% data variables.product.prodname_copilot_short %} code completion** - See [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-code-suggestions-in-your-editor). -* **Find out more about {% data variables.product.prodname_copilot_chat %}** - See [AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion fpt %}.{% endif %}{% ifversion ghec %} and [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom).{% endif %} +* **Find out more about {% data variables.copilot.copilot_chat %}** - See [AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion fpt %}.{% endif %}{% ifversion ghec %} and [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom).{% endif %} * **Learn how to write effective prompts** - See [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot). diff --git a/data/reusables/copilot/quickstart-signup.md b/data/reusables/copilot/quickstart-signup.md index 2327b11eaa..8644ba7a2d 100644 --- a/data/reusables/copilot/quickstart-signup.md +++ b/data/reusables/copilot/quickstart-signup.md @@ -6,8 +6,8 @@ To use {% data variables.product.prodname_copilot_short %}, you’ll need a personal {% data variables.product.github %} account with access to a {% data variables.product.prodname_copilot_short %} plan. You can: -* Start with {% data variables.product.prodname_copilot_free_short %} to explore limited features without subscribing to a plan. -* Upgrade to {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} to unlock more features, models, and request limits. +* Start with {% data variables.copilot.copilot_free_short %} to explore limited features without subscribing to a plan. +* Upgrade to {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} to unlock more features, models, and request limits. For more information about the different plans for {% data variables.product.prodname_copilot %}, see [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot). @@ -15,6 +15,6 @@ For more information about the different plans for {% data variables.product.pro ## Prerequisites -To use {% data variables.product.prodname_copilot %} you must have been assigned a seat by your organization as part of a {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} subscription, or you must have signed up for {% data variables.product.prodname_copilot_pro %} on your personal {% data variables.product.prodname_dotcom %} account. +To use {% data variables.product.prodname_copilot %} you must have been assigned a seat by your organization as part of a {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} subscription, or you must have signed up for {% data variables.copilot.copilot_pro %} on your personal {% data variables.product.prodname_dotcom %} account. {% endif %} diff --git a/data/reusables/copilot/repository-custom-instructions-note.md b/data/reusables/copilot/repository-custom-instructions-note.md index 7a2bcc3fe2..9b8d708739 100644 --- a/data/reusables/copilot/repository-custom-instructions-note.md +++ b/data/reusables/copilot/repository-custom-instructions-note.md @@ -1 +1 @@ -> [!NOTE] Repository custom instructions are currently supported for {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode_shortname %} and on the {% data variables.product.github %} website. +> [!NOTE] Repository custom instructions are currently supported for {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode_shortname %} and on the {% data variables.product.github %} website. diff --git a/data/reusables/copilot/sku-isolation.md b/data/reusables/copilot/sku-isolation.md index 03359131fb..968ed88e90 100644 --- a/data/reusables/copilot/sku-isolation.md +++ b/data/reusables/copilot/sku-isolation.md @@ -1,36 +1,36 @@ -## About {% data variables.product.prodname_copilot_sku_isolation %} +## About {% data variables.copilot.copilot_sku_isolation %} -As an {% ifversion ghec %}enterprise or {% endif %}organization owner, you can use your network firewall to explicitly allow access to {% data variables.product.prodname_copilot_for_business %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise %}, or both{% endif %}, and/or block access to {% data variables.product.prodname_copilot_pro %} or {% data variables.product.prodname_copilot_free %}. This allows you to control which {% data variables.product.prodname_copilot %} plans your members can use within your network. +As an {% ifversion ghec %}enterprise or {% endif %}organization owner, you can use your network firewall to explicitly allow access to {% data variables.copilot.copilot_for_business %}{% ifversion ghec %} or {% data variables.copilot.copilot_enterprise %}, or both{% endif %}, and/or block access to {% data variables.copilot.copilot_pro %} or {% data variables.copilot.copilot_free %}. This allows you to control which {% data variables.product.prodname_copilot %} plans your members can use within your network. -Configuring {% data variables.product.prodname_copilot_sku_isolation %} will affect the following {% data variables.product.prodname_copilot_short %} features: +Configuring {% data variables.copilot.copilot_sku_isolation %} will affect the following {% data variables.product.prodname_copilot_short %} features: * Code completion in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, and Vim/NeoVim -* {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and JetBrains IDEs -* {% data variables.product.prodname_copilot_chat_short %} on {% data variables.product.github %} +* {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and JetBrains IDEs +* {% data variables.copilot.copilot_chat_short %} on {% data variables.product.github %} * {% data variables.product.prodname_mobile %} Apps -* {% data variables.product.prodname_copilot_cli_short %} +* {% data variables.copilot.copilot_cli_short %} -{% data variables.product.prodname_copilot_sku_isolation %} is enabled for all users. This ensures that users access {% data variables.product.prodname_copilot_short %} through an endpoint that is specific to their {% data variables.product.prodname_copilot_short %} plan. Only {% data variables.product.prodname_copilot_business_short %} users will be able to connect to the {% data variables.product.prodname_copilot_business_short %} endpoint and only {% data variables.product.prodname_copilot_enterprise_short %} users will be able to connect to the {% data variables.product.prodname_copilot_enterprise_short %} endpoint. +{% data variables.copilot.copilot_sku_isolation %} is enabled for all users. This ensures that users access {% data variables.product.prodname_copilot_short %} through an endpoint that is specific to their {% data variables.product.prodname_copilot_short %} plan. Only {% data variables.copilot.copilot_business_short %} users will be able to connect to the {% data variables.copilot.copilot_business_short %} endpoint and only {% data variables.copilot.copilot_enterprise_short %} users will be able to connect to the {% data variables.copilot.copilot_enterprise_short %} endpoint. ## Important steps to ensure continued access to {% data variables.product.prodname_copilot_short %} You should ensure that your firewall allows access to all of the hostnames listed in [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-your-proxy-server-or-firewall-for-copilot). -## Configuring {% data variables.product.prodname_copilot_sku_isolation %} for your {% ifversion ghec %}enterprise or {% endif %}organization +## Configuring {% data variables.copilot.copilot_sku_isolation %} for your {% ifversion ghec %}enterprise or {% endif %}organization -{% ifversion ghec %}Enterprise or organization {% else %}Organization {% endif %}owners can add the endpoints for {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %}{% ifversion ghec %}, or both,{% endif %} to their allow-list. This will ensure that members can only access {% data variables.product.prodname_copilot_short %} through the allowed endpoint. +{% ifversion ghec %}Enterprise or organization {% else %}Organization {% endif %}owners can add the endpoints for {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %}{% ifversion ghec %}, or both,{% endif %} to their allow-list. This will ensure that members can only access {% data variables.product.prodname_copilot_short %} through the allowed endpoint. {% ifversion ghec %} -> [!NOTE] If your enterprise account includes both {% data variables.product.prodname_copilot_business_short %} and {% data variables.product.prodname_copilot_enterprise_short %} plans, make sure both endpoints are added to your allow-list.{% endif %} +> [!NOTE] If your enterprise account includes both {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %} plans, make sure both endpoints are added to your allow-list.{% endif %} 1. Ensure your members have updated to at least the minimum version of their {% data variables.product.prodname_copilot_short %} client listed below. - * For {% data variables.product.prodname_vscode %}, use {% data variables.product.prodname_copilot_chat_short %} version 0.17 or later. + * For {% data variables.product.prodname_vscode %}, use {% data variables.copilot.copilot_chat_short %} version 0.17 or later. * For JetBrains IDEs, use {% data variables.product.prodname_copilot_short %} version 1.5.6.5692 or later. * For {% data variables.product.prodname_vs %}, use version VS 2022 17.11 or later. 1. Update your corporate network firewall to include one, or both, of these paths in your allowlist: - * For a {% data variables.product.prodname_copilot_business_short %} plan, add `*.business.githubcopilot.com` - * For a {% data variables.product.prodname_copilot_enterprise_short %} plan, add `*.enterprise.githubcopilot.com` + * For a {% data variables.copilot.copilot_business_short %} plan, add `*.business.githubcopilot.com` + * For a {% data variables.copilot.copilot_enterprise_short %} plan, add `*.enterprise.githubcopilot.com` > [!NOTE] The `*` indicates a wildcard character. A wildcard is necessary as there are multiple subdomains required for {% data variables.product.prodname_copilot_short %} to function correctly. diff --git a/data/reusables/copilot/using-skills.md b/data/reusables/copilot/using-skills.md index 1592b7372c..46174e80eb 100644 --- a/data/reusables/copilot/using-skills.md +++ b/data/reusables/copilot/using-skills.md @@ -1,7 +1,7 @@ -{% data variables.product.prodname_copilot_short %}'s {% data variables.product.prodname_dotcom %}-specific skills expand the type of information {% data variables.product.prodname_copilot_short %} can provide. To access these skills in {% data variables.product.prodname_copilot_chat_short %}, include `@github` in your question. +{% data variables.product.prodname_copilot_short %}'s {% data variables.product.prodname_dotcom %}-specific skills expand the type of information {% data variables.product.prodname_copilot_short %} can provide. To access these skills in {% data variables.copilot.copilot_chat_short %}, include `@github` in your question. -When you add `@github` to a question, {% data variables.product.prodname_copilot_short %} dynamically selects an appropriate skill, based on the content of your question. You can also explicitly ask {% data variables.product.prodname_copilot_chat_short %} to use a particular skill. You can do this in two ways: -* Use natural language to ask {% data variables.product.prodname_copilot_chat_short %} to use a skill. For example, `@github Search the web to find the latest GPT model from OpenAI.` +When you add `@github` to a question, {% data variables.product.prodname_copilot_short %} dynamically selects an appropriate skill, based on the content of your question. You can also explicitly ask {% data variables.copilot.copilot_chat_short %} to use a particular skill. You can do this in two ways: +* Use natural language to ask {% data variables.copilot.copilot_chat_short %} to use a skill. For example, `@github Search the web to find the latest GPT model from OpenAI.` * To specifically invoke a web search you can include the `#web` variable in your question. For example, `@github #web What is the latest LTS of Node.js?` You can generate a list of currently available skills by asking {% data variables.product.prodname_copilot_short %}: `@github What skills are available?` diff --git a/data/reusables/copilot/viewing-code-references-in-chat.md b/data/reusables/copilot/viewing-code-references-in-chat.md index 47e0f64b28..9f9e8e7ec3 100644 --- a/data/reusables/copilot/viewing-code-references-in-chat.md +++ b/data/reusables/copilot/viewing-code-references-in-chat.md @@ -1,4 +1,4 @@ -If a response in {% data variables.product.prodname_copilot_chat_short %} includes matching code, this is indicated at the end of the response by the following text: +If a response in {% data variables.copilot.copilot_chat_short %} includes matching code, this is indicated at the end of the response by the following text: > Similar code found with _n_ license types - **View matches** diff --git a/data/reusables/copilot/vscode-version-compatibility.md b/data/reusables/copilot/vscode-version-compatibility.md index 2df2d4c80a..c2b1d112c3 100644 --- a/data/reusables/copilot/vscode-version-compatibility.md +++ b/data/reusables/copilot/vscode-version-compatibility.md @@ -1,3 +1,3 @@ -Changes to {% data variables.product.prodname_copilot_chat_short %} coincide with {% data variables.product.prodname_vscode %} releases, due to {% data variables.product.prodname_copilot_chat_short %}'s deep UI integration. As a result, every new version of {% data variables.product.prodname_copilot_chat_short %} is only compatible with the latest release of {% data variables.product.prodname_vscode %}. This means that if you are using an older version of {% data variables.product.prodname_vscode %}, you will not be able to use the latest {% data variables.product.prodname_copilot_chat_short %}. +Changes to {% data variables.copilot.copilot_chat_short %} coincide with {% data variables.product.prodname_vscode %} releases, due to {% data variables.copilot.copilot_chat_short %}'s deep UI integration. As a result, every new version of {% data variables.copilot.copilot_chat_short %} is only compatible with the latest release of {% data variables.product.prodname_vscode %}. This means that if you are using an older version of {% data variables.product.prodname_vscode %}, you will not be able to use the latest {% data variables.copilot.copilot_chat_short %}. -Only the latest {% data variables.product.prodname_copilot_chat_short %} versions will use the latest large language model provided by the {% data variables.product.prodname_copilot_short %} service, as even minor model upgrades require prompt changes and fixes in the extension. An older version of {% data variables.product.prodname_copilot_chat_short %} will still use the latest version of {% data variables.product.prodname_copilot_short %} code completion. +Only the latest {% data variables.copilot.copilot_chat_short %} versions will use the latest large language model provided by the {% data variables.product.prodname_copilot_short %} service, as even minor model upgrades require prompt changes and fixes in the extension. An older version of {% data variables.copilot.copilot_chat_short %} will still use the latest version of {% data variables.product.prodname_copilot_short %} code completion. diff --git a/data/reusables/copilot/windows-terminal-access-denied.md b/data/reusables/copilot/windows-terminal-access-denied.md index 0917c1d700..0d8b38be7a 100644 --- a/data/reusables/copilot/windows-terminal-access-denied.md +++ b/data/reusables/copilot/windows-terminal-access-denied.md @@ -1 +1 @@ -If you have access to {% data variables.product.prodname_copilot %} via your organization{% ifversion ghec %} or enterprise{% endif %}, you won't be able to use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_windows_terminal %} if your organization owner{% ifversion ghec %} or enterprise administrator{% endif %} has disabled {% data variables.product.prodname_copilot_cli %}. See [AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization). +If you have access to {% data variables.product.prodname_copilot %} via your organization{% ifversion ghec %} or enterprise{% endif %}, you won't be able to use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_windows_terminal %} if your organization owner{% ifversion ghec %} or enterprise administrator{% endif %} has disabled {% data variables.copilot.copilot_cli %}. See [AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization). diff --git a/data/reusables/enterprise/emus-trial-content.md b/data/reusables/enterprise/emus-trial-content.md index 5679e8c708..30f08941a3 100644 --- a/data/reusables/enterprise/emus-trial-content.md +++ b/data/reusables/enterprise/emus-trial-content.md @@ -2,5 +2,5 @@ If you choose an {% data variables.enterprise.prodname_emu_enterprise %}, you will also choose whether to create an enterprise on {% data variables.product.prodname_dotcom_the_website %} or in a specific data residency region on {% data variables.enterprise.data_residency_site %}. -* Trials on **{% data variables.product.prodname_dotcom_the_website %}** include free access to {% data variables.product.prodname_copilot_for_business %} and {% data variables.product.prodname_GHAS %} features. Your enterprise will be hosted in the US. -* Trials on **{% data variables.enterprise.data_residency_site %}** allow you to meet specific regulatory requirements and choose a unique subdomain for your enterprise. However, the trial won't include free access to {% data variables.product.prodname_copilot_for_business %} and {% data variables.product.prodname_GHAS %} features, or access to the currently unavailable features listed in [AUTOTITLE](/enterprise-cloud@latest/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency#currently-unavailable-features). +* Trials on **{% data variables.product.prodname_dotcom_the_website %}** include free access to {% data variables.copilot.copilot_for_business %} and {% data variables.product.prodname_GHAS %} features. Your enterprise will be hosted in the US. +* Trials on **{% data variables.enterprise.data_residency_site %}** allow you to meet specific regulatory requirements and choose a unique subdomain for your enterprise. However, the trial won't include free access to {% data variables.copilot.copilot_for_business %} and {% data variables.product.prodname_GHAS %} features, or access to the currently unavailable features listed in [AUTOTITLE](/enterprise-cloud@latest/admin/data-residency/feature-overview-for-github-enterprise-cloud-with-data-residency#currently-unavailable-features). diff --git a/data/reusables/gated-features/copilot-audit-logs.md b/data/reusables/gated-features/copilot-audit-logs.md index 5c236f4d51..5e3a40e688 100644 --- a/data/reusables/gated-features/copilot-audit-logs.md +++ b/data/reusables/gated-features/copilot-audit-logs.md @@ -1 +1 @@ -Audit logs for {% data variables.product.prodname_copilot %} are available for organizations{% ifversion ghec %} and enterprise accounts{% endif %} with a {% data variables.product.prodname_copilot_business_short %} plan. +Audit logs for {% data variables.product.prodname_copilot %} are available for organizations{% ifversion ghec %} and enterprise accounts{% endif %} with a {% data variables.copilot.copilot_business_short %} plan. diff --git a/data/reusables/gated-features/copilot-billing.md b/data/reusables/gated-features/copilot-billing.md index badea18fbb..d96ac26213 100644 --- a/data/reusables/gated-features/copilot-billing.md +++ b/data/reusables/gated-features/copilot-billing.md @@ -1 +1 @@ -{% data variables.product.prodname_copilot %} can be managed through personal accounts with {% data variables.product.prodname_copilot_pro %} or {% data variables.product.prodname_copilot_pro_plus %} {% ifversion ghec %}, {% elsif fpt %} or {% endif %}through organization{% ifversion ghec %} or enterprise{% endif %} accounts with {% data variables.product.prodname_copilot_for_business %}{% ifversion ghec %}, or through enterprise accounts with {% data variables.product.prodname_copilot_enterprise %}{% endif %}. +{% data variables.product.prodname_copilot %} can be managed through personal accounts with {% data variables.copilot.copilot_pro %} or {% data variables.copilot.copilot_pro_plus %} {% ifversion ghec %}, {% elsif fpt %} or {% endif %}through organization{% ifversion ghec %} or enterprise{% endif %} accounts with {% data variables.copilot.copilot_for_business %}{% ifversion ghec %}, or through enterprise accounts with {% data variables.copilot.copilot_enterprise %}{% endif %}. diff --git a/data/reusables/gated-features/copilot-business-and-enterprise.md b/data/reusables/gated-features/copilot-business-and-enterprise.md index ce29b5392b..05f022cd93 100644 --- a/data/reusables/gated-features/copilot-business-and-enterprise.md +++ b/data/reusables/gated-features/copilot-business-and-enterprise.md @@ -1 +1 @@ -Organizations{% ifversion ghec %} and enterprises{% endif %} with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan. +Organizations{% ifversion ghec %} and enterprises{% endif %} with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan. diff --git a/data/reusables/gated-features/copilot-chat-callout.md b/data/reusables/gated-features/copilot-chat-callout.md index 2af4e26fef..7d102562b5 100644 --- a/data/reusables/gated-features/copilot-chat-callout.md +++ b/data/reusables/gated-features/copilot-chat-callout.md @@ -1,3 +1,3 @@ -All users with a {% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_pro_plus_short %}, or {% data variables.product.prodname_copilot_free_short %} plan can access {% data variables.product.prodname_copilot_chat_short %} in supported IDEs and on the {% data variables.product.github %} website. +All users with a {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, or {% data variables.copilot.copilot_free_short %} plan can access {% data variables.copilot.copilot_chat_short %} in supported IDEs and on the {% data variables.product.github %} website. -Owners of organizations {% ifversion ghec %}or enterprises {% endif %}with a {% data variables.product.prodname_copilot_business_short %}{% ifversion ghec %} or a {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} plan can decide whether to grant access to {% data variables.product.prodname_copilot_chat_short %}. +Owners of organizations {% ifversion ghec %}or enterprises {% endif %}with a {% data variables.copilot.copilot_business_short %}{% ifversion ghec %} or a {% data variables.copilot.copilot_enterprise_short %}{% endif %} plan can decide whether to grant access to {% data variables.copilot.copilot_chat_short %}. diff --git a/data/reusables/gated-features/copilot-coding-agent.md b/data/reusables/gated-features/copilot-coding-agent.md index 59aa8cd850..996e507a8d 100644 --- a/data/reusables/gated-features/copilot-coding-agent.md +++ b/data/reusables/gated-features/copilot-coding-agent.md @@ -1 +1 @@ -{% data variables.copilot.copilot_coding_agent %} is available with the {% data variables.product.prodname_copilot_pro_plus %} and {% data variables.product.prodname_copilot_enterprise %} plans in repositories where it is enabled. +{% data variables.copilot.copilot_coding_agent %} is available with the {% data variables.copilot.copilot_pro_plus %} and {% data variables.copilot.copilot_enterprise %} plans in repositories where it is enabled. diff --git a/data/reusables/gated-features/copilot-extensions.md b/data/reusables/gated-features/copilot-extensions.md index f4ad081738..02156fc8f3 100644 --- a/data/reusables/gated-features/copilot-extensions.md +++ b/data/reusables/gated-features/copilot-extensions.md @@ -1,5 +1,5 @@ -Anyone with a {% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_pro_plus_short %}, or {% data variables.product.prodname_copilot_free_short %} plan can use {% data variables.product.prodname_copilot_extensions_short %}. +Anyone with a {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, or {% data variables.copilot.copilot_free_short %} plan can use {% data variables.copilot.copilot_extensions_short %}. -For organizations or enterprises with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} plan, organization owners and enterprise administrators can grant access to {% data variables.product.prodname_copilot_extensions_short %}. +For organizations or enterprises with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, organization owners and enterprise administrators can grant access to {% data variables.copilot.copilot_extensions_short %}. -{% data variables.product.prodname_copilot_extensions_short %} is not available for {% data variables.product.prodname_ghe_server %}. +{% data variables.copilot.copilot_extensions_short %} is not available for {% data variables.product.prodname_ghe_server %}. diff --git a/data/reusables/gated-features/copilot-free-availability.md b/data/reusables/gated-features/copilot-free-availability.md index b372b16739..5b256867d3 100644 --- a/data/reusables/gated-features/copilot-free-availability.md +++ b/data/reusables/gated-features/copilot-free-availability.md @@ -1 +1 @@ -This feature is not available in {% data variables.product.prodname_copilot_free %}. +This feature is not available in {% data variables.copilot.copilot_free %}. diff --git a/data/reusables/gated-features/copilot-in-cli.md b/data/reusables/gated-features/copilot-in-cli.md index 5acbc34edb..0d8094e037 100644 --- a/data/reusables/gated-features/copilot-in-cli.md +++ b/data/reusables/gated-features/copilot-in-cli.md @@ -1,3 +1,3 @@ -Owners of organizations or enterprises with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription can decide whether to grant access to {% data variables.product.prodname_copilot_cli %} for users in their organization or enterprise. +Owners of organizations or enterprises with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription can decide whether to grant access to {% data variables.copilot.copilot_cli %} for users in their organization or enterprise.

-If you have a {% data variables.product.prodname_copilot_pro_short %} or {% data variables.product.prodname_copilot_pro_plus_short %} subscription, you now have access to {% data variables.product.prodname_copilot_cli %}. +If you have a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} subscription, you now have access to {% data variables.copilot.copilot_cli %}. diff --git a/data/reusables/gated-features/copilot-in-desktop.md b/data/reusables/gated-features/copilot-in-desktop.md index ba4589f59b..2a1d45f642 100644 --- a/data/reusables/gated-features/copilot-in-desktop.md +++ b/data/reusables/gated-features/copilot-in-desktop.md @@ -1,3 +1,3 @@ -Owners of organizations or enterprises with a {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} subscription can decide whether to grant access to {% data variables.product.prodname_copilot_desktop_short %} for users in their organization or enterprise. +Owners of organizations or enterprises with a {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} subscription can decide whether to grant access to {% data variables.copilot.copilot_desktop_short %} for users in their organization or enterprise.

-If you have a {% data variables.product.prodname_copilot_free %} or {% data variables.product.prodname_copilot_pro %} subscription, you now have access to {% data variables.product.prodname_copilot_desktop_short %}. +If you have a {% data variables.copilot.copilot_free %} or {% data variables.copilot.copilot_pro %} subscription, you now have access to {% data variables.copilot.copilot_desktop_short %}. diff --git a/data/reusables/gated-features/copilot-in-windows-terminal.md b/data/reusables/gated-features/copilot-in-windows-terminal.md index 3d1ac1f00a..508ba56438 100644 --- a/data/reusables/gated-features/copilot-in-windows-terminal.md +++ b/data/reusables/gated-features/copilot-in-windows-terminal.md @@ -1,3 +1,3 @@ -If you have a {% data variables.product.prodname_copilot_free_short %}, {% data variables.product.prodname_copilot_pro_short %}, or {% data variables.product.prodname_copilot_pro_plus_short %} subscription, you have access to {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_windows_terminal %}. +If you have a {% data variables.copilot.copilot_free_short %}, {% data variables.copilot.copilot_pro_short %}, or {% data variables.copilot.copilot_pro_plus_short %} subscription, you have access to {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_windows_terminal %}.

-Owners of organizations or enterprises with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription can decide whether to grant access to {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_windows_terminal %} for users in their organization or enterprise under the {% data variables.product.prodname_copilot_cli %} policy. +Owners of organizations or enterprises with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription can decide whether to grant access to {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_windows_terminal %} for users in their organization or enterprise under the {% data variables.copilot.copilot_cli %} policy. diff --git a/data/reusables/rai/code-scanning/copilot-autofix-note.md b/data/reusables/rai/code-scanning/copilot-autofix-note.md index 73d5c11c05..0fcd67c034 100644 --- a/data/reusables/rai/code-scanning/copilot-autofix-note.md +++ b/data/reusables/rai/code-scanning/copilot-autofix-note.md @@ -1,6 +1,6 @@ {% ifversion code-scanning-autofix %} > [!NOTE] -> You do not need a subscription to {% data variables.product.prodname_copilot %} to use {% data variables.product.prodname_copilot_autofix %}. {% data variables.product.prodname_copilot_autofix_short %} is available to all public repositories on {% data variables.product.prodname_dotcom_the_website %}, as well as internal or private repositories owned by organizations and enterprises that have a license for {% data variables.product.prodname_GH_code_security %}. +> You do not need a subscription to {% data variables.product.prodname_copilot %} to use {% data variables.copilot.copilot_autofix %}. {% data variables.copilot.copilot_autofix_short %} is available to all public repositories on {% data variables.product.prodname_dotcom_the_website %}, as well as internal or private repositories owned by organizations and enterprises that have a license for {% data variables.product.prodname_GH_code_security %}. {% endif %} diff --git a/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md b/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md index 0dda0ad76e..dae4d0d456 100644 --- a/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md +++ b/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md @@ -1,6 +1,6 @@ {% ifversion copilot-hadron %} > [!NOTE] -> If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.product.prodname_copilot_workspace_pr_short %}, you can click **Open in Workspace** on a {% data variables.product.prodname_copilot_autofix_short %} suggestion to open a {% data variables.product.prodname_copilot_workspace %} directly on {% data variables.product.github %}. {% data variables.product.prodname_copilot_workspace_pr_short %} allows you to view and edit all {% data variables.product.prodname_copilot_autofix_short %} suggestions and other review suggestions for the pull request, run CI tests to confirm they still pass, and then apply multiple changes in one commit. 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). +> If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.copilot.copilot_workspace_pr_short %}, you can click **Open in Workspace** on a {% data variables.copilot.copilot_autofix_short %} suggestion to open a {% data variables.copilot.copilot_workspace %} directly on {% data variables.product.github %}. {% data variables.copilot.copilot_workspace_pr_short %} allows you to view and edit all {% data variables.copilot.copilot_autofix_short %} suggestions and other review suggestions for the pull request, run CI tests to confirm they still pass, and then apply multiple changes in one commit. 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). {% endif %} diff --git a/data/reusables/rai/code-scanning/gated-feature-autofix.md b/data/reusables/rai/code-scanning/gated-feature-autofix.md index 97f67d5977..3ecec43c52 100644 --- a/data/reusables/rai/code-scanning/gated-feature-autofix.md +++ b/data/reusables/rai/code-scanning/gated-feature-autofix.md @@ -1,4 +1,4 @@ -{% data variables.product.prodname_copilot_autofix %} for {% data variables.product.prodname_code_scanning %} is available for the following repository types: +{% data variables.copilot.copilot_autofix %} for {% data variables.product.prodname_code_scanning %} is available for the following repository types: {% ifversion fpt %} * Public repositories on {% data variables.product.prodname_dotcom_the_website %} diff --git a/data/reusables/rai/copilot-dotcom-feedback-collection.md b/data/reusables/rai/copilot-dotcom-feedback-collection.md index d6026026fc..3288c00a0c 100644 --- a/data/reusables/rai/copilot-dotcom-feedback-collection.md +++ b/data/reusables/rai/copilot-dotcom-feedback-collection.md @@ -1 +1 @@ -> [!NOTE] The ability to provide feedback to {% data variables.product.prodname_dotcom %} about {% data variables.product.prodname_copilot_for_prs %} is dependent on enterprise settings. For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). +> [!NOTE] The ability to provide feedback to {% data variables.product.prodname_dotcom %} about {% data variables.copilot.copilot_for_prs %} is dependent on enterprise settings. For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise). diff --git a/data/reusables/rai/copilot/about-copilot-chat-ide.md b/data/reusables/rai/copilot/about-copilot-chat-ide.md index 8f8be0d315..8bd8350369 100644 --- a/data/reusables/rai/copilot/about-copilot-chat-ide.md +++ b/data/reusables/rai/copilot/about-copilot-chat-ide.md @@ -1,9 +1,9 @@ -## About {% data variables.product.prodname_copilot_chat %} +## About {% data variables.copilot.copilot_chat %} -{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within the {% data variables.product.github %} website and supported IDEs. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. For more information, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). +{% data variables.copilot.copilot_chat %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within the {% data variables.product.github %} website and supported IDEs. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. For more information, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). -{% data variables.product.prodname_copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.product.prodname_copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. +{% data variables.copilot.copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.copilot.copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. -The primary supported language for {% data variables.product.prodname_copilot_chat %} is English. +The primary supported language for {% data variables.copilot.copilot_chat %} is English. -{% data variables.product.prodname_copilot_chat %} works by using a combination of natural language processing and machine learning to understand your question and provide you with an answer. This process can be broken down into a number of steps. +{% data variables.copilot.copilot_chat %} works by using a combination of natural language processing and machine learning to understand your question and provide you with an answer. This process can be broken down into a number of steps. diff --git a/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md b/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md index ed394607ab..50a9b4b9ff 100644 --- a/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md +++ b/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md @@ -1,10 +1,10 @@ ### Input processing -The input prompt from the user is pre-processed by the {% data variables.product.prodname_copilot_chat_short %} system and sent to a large language model to get a response based on the context and prompt. User input can take the form of code snippets or plain language. The system is only intended to respond to coding-related questions. +The input prompt from the user is pre-processed by the {% data variables.copilot.copilot_chat_short %} system and sent to a large language model to get a response based on the context and prompt. User input can take the form of code snippets or plain language. The system is only intended to respond to coding-related questions. ### Language model analysis -The pre-processed prompt is then passed through the {% data variables.product.prodname_copilot_chat_short %} language model, which is a neural network that has been trained on a large body of text data. The language model analyzes the input prompt. +The pre-processed prompt is then passed through the {% data variables.copilot.copilot_chat_short %} language model, which is a neural network that has been trained on a large body of text data. The language model analyzes the input prompt. ### Response generation @@ -12,90 +12,90 @@ The language model generates a response based on its analysis of the input promp ### Output formatting -The response generated by {% data variables.product.prodname_copilot_chat_short %} is formatted and presented to the user. {% data variables.product.prodname_copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. +The response generated by {% data variables.copilot.copilot_chat_short %} is formatted and presented to the user. {% data variables.copilot.copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. -{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. For more information on improving the performance of {% data variables.product.prodname_copilot_mobile_short %}, see [Improving performance for {% data variables.product.prodname_copilot_mobile_short %}](#improving-performance-for-copilot-chat-in-github-mobile). +{% data variables.copilot.copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.copilot.copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. For more information on improving the performance of {% data variables.copilot.copilot_mobile_short %}, see [Improving performance for {% data variables.copilot.copilot_mobile_short %}](#improving-performance-for-copilot-chat-in-github-mobile). ## Differences per {% data variables.product.prodname_copilot %} plan -The options available to you in {% data variables.product.prodname_copilot_mobile_short %} vary depending on the {% data variables.product.prodname_copilot %} plan you are using. +The options available to you in {% data variables.copilot.copilot_mobile_short %} vary depending on the {% data variables.product.prodname_copilot %} plan you are using. -* Only people with a {% data variables.product.prodname_copilot_enterprise %} subscription can access and have conversations using the data from private indexed repositories. -* If you have a {% data variables.product.prodname_copilot_enterprise %} subscription and you have enabled Bing search integration, {% data variables.product.prodname_copilot_mobile_short %} may respond using information based on the results of a Bing search. For information on how to enable or disable Bing search integration, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %} -* In addition to general coding conversations or conversations about a single file, people with a {% data variables.product.prodname_copilot_pro_short %} subscription have the ability to discuss top popular public repositories using embeddings. +* Only people with a {% data variables.copilot.copilot_enterprise %} subscription can access and have conversations using the data from private indexed repositories. +* If you have a {% data variables.copilot.copilot_enterprise %} subscription and you have enabled Bing search integration, {% data variables.copilot.copilot_mobile_short %} may respond using information based on the results of a Bing search. For information on how to enable or disable Bing search integration, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %} +* In addition to general coding conversations or conversations about a single file, people with a {% data variables.copilot.copilot_pro_short %} subscription have the ability to discuss top popular public repositories using embeddings. -If you do not have a {% data variables.product.prodname_copilot %} subscription, you can purchase a {% data variables.product.prodname_copilot_pro_short %} subscription directly in the iOS version of {% data variables.product.prodname_mobile %}, or in the Google Play Store for the Android version of {% data variables.product.prodname_mobile %}. +If you do not have a {% data variables.product.prodname_copilot %} subscription, you can purchase a {% data variables.copilot.copilot_pro_short %} subscription directly in the iOS version of {% data variables.product.prodname_mobile %}, or in the Google Play Store for the Android version of {% data variables.product.prodname_mobile %}. -## Use cases for {% data variables.product.prodname_copilot_mobile %} +## Use cases for {% data variables.copilot.copilot_mobile %} -{% data variables.product.prodname_copilot_mobile %} can provide coding assistance in a variety of scenarios. +{% data variables.copilot.copilot_mobile %} can provide coding assistance in a variety of scenarios. ### Explaining code and suggesting improvements -{% data variables.product.prodname_copilot_chat_short %} can help explain selected code by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, if you select a function or code block in the code editor, {% data variables.product.prodname_copilot_chat_short %} can generate a natural language description of what the code does and how it fits into the overall system. This can include information such as the function's input and output parameters, its dependencies, and its purpose in the larger application. +{% data variables.copilot.copilot_chat_short %} can help explain selected code by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, if you select a function or code block in the code editor, {% data variables.copilot.copilot_chat_short %} can generate a natural language description of what the code does and how it fits into the overall system. This can include information such as the function's input and output parameters, its dependencies, and its purpose in the larger application. -{% data variables.product.prodname_copilot_chat_short %} can also suggest potential improvements to selected code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. +{% data variables.copilot.copilot_chat_short %} can also suggest potential improvements to selected code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. -By generating explanations and suggesting related documentation, {% data variables.product.prodname_copilot_chat_short %} may help you to understand the selected code, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.product.prodname_copilot_chat_short %}'s output. +By generating explanations and suggesting related documentation, {% data variables.copilot.copilot_chat_short %} may help you to understand the selected code, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.copilot.copilot_chat_short %}'s output. ### Proposing code fixes -{% data variables.product.prodname_copilot_chat_short %} can propose a fix for bugs in your code by suggesting code snippets and solutions based on the context of the error or issue. This can be useful if you are struggling to identify the root cause of a bug or you need guidance on the best way to fix it. For example, if your code produces an error message or warning, {% data variables.product.prodname_copilot_chat_short %} can suggest possible fixes based on the error message, the code's syntax, and the surrounding code. +{% data variables.copilot.copilot_chat_short %} can propose a fix for bugs in your code by suggesting code snippets and solutions based on the context of the error or issue. This can be useful if you are struggling to identify the root cause of a bug or you need guidance on the best way to fix it. For example, if your code produces an error message or warning, {% data variables.copilot.copilot_chat_short %} can suggest possible fixes based on the error message, the code's syntax, and the surrounding code. -{% data variables.product.prodname_copilot_chat_short %} can suggest changes to variables, control structures, or function calls that might resolve the issue and generate code snippets that can be incorporated into the codebase. However, it's important to note that the suggested fixes may not always be optimal or complete, so you'll need to review and test the suggestions. +{% data variables.copilot.copilot_chat_short %} can suggest changes to variables, control structures, or function calls that might resolve the issue and generate code snippets that can be incorporated into the codebase. However, it's important to note that the suggested fixes may not always be optimal or complete, so you'll need to review and test the suggestions. ### Answering coding questions -You can ask {% data variables.product.prodname_copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. This can be a useful tool for programmers, as it can provide guidance and support for common coding tasks and challenges. +You can ask {% data variables.copilot.copilot_chat_short %} for help or clarification on specific coding problems and receive responses in natural language format or in code snippet format. This can be a useful tool for programmers, as it can provide guidance and support for common coding tasks and challenges. -## Improving performance for {% data variables.product.prodname_copilot_mobile_short %} +## Improving performance for {% data variables.copilot.copilot_mobile_short %} -{% data variables.product.prodname_copilot_chat_short %} can support a wide range of practical applications like code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the limitations of {% data variables.product.prodname_copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.product.prodname_copilot_mobile_short %}, see [Limitations of {% data variables.product.prodname_copilot_mobile_short %}](#limitations-of-copilot-chat-in-github-mobile). +{% data variables.copilot.copilot_chat_short %} can support a wide range of practical applications like code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the limitations of {% data variables.copilot.copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.copilot.copilot_mobile_short %}, see [Limitations of {% data variables.copilot.copilot_mobile_short %}](#limitations-of-copilot-chat-in-github-mobile). ### Keep your prompts on topic -{% data variables.product.prodname_copilot_chat_short %} is intended to address queries related to coding exclusively. Therefore, limiting the prompt to coding questions or tasks can enhance the model's output quality. +{% data variables.copilot.copilot_chat_short %} is intended to address queries related to coding exclusively. Therefore, limiting the prompt to coding questions or tasks can enhance the model's output quality. -### Use {% data variables.product.prodname_copilot_chat_short %} as a tool, not a replacement +### Use {% data variables.copilot.copilot_chat_short %} as a tool, not a replacement -While {% data variables.product.prodname_copilot_chat_short %} can be a powerful tool for generating code, it is important to use it as a tool rather than a replacement for human programming. You should always review and test the code generated by {% data variables.product.prodname_copilot_chat_short %} to ensure that it meets your requirements and is free of errors or security concerns. +While {% data variables.copilot.copilot_chat_short %} can be a powerful tool for generating code, it is important to use it as a tool rather than a replacement for human programming. You should always review and test the code generated by {% data variables.copilot.copilot_chat_short %} to ensure that it meets your requirements and is free of errors or security concerns. ### Use secure coding and code review practices -While {% data variables.product.prodname_copilot_chat_short %} can generate syntactically correct code, it may not always be secure. You should always follow best practices for secure coding, such as avoiding hard-coded passwords or SQL injection vulnerabilities, as well as following code review best practices, to address {% data variables.product.prodname_copilot_chat_short %}'s limitations. +While {% data variables.copilot.copilot_chat_short %} can generate syntactically correct code, it may not always be secure. You should always follow best practices for secure coding, such as avoiding hard-coded passwords or SQL injection vulnerabilities, as well as following code review best practices, to address {% data variables.copilot.copilot_chat_short %}'s limitations. ### Provide feedback -If you encounter any issues or limitations with {% data variables.product.prodname_copilot_chat_short %}, we recommend that you provide feedback through the **share feedback** link in {% data variables.product.prodname_copilot_mobile_short %} that appears when you dislike a response. This can help the developers to improve the tool and address any concerns or limitations. +If you encounter any issues or limitations with {% data variables.copilot.copilot_chat_short %}, we recommend that you provide feedback through the **share feedback** link in {% data variables.copilot.copilot_mobile_short %} that appears when you dislike a response. This can help the developers to improve the tool and address any concerns or limitations. ### Stay up to date -{% data variables.product.prodname_copilot_mobile_short %} is a new technology and is likely to evolve over time. You should stay up to date with any updates or changes to the tool, as well as any new security risks or best practices that may emerge. +{% data variables.copilot.copilot_mobile_short %} is a new technology and is likely to evolve over time. You should stay up to date with any updates or changes to the tool, as well as any new security risks or best practices that may emerge. -## Limitations of {% data variables.product.prodname_copilot_mobile_short %} +## Limitations of {% data variables.copilot.copilot_mobile_short %} -Depending on factors such as your codebase and input data, you may experience different levels of performance when using {% data variables.product.prodname_copilot_chat_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.product.prodname_copilot_chat_short %}. +Depending on factors such as your codebase and input data, you may experience different levels of performance when using {% data variables.copilot.copilot_chat_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.copilot.copilot_chat_short %}. ### Limited scope -{% data variables.product.prodname_copilot_chat_short %} has been trained on a large body of code but still has a limited scope and may not be able to handle more complex code structures or obscure programming languages. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may be more challenging for {% data variables.product.prodname_copilot_chat_short %} to provide assistance with. Additionally, {% data variables.product.prodname_copilot_chat_short %} can only suggest code based on the context of the code being written, so it may not be able to identify larger design or architectural issues. +{% data variables.copilot.copilot_chat_short %} has been trained on a large body of code but still has a limited scope and may not be able to handle more complex code structures or obscure programming languages. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may be more challenging for {% data variables.copilot.copilot_chat_short %} to provide assistance with. Additionally, {% data variables.copilot.copilot_chat_short %} can only suggest code based on the context of the code being written, so it may not be able to identify larger design or architectural issues. ### Potential biases -{% data variables.product.prodname_copilot_short %}'s training data is drawn from existing code repositories, which may contain biases and errors that can be perpetuated by the tool. Additionally, {% data variables.product.prodname_copilot_chat_short %} may be biased towards certain programming languages or coding styles, which can lead to suboptimal or incomplete code suggestions. +{% data variables.product.prodname_copilot_short %}'s training data is drawn from existing code repositories, which may contain biases and errors that can be perpetuated by the tool. Additionally, {% data variables.copilot.copilot_chat_short %} may be biased towards certain programming languages or coding styles, which can lead to suboptimal or incomplete code suggestions. ### Security risks -{% data variables.product.prodname_copilot_chat_short %} generates code based on the context of the code being written, which can potentially expose sensitive information or vulnerabilities if not used carefully. You should be careful when using {% data variables.product.prodname_copilot_chat_short %} to generate code for security-sensitive applications and always review and test the generated code thoroughly. +{% data variables.copilot.copilot_chat_short %} generates code based on the context of the code being written, which can potentially expose sensitive information or vulnerabilities if not used carefully. You should be careful when using {% data variables.copilot.copilot_chat_short %} to generate code for security-sensitive applications and always review and test the generated code thoroughly. ### Matches with public code -{% data variables.product.prodname_copilot_chat_short %} is capable of generating new code, which it does in a probabilistic way. While the probability that it may produce code that matches code in the training set is low, a {% data variables.product.prodname_copilot_chat_short %} suggestion may contain some code snippets that match code in the training set. {% data variables.product.prodname_copilot_chat_short %} utilizes filters that block matches with public code on {% data variables.product.prodname_dotcom %} repositories, but you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. +{% data variables.copilot.copilot_chat_short %} is capable of generating new code, which it does in a probabilistic way. While the probability that it may produce code that matches code in the training set is low, a {% data variables.copilot.copilot_chat_short %} suggestion may contain some code snippets that match code in the training set. {% data variables.copilot.copilot_chat_short %} utilizes filters that block matches with public code on {% data variables.product.prodname_dotcom %} repositories, but you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. ### Inaccurate code -One of the limitations of {% data variables.product.prodname_copilot_chat_short %} is that it may generate code that appears to be valid but may not actually be semantically or syntactically correct or may not accurately reflect the intent of the developer. To mitigate the risk of inaccurate code, you should carefully review and test the generated code, particularly when dealing with critical or sensitive applications. You should also ensure that the generated code adheres to best practices and design patterns and fits within the overall architecture and style of the codebase. +One of the limitations of {% data variables.copilot.copilot_chat_short %} is that it may generate code that appears to be valid but may not actually be semantically or syntactically correct or may not accurately reflect the intent of the developer. To mitigate the risk of inaccurate code, you should carefully review and test the generated code, particularly when dealing with critical or sensitive applications. You should also ensure that the generated code adheres to best practices and design patterns and fits within the overall architecture and style of the codebase. ### Inaccurate responses to non-coding topics -{% data variables.product.prodname_copilot_chat_short %} is not designed to answer non-coding questions, and therefore its responses may not always be accurate or helpful in these contexts. If a user asks {% data variables.product.prodname_copilot_chat_short %} a non-coding question, it may generate an answer that is irrelevant or nonsensical, or it may simply indicate that it is unable to provide a useful response. +{% data variables.copilot.copilot_chat_short %} is not designed to answer non-coding questions, and therefore its responses may not always be accurate or helpful in these contexts. If a user asks {% data variables.copilot.copilot_chat_short %} a non-coding question, it may generate an answer that is irrelevant or nonsensical, or it may simply indicate that it is unable to provide a useful response. diff --git a/data/reusables/rai/copilot/copilot-chat-explain-code.md b/data/reusables/rai/copilot/copilot-chat-explain-code.md index 1aadccc2d3..b39d99c0e8 100644 --- a/data/reusables/rai/copilot/copilot-chat-explain-code.md +++ b/data/reusables/rai/copilot/copilot-chat-explain-code.md @@ -1,7 +1,7 @@ ### Explaining code and suggesting improvements -{% data variables.product.prodname_copilot_chat_short %} can help explain selected code by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, if you select a function or code block in the code editor, {% data variables.product.prodname_copilot_chat_short %} can generate a natural language description of what the code does and how it fits into the overall system. This can include information such as the function's input and output parameters, its dependencies, and its purpose in the larger application. +{% data variables.copilot.copilot_chat_short %} can help explain selected code by generating natural language descriptions of the code's functionality and purpose. This can be useful if you want to understand the code's behavior or for non-technical stakeholders who need to understand how the code works. For example, if you select a function or code block in the code editor, {% data variables.copilot.copilot_chat_short %} can generate a natural language description of what the code does and how it fits into the overall system. This can include information such as the function's input and output parameters, its dependencies, and its purpose in the larger application. -{% data variables.product.prodname_copilot_chat_short %} can also suggest potential improvements to selected code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. +{% data variables.copilot.copilot_chat_short %} can also suggest potential improvements to selected code, such as improved handling of errors and edge cases, or changes to the logical flow to make the code more readable. -By generating explanations and suggesting related documentation, {% data variables.product.prodname_copilot_chat_short %} may help you to understand the selected code, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.product.prodname_copilot_chat_short %}'s output. +By generating explanations and suggesting related documentation, {% data variables.copilot.copilot_chat_short %} may help you to understand the selected code, leading to improved collaboration and more effective software development. However, it's important to note that the generated explanations and documentation may not always be accurate or complete, so you'll need to review, and occasionally correct, {% data variables.copilot.copilot_chat_short %}'s output. diff --git a/data/reusables/rai/copilot/copilot-chat-generate-test-cases.md b/data/reusables/rai/copilot/copilot-chat-generate-test-cases.md index 79961cd050..44bdba4ff5 100644 --- a/data/reusables/rai/copilot/copilot-chat-generate-test-cases.md +++ b/data/reusables/rai/copilot/copilot-chat-generate-test-cases.md @@ -1,5 +1,5 @@ ### Generating unit test cases -{% data variables.product.prodname_copilot_chat_short %} can help you write unit test cases by generating code snippets based on the code open in the editor or the code snippet you highlight in the editor. This may help you write test cases without spending as much time on repetitive tasks. For example, if you are writing a test case for a specific function, you can use {% data variables.product.prodname_copilot_chat_short %} to suggest possible input parameters and expected output values based on the function's signature and body. {% data variables.product.prodname_copilot_chat_short %} can also suggest assertions that ensure the function is working correctly, based on the code's context and semantics. +{% data variables.copilot.copilot_chat_short %} can help you write unit test cases by generating code snippets based on the code open in the editor or the code snippet you highlight in the editor. This may help you write test cases without spending as much time on repetitive tasks. For example, if you are writing a test case for a specific function, you can use {% data variables.copilot.copilot_chat_short %} to suggest possible input parameters and expected output values based on the function's signature and body. {% data variables.copilot.copilot_chat_short %} can also suggest assertions that ensure the function is working correctly, based on the code's context and semantics. -{% data variables.product.prodname_copilot_chat_short %} can also help you write test cases for edge cases and boundary conditions that might be difficult to identify manually. For instance, {% data variables.product.prodname_copilot_chat_short %} can suggest test cases for error handling, null values, or unexpected input types, helping you ensure your code is robust and resilient. However, it is important to note that generated test cases may not cover all possible scenarios, and manual testing and code review are still necessary to ensure the quality of the code. For more information on generating unit test cases, see [Asking {% data variables.product.prodname_copilot_chat %} questions about your code](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-github-copilot-chat-questions-about-your-code). +{% data variables.copilot.copilot_chat_short %} can also help you write test cases for edge cases and boundary conditions that might be difficult to identify manually. For instance, {% data variables.copilot.copilot_chat_short %} can suggest test cases for error handling, null values, or unexpected input types, helping you ensure your code is robust and resilient. However, it is important to note that generated test cases may not cover all possible scenarios, and manual testing and code review are still necessary to ensure the quality of the code. For more information on generating unit test cases, see [Asking {% data variables.copilot.copilot_chat %} questions about your code](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-github-copilot-chat-questions-about-your-code). diff --git a/data/reusables/rai/copilot/copilot-chat-ide-improving-performance.md b/data/reusables/rai/copilot/copilot-chat-ide-improving-performance.md index 3894a5baf9..93796eb7db 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-improving-performance.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-improving-performance.md @@ -1,15 +1,15 @@ -## Improving performance for {% data variables.product.prodname_copilot_chat %} +## Improving performance for {% data variables.copilot.copilot_chat %} -{% data variables.product.prodname_copilot_chat_short %} can support a wide range of practical applications like code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the limitations of {% data variables.product.prodname_copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.product.prodname_copilot_chat_short %}, see [Limitations of {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#limitations-of-github-copilot-chat). +{% data variables.copilot.copilot_chat_short %} can support a wide range of practical applications like code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the limitations of {% data variables.copilot.copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.copilot.copilot_chat_short %}, see [Limitations of {% data variables.copilot.copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#limitations-of-github-copilot-chat). ### Keep your prompts on topic -{% data variables.product.prodname_copilot_chat_short %} is intended to address queries related to coding exclusively. Therefore, limiting the prompt to coding questions or tasks can enhance the model's output quality. +{% data variables.copilot.copilot_chat_short %} is intended to address queries related to coding exclusively. Therefore, limiting the prompt to coding questions or tasks can enhance the model's output quality. -### Use {% data variables.product.prodname_copilot_chat_short %} as a tool, not a replacement +### Use {% data variables.copilot.copilot_chat_short %} as a tool, not a replacement -While {% data variables.product.prodname_copilot_chat_short %} can be a powerful tool for generating code, it is important to use it as a tool rather than a replacement for human programming. You should always review and test the code generated by {% data variables.product.prodname_copilot_chat_short %} to ensure that it meets your requirements and is free of errors or security concerns. +While {% data variables.copilot.copilot_chat_short %} can be a powerful tool for generating code, it is important to use it as a tool rather than a replacement for human programming. You should always review and test the code generated by {% data variables.copilot.copilot_chat_short %} to ensure that it meets your requirements and is free of errors or security concerns. ### Use secure coding and code review practices -While {% data variables.product.prodname_copilot_chat_short %} can generate syntactically correct code, it may not always be secure. You should always follow best practices for secure coding, such as avoiding hard-coded passwords or SQL injection vulnerabilities, as well as following code review best practices, to address {% data variables.product.prodname_copilot_chat_short %}'s limitations. +While {% data variables.copilot.copilot_chat_short %} can generate syntactically correct code, it may not always be secure. You should always follow best practices for secure coding, such as avoiding hard-coded passwords or SQL injection vulnerabilities, as well as following code review best practices, to address {% data variables.copilot.copilot_chat_short %}'s limitations. diff --git a/data/reusables/rai/copilot/copilot-chat-ide-input-processing-all1.md b/data/reusables/rai/copilot/copilot-chat-ide-input-processing-all1.md index 6dbf694b66..016dd86582 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-input-processing-all1.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-input-processing-all1.md @@ -1,3 +1,3 @@ ### Input processing -The input prompt from the user is pre-processed by the {% data variables.product.prodname_copilot_chat_short %} system, combined with contextual information (for example, the name of the repository the user is currently viewing and the files the user has open), and sent to a large language model. User input can take the form of code snippets or plain language. +The input prompt from the user is pre-processed by the {% data variables.copilot.copilot_chat_short %} system, combined with contextual information (for example, the name of the repository the user is currently viewing and the files the user has open), and sent to a large language model. User input can take the form of code snippets or plain language. diff --git a/data/reusables/rai/copilot/copilot-chat-ide-language-model-analysis.md b/data/reusables/rai/copilot/copilot-chat-ide-language-model-analysis.md index 6d9128912a..df80e3f29e 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-language-model-analysis.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-language-model-analysis.md @@ -1,3 +1,3 @@ ### Language model analysis -The pre-processed prompt is then passed through the {% data variables.product.prodname_copilot_chat_short %} language model, which is a neural network that has been trained on a large body of text data. The language model analyzes the input prompt. +The pre-processed prompt is then passed through the {% data variables.copilot.copilot_chat_short %} language model, which is a neural network that has been trained on a large body of text data. The language model analyzes the input prompt. diff --git a/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md b/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md index ee114cf9c7..f4b61e0e2e 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md @@ -1,6 +1,6 @@ ### Leveraging a web search to answer a question -When you use the `@github` chat participant, {% data variables.product.prodname_copilot_chat %} can use a Bing search to help answer your question if this has been enabled by your administrator. +When you use the `@github` chat participant, {% data variables.copilot.copilot_chat %} can use a Bing search to help answer your question if this has been enabled by your administrator. Your {% data variables.product.prodname_enterprise %} administrator can enable Bing for your whole enterprise, or can delegate this decision to the organizational administrator. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise). diff --git a/data/reusables/rai/copilot/copilot-chat-ide-limitations.md b/data/reusables/rai/copilot/copilot-chat-ide-limitations.md index a64f20dac2..cf108030b4 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-limitations.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-limitations.md @@ -1,47 +1,47 @@ -## Limitations of {% data variables.product.prodname_copilot_chat %} +## Limitations of {% data variables.copilot.copilot_chat %} -Depending on factors such as your codebase and input data, you may experience different levels of performance when using {% data variables.product.prodname_copilot_chat_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.product.prodname_copilot_chat_short %}. +Depending on factors such as your codebase and input data, you may experience different levels of performance when using {% data variables.copilot.copilot_chat_short %}. The following information is designed to help you understand system limitations and key concepts about performance as they apply to {% data variables.copilot.copilot_chat_short %}. ### Limited scope -{% data variables.product.prodname_copilot_chat_short %} has been trained on a large body of code but still has a limited scope and may not be able to handle more complex code structures or obscure programming languages. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may be more challenging for {% data variables.product.prodname_copilot_chat_short %} to provide assistance with. Additionally, {% data variables.product.prodname_copilot_chat_short %} can only suggest code based on the context of the code being written, so it may not be able to identify larger design or architectural issues. +{% data variables.copilot.copilot_chat_short %} has been trained on a large body of code but still has a limited scope and may not be able to handle more complex code structures or obscure programming languages. For each language, the quality of suggestions you receive may depend on the volume and diversity of training data for that language. For example, JavaScript is well-represented in public repositories and is one of {% data variables.product.prodname_copilot %}'s best supported languages. Languages with less representation in public repositories may be more challenging for {% data variables.copilot.copilot_chat_short %} to provide assistance with. Additionally, {% data variables.copilot.copilot_chat_short %} can only suggest code based on the context of the code being written, so it may not be able to identify larger design or architectural issues. ### Potential biases -{% data variables.product.prodname_copilot_short %}'s training data is drawn from existing code repositories, which may contain biases and errors that can be perpetuated by the tool. Additionally, {% data variables.product.prodname_copilot_chat_short %} may be biased towards certain programming languages or coding styles, which can lead to suboptimal or incomplete code suggestions. +{% data variables.product.prodname_copilot_short %}'s training data is drawn from existing code repositories, which may contain biases and errors that can be perpetuated by the tool. Additionally, {% data variables.copilot.copilot_chat_short %} may be biased towards certain programming languages or coding styles, which can lead to suboptimal or incomplete code suggestions. ### Security risks -{% data variables.product.prodname_copilot_chat_short %} generates code based on the context of the code being written, which can potentially expose sensitive information or vulnerabilities if not used carefully. You should be careful when using {% data variables.product.prodname_copilot_chat_short %} to generate code for security-sensitive applications and always review and test the generated code thoroughly. +{% data variables.copilot.copilot_chat_short %} generates code based on the context of the code being written, which can potentially expose sensitive information or vulnerabilities if not used carefully. You should be careful when using {% data variables.copilot.copilot_chat_short %} to generate code for security-sensitive applications and always review and test the generated code thoroughly. ### Matches with public code -{% data variables.product.prodname_copilot_chat_short %} is capable of generating new code, which it does in a probabilistic way. While the probability that it may produce code that matches code in the training set is low, a {% data variables.product.prodname_copilot_chat_short %} suggestion may contain some code snippets that match code in the training set. +{% data variables.copilot.copilot_chat_short %} is capable of generating new code, which it does in a probabilistic way. While the probability that it may produce code that matches code in the training set is low, a {% data variables.copilot.copilot_chat_short %} suggestion may contain some code snippets that match code in the training set. {% vscode %} -If you have disabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} utilizes filters that prevent it from showing code that matches code found in public repositories on {% data variables.product.prodname_dotcom %}. However, you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. +If you have disabled suggestions that match public code then {% data variables.copilot.copilot_chat_short %} utilizes filters that prevent it from showing code that matches code found in public repositories on {% data variables.product.prodname_dotcom %}. However, you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. -If you have enabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} displays a message if matching code is found. The message includes a link that allows you to show the details of the matched code, and any license details that were found, in the {% data variables.product.prodname_vscode_shortname %} editor. For more information, see [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions). +If you have enabled suggestions that match public code then {% data variables.copilot.copilot_chat_short %} displays a message if matching code is found. The message includes a link that allows you to show the details of the matched code, and any license details that were found, in the {% data variables.product.prodname_vscode_shortname %} editor. For more information, see [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions). {% endvscode %} {% visualstudio %} -{% data variables.product.prodname_copilot_chat_short %} utilizes filters that block matches with public code on {% data variables.product.prodname_dotcom %} repositories, but you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. +{% data variables.copilot.copilot_chat_short %} utilizes filters that block matches with public code on {% data variables.product.prodname_dotcom %} repositories, but you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. {% endvisualstudio %} {% jetbrains %} -{% data variables.product.prodname_copilot_chat_short %} utilizes filters that block matches with public code on {% data variables.product.prodname_dotcom %} repositories, but you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. +{% data variables.copilot.copilot_chat_short %} utilizes filters that block matches with public code on {% data variables.product.prodname_dotcom %} repositories, but you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. {% endjetbrains %} ### Inaccurate code -One of the limitations of {% data variables.product.prodname_copilot_chat_short %} is that it may generate code that appears to be valid but may not actually be semantically or syntactically correct or may not accurately reflect the intent of the developer. To mitigate the risk of inaccurate code, you should carefully review and test the generated code, particularly when dealing with critical or sensitive applications. You should also ensure that the generated code adheres to best practices and design patterns and fits within the overall architecture and style of the codebase. +One of the limitations of {% data variables.copilot.copilot_chat_short %} is that it may generate code that appears to be valid but may not actually be semantically or syntactically correct or may not accurately reflect the intent of the developer. To mitigate the risk of inaccurate code, you should carefully review and test the generated code, particularly when dealing with critical or sensitive applications. You should also ensure that the generated code adheres to best practices and design patterns and fits within the overall architecture and style of the codebase. ### Inaccurate responses to non-coding topics -{% data variables.product.prodname_copilot_chat_short %} is not designed to answer non-coding questions, and therefore its responses may not always be accurate or helpful in these contexts. If a user asks {% data variables.product.prodname_copilot_chat_short %} a non-coding question, it may generate an answer that is irrelevant or nonsensical, or it may simply indicate that it is unable to provide a useful response. +{% data variables.copilot.copilot_chat_short %} is not designed to answer non-coding questions, and therefore its responses may not always be accurate or helpful in these contexts. If a user asks {% data variables.copilot.copilot_chat_short %} a non-coding question, it may generate an answer that is irrelevant or nonsensical, or it may simply indicate that it is unable to provide a useful response. diff --git a/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md b/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md index 35829545a3..ecbd744773 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md @@ -1,6 +1,6 @@ ## Next steps -For details of how to use {% data variables.product.prodname_copilot_chat %}, see: +For details of how to use {% data variables.copilot.copilot_chat %}, see: * [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide) * [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom) diff --git a/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md b/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md index 9c98e2e7ec..2b9e5ad7af 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md @@ -1,5 +1,5 @@ ### Output formatting -The response generated by {% data variables.product.prodname_copilot_chat_short %} is formatted and presented to the user. {% data variables.product.prodname_copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. +The response generated by {% data variables.copilot.copilot_chat_short %} is formatted and presented to the user. {% data variables.copilot.copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. -{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.product.prodname_copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.product.prodname_copilot_chat %}, see [Improving performance for {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#improving-performance-for-github-copilot-chat). +{% data variables.copilot.copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.copilot.copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.copilot.copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.copilot.copilot_chat %}, see [Improving performance for {% data variables.copilot.copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#improving-performance-for-github-copilot-chat). diff --git a/data/reusables/rai/copilot/copilot-chat-ide-provide-feedback.md b/data/reusables/rai/copilot/copilot-chat-ide-provide-feedback.md index d145fd5f3f..90d0aa27de 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-provide-feedback.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-provide-feedback.md @@ -1,3 +1,3 @@ ### Provide feedback -If you encounter any issues or limitations with {% data variables.product.prodname_copilot_chat_short %}, we recommend that you provide feedback through the **share feedback** link in the {% data variables.product.prodname_copilot_chat_short %} interface of your IDE. This can help the developers to improve the tool and address any concerns or limitations. +If you encounter any issues or limitations with {% data variables.copilot.copilot_chat_short %}, we recommend that you provide feedback through the **share feedback** link in the {% data variables.copilot.copilot_chat_short %} interface of your IDE. This can help the developers to improve the tool and address any concerns or limitations. diff --git a/data/reusables/rai/copilot/copilot-chat-ide-stay-up-to-date.md b/data/reusables/rai/copilot/copilot-chat-ide-stay-up-to-date.md index d6e8c32b91..29a7f8b2af 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-stay-up-to-date.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-stay-up-to-date.md @@ -1,3 +1,3 @@ ### Stay up to date -{% data variables.product.prodname_copilot_chat_short %} is a new technology and is likely to evolve over time. You should stay up to date with any updates or changes to the tool, as well as any new security risks or best practices that may emerge. Automated extension updates are enabled by default in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and the JetBrains suite of IDEs. For {% data variables.product.prodname_copilot_chat_dotcom %} you will always have access to the latest product experience. If you have automatic updates enabled, {% data variables.product.prodname_copilot_chat_short %} will automatically update to the latest version when you open your IDE. For more information on automatic updates in your IDE, see [the {% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs/editor/extension-marketplace), [the {% data variables.product.prodname_vs %} documentation](https://learn.microsoft.com/en-us/visualstudio/ide/finding-and-using-visual-studio-extensions) and [the documentation for your JetBrains IDE](https://www.jetbrains.com/help). +{% data variables.copilot.copilot_chat_short %} is a new technology and is likely to evolve over time. You should stay up to date with any updates or changes to the tool, as well as any new security risks or best practices that may emerge. Automated extension updates are enabled by default in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and the JetBrains suite of IDEs. For {% data variables.copilot.copilot_chat_dotcom %} you will always have access to the latest product experience. If you have automatic updates enabled, {% data variables.copilot.copilot_chat_short %} will automatically update to the latest version when you open your IDE. For more information on automatic updates in your IDE, see [the {% data variables.product.prodname_vscode %} documentation](https://code.visualstudio.com/docs/editor/extension-marketplace), [the {% data variables.product.prodname_vs %} documentation](https://learn.microsoft.com/en-us/visualstudio/ide/finding-and-using-visual-studio-extensions) and [the documentation for your JetBrains IDE](https://www.jetbrains.com/help). diff --git a/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md b/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md index 293f507393..47458057d8 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md @@ -1,6 +1,6 @@ -## Use cases for {% data variables.product.prodname_copilot_chat %} +## Use cases for {% data variables.copilot.copilot_chat %} -{% data variables.product.prodname_copilot_chat %} can provide coding assistance in a variety of scenarios. +{% data variables.copilot.copilot_chat %} can provide coding assistance in a variety of scenarios. {% data reusables.rai.copilot.copilot-chat-generate-test-cases %} {% data reusables.rai.copilot.copilot-chat-explain-code %} {% data reusables.rai.copilot.copilot-chat-propose-fixes %} diff --git a/data/reusables/rai/copilot/copilot-chat-propose-fixes.md b/data/reusables/rai/copilot/copilot-chat-propose-fixes.md index ce12fc1b74..87e5cbf5d4 100644 --- a/data/reusables/rai/copilot/copilot-chat-propose-fixes.md +++ b/data/reusables/rai/copilot/copilot-chat-propose-fixes.md @@ -1,5 +1,5 @@ ### Proposing code fixes -{% data variables.product.prodname_copilot_chat_short %} can propose a fix for bugs in your code by suggesting code snippets and solutions based on the context of the error or issue. This can be useful if you are struggling to identify the root cause of a bug or you need guidance on the best way to fix it. For example, if your code produces an error message or warning, {% data variables.product.prodname_copilot_chat_short %} can suggest possible fixes based on the error message, the code's syntax, and the surrounding code. +{% data variables.copilot.copilot_chat_short %} can propose a fix for bugs in your code by suggesting code snippets and solutions based on the context of the error or issue. This can be useful if you are struggling to identify the root cause of a bug or you need guidance on the best way to fix it. For example, if your code produces an error message or warning, {% data variables.copilot.copilot_chat_short %} can suggest possible fixes based on the error message, the code's syntax, and the surrounding code. -{% data variables.product.prodname_copilot_chat_short %} can suggest changes to variables, control structures, or function calls that might resolve the issue and generate code snippets that can be incorporated into the codebase. However, it's important to note that the suggested fixes may not always be optimal or complete, so you'll need to review and test the suggestions. +{% data variables.copilot.copilot_chat_short %} can suggest changes to variables, control structures, or function calls that might resolve the issue and generate code snippets that can be incorporated into the codebase. However, it's important to note that the suggested fixes may not always be optimal or complete, so you'll need to review and test the suggestions. diff --git a/data/reusables/rai/copilot/enterprise-fpt-link.md b/data/reusables/rai/copilot/enterprise-fpt-link.md index e3f6761133..37577761b4 100644 --- a/data/reusables/rai/copilot/enterprise-fpt-link.md +++ b/data/reusables/rai/copilot/enterprise-fpt-link.md @@ -1 +1 @@ -> [!NOTE] You are currently viewing the documentation for Free, Pro, and Team plans. {% data variables.product.prodname_copilot_enterprise %} is only available to customers on the {% data variables.product.prodname_ghe_cloud %} plan. For full documentation of {% data variables.product.prodname_copilot_enterprise_short %}, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise) in the {% data variables.product.prodname_ghe_cloud %} documentation. +> [!NOTE] You are currently viewing the documentation for Free, Pro, and Team plans. {% data variables.copilot.copilot_enterprise %} is only available to customers on the {% data variables.product.prodname_ghe_cloud %} plan. For full documentation of {% data variables.copilot.copilot_enterprise_short %}, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise) in the {% data variables.product.prodname_ghe_cloud %} documentation. diff --git a/data/reusables/security/compliance-report-list.md b/data/reusables/security/compliance-report-list.md index 22a70b4590..3aa3391cc4 100644 --- a/data/reusables/security/compliance-report-list.md +++ b/data/reusables/security/compliance-report-list.md @@ -1,6 +1,6 @@ {%- ifversion ghec %} * SOC 1, Type 2 -* SOC 2, Type 1 ({% data variables.product.prodname_copilot_for_business %} only) +* SOC 2, Type 1 ({% data variables.copilot.copilot_for_business %} only) * SOC 2, Type 2 {%- elsif fpt %} * SOC 3 diff --git a/data/reusables/support/free-and-paid-support.md b/data/reusables/support/free-and-paid-support.md index f9ad69cffa..d4e01d98eb 100644 --- a/data/reusables/support/free-and-paid-support.md +++ b/data/reusables/support/free-and-paid-support.md @@ -1,3 +1,3 @@ -If your account uses a paid {% data variables.product.prodname_dotcom %} plan, {% data variables.product.prodname_copilot_business_short %}, or {% data variables.product.prodname_copilot_enterprise_short %}, you can directly contact {% data variables.contact.github_support %}. +If your account uses a paid {% data variables.product.prodname_dotcom %} plan, {% data variables.copilot.copilot_business_short %}, or {% data variables.copilot.copilot_enterprise_short %}, you can directly contact {% data variables.contact.github_support %}. If your account uses {% data variables.product.prodname_free_user %}, you can speak to {% data variables.product.prodname_dotcom %} users and staff on the {% data variables.contact.community_support_forum %} for most issues, and you can contact {% data variables.contact.github_support %} to report account, security, and abuse issues. diff --git a/data/variables/copilot.yml b/data/variables/copilot.yml index 7d40be703a..57252b731e 100644 --- a/data/variables/copilot.yml +++ b/data/variables/copilot.yml @@ -1,30 +1,37 @@ -# Variables used in the Copilot docs that are not product names +# Variables used in the Copilot docs. +# Note: variables for the product names 'GitHub Copilot' and 'Copilot' are defined in product.yml. -# Copilot billing: price per additional premium request +## Copilot plans (moved from product.yml) +copilot_for_business: 'GitHub Copilot Business' +copilot_for_individuals: 'GitHub Copilot Individual' +copilot_pro: 'GitHub Copilot Pro' +copilot_pro_short: 'Copilot Pro' +copilot_pro_plus: 'GitHub Copilot Pro+' +copilot_pro_plus_short: 'Copilot Pro+' +copilot_business_short: 'Copilot Business' +copilot_individuals_short: 'Copilot Individual' +copilot_enterprise: 'GitHub Copilot Enterprise' +copilot_enterprise_short: 'Copilot Enterprise' +copilot_free: 'GitHub Copilot Free' +copilot_free_short: 'Copilot Free' + +## Copilot billing +# Price per additional premium request additional_premium_requests: '$0.04 USD' - -# Copilot billing: price per month for Copilot Pro +# Price per month for Copilot Pro cfi_price_per_month: '$10 USD' - -# Copilot billing: price per year for Copilot Pro +# Price per year for Copilot Pro cfi_price_per_year: '$100 USD' - -# Copilot billing: price per month for Copilot Pro Plus +# Price per month for Copilot Pro Plus cpp_price_per_month: '$39 USD' - -# Copilot billing: price per year for Copilot Pro Plus +# Price per year for Copilot Pro Plus cpp_price_per_year: '$390 USD' - -# Copilot billing: price per month for Copilot Business +# Price per month for Copilot Business cfb_price_per_month: '$19 USD' - -# Copilot billing: price per month for Copilot Enterprise +# Price per month for Copilot Enterprise ce_price_per_month: '$39 USD' -# Copilot Chat in GitHub: maximum number of repos that can be indexed for an org -max-chat-indexed-repos: '50' - -# Copilot partners: builders who can develop Copilot extensions +## Copilot partners: builders who can develop Copilot extensions copilot_partners: 'Copilot Partners' copilot_partner: 'Copilot Partner' copilot_partner_program: 'Copilot Partner Program' @@ -32,29 +39,77 @@ copilot_partner_program: 'Copilot Partner Program' ## Copilot URLs chat_completions_api: 'https://api.githubcopilot.com/chat/completions' -## Copilot code review - e.g. {% data variables.copilot.copilot_code-review %} +## Copilot code review -> {% data variables.copilot.copilot_code-review %} copilot_code-review: 'GitHub Copilot code review' copilot_code-review_short: 'Copilot code review' -## Copilot coding agent (aka Padawan) - e.g. {% data variables.copilot.copilot_coding_agent %} +## Copilot coding agent (previously Padawan) -> {% data variables.copilot.copilot_coding_agent %} copilot_coding_agent: 'Copilot coding agent' -coding_agent_UI: 'Coding agent' + +## Short for "Copilot Extensions agent" -> {% data variables.copilot.copilot_agent_short %} +## Note: this is NOT a short form for the Copilot coding agent (previously Padawan): +copilot_agent_short: 'Copilot agent' + +## Copilot feature variables (moved from product.yml) +copilot_chat: 'GitHub Copilot Chat' +copilot_chat_short: 'Copilot Chat' +copilot_chat_dotcom: 'GitHub Copilot Chat in GitHub' +copilot_chat_dotcom_short: 'Copilot Chat in GitHub' +copilot_mobile: 'GitHub Copilot Chat in GitHub Mobile' +copilot_mobile_short: 'Copilot Chat in GitHub Mobile' +copilot_extensions: 'GitHub Copilot Extensions' +copilot_extension: 'GitHub Copilot Extension' +copilot_extensions_short: 'Copilot Extensions' +copilot_extension_short: 'Copilot Extension' +copilot_extensions_vsc: 'Copilot-enabled Visual Studio Code extensions' +copilot_extension_vsc: 'Copilot-enabled Visual Studio Code extension' +copilot_extensibility_platform: 'GitHub Copilot Extensibility Platform' +copilot_extensibility_platform_short: 'Copilot Extensibility Platform' +copilot_agents: 'GitHub Copilot agents' +copilot_agents_short: 'Copilot agents' +copilot_skillset: 'Github Copilot skillset' +copilot_skillset_short: 'Copilot skillset' +copilot_skillsets: 'Github Copilot skillsets' +copilot_skillsets_short: 'Copilot skillsets' +copilot_cli: 'GitHub Copilot in the CLI' +copilot_cli_short: 'Copilot in the CLI' +copilot_for_prs: 'Copilot pull request summaries' +copilot_prs_short: 'pull request summaries' +copilot_customization: 'Copilot Customization' +copilot_in_support: 'Copilot in GitHub Support' +copilot_sku_isolation: 'Copilot subscription-based network routing' +copilot_autocomplete_pr: 'Copilot text completion' +copilot_desktop: 'GitHub Copilot in GitHub Desktop' +copilot_desktop_short: 'Copilot in GitHub Desktop' +copilot_edits: 'GitHub Copilot Edits' +copilot_edits_short: 'Copilot Edits' +copilot_spaces: 'Copilot Spaces' +copilot_spaces_short: 'Spaces' + +# Note: Copilot Autofix is branded as a Copilot feature but is billed using a Code security or GHAS license +copilot_autofix: 'GitHub Copilot Autofix' +copilot_autofix_short: 'Copilot Autofix' + +## Copilot Chat in GitHub: maximum number of repos that can be indexed for an org +max-chat-indexed-repos: '50' ## LLM models for Copilot +# Claude: copilot_claude: 'Claude' copilot_claude_sonnet: 'Claude Sonnet' copilot_claude_sonnet_35: 'Claude 3.5 Sonnet' copilot_claude_sonnet_37: 'Claude 3.7 Sonnet' copilot_claude_sonnet_40: 'Claude Sonnet 4' copilot_claude_opus: 'Claude Opus 4' - +# Gemini: copilot_gemini: 'Gemini' copilot_gemini_flash: 'Gemini 2.0 Flash' copilot_gemini_25_pro: 'Gemini 2.5 Pro' - +# OpenAI GPT series: copilot_gpt_4o: 'GPT-4o' copilot_gpt_41: 'GPT-4.1' copilot_gpt_45: 'GPT-4.5' +# OpenAI 'o' series: copilot_o1: 'o1' copilot_o3: 'o3' copilot_o3_mini: 'o3-mini' @@ -63,3 +118,9 @@ copilot_o4_mini: 'o4-mini' ## Next edit suggestions in VS Code next_edit_suggestions: 'next edit suggestions' next_edit_suggestions_caps: 'Next edit suggestions' + +## Copilot Workspace +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' diff --git a/data/variables/product.yml b/data/variables/product.yml index d48e3b025d..1735b64788 100644 --- a/data/variables/product.yml +++ b/data/variables/product.yml @@ -300,62 +300,6 @@ prodname_arctic_vault: 'Arctic Code Vault' # GitHub Copilot (product) prodname_copilot: 'GitHub Copilot' prodname_copilot_short: 'Copilot' -prodname_copilot_for_business: 'GitHub Copilot Business' -prodname_copilot_for_individuals: 'GitHub Copilot Individual' -prodname_copilot_pro: 'GitHub Copilot Pro' -prodname_copilot_pro_short: 'Copilot Pro' -prodname_copilot_pro_plus: 'GitHub Copilot Pro+' -prodname_copilot_pro_plus_short: 'Copilot Pro+' -prodname_copilot_business_short: 'Copilot Business' -prodname_copilot_individuals_short: 'Copilot Individual' -prodname_copilot_enterprise: 'GitHub Copilot Enterprise' -prodname_copilot_enterprise_short: 'Copilot Enterprise' -prodname_copilot_free: 'GitHub Copilot Free' -prodname_copilot_free_short: 'Copilot Free' -prodname_copilot_chat: 'GitHub Copilot Chat' -prodname_copilot_chat_short: 'Copilot Chat' -prodname_copilot_chat_dotcom: 'GitHub Copilot Chat in GitHub' -prodname_copilot_chat_dotcom_short: 'Copilot Chat in GitHub' -prodname_copilot_mobile: 'GitHub Copilot Chat in GitHub Mobile' -prodname_copilot_mobile_short: 'Copilot Chat in GitHub Mobile' -prodname_copilot_extensions: 'GitHub Copilot Extensions' -prodname_copilot_extension: 'GitHub Copilot Extension' -prodname_copilot_extensions_short: 'Copilot Extensions' -prodname_copilot_extension_short: 'Copilot Extension' -prodname_copilot_extensions_vsc: 'Copilot-enabled Visual Studio Code extensions' -prodname_copilot_extension_vsc: 'Copilot-enabled Visual Studio Code extension' -prodname_copilot_extensibility_platform: 'GitHub Copilot Extensibility Platform' -prodname_copilot_extensibility_platform_short: 'Copilot Extensibility Platform' -prodname_copilot_agent: 'GitHub Copilot agent' -prodname_copilot_agent_short: 'Copilot agent' -prodname_copilot_agents: 'GitHub Copilot agents' -prodname_copilot_agents_short: 'Copilot agents' -prodname_copilot_skillset: 'Github Copilot skillset' -prodname_copilot_skillset_short: 'Copilot skillset' -prodname_copilot_skillsets: 'Github Copilot skillsets' -prodname_copilot_skillsets_short: 'Copilot skillsets' -prodname_copilot_cli: 'GitHub Copilot in the CLI' -prodname_copilot_cli_short: 'Copilot in the CLI' -prodname_copilot_for_prs: 'Copilot pull request summaries' -prodname_copilot_prs_short: 'pull request summaries' -prodname_copilot_customization: 'Copilot Customization' -prodname_copilot_in_support: 'Copilot in GitHub Support' -prodname_copilot_sku_isolation: 'Copilot subscription-based network routing' -prodname_copilot_autocomplete_pr: 'Copilot text completion' -prodname_copilot_desktop: 'GitHub Copilot in GitHub Desktop' -prodname_copilot_desktop_short: 'Copilot in GitHub Desktop' -prodname_copilot_edits: 'GitHub Copilot Edits' -prodname_copilot_edits_short: 'Copilot Edits' -prodname_copilot_workspace_pr: 'GitHub Copilot Workspace for pull requests' -prodname_copilot_workspace_pr_short: 'Copilot Workspace for PRs' -prodname_copilot_workspace: 'Copilot Workspace' -prodname_copilot_workspace_short: 'Workspace' -prodname_copilot_spaces: 'Copilot Spaces' -prodname_copilot_spaces_short: 'Spaces' - -# GHAS licensed features branded as Copilot -prodname_copilot_autofix: 'GitHub Copilot Autofix' -prodname_copilot_autofix_short: 'Copilot Autofix' # Windows prodname_windows_terminal: 'Windows Terminal' diff --git a/src/code-scanning/scripts/generate-code-scanning-query-list.ts b/src/code-scanning/scripts/generate-code-scanning-query-list.ts index b5c066c38e..9a1c284d2a 100644 --- a/src/code-scanning/scripts/generate-code-scanning-query-list.ts +++ b/src/code-scanning/scripts/generate-code-scanning-query-list.ts @@ -201,7 +201,7 @@ function printQueries(options: Options, queries: QueryExtended[]) { 'Related CWEs', 'Default', 'Extended', - '{% data variables.product.prodname_copilot_autofix_short %}', + '{% data variables.copilot.copilot_autofix_short %}', ] markdown.push(`| ${header.join(' | ')} |`) markdown.push(`| ${header.map(() => '---').join(' | ')} |`) diff --git a/src/languages/lib/correct-translation-content.js b/src/languages/lib/correct-translation-content.js index 75b6b19bb0..0e73189078 100644 --- a/src/languages/lib/correct-translation-content.js +++ b/src/languages/lib/correct-translation-content.js @@ -81,7 +81,7 @@ export function correctTranslatedContentStrings(content, englishContent, context // Internal issue #4160 content = content.replaceAll( '- % data variables.product.prodname_copilot_enterprise %}', - '- {% data variables.product.prodname_copilot_enterprise %}', + '- {% data variables.copilot.copilot_enterprise %}', ) // This might not be exclusive to Japanese but put here because, at