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 5ab96e6b34..c8e03f6697 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 120699a103..94d05a20a3 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 2f07ba8da0..3b79c64610 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 44a197a63f..5ac72b1e63 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 20c48cab52..86b942ce72 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 0000000000..a36420c0f2 --- /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 27df0db51a..8676dde065 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 0000000000..f4600e89ed --- /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 0000000000..fcd2299ccc --- /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 89% rename from content/copilot/concepts/knowledge-bases.md rename to content/copilot/concepts/context/knowledge-bases.md index 9ce8a377e4..abc0a7fbc3 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,6 +10,7 @@ topics: - Copilot redirect_from: - /copilot/concepts/copilot-knowledge-bases + - /copilot/concepts/knowledge-bases contentType: concepts --- 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 5f00fff46f..0a865051db 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 e8e94de03f..888f4c4a47 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 f6062299fa..5796e2a046 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 7e0729c41a..3c0644d2d7 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 fa2ceacdbb..18ebc2726a 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 5f5ee33ebb..3c5df75926 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 0000000000..ad3ba17453 --- /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 a547d34cc0..ce789c70c3 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 0d2f8baba5..70626a0650 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 c7b5841f85..ab77168074 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 f79b0a1cf8..98230f5242 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 8e5ca5f389..ff6bc58c9a 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 e7d86dd36a..ae4f2769ab 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 63652004b8..ca5f01bb1d 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 194baad4c5..ab0c82e57d 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 cb729f0a6f..e44cb24b59 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 4adf2dd966..df2f159ce5 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 48e67749ee..54e8a01279 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 1a7a1def4a..b298057056 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 b4c2a8f0c3..2504866fb1 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/use-copilot-agents/coding-agent/index.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/index.md index 5661089fa8..00d195ffb1 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 8485e42764..9312a5278a 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 1b4265a614..a3447a6e98 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 094413a2b9..7a57aadc36 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 244c754b06..8cd4f31f6a 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 8faca07db8..eb561fa190 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 5da3376580..41cb052004 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 d16fd3c63b..0000000000 --- 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 23bda4a869..f23d8ad56a 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 e5f12aec8d..1f2876a300 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 d066b10e9e..17bfc1d200 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 d03e6ec54a..a3395c398d 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 0dc007e41e..88461708db 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 ab3764629b..e40b88b800 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 21e448f7ab..d621d34f15 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 7250533cd3..725d15238a 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 fd4b12b217..f398824521 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 c85fd31824..b4046a089e 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 5cfdcd7b51..6bcec45396 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 89aafcd866..3cc5ab4f52 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 3263b8e075..08c90dca90 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 312655e452..b1f9266023 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/data/reusables/copilot/copilot-extensions/about-copilot-extensions.md b/data/reusables/copilot/copilot-extensions/about-copilot-extensions.md new file mode 100644 index 0000000000..6d4197f6de --- /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/prompt-files-preview-note.md b/data/reusables/copilot/prompt-files-preview-note.md index face3ef91e..5666c45011 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.