diff --git a/content/copilot/concepts/code-review.md b/content/copilot/concepts/agents/code-review.md similarity index 99% rename from content/copilot/concepts/code-review.md rename to content/copilot/concepts/agents/code-review.md index 5ab96e6b3420..c8e03f6697b9 100644 --- a/content/copilot/concepts/code-review.md +++ b/content/copilot/concepts/agents/code-review.md @@ -10,6 +10,7 @@ topics: redirect_from: - /copilot/code-review - /copilot/concepts/code-review/code-review + - /copilot/concepts/code-review contentType: concepts --- diff --git a/content/copilot/concepts/coding-agent/coding-agent.md b/content/copilot/concepts/agents/coding-agent/about-coding-agent.md similarity index 98% rename from content/copilot/concepts/coding-agent/coding-agent.md rename to content/copilot/concepts/agents/coding-agent/about-coding-agent.md index 120699a10331..94d05a20a3e2 100644 --- a/content/copilot/concepts/coding-agent/coding-agent.md +++ b/content/copilot/concepts/agents/coding-agent/about-coding-agent.md @@ -1,7 +1,7 @@ --- title: About GitHub Copilot coding agent -shortTitle: Coding agent -intro: 'You can assign {% data variables.product.github %} issues to {% data variables.product.prodname_copilot_short %}, or ask {% data variables.product.prodname_copilot_short %} to create a pull request.' +shortTitle: About coding agent +intro: You can assign {% data variables.product.github %} issues to {% data variables.product.prodname_copilot_short %}, or 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 @@ -15,6 +15,7 @@ redirect_from: - /copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot - /copilot/concepts/about-copilot-coding-agent - /copilot/concepts/coding-agent/about-copilot-coding-agent + - /copilot/concepts/coding-agent/coding-agent contentType: concepts --- diff --git a/content/copilot/concepts/coding-agent/enable-coding-agent.md b/content/copilot/concepts/agents/coding-agent/coding-agent-for-business-and-enterprise.md similarity index 86% rename from content/copilot/concepts/coding-agent/enable-coding-agent.md rename to content/copilot/concepts/agents/coding-agent/coding-agent-for-business-and-enterprise.md index 2f07ba8da05d..3b79c6461030 100644 --- a/content/copilot/concepts/coding-agent/enable-coding-agent.md +++ b/content/copilot/concepts/agents/coding-agent/coding-agent-for-business-and-enterprise.md @@ -1,8 +1,8 @@ --- -title: About enabling GitHub Copilot coding agent -shortTitle: 'Enable {% data variables.copilot.copilot_coding_agent_short %}' +title: About GitHub Copilot coding agent for business and enterprise +shortTitle: Business and enterprise allowTitleToDifferFromFilename: true -intro: 'Find out about enabling {% data variables.copilot.copilot_coding_agent %} for {% data variables.copilot.copilot_enterprise %} and {% data variables.copilot.copilot_for_business %}, and about disabling the agent for specific repositories.' +intro: Find out about {% data variables.copilot.copilot_coding_agent %} policies available for {% data variables.copilot.copilot_enterprise %} and {% data variables.copilot.copilot_for_business %}, and about disabling the agent for specific repositories. 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,6 +14,8 @@ redirect_from: - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/enabling-copilot-coding-agent-for-your-personal-repositories - /copilot/using-github-copilot/coding-agent/enabling-copilot-coding-agent - /copilot/concepts/coding-agent/about-enabling-coding-agent + - /copilot/concepts/coding-agent/enable-coding-agent + - /copilot/concepts/agents/coding-agent/enable-coding-agent contentType: concepts --- @@ -32,7 +34,7 @@ If you are a {% data variables.copilot.copilot_pro %} or Pro+ subscriber, {% dat Once enabled, you can use {% data variables.copilot.copilot_coding_agent %} in any repository, provided that an administrator hasn't opted the repository out. -## Enabling {% data variables.copilot.copilot_coding_agent %} for {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %} subscribers +## {% data variables.copilot.copilot_coding_agent %} policies for {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %} {% data reusables.copilot.coding-agent.enabling-for-orgs-and-enterprises %} diff --git a/content/copilot/concepts/coding-agent/index.md b/content/copilot/concepts/agents/coding-agent/index.md similarity index 66% rename from content/copilot/concepts/coding-agent/index.md rename to content/copilot/concepts/agents/coding-agent/index.md index 44a197a63fe7..5ac72b1e63a0 100644 --- a/content/copilot/concepts/coding-agent/index.md +++ b/content/copilot/concepts/agents/coding-agent/index.md @@ -2,16 +2,18 @@ title: Concepts for GitHub Copilot coding agent shortTitle: '{% data variables.copilot.copilot_coding_agent_short_cap_c %}' allowTitleToDifferFromFilename: true -intro: 'Learn how {% data variables.copilot.copilot_coding_agent %} can carry out coding tasks for you, working independently in the same workflow you use yourself.' +intro: Learn how {% data variables.copilot.copilot_coding_agent %} can carry out coding tasks for you, working independently in the same workflow you use yourself. versions: feature: copilot topics: - Copilot children: - - /coding-agent - - /enable-coding-agent + - /about-coding-agent + - /coding-agent-for-business-and-enterprise - /mcp-and-coding-agent contentType: concepts +redirect_from: + - /copilot/concepts/coding-agent --- These articles provide an overview of {% data variables.copilot.copilot_coding_agent %}. For instructions on configuring and using {% data variables.copilot.copilot_coding_agent %}, see the how-to articles under [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent). diff --git a/content/copilot/concepts/coding-agent/mcp-and-coding-agent.md b/content/copilot/concepts/agents/coding-agent/mcp-and-coding-agent.md similarity index 93% rename from content/copilot/concepts/coding-agent/mcp-and-coding-agent.md rename to content/copilot/concepts/agents/coding-agent/mcp-and-coding-agent.md index 20c48cab5250..86b942ce723b 100644 --- a/content/copilot/concepts/coding-agent/mcp-and-coding-agent.md +++ b/content/copilot/concepts/agents/coding-agent/mcp-and-coding-agent.md @@ -1,13 +1,15 @@ --- title: Model Context Protocol (MCP) and GitHub Copilot coding agent -shortTitle: 'MCP and {% data variables.copilot.copilot_coding_agent_short %}' +shortTitle: MCP and {% data variables.copilot.copilot_coding_agent_short %} allowTitleToDifferFromFilename: true -intro: 'Find out about using the Model Context Protocol (MCP) with {% data variables.copilot.copilot_coding_agent %}.' +intro: Find out about using the Model Context Protocol (MCP) with {% data variables.copilot.copilot_coding_agent %}. versions: feature: copilot topics: - Copilot contentType: concepts +redirect_from: + - /copilot/concepts/coding-agent/mcp-and-coding-agent --- > [!NOTE] diff --git a/content/copilot/concepts/agents/index.md b/content/copilot/concepts/agents/index.md new file mode 100644 index 000000000000..a36420c0f2a0 --- /dev/null +++ b/content/copilot/concepts/agents/index.md @@ -0,0 +1,15 @@ +--- +title: Concepts for GitHub Copilot agents +shortTitle: Agents +allowTitleToDifferFromFilename: true +intro: Learn how {% data variables.product.prodname_copilot %} can independently execute tasks across the software development lifecycle. +versions: + feature: copilot +topics: + - Copilot +children: + - /coding-agent + - /code-review +contentType: concepts +--- + diff --git a/content/copilot/concepts/content-exclusion.md b/content/copilot/concepts/context/content-exclusion.md similarity index 96% rename from content/copilot/concepts/content-exclusion.md rename to content/copilot/concepts/context/content-exclusion.md index 27df0db51aaa..8676dde0652f 100644 --- a/content/copilot/concepts/content-exclusion.md +++ b/content/copilot/concepts/context/content-exclusion.md @@ -1,7 +1,7 @@ --- title: Content exclusion for GitHub Copilot shortTitle: Content exclusion -intro: 'You can prevent {% data variables.product.prodname_copilot_short %} from accessing certain files.' +intro: You can prevent {% data variables.product.prodname_copilot_short %} from accessing certain files. product: '{% data reusables.gated-features.copilot-business-and-enterprise %}' versions: feature: copilot @@ -9,6 +9,7 @@ topics: - Copilot redirect_from: - /copilot/concepts/content-exclusion-for-github-copilot + - /copilot/concepts/content-exclusion contentType: concepts --- diff --git a/content/copilot/concepts/context/copilot-extensions.md b/content/copilot/concepts/context/copilot-extensions.md new file mode 100644 index 000000000000..f4600e89ed92 --- /dev/null +++ b/content/copilot/concepts/context/copilot-extensions.md @@ -0,0 +1,83 @@ +--- +title: About GitHub Copilot Extensions +shortTitle: Copilot extensions +intro: 'Learn about {% data variables.copilot.copilot_extensions_short %}.' +allowTitleToDifferFromFilename: true +product: '{% data reusables.gated-features.copilot-extensions %}' +versions: + feature: copilot-extensions +topics: + - Copilot +redirect_from: + - /copilot/reference/copilot-extensions/copilot-extensions-faq + - /copilot/reference/copilot-extensions + - /copilot/concepts/copilot-extensions/about-copilot-extensions + - /copilot/concepts/copilot-extensions/about-extensions +contentType: concepts +--- + +## About {% data variables.copilot.copilot_extensions_short %} + +{% data reusables.copilot.copilot-extensions.about-copilot-extensions %} + +## Supported clients and IDEs + +{% data reusables.copilot.copilot-extensions.supported-clients-and-ides-table %} + +## Visibility of {% data variables.copilot.copilot_extensions %} + +{% 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 + * Need to integrate with a large volume of internal documents and databases + * Have strict security policies making it difficult to authorize permissions for third-parties +* Public extensions are suitable for: + * Open-source projects + * Collaborative development and use across organizations within an enterprise + * Sharing your tool and getting feedback before publishing to the {% data variables.product.prodname_marketplace %} +* {% data variables.product.prodname_marketplace %} extensions are ideal for third-parties that want to: + * Offer their service to a broader audience + * 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 + +## {% data variables.copilot.copilot_extensions %} permissions + +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 extension users**: 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 extension creators**: 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. + +For more information on {% data variables.product.prodname_github_app %} permissions, see [AUTOTITLE](/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app). + +### Granting permissions to access organization resources + +Users with an individual {% data variables.product.prodname_copilot_short %} subscription can install and use {% data variables.copilot.copilot_extensions_short %}. Users with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription need an organization administrator to enable this feature. + +Only organization administrators can grant permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources. + +To grant organization members access, the organization administrator must: + +* Install the extension +* Grant the extension permission to access specific repositories +* Authorize access for all, or specific repositories + +### Controlling access at the enterprise level + +If you are an enterprise administrator, you can disable {% data variables.copilot.copilot_extensions_short %} across your enterprise by setting the **{% data variables.copilot.copilot_extensions_short %}** policy to "Disabled". The "No Policy" setting allows organization administrators to set their own policy. + +No, there is no allowlist or blocklist at the enterprise level. + +## Sharing data with {% data variables.copilot.copilot_extensions_short %} + +The following data is shared when you interact 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 administrator. Administrators installing extensions must approve access to the required permissions prior to completing installation. +* For {% data variables.copilot.copilot_chat_dotcom_short %}, if your administrator has approved the extension to access repository or organization metadata, that data will be shared as well. + +## Further reading + +* [AUTOTITLE](/copilot/concepts/extensions/build-extensions) diff --git a/content/copilot/concepts/context/index.md b/content/copilot/concepts/context/index.md new file mode 100644 index 000000000000..fcd2299cccc1 --- /dev/null +++ b/content/copilot/concepts/context/index.md @@ -0,0 +1,19 @@ +--- +title: Concepts for providing context to GitHub Copilot +shortTitle: Context +allowTitleToDifferFromFilename: true +intro: Learn how {% data variables.product.prodname_copilot %} gathers contextual information to provide relevant responses to your prompts. +versions: + feature: copilot +topics: + - Copilot +children: + - /mcp + - /spaces + - /repository-indexing + - /content-exclusion + - /knowledge-bases + - /copilot-extensions +contentType: concepts +--- + diff --git a/content/copilot/concepts/knowledge-bases.md b/content/copilot/concepts/context/knowledge-bases.md similarity index 61% rename from content/copilot/concepts/knowledge-bases.md rename to content/copilot/concepts/context/knowledge-bases.md index 9ce8a377e4e1..b58a3c1e1b8c 100644 --- a/content/copilot/concepts/knowledge-bases.md +++ b/content/copilot/concepts/context/knowledge-bases.md @@ -1,7 +1,7 @@ --- title: GitHub Copilot knowledge bases shortTitle: Knowledge bases -intro: 'Knowledge bases allow you to bring together Markdown documentation across one or more repositories, which can then be used as context for {% data variables.copilot.copilot_chat_short %}.' +intro: Knowledge bases allow you to bring together Markdown documentation across one or more repositories, which can then be used as context for {% data variables.copilot.copilot_chat_short %}. versions: fpt: '*' ghec: '*' @@ -10,16 +10,17 @@ topics: - Copilot redirect_from: - /copilot/concepts/copilot-knowledge-bases + - /copilot/concepts/knowledge-bases contentType: concepts --- - + ->[!IMPORTANT] Beginning September 12, 2025, knowledge bases will be {% data variables.release-phases.retired %} and fully replaced by {% data variables.copilot.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). +{% data reusables.copilot.knowledge-bases-retirement %} - + ## About knowledge bases diff --git a/content/copilot/concepts/about-mcp.md b/content/copilot/concepts/context/mcp.md similarity index 95% rename from content/copilot/concepts/about-mcp.md rename to content/copilot/concepts/context/mcp.md index 5f00fff46fe5..0a865051db82 100644 --- a/content/copilot/concepts/about-mcp.md +++ b/content/copilot/concepts/context/mcp.md @@ -1,13 +1,15 @@ --- title: About Model Context Protocol (MCP) allowTitleToDifferFromFilename: true -shortTitle: About MCP -intro: 'Model Context Protocol (MCP) is a protocol that allows you to extend the capabilities of {% data variables.product.prodname_copilot %} by integrating it with other systems.' +shortTitle: MCP +intro: Model Context Protocol (MCP) is a protocol that allows you to extend the capabilities of {% data variables.product.prodname_copilot %} by integrating it with other systems. versions: feature: copilot topics: - Copilot contentType: concepts +redirect_from: + - /copilot/concepts/about-mcp --- ## Overview of Model Context Protocol (MCP) diff --git a/content/copilot/concepts/repository-indexes.md b/content/copilot/concepts/context/repository-indexing.md similarity index 98% rename from content/copilot/concepts/repository-indexes.md rename to content/copilot/concepts/context/repository-indexing.md index e8e94de03fb2..888f4c4a4768 100644 --- a/content/copilot/concepts/repository-indexes.md +++ b/content/copilot/concepts/context/repository-indexing.md @@ -1,6 +1,6 @@ --- title: Indexing repositories for GitHub Copilot Chat -shortTitle: Repository indexes +shortTitle: Repository indexing intro: '{% data variables.copilot.copilot_chat %} improves responses to questions about code by indexing your repositories.' versions: feature: copilot @@ -14,6 +14,7 @@ redirect_from: - /copilot/using-github-copilot/indexing-repositories-for-copilot-chat - /copilot/using-github-copilot/copilot-chat/indexing-repositories-for-copilot-chat - /copilot/concepts/indexing-repositories-for-copilot-chat + - /copilot/concepts/repository-indexes contentType: concepts --- diff --git a/content/copilot/concepts/spaces.md b/content/copilot/concepts/context/spaces.md similarity index 94% rename from content/copilot/concepts/spaces.md rename to content/copilot/concepts/context/spaces.md index f6062299fa7a..5796e2a046ac 100644 --- a/content/copilot/concepts/spaces.md +++ b/content/copilot/concepts/context/spaces.md @@ -1,8 +1,8 @@ --- title: About organizing and sharing context with GitHub Copilot Spaces shortTitle: Spaces -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 %}.' +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 topics: @@ -10,6 +10,7 @@ topics: redirect_from: - /copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces - /copilot/concepts/about-organizing-and-sharing-context-with-copilot-spaces + - /copilot/concepts/spaces contentType: concepts --- diff --git a/content/copilot/concepts/extensions/about-extensions.md b/content/copilot/concepts/extensions/build-extensions.md similarity index 58% rename from content/copilot/concepts/extensions/about-extensions.md rename to content/copilot/concepts/extensions/build-extensions.md index 7e0729c41aa1..3c0644d2d74e 100644 --- a/content/copilot/concepts/extensions/about-extensions.md +++ b/content/copilot/concepts/extensions/build-extensions.md @@ -1,7 +1,7 @@ --- -title: About GitHub Copilot Extensions -shortTitle: About extensions -intro: 'Learn about the development process for {% data variables.copilot.copilot_extensions_short %}.' +title: About building GitHub Copilot Extensions +shortTitle: Build extensions +intro: Learn about developing {% data variables.copilot.copilot_extensions_short %}. allowTitleToDifferFromFilename: true product: '{% data reusables.gated-features.copilot-extensions %}' versions: @@ -11,83 +11,14 @@ topics: redirect_from: - /copilot/building-copilot-extensions/about-building-copilot-extensions - /copilot/concepts/build-copilot-extensions/about-building-copilot-extensions - - /copilot/building-copilot-extensions/copilot-extensions-faq - - /copilot/reference/copilot-extensions/copilot-extensions-faq - - /copilot/reference/copilot-extensions - /copilot/concepts/copilot-extensions/about-building-copilot-extensions - - /copilot/concepts/copilot-extensions/about-copilot-extensions - - /copilot/concepts/copilot-extensions/about-extensions + - /copilot/concepts/extensions/about-extensions contentType: concepts --- -## About {% data variables.copilot.copilot_extensions_short %} +## About building {% data variables.copilot.copilot_extensions_short %} -{% 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.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. - -{% data variables.copilot.copilot_extensions %} are built with {% data variables.product.prodname_github_apps %}. They 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 %} - -## Visibility of {% data variables.copilot.copilot_extensions %} - -{% 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 - * Need to integrate with a large volume of internal documents and databases - * Have strict security policies making it difficult to authorize permissions for third-parties -* Public extensions are suitable for: - * Open-source projects - * Collaborative development and use across organizations within an enterprise - * Sharing your tool and getting feedback before publishing to the {% data variables.product.prodname_marketplace %} -* {% data variables.product.prodname_marketplace %} extensions are ideal for third-parties that want to: - * Offer their service to a broader audience - * 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 - -## {% data variables.copilot.copilot_extensions %} permissions - -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 extension users**: 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 extension creators**: 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. - -For more information on {% data variables.product.prodname_github_app %} permissions, see [AUTOTITLE](/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app). - -### Granting permissions to access organization resources - -Users with an individual {% data variables.product.prodname_copilot_short %} subscription can install and use {% data variables.copilot.copilot_extensions_short %}. Users with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription need an organization administrator to enable this feature. - -Only organization administrators can grant permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources. - -To grant organization members access, the organization administrator must: - -* Install the extension -* Grant the extension permission to access specific repositories -* Authorize access for all, or specific repositories - -### Controlling access at the enterprise level - -If you are an enterprise administrator, you can disable {% data variables.copilot.copilot_extensions_short %} across your enterprise by setting the **{% data variables.copilot.copilot_extensions_short %}** policy to "Disabled". The "No Policy" setting allows organization administrators to set their own policy. - -No, there is no allowlist or blocklist at the enterprise level. - -## Sharing data with {% data variables.copilot.copilot_extensions_short %} - -The following data is shared when you interact 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 administrator. Administrators installing extensions must approve access to the required permissions prior to completing installation. -* For {% data variables.copilot.copilot_chat_dotcom_short %}, if your administrator has approved the extension to access repository or organization metadata, that data will be shared as well. +{% data reusables.copilot.copilot-extensions.about-copilot-extensions %} ## About skillsets and agents diff --git a/content/copilot/concepts/extensions/index.md b/content/copilot/concepts/extensions/index.md index fa2ceacdbb24..18ebc2726af4 100644 --- a/content/copilot/concepts/extensions/index.md +++ b/content/copilot/concepts/extensions/index.md @@ -1,7 +1,7 @@ --- title: GitHub Copilot Extensions shortTitle: Extensions -intro: 'Understand components for building {% data variables.copilot.copilot_extensions_short %}.' +intro: Understand components for building {% data variables.copilot.copilot_extensions_short %}. versions: feature: copilot topics: @@ -10,7 +10,7 @@ redirect_from: - /copilot/concepts/build-copilot-extensions - /copilot/concepts/copilot-extensions children: - - /about-extensions + - /build-extensions - /agents - /skillsets - /openid-connect diff --git a/content/copilot/concepts/index.md b/content/copilot/concepts/index.md index 5f5ee33ebb93..3c5df75926f8 100644 --- a/content/copilot/concepts/index.md +++ b/content/copilot/concepts/index.md @@ -1,7 +1,7 @@ --- title: Concepts for GitHub Copilot shortTitle: Concepts -intro: 'Learn the core concepts that you''ll need to understand {% data variables.product.prodname_copilot %}.' +intro: Learn the core concepts that you'll need to understand {% data variables.product.prodname_copilot %}. versions: feature: copilot topics: @@ -10,21 +10,15 @@ children: - /ai-tools - /completions - /chat - - /coding-agent - - /code-review - - /about-mcp - - /spaces - - /billing - - /prompt-engineering - - /response-customization + - /agents + - /prompting + - /context - /auto-model-selection - - /content-exclusion - - /knowledge-bases - - /extensions - - /policies - /rate-limits + - /billing + - /policies - /network-settings - - /repository-indexes + - /extensions contentType: concepts --- diff --git a/content/copilot/concepts/prompting/index.md b/content/copilot/concepts/prompting/index.md new file mode 100644 index 000000000000..ad3ba174535d --- /dev/null +++ b/content/copilot/concepts/prompting/index.md @@ -0,0 +1,15 @@ +--- +title: Concepts for prompting GitHub Copilot +shortTitle: Prompting +allowTitleToDifferFromFilename: true +intro: Learn how to interact with {% data variables.product.prodname_copilot %} to get the best results. +versions: + feature: copilot +topics: + - Copilot +children: + - /prompt-engineering + - /response-customization +contentType: concepts +--- + diff --git a/content/copilot/concepts/prompt-engineering.md b/content/copilot/concepts/prompting/prompt-engineering.md similarity index 98% rename from content/copilot/concepts/prompt-engineering.md rename to content/copilot/concepts/prompting/prompt-engineering.md index a547d34cc041..ce789c70c36e 100644 --- a/content/copilot/concepts/prompt-engineering.md +++ b/content/copilot/concepts/prompting/prompt-engineering.md @@ -1,7 +1,7 @@ --- title: Prompt engineering for GitHub Copilot Chat shortTitle: Prompt engineering -intro: 'Follow these strategies to improve your {% data variables.product.prodname_copilot_short %} results.' +intro: Follow these strategies to improve your {% data variables.product.prodname_copilot_short %} results. versions: feature: copilot topics: @@ -10,6 +10,7 @@ redirect_from: - /copilot/using-github-copilot/prompt-engineering-for-github-copilot - /copilot/using-github-copilot/copilot-chat/prompt-engineering-for-copilot-chat - /copilot/concepts/prompt-engineering-for-copilot-chat + - /copilot/concepts/prompt-engineering contentType: concepts --- diff --git a/content/copilot/concepts/response-customization.md b/content/copilot/concepts/prompting/response-customization.md similarity index 98% rename from content/copilot/concepts/response-customization.md rename to content/copilot/concepts/prompting/response-customization.md index 0d2f8baba5d7..70626a0650ff 100644 --- a/content/copilot/concepts/response-customization.md +++ b/content/copilot/concepts/prompting/response-customization.md @@ -1,7 +1,7 @@ --- title: About customizing GitHub Copilot Chat responses shortTitle: Response customization -intro: 'Learn about customizing the behavior of {% data variables.product.prodname_copilot %} to fit with your preferences and requirements.' +intro: Learn about customizing the behavior of {% data variables.product.prodname_copilot %} to fit with your preferences and requirements. versions: feature: copilot topics: @@ -10,6 +10,7 @@ redirect_from: - /copilot/customizing-copilot/about-customizing-github-copilot-chat-responses - /copilot/concepts/about-customizing-github-copilot-chat-responses - /copilot/concepts/code-review/coding-guidelines + - /copilot/concepts/response-customization contentType: concepts --- diff --git a/content/copilot/how-tos/use-chat/use-chat-in-github.md b/content/copilot/how-tos/chat-with-copilot/chat-in-github.md similarity index 98% rename from content/copilot/how-tos/use-chat/use-chat-in-github.md rename to content/copilot/how-tos/chat-with-copilot/chat-in-github.md index c7b5841f8532..ab77168074ad 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-github.md +++ b/content/copilot/how-tos/chat-with-copilot/chat-in-github.md @@ -1,7 +1,7 @@ --- title: Asking GitHub Copilot questions in GitHub -shortTitle: Use Chat in GitHub -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.' +shortTitle: Chat in GitHub +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: @@ -17,6 +17,8 @@ redirect_from: - /copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github - /copilot/how-tos/chat/asking-github-copilot-questions-in-github - /copilot/how-tos/chat/use-chat-in-github + - /copilot/how-tos/use-chat/use-chat-in-github + - /copilot/how-tos/chat-with-copilot/use-chat-in-github contentType: how-tos --- diff --git a/content/copilot/how-tos/use-chat/use-chat-in-ide.md b/content/copilot/how-tos/chat-with-copilot/chat-in-ide.md similarity index 99% rename from content/copilot/how-tos/use-chat/use-chat-in-ide.md rename to content/copilot/how-tos/chat-with-copilot/chat-in-ide.md index f79b0a1cf82a..98230f5242d0 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-ide.md +++ b/content/copilot/how-tos/chat-with-copilot/chat-in-ide.md @@ -1,6 +1,6 @@ --- title: Asking GitHub Copilot questions in your IDE -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.' +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: @@ -12,10 +12,12 @@ redirect_from: - /copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide - /copilot/how-tos/chat/asking-github-copilot-questions-in-your-ide - /copilot/how-tos/chat/use-chat-in-ide + - /copilot/how-tos/use-chat/use-chat-in-ide + - /copilot/how-tos/chat-with-copilot/use-chat-in-ide defaultTool: vscode versions: feature: copilot -shortTitle: Use Chat in IDE +shortTitle: Chat in IDE contentType: how-tos --- diff --git a/content/copilot/how-tos/use-chat/use-chat-in-mobile.md b/content/copilot/how-tos/chat-with-copilot/chat-in-mobile.md similarity index 96% rename from content/copilot/how-tos/use-chat/use-chat-in-mobile.md rename to content/copilot/how-tos/chat-with-copilot/chat-in-mobile.md index 8e5ca5f3890e..ff6bc58c9aa8 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-mobile.md +++ b/content/copilot/how-tos/chat-with-copilot/chat-in-mobile.md @@ -1,12 +1,12 @@ --- title: Asking GitHub Copilot questions in GitHub Mobile -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 %}.' +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 versions: feature: copilot-chat-for-mobile -shortTitle: Use Chat in Mobile +shortTitle: Chat in Mobile redirect_from: - /copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile - /copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile @@ -15,6 +15,8 @@ redirect_from: - /copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github-mobile - /copilot/how-tos/chat/asking-github-copilot-questions-in-github-mobile - /copilot/how-tos/chat/use-chat-in-mobile + - /copilot/how-tos/use-chat/use-chat-in-mobile + - /copilot/how-tos/chat-with-copilot/use-chat-in-mobile contentType: how-tos --- diff --git a/content/copilot/how-tos/use-chat/use-chat-in-windows-terminal.md b/content/copilot/how-tos/chat-with-copilot/chat-in-windows-terminal.md similarity index 86% rename from content/copilot/how-tos/use-chat/use-chat-in-windows-terminal.md rename to content/copilot/how-tos/chat-with-copilot/chat-in-windows-terminal.md index e7d86dd36a45..ae4f2769ab23 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-windows-terminal.md +++ b/content/copilot/how-tos/chat-with-copilot/chat-in-windows-terminal.md @@ -1,15 +1,17 @@ --- title: Asking GitHub Copilot questions in Windows Terminal -intro: 'You can use {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_windows_terminal %} to get suggestions and explanations for the command line.' +intro: You can use {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_windows_terminal %} to get suggestions and explanations for the command line. topics: - Copilot -shortTitle: Use Chat in Windows Terminal +shortTitle: Chat in Windows Terminal versions: feature: copilot redirect_from: - /copilot/using-github-copilot/asking-github-copilot-questions-in-windows-terminal - /copilot/how-tos/chat/asking-github-copilot-questions-in-windows-terminal - /copilot/how-tos/chat/use-chat-in-windows-terminal + - /copilot/how-tos/use-chat/use-chat-in-windows-terminal + - /copilot/how-tos/chat-with-copilot/use-chat-in-windows-terminal contentType: how-tos --- diff --git a/content/copilot/how-tos/use-chat/get-started-with-chat.md b/content/copilot/how-tos/chat-with-copilot/get-started-with-chat.md similarity index 99% rename from content/copilot/how-tos/use-chat/get-started-with-chat.md rename to content/copilot/how-tos/chat-with-copilot/get-started-with-chat.md index 63652004b837..ca5f01bb1d82 100644 --- a/content/copilot/how-tos/use-chat/get-started-with-chat.md +++ b/content/copilot/how-tos/chat-with-copilot/get-started-with-chat.md @@ -1,6 +1,6 @@ --- title: Getting started with prompts for GitHub Copilot Chat -intro: 'Get an overview of ways to use {% data variables.copilot.copilot_chat_short %}.' +intro: Get an overview of ways to use {% data variables.copilot.copilot_chat_short %}. topics: - Copilot defaultTool: vscode @@ -13,6 +13,7 @@ redirect_from: - /copilot/get-started/getting-started-with-prompts-for-copilot-chat - /copilot/how-tos/chat/getting-started-with-prompts-for-copilot-chat - /copilot/how-tos/chat/get-started-with-chat + - /copilot/how-tos/use-chat/get-started-with-chat shortTitle: Get started with Chat contentType: how-tos --- diff --git a/content/copilot/how-tos/use-chat/index.md b/content/copilot/how-tos/chat-with-copilot/index.md similarity index 55% rename from content/copilot/how-tos/use-chat/index.md rename to content/copilot/how-tos/chat-with-copilot/index.md index 194baad4c504..ab0c82e57d0b 100644 --- a/content/copilot/how-tos/use-chat/index.md +++ b/content/copilot/how-tos/chat-with-copilot/index.md @@ -1,7 +1,7 @@ --- title: GitHub Copilot Chat -shortTitle: Use Chat -intro: 'Learn how to use {% data variables.copilot.copilot_chat_short %} across different environments.' +shortTitle: Chat with Copilot +intro: Learn how to use {% data variables.copilot.copilot_chat_short %} across different environments. versions: feature: copilot topics: @@ -10,11 +10,13 @@ redirect_from: - /copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat - /copilot/using-github-copilot/copilot-chat - /copilot/how-tos/chat + - /copilot/how-tos/use-chat children: - /get-started-with-chat - - /use-chat-in-ide - - /use-chat-in-windows-terminal - - /use-chat-in-github - - /use-chat-in-mobile + - /chat-in-ide + - /chat-in-windows-terminal + - /chat-in-github + - /chat-in-mobile contentType: how-tos --- + diff --git a/content/copilot/how-tos/configure-personal-settings/configure-in-your-environment.md b/content/copilot/how-tos/configure-personal-settings/configure-in-ide.md similarity index 99% rename from content/copilot/how-tos/configure-personal-settings/configure-in-your-environment.md rename to content/copilot/how-tos/configure-personal-settings/configure-in-ide.md index cb729f0a6f6b..e44cb24b5971 100644 --- a/content/copilot/how-tos/configure-personal-settings/configure-in-your-environment.md +++ b/content/copilot/how-tos/configure-personal-settings/configure-in-ide.md @@ -1,7 +1,7 @@ --- title: Configuring GitHub Copilot in your environment -shortTitle: Configure in your environment -intro: 'You can enable, configure, or disable {% data variables.product.prodname_copilot %} in a supported IDE.' +shortTitle: Configure in IDE +intro: You can enable, configure, or disable {% data variables.product.prodname_copilot %} in a supported IDE. redirect_from: - /copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio - /copilot/configuring-github-copilot/configuring-github-copilot-in-visual-studio-code @@ -11,6 +11,7 @@ redirect_from: - /copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment - /copilot/how-tos/personal-settings/configuring-github-copilot-in-your-environment - /copilot/how-tos/personal-settings/configure-in-your-environment + - /copilot/how-tos/configure-personal-settings/configure-in-your-environment topics: - Copilot versions: diff --git a/content/copilot/how-tos/configure-personal-settings/index.md b/content/copilot/how-tos/configure-personal-settings/index.md index 4adf2dd966f7..df2f159ce50d 100644 --- a/content/copilot/how-tos/configure-personal-settings/index.md +++ b/content/copilot/how-tos/configure-personal-settings/index.md @@ -1,13 +1,13 @@ --- title: Configure personal settings -intro: 'You can manage the configuration of {% data variables.product.prodname_copilot %} in a supported IDE or on {% data variables.product.github %}.' +intro: You can manage the configuration of {% data variables.product.prodname_copilot %} in a supported IDE or on {% data variables.product.github %}. versions: feature: copilot topics: - Copilot children: - /configure-network-settings - - /configure-in-your-environment + - /configure-in-ide - /customize-copilot-in-the-cli - /authenticate-to-ghecom redirect_from: diff --git a/content/copilot/how-tos/get-code-suggestions/get-code-suggestions.md b/content/copilot/how-tos/get-code-suggestions/get-ide-code-suggestions.md similarity index 99% rename from content/copilot/how-tos/get-code-suggestions/get-code-suggestions.md rename to content/copilot/how-tos/get-code-suggestions/get-ide-code-suggestions.md index 48e67749ee62..54e8a0127943 100644 --- a/content/copilot/how-tos/get-code-suggestions/get-code-suggestions.md +++ b/content/copilot/how-tos/get-code-suggestions/get-ide-code-suggestions.md @@ -1,6 +1,6 @@ --- title: Getting code suggestions in your IDE with GitHub Copilot -shortTitle: Get code suggestions +shortTitle: Get IDE code suggestions intro: 'Use {% data variables.product.prodname_copilot %} to get code suggestions in your editor.' redirect_from: - /copilot/using-github-copilot/using-github-copilot-code-suggestions-in-your-editor diff --git a/content/copilot/how-tos/get-code-suggestions/index.md b/content/copilot/how-tos/get-code-suggestions/index.md index 1a7a1def4a04..b2980570564d 100644 --- a/content/copilot/how-tos/get-code-suggestions/index.md +++ b/content/copilot/how-tos/get-code-suggestions/index.md @@ -1,13 +1,13 @@ --- title: Get suggestions from GitHub Copilot shortTitle: Get code suggestions -intro: 'Learn how to use {% data variables.product.prodname_copilot %}.' +intro: 'Learn how to get suggestions from {% data variables.product.prodname_copilot %}.' versions: feature: copilot topics: - Copilot children: - - /get-code-suggestions + - /get-ide-code-suggestions - /write-pr-descriptions - /find-matching-code redirect_from: diff --git a/content/copilot/how-tos/index.md b/content/copilot/how-tos/index.md index b4c2a8f0c354..2504866fb1cb 100644 --- a/content/copilot/how-tos/index.md +++ b/content/copilot/how-tos/index.md @@ -1,7 +1,7 @@ --- title: How-tos for GitHub Copilot shortTitle: How-tos -intro: 'Learn how to use {% data variables.product.prodname_copilot %}.' +intro: Learn how to use {% data variables.product.prodname_copilot %}. versions: feature: copilot topics: @@ -9,15 +9,15 @@ topics: children: - /set-up - /get-code-suggestions - - /use-chat + - /chat-with-copilot - /use-copilot-agents - /use-ai-models - /provide-context - /configure-custom-instructions - /configure-content-exclusion - /use-copilot-for-common-tasks - - /manage-and-track-spending - /configure-personal-settings + - /manage-and-track-spending - /manage-your-account - /administer-copilot - /troubleshoot-copilot diff --git a/content/copilot/how-tos/provide-context/create-knowledge-bases.md b/content/copilot/how-tos/provide-context/create-knowledge-bases.md index c96aa3a6dab3..36388b1ba2d3 100644 --- a/content/copilot/how-tos/provide-context/create-knowledge-bases.md +++ b/content/copilot/how-tos/provide-context/create-knowledge-bases.md @@ -25,13 +25,13 @@ redirect_from: - /copilot/how-tos/context/create-knowledge-bases contentType: how-tos --- - + ->[!IMPORTANT] Beginning September 12, 2025, knowledge bases will be {% data variables.release-phases.retired %} and fully replaced by {% data variables.copilot.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). +{% data reusables.copilot.knowledge-bases-retirement %} - + Knowledge bases are a way to bring together Markdown documentation across one or more repositories. When you ask a question in {% data variables.copilot.copilot_chat_short %} with a knowledge base selected, {% data variables.product.prodname_copilot_short %} will search the knowledge base for relevant information and synthesize a response. diff --git a/content/copilot/how-tos/provide-context/use-knowledge-bases.md b/content/copilot/how-tos/provide-context/use-knowledge-bases.md index d681dc4b518b..307820e8fdff 100644 --- a/content/copilot/how-tos/provide-context/use-knowledge-bases.md +++ b/content/copilot/how-tos/provide-context/use-knowledge-bases.md @@ -12,13 +12,13 @@ redirect_from: contentType: how-tos --- - + ->[!IMPORTANT] Beginning September 12, 2025, knowledge bases will be {% data variables.release-phases.retired %} and fully replaced by {% data variables.copilot.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). +{% data reusables.copilot.knowledge-bases-retirement %} - + ## Introduction diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/index.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/index.md index 5661089fa888..00d195ffb1a1 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/index.md +++ b/content/copilot/how-tos/use-copilot-agents/coding-agent/index.md @@ -25,4 +25,4 @@ redirect_from: contentType: how-tos --- -These articles provide how-to information for using {% data variables.copilot.copilot_coding_agent %}. For an overview of {% data variables.copilot.copilot_coding_agent %}, see the articles under [AUTOTITLE](/copilot/concepts/coding-agent). +These articles provide how-to information for using {% data variables.copilot.copilot_coding_agent %}. For an overview of {% data variables.copilot.copilot_coding_agent %}, see the articles under [AUTOTITLE](/copilot/concepts/agents/coding-agent). diff --git a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md index 8485e4276400..9312a5278a1b 100644 --- a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md +++ b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/index.md @@ -16,4 +16,4 @@ redirect_from: contentType: how-tos --- -These articles provide instructions on configuring and using {% data variables.copilot.copilot_code-review_short %}. For an introduction to {% data variables.copilot.copilot_code-review_short %}, see [AUTOTITLE](/copilot/concepts/code-review). +These articles provide instructions on configuring and using {% data variables.copilot.copilot_code-review_short %}. For an introduction to {% data variables.copilot.copilot_code-review_short %}, see [AUTOTITLE](/copilot/concepts/agents/code-review). diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-copilot-platform.md b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-copilot-platform.md index 1b4265a614eb..a3447a6e9878 100644 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-copilot-platform.md +++ b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-copilot-platform.md @@ -1,6 +1,6 @@ --- title: Configuring your GitHub Copilot agent to communicate with the GitHub 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.copilot.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: diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-github.md b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-github.md index 094413a2b953..7a57aadc3625 100644 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-github.md +++ b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/communicate-with-github.md @@ -1,6 +1,6 @@ --- title: Configuring your GitHub Copilot agent to communicate with GitHub -intro: 'Learn how to verify payloads and get resources from {% data variables.product.github %} with your {% data variables.copilot.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: diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/index.md b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/index.md index 244c754b06d7..8cd4f31f6aa8 100644 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/index.md +++ b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/index.md @@ -1,7 +1,7 @@ --- title: Building a GitHub Copilot agent for your GitHub Copilot Extension shortTitle: Build a Copilot agent -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 %}.' +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: @@ -17,3 +17,4 @@ redirect_from: - /copilot/how-tos/build-copilot-extensions/build-a-copilot-agent contentType: how-tos --- + diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-context-passing.md b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-context-passing.md index 8faca07db86d..eb561fa1900c 100644 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-context-passing.md +++ b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-context-passing.md @@ -1,6 +1,6 @@ --- title: Context passing for your agent -intro: 'Learn how to use context passing with your {% data variables.copilot.copilot_agent_short %}.' +intro: Learn how to use context passing with your {% data variables.copilot.copilot_agent_short %}. versions: feature: copilot-extensions topics: diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-copilots-llm.md b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-copilots-llm.md index 5da3376580fd..41cb0520048d 100644 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-copilots-llm.md +++ b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-agent/use-copilots-llm.md @@ -1,6 +1,6 @@ --- title: Using GitHub Copilot's LLM for your agent -intro: 'Learn how to use {% data variables.product.prodname_copilot_short %}''s LLM for your agent.' +intro: Learn how to use {% data variables.product.prodname_copilot_short %}'s LLM for your agent. versions: feature: copilot-extensions topics: diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/index.md b/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/index.md deleted file mode 100644 index d16fd3c63b2d..000000000000 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/index.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Building a GitHub Copilot skillset for your GitHub Copilot Extension -shortTitle: Build a Copilot skillset -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: - - Copilot -redirect_from: - - /copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension - - /copilot/how-tos/build-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension - - /copilot/how-tos/build-copilot-extensions/build-a-copilot-skillset -children: - - /build-copilot-skillsets -contentType: how-tos ---- diff --git a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/build-copilot-skillsets.md b/content/copilot/how-tos/use-copilot-extensions/build-copilot-skillsets.md similarity index 90% rename from content/copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/build-copilot-skillsets.md rename to content/copilot/how-tos/use-copilot-extensions/build-copilot-skillsets.md index 23bda4a86935..f23d8ad56a15 100644 --- a/content/copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/build-copilot-skillsets.md +++ b/content/copilot/how-tos/use-copilot-extensions/build-copilot-skillsets.md @@ -1,16 +1,20 @@ --- title: Building GitHub Copilot skillsets -intro: 'Learn the steps to build {% data variables.copilot.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 Copilot skillsets' +shortTitle: Build Copilot skillsets redirect_from: + - /copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension - /copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets - /copilot/how-tos/build-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets - /copilot/how-tos/build-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/build-copilot-skillsets - /copilot/how-tos/build-copilot-extensions/build-a-copilot-skillset/build-copilot-skillsets + - /copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset/build-copilot-skillsets + - /copilot/how-tos/use-copilot-extensions/build-a-copilot-skillset + - /copilot/how-tos/build-copilot-extensions/build-copilot-skillsets contentType: how-tos --- diff --git a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/configure-app-for-extension.md b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/configure-app-for-extension.md index e5f12aec8d38..1f2876a3008b 100644 --- a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/configure-app-for-extension.md +++ b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/configure-app-for-extension.md @@ -1,6 +1,6 @@ --- title: Configuring your GitHub App for your GitHub Copilot extension -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 %}.' +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 diff --git a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/create-github-app.md b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/create-github-app.md index d066b10e9edb..17bfc1d200a7 100644 --- a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/create-github-app.md +++ b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/create-github-app.md @@ -1,6 +1,6 @@ --- title: Creating a GitHub App for your GitHub Copilot Extension -intro: 'Learn how to create a {% data variables.product.prodname_github_app %} for your {% data variables.copilot.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: diff --git a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/host-your-extension.md b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/host-your-extension.md index d03e6ec54a5d..a3395c398d39 100644 --- a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/host-your-extension.md +++ b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/host-your-extension.md @@ -1,6 +1,6 @@ --- title: Configuring your server to host your GitHub Copilot extension -intro: 'Learn how to make your {% data variables.product.prodname_copilot_short %} extension accessible to the internet.' +intro: Learn how to make your {% data variables.product.prodname_copilot_short %} extension accessible to the internet. versions: feature: copilot-extensions redirect_from: diff --git a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/index.md b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/index.md index 0dc007e41e2e..88461708db8c 100644 --- a/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/index.md +++ b/content/copilot/how-tos/use-copilot-extensions/create-a-copilot-extension/index.md @@ -1,7 +1,7 @@ --- title: Creating a GitHub Copilot Extension shortTitle: Create a Copilot Extension -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 %}.' +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: @@ -16,3 +16,4 @@ redirect_from: - /copilot/how-tos/build-copilot-extensions/create-a-copilot-extension contentType: how-tos --- + diff --git a/content/copilot/how-tos/use-copilot-extensions/debug-copilot-extension.md b/content/copilot/how-tos/use-copilot-extensions/debug-copilot-extension.md index ab3764629ba1..e40b88b80098 100644 --- a/content/copilot/how-tos/use-copilot-extensions/debug-copilot-extension.md +++ b/content/copilot/how-tos/use-copilot-extensions/debug-copilot-extension.md @@ -1,6 +1,6 @@ --- title: Debugging your GitHub Copilot Extension -intro: 'Learn how to debug your {% data variables.copilot.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: diff --git a/content/copilot/how-tos/use-copilot-extensions/index.md b/content/copilot/how-tos/use-copilot-extensions/index.md index 21e448f7abfa..d621d34f1538 100644 --- a/content/copilot/how-tos/use-copilot-extensions/index.md +++ b/content/copilot/how-tos/use-copilot-extensions/index.md @@ -1,7 +1,7 @@ --- title: GitHub Copilot Extensions -shortTitle: Use Copilot Extensions -intro: 'Learn how to integrate external tools with {% data variables.product.prodname_copilot_short %}.' +shortTitle: Build Copilot Extensions +intro: Learn how to integrate external tools with {% data variables.product.prodname_copilot_short %}. versions: feature: copilot topics: @@ -10,7 +10,7 @@ children: - /set-up-copilot-extensions - /create-a-copilot-extension - /build-a-copilot-agent - - /build-a-copilot-skillset + - /build-copilot-skillsets - /set-up-oidc - /debug-copilot-extension - /manage-extension-availability @@ -19,3 +19,4 @@ redirect_from: - /copilot/how-tos/build-copilot-extensions contentType: how-tos --- + diff --git a/content/copilot/how-tos/use-copilot-extensions/manage-extension-availability.md b/content/copilot/how-tos/use-copilot-extensions/manage-extension-availability.md index 7250533cd3fa..725d15238ab0 100644 --- a/content/copilot/how-tos/use-copilot-extensions/manage-extension-availability.md +++ b/content/copilot/how-tos/use-copilot-extensions/manage-extension-availability.md @@ -1,6 +1,6 @@ --- title: Managing the availability of your GitHub Copilot Extension -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 %}.' +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: diff --git a/content/copilot/how-tos/use-copilot-extensions/set-up-copilot-extensions.md b/content/copilot/how-tos/use-copilot-extensions/set-up-copilot-extensions.md index fd4b12b21720..f398824521ff 100644 --- a/content/copilot/how-tos/use-copilot-extensions/set-up-copilot-extensions.md +++ b/content/copilot/how-tos/use-copilot-extensions/set-up-copilot-extensions.md @@ -1,6 +1,6 @@ --- title: Setting up GitHub Copilot Extensions -intro: 'Follow these steps to start building {% data variables.copilot.copilot_extensions_short %}.' +intro: Follow these steps to start building {% data variables.copilot.copilot_extensions_short %}. defaultTool: agents versions: feature: copilot-extensions diff --git a/content/copilot/how-tos/use-copilot-extensions/set-up-oidc.md b/content/copilot/how-tos/use-copilot-extensions/set-up-oidc.md index c85fd318240c..b4046a089e84 100644 --- a/content/copilot/how-tos/use-copilot-extensions/set-up-oidc.md +++ b/content/copilot/how-tos/use-copilot-extensions/set-up-oidc.md @@ -1,6 +1,6 @@ --- title: Setting up OIDC for your GitHub Copilot extension -intro: 'Learn how to set up OpenID Connect (OIDC) with your {% data variables.copilot.copilot_extension_short %} to enhance security.' +intro: Learn how to set up OpenID Connect (OIDC) with your {% data variables.copilot.copilot_extension_short %} to enhance security. versions: feature: copilot-extensions topics: diff --git a/content/copilot/index.md b/content/copilot/index.md index 5cfdcd7b5177..6bcec453964a 100644 --- a/content/copilot/index.md +++ b/content/copilot/index.md @@ -15,12 +15,12 @@ featuredLinks: - /copilot/get-started/what-is-github-copilot - /copilot/get-started/quickstart - /copilot/tutorials/try-extensions - - /copilot/concepts/coding-agent/coding-agent + - /copilot/concepts/agents/coding-agent popular: - /copilot/get-started/features - /copilot/tutorials/copilot-chat-cookbook - - /copilot/how-tos/get-code-suggestions/get-code-suggestions - - /copilot/how-tos/use-chat/use-chat-in-ide + - /copilot/how-tos/get-code-suggestions/get-ide-code-suggestions + - /copilot/how-tos/chat-with-copilot/chat-in-ide - /copilot/how-tos/use-copilot-for-common-tasks/use-copilot-in-the-cli layout: product-landing versions: diff --git a/content/copilot/reference/index.md b/content/copilot/reference/index.md index 89aafcd866fb..3cc5ab4f52aa 100644 --- a/content/copilot/reference/index.md +++ b/content/copilot/reference/index.md @@ -7,14 +7,14 @@ versions: topics: - Copilot children: - - /copilot-billing - /cheat-sheet + - /ai-models - /keyboard-shortcuts - /policy-conflicts - - /ai-models - /allowlist-reference - - /extensions-glossary - /metrics-data + - /copilot-billing + - /extensions-glossary contentType: reference --- diff --git a/content/copilot/tutorials/index.md b/content/copilot/tutorials/index.md index 3263b8e075d2..08c90dca9008 100644 --- a/content/copilot/tutorials/index.md +++ b/content/copilot/tutorials/index.md @@ -10,23 +10,23 @@ children: - /copilot-chat-cookbook - /customization-library - /coding-agent - - /compare-ai-models - /enhance-agent-mode-with-mcp - - /try-extensions + - /compare-ai-models - /speed-up-development-work + - /easy-apps-with-spark + - /build-apps-with-spark + - /roll-out-at-scale - /explore-a-codebase - /explore-issues-and-discussions - /explore-pull-requests - /write-tests - /refactor-code - /learn-a-new-language - - /easy-apps-with-spark - - /build-apps-with-spark - /modernize-legacy-code - /migrate-a-project - /plan-a-project - /upgrade-projects - - /roll-out-at-scale + - /try-extensions redirect_from: - /copilot/using-github-copilot/guides-on-using-github-copilot contentType: tutorials diff --git a/content/index.md b/content/index.md index 312655e45239..b1f9266023af 100644 --- a/content/index.md +++ b/content/index.md @@ -9,7 +9,7 @@ featuredLinks: popular: - /pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests - /authentication - - /copilot/how-tos/get-code-suggestions/get-code-suggestions + - /copilot/how-tos/get-code-suggestions/get-ide-code-suggestions - /get-started/git-basics/managing-remote-repositories - /pages redirect_from: @@ -109,7 +109,7 @@ childGroups: children: - copilot - copilot/get-started/plans - - copilot/how-tos/get-code-suggestions/get-code-suggestions + - copilot/how-tos/get-code-suggestions/get-ide-code-suggestions - copilot/tutorials/copilot-chat-cookbook - copilot/how-tos/use-copilot-agents/coding-agent - copilot/how-tos/configure-custom-instructions diff --git a/content/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer.md b/content/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer.md index 2e45532c8592..61bb625ba39b 100644 --- a/content/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer.md +++ b/content/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer.md @@ -22,6 +22,9 @@ The migration log lists the steps that were completed as part of the migration a * The source of the migration * How long the migration took +> [!IMPORTANT] +> Issues should be enabled in the target repository for the migration log to be created. + You can access the migration log for a repository migration in multiple ways. * On {% data variables.product.prodname_dotcom %}, by viewing the "Migration Log" issue in the migrated repository. You can use this issue to discuss any warnings with your team and record any decisions. diff --git a/data/reusables/copilot/copilot-extensions/about-copilot-extensions.md b/data/reusables/copilot/copilot-extensions/about-copilot-extensions.md new file mode 100644 index 000000000000..6d4197f6de5b --- /dev/null +++ b/data/reusables/copilot/copilot-extensions/about-copilot-extensions.md @@ -0,0 +1,8 @@ +{% 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.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. + +{% data variables.copilot.copilot_extensions %} are built with {% data variables.product.prodname_github_apps %}. They are best suited for developers who want cross-platform compatibility and app management and support from {% data variables.product.github %}. diff --git a/data/reusables/copilot/knowledge-bases-retirement.md b/data/reusables/copilot/knowledge-bases-retirement.md new file mode 100644 index 000000000000..46cb9ea6be1e --- /dev/null +++ b/data/reusables/copilot/knowledge-bases-retirement.md @@ -0,0 +1,2 @@ +> [!IMPORTANT] +> Beginning November 1, 2025, knowledge bases will be {% data variables.release-phases.retired %} and fully replaced by {% data variables.copilot.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). diff --git a/data/reusables/copilot/prompt-files-preview-note.md b/data/reusables/copilot/prompt-files-preview-note.md index face3ef91eba..5666c4501167 100644 --- a/data/reusables/copilot/prompt-files-preview-note.md +++ b/data/reusables/copilot/prompt-files-preview-note.md @@ -1,3 +1,3 @@ > [!NOTE] -> * {% data variables.product.prodname_copilot_short %} prompt files are in {% data variables.release-phases.public_preview %} and subject to change. Prompt files are only available in {% data variables.product.prodname_vscode_shortname %}. See [AUTOTITLE](/copilot/concepts/response-customization?tool=vscode#about-prompt-files). +> * {% data variables.product.prodname_copilot_short %} prompt files are in {% data variables.release-phases.public_preview %} and subject to change. Prompt files are only available in {% data variables.product.prodname_vscode_shortname %}. See [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=vscode#about-prompt-files). > * For community-contributed examples of prompt files for specific languages and scenarios, see the [Awesome GitHub Copilot Customizations](https://github.com/github/awesome-copilot/blob/main/README.prompts.md) repository. diff --git a/src/frame/lib/frontmatter.js b/src/frame/lib/frontmatter.js index 9de39a7ac389..4c13dd76b838 100644 --- a/src/frame/lib/frontmatter.js +++ b/src/frame/lib/frontmatter.js @@ -169,6 +169,13 @@ export const schema = { prefix: { type: 'string' }, }, }, + audience: { + type: 'array', + items: { + type: 'string', + enum: ['builder', 'driver'], + }, + }, // DEPRECATED: Use 'contentType' instead of 'type' for new content. // 'type' exists on ~40% of files but is used only for internal analytics. // Migration tool: src/content-render/scripts/add-content-type.ts