Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot contentType: how-tos category: - Author and optimize with Copilot +redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/make-changes-to-an-existing-pr --- > [!NOTE] -> For an overview of {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +> For an overview of {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). ## Introduction @@ -37,10 +39,10 @@ You can ask {% data variables.product.prodname_copilot_short %} to resolve merge If you prefer not to use this default behavior, you can ask {% data variables.product.prodname_copilot_short %} to create a new branch and a new pull request targeting your branch instead. Once the agent finishes work, it will request a review from you. -{% data reusables.copilot.coding-agent.monitoring-progress-heading %} +{% data reusables.copilot.cloud-agent.monitoring-progress-heading %} ## Further reading -* [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent) -* [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices) -* [AUTOTITLE](/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent#copilot-cant-create-a-pull-request-from-copilot-chat) +* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent#copilot-cant-create-a-pull-request-from-copilot-chat) diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/provide-visual-inputs.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/provide-visual-inputs.md similarity index 63% rename from content/copilot/how-tos/use-copilot-agents/coding-agent/provide-visual-inputs.md rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/provide-visual-inputs.md index 426162b76be0..13dc462bca92 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/provide-visual-inputs.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/provide-visual-inputs.md @@ -2,20 +2,22 @@ title: Provide visual inputs to GitHub Copilot shortTitle: Provide visual inputs intro: 'You can attach images to issues or {% data variables.copilot.copilot_chat_short %} prompts to help {% data variables.product.prodname_copilot_short %} understand your task.' -product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot contentType: how-tos category: - Author and optimize with Copilot +redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/provide-visual-inputs --- > [!NOTE] -> For an overview of {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +> For an overview of {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). ## Introduction -{% data variables.copilot.copilot_coding_agent_short_cap_c %} can process images, such as a photo or screenshot of a sketch or design, as part of your task description. This is useful when you want to show {% data variables.product.prodname_copilot_short %} what you're trying to achieve visually, for example, when updating a UI or implementing a design. +{% data variables.copilot.copilot_cloud_agent_short_cap_c %} can process images, such as a photo or screenshot of a sketch or design, as part of your task description. This is useful when you want to show {% data variables.product.prodname_copilot_short %} what you're trying to achieve visually, for example, when updating a UI or implementing a design. You can provide images to {% data variables.product.prodname_copilot_short %} in two ways: @@ -28,7 +30,7 @@ You can provide images to {% data variables.product.prodname_copilot_short %} in 1. Create a new issue or open an existing issue. 1. In the issue body, drag and drop your image. 1. Add a clear description of what you want {% data variables.product.prodname_copilot_short %} to do with the image. For example, "Let's update the login form to match this mockup". -1. Assign the issue to {% data variables.product.prodname_copilot_short %}. For detailed instructions, see [Assign an issue to {% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %}](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr#assigning-an-issue-to-copilot-on-githubcom). +1. Assign the issue to {% data variables.product.prodname_copilot_short %}. For detailed instructions, see [Assign an issue to {% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %}](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr#assigning-an-issue-to-copilot-on-githubcom). {% data variables.product.prodname_copilot_short %} will analyze the image along with your description when working on the task. @@ -37,11 +39,11 @@ You can provide images to {% data variables.product.prodname_copilot_short %} in 1. Open {% data variables.copilot.copilot_chat_short %}. 1. Attach your image to the chat prompt, and use `/task` to describe what you want {% data variables.product.prodname_copilot_short %} to do. For example, "Update the notification badge to match this mockup". - For detailed instructions, see [Asking {% data variables.product.prodname_copilot_short %} to create a pull request from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_dotcom_the_website %}](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-githubcom). + For detailed instructions, see [Asking {% data variables.product.prodname_copilot_short %} to create a pull request from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_dotcom_the_website %}](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-githubcom). 1. {% data variables.product.prodname_copilot_short %} will start work using the image as context for the task. ## Further reading -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr) -* [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices) -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr) +* [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs) diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/research-plan-iterate.md similarity index 63% rename from content/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate.md rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/research-plan-iterate.md index 5a3e1450640a..ee12c65f4927 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/research-plan-iterate.md @@ -2,12 +2,14 @@ title: Research, plan, and iterate on code changes with Copilot cloud agent shortTitle: Research, plan, iterate intro: "Perform deep research on a repository, create an implementation plan, and make iterative code changes on a branch, then create a pull request when you're ready." -product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot contentType: how-tos category: - Author and optimize with Copilot +redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate --- ## Introduction @@ -18,13 +20,13 @@ You can use {% data variables.copilot.copilot_cloud_agent_tmp %} to: * **Plan** and refine an approach before {% data variables.product.prodname_copilot_short %} makes changes. * **Iterate** on code changes on a branch, review a diff, and get {% data variables.product.prodname_copilot_short %} to only **create a pull request when you're ready**. -{% data variables.copilot.copilot_coding_agent %} *won't* automatically open a pull request as part of the session. If you *do* want {% data variables.product.prodname_copilot_short %} to open a pull request for your task right away, you can explicitly ask for one in your prompt. For example, by stating **"Create a pull request to ..."**. +{% data variables.copilot.copilot_cloud_agent %} *won't* automatically open a pull request as part of the session. If you *do* want {% data variables.product.prodname_copilot_short %} to open a pull request for your task right away, you can explicitly ask for one in your prompt. For example, by stating **"Create a pull request to ..."**. -> [!NOTE] Deep research, planning, and iterating on code changes before creating a pull request are only available with {% data variables.copilot.copilot_coding_agent %} on {% data variables.product.prodname_dotcom_the_website %}. {% data variables.copilot.copilot_coding_agent_short_cap_c %} integrations (such as Azure Boards, JIRA, Linear, Slack, or Teams) only support creating a pull request directly. +> [!NOTE] Deep research, planning, and iterating on code changes before creating a pull request are only available with {% data variables.copilot.copilot_cloud_agent %} on {% data variables.product.prodname_dotcom_the_website %}. {% data variables.copilot.copilot_cloud_agent_short_cap_c %} integrations (such as Azure Boards, JIRA, Linear, Slack, or Teams) only support creating a pull request directly. ## Performing deep research -You can ask {% data variables.copilot.copilot_coding_agent %} questions about a repository to understand how it works, identify where to make a change, or confirm assumptions before planning and implementation. {% data variables.product.prodname_copilot_short %} starts a **deep research** session to examine the repository and return a grounded answer. +You can ask {% data variables.copilot.copilot_cloud_agent %} questions about a repository to understand how it works, identify where to make a change, or confirm assumptions before planning and implementation. {% data variables.product.prodname_copilot_short %} starts a **deep research** session to examine the repository and return a grounded answer. {% data reusables.copilot.open-agents-panel-or-page %} 1. Ask a question about the repository. @@ -37,7 +39,7 @@ You can ask {% data variables.copilot.copilot_coding_agent %} questions about a ## Creating a plan -You can ask {% data variables.copilot.copilot_coding_agent %} to propose a plan before making changes, simply by prompting the agent. +You can ask {% data variables.copilot.copilot_cloud_agent %} to propose a plan before making changes, simply by prompting the agent. 1. Ask the agent to create a plan. @@ -60,6 +62,6 @@ After research and planning, you can make changes on a branch, review the diff, ## Further reading -* [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent) -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr) -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents) \ No newline at end of file +* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents) \ No newline at end of file diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs.md similarity index 76% rename from content/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs.md rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs.md index d5ae3a779c8d..d5d2fcecc195 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs.md @@ -2,10 +2,11 @@ title: Reviewing a pull request created by GitHub Copilot shortTitle: Review Copilot PRs intro: 'After {% data variables.product.prodname_copilot_short %} creates a pull request, you should review it. You can mention `@copilot` to ask {% data variables.product.prodname_copilot_short %} to make changes, or push changes yourself.' -product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/reviewing-a-pull-request-created-by-copilot - /copilot/using-github-copilot/coding-agent/reviewing-a-pull-request-created-by-copilot - /copilot/how-tos/agents/copilot-coding-agent/reviewing-a-pull-request-created-by-copilot @@ -17,7 +18,7 @@ category: --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). ## Reviewing {% data variables.product.prodname_copilot_short %}'s changes @@ -33,22 +34,22 @@ Optionally, when submitting a pull request comment (not a review or review comme > [!TIP] > We recommend you batch your review comments instead of submitting them individually. -{% data reusables.copilot.coding-agent.write-access-required %} +{% data reusables.copilot.cloud-agent.write-access-required %} When {% data variables.product.prodname_copilot_short %} starts a new agent session in response to your comment, an eyes emoji (👀) is added as a reaction to the comment, and a "Copilot has started work" event is added to the pull request timeline. - + When {% data variables.product.prodname_copilot_short %} starts a new session on the same pull request, it remembers context from the previous session, allowing it to work faster and more reliably. > [!NOTE] -> If the pull request was created by a {% data variables.copilot.copilot_custom_agent_short %}, when you mention `@copilot` in pull request comments, the same {% data variables.copilot.copilot_custom_agent_short %} will be used to make further changes. This ensures consistency in the agent's specialized configuration throughout the pull request lifecycle. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). +> If the pull request was created by a {% data variables.copilot.copilot_custom_agent_short %}, when you mention `@copilot` in pull request comments, the same {% data variables.copilot.copilot_custom_agent_short %} will be used to make further changes. This ensures consistency in the agent's specialized configuration throughout the pull request lifecycle. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). -For more information, see the section "Use comments to iterate on a pull request" in [AUTOTITLE](/copilot/using-github-copilot/coding-agent/best-practices-for-using-copilot-to-work-on-tasks#using-comments-to-iterate-on-a-pull-request). +For more information, see the section "Use comments to iterate on a pull request" in [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results#using-comments-to-iterate-on-a-pull-request). ## Managing {% data variables.product.prodname_actions %} workflow runs -{% data reusables.copilot.coding-agent-workflow-run-approval-default %} For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/configuring-agent-settings). +{% data reusables.copilot.cloud-agent-workflow-run-approval-default %} For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings). ## Giving feedback on {% data variables.product.prodname_copilot_short %}'s work @@ -59,6 +60,6 @@ You can provide feedback on {% data variables.product.prodname_copilot_short %}' ## Further reading -* [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices) -* [AUTOTITLE](/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs) -* [AUTOTITLE](/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent) +* [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent) diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/test-custom-agents.md similarity index 95% rename from content/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents.md rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/test-custom-agents.md index f3a77308301d..e5b892897fb9 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/test-custom-agents.md @@ -8,6 +8,8 @@ contentType: how-tos category: - Configure Copilot - Manage Copilot for a team +redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents --- {% data reusables.copilot.custom-agents-preview-note %} @@ -23,7 +25,7 @@ Before you can test a {% data variables.copilot.copilot_custom_agent_short %}, y ## 1. Create your test {% data variables.copilot.copilot_custom_agent_short %} 1. In your organization or enterprise's `.github-private` repository, create a new directory called `.github/agents`. Agents stored in this directory are only available to members of your organization or enterprise who have access to the `.github-private` repository, and can only be used when they start a task within that repository. -1. In your `.github/agents` directory, create the {% data variables.copilot.agent_profile %} for your test agent. You can create a net-new profile or duplicate an existing profile to test potential updates. For information on configuring an {% data variables.copilot.agent_profile %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents#configuring-an-agent-profile). +1. In your `.github/agents` directory, create the {% data variables.copilot.agent_profile %} for your test agent. You can create a net-new profile or duplicate an existing profile to test potential updates. For information on configuring an {% data variables.copilot.agent_profile %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents#configuring-an-agent-profile). 1. Merge your test {% data variables.copilot.agent_profile %} into the default branch of your repository. ## 2. Test your {% data variables.copilot.copilot_custom_agent_short %} diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions.md similarity index 86% rename from content/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions.md rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions.md index 8fe6de681752..fe0c3a19c59e 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions.md @@ -2,10 +2,11 @@ title: Tracking GitHub Copilot's sessions shortTitle: Track Copilot sessions intro: 'You can use the agents panel or page, {% data variables.product.prodname_vscode %}, JetBrains IDEs, Eclipse, the {% data variables.product.prodname_cli %}, Raycast and session logs to track {% data variables.product.prodname_copilot_short %}''s progress and understand its approach.' -product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/using-the-copilot-coding-agent-logs - /copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs - /copilot/how-tos/agents/copilot-coding-agent/using-the-copilot-coding-agent-logs @@ -19,7 +20,7 @@ category: ## Introduction -After you give {% data variables.product.prodname_copilot_short %} a task, it works autonomously in the background to complete it. See [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +After you give {% data variables.product.prodname_copilot_short %} a task, it works autonomously in the background to complete it. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). The agents panel, [agents tab](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text), the {% data variables.product.prodname_cli %}, and {% data variables.product.prodname_copilot %} extension for Raycast provide an overview of your agent sessions across repositories. You can use them to kick off new tasks and track {% data variables.product.prodname_copilot_short %}'s progress. @@ -35,7 +36,7 @@ To open the [agents tab](https://github.com/copilot/agents?ref_product=copilot&r Each session displays its status. Click on a session to open the session log and overview, where you can monitor the agent's progress, token usage, session count, and session length. -You can start new agent sessions from the tab. See [AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request). +You can start new agent sessions from the tab. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr). ## Tracking agent sessions from the {% data variables.product.prodname_cli %} @@ -52,9 +53,9 @@ To see all of the available options, run `gh agent-task list --help` or `gh agen ## Tracking agent sessions from Raycast -{% data reusables.copilot.coding-agent.raycast-intro %} +{% data reusables.copilot.cloud-agent.raycast-intro %} -{% data reusables.copilot.coding-agent.raycast-setup %} +{% data reusables.copilot.cloud-agent.raycast-setup %} 1. Open Raycast, search for "{% data variables.product.prodname_copilot_short %}," find the **View Tasks** command, then press Enter. 1. Click **Sign in with {% data variables.product.github %}**, then complete the authentication flow. Raycast will re-open. 1. You'll see a list of your tasks. Select a task, then use the following keyboard shortcuts: @@ -65,7 +66,7 @@ To see all of the available options, run `gh agent-task list --help` or `gh agen > [!NOTE] > If you are unable to see some tasks in Raycast, the organization that owns the repository may have enabled {% data variables.product.prodname_oauth_app %} access restrictions. To learn how to request approval for the "{% data variables.product.prodname_copilot %} for Raycast" {% data variables.product.prodname_oauth_app %}, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps). -You can also start new agent sessions from Raycast. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr#asking-copilot-to-create-a-pull-request-from-raycast). +You can also start new agent sessions from Raycast. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr#asking-copilot-to-create-a-pull-request-from-raycast). ## Tracking sessions from {% data variables.product.prodname_vscode %} @@ -77,7 +78,7 @@ For each session listed, you can see its status at a glance, or click on it to n To view the session logs, click on the pull request in the list, then click **View Session**. -You can also start new agent sessions from {% data variables.product.prodname_vscode %}. See [AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-visual-studio-code). +You can also start new agent sessions from {% data variables.product.prodname_vscode %}. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr#asking-copilot-to-create-a-pull-request-from-copilot-chat-in-visual-studio-code). To directly open agent sessions in {% data variables.product.prodname_vscode_shortname %}, click the **Open in {% data variables.product.prodname_vscode_shortname %}** option on the agents tab. @@ -87,7 +88,7 @@ To directly open agent sessions in {% data variables.product.prodname_vscode_sho ## Tracking sessions from JetBrains IDEs > [!NOTE] -> {% data variables.copilot.copilot_coding_agent %} in JetBrains IDEs is in {% data variables.release-phases.public_preview %}, and subject to change. +> {% data variables.copilot.copilot_cloud_agent %} in JetBrains IDEs is in {% data variables.release-phases.public_preview %}, and subject to change. You can see a list of your running and past agent sessions for a project in JetBrains IDEs with the {% data variables.copilot.copilot_chat %} extension. See [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-extension?tool=jetbrains). @@ -100,7 +101,7 @@ For each session listed, you can see its status at a glance. Click **Open in Bro ## Tracking sessions from Eclipse > [!NOTE] -> {% data variables.copilot.copilot_coding_agent %} in Eclipse is in {% data variables.release-phases.public_preview %}, and subject to change. +> {% data variables.copilot.copilot_cloud_agent %} in Eclipse is in {% data variables.release-phases.public_preview %}, and subject to change. You can see a list of your running and past agent sessions for a project in Eclipse with the {% data variables.copilot.copilot_chat %} extension. See [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-extension?tool=eclipse). @@ -122,15 +123,15 @@ You can see a list of your running and past pull requests generated by agents in For example, to show only merged tasks, tap **Open** and then, in the dropdown, tap **Merged**. -
+ 
## Tracing commits to session logs
-Commits from {% data variables.copilot.copilot_coding_agent %} have the following characteristics:
+Commits from {% data variables.copilot.copilot_cloud_agent %} have the following characteristics:
* Every commit is authored by {% data variables.product.prodname_copilot_short %}, with the human who started the task marked as the co-author.
* Each commit message includes a link to the session logs for that commit, so you can understand why {% data variables.product.prodname_copilot_short %} made a change during code review or trace it later for auditing purposes.
-* Commits from {% data variables.copilot.copilot_coding_agent %} are signed and appear as "Verified" on {% data variables.product.github %}.
+* Commits from {% data variables.copilot.copilot_cloud_agent %} are signed and appear as "Verified" on {% data variables.product.github %}.
## Using the session logs to understand {% data variables.product.prodname_copilot_short %}'s approach
@@ -165,7 +166,7 @@ Follow these steps to steer {% data variables.product.prodname_copilot_short %}:
You can stop {% data variables.product.prodname_copilot_short %} from continuing to work on a task by clicking **Stop session** in the session log viewer.
-
+
Reasons you might want to stop a session include:
@@ -174,5 +175,5 @@ Reasons you might want to stop a session include:
## Further reading
-* [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices)
-* [AUTOTITLE](/copilot/using-github-copilot/coding-agent/troubleshooting-copilot-coding-agent)
+* [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results)
+* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent)
diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/troubleshoot-coding-agent.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent.md
similarity index 69%
rename from content/copilot/how-tos/use-copilot-agents/coding-agent/troubleshoot-coding-agent.md
rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent.md
index d8cded321709..239e3dd24c58 100644
--- a/content/copilot/how-tos/use-copilot-agents/coding-agent/troubleshoot-coding-agent.md
+++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent.md
@@ -3,10 +3,11 @@ title: Troubleshooting GitHub Copilot cloud agent
shortTitle: Troubleshoot cloud agent
allowTitleToDifferFromFilename: true
intro: 'Learn how to resolve problems that may occur when you assign tasks to {% data variables.product.prodname_copilot_short %}.'
-product: '{% data reusables.gated-features.copilot-coding-agent %}Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/troubleshoot-coding-agent - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/troubleshooting-copilot-coding-agent - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/troubleshooting-copilot-coding-agent - /early-access/copilot/coding-agent/troubleshooting-copilot-coding-agent @@ -26,35 +27,35 @@ You can only assign issues to {% data variables.product.prodname_copilot_short % If you do not already have a subscription for one of these plans, click this button for more information:
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 aria-label="link-external" %} -If you _do_ have {% data variables.copilot.copilot_pro %}, {% data variables.copilot.copilot_pro_plus %}, {% data variables.copilot.copilot_for_business %}, or {% data variables.copilot.copilot_enterprise %}, check that {% data variables.copilot.copilot_coding_agent %} {% ifversion ghec %}is enabled and{% endif %} has not been manually disabled for the repository: +If you _do_ have {% data variables.copilot.copilot_pro %}, {% data variables.copilot.copilot_pro_plus %}, {% data variables.copilot.copilot_for_business %}, or {% data variables.copilot.copilot_enterprise %}, check that {% data variables.copilot.copilot_cloud_agent %} {% ifversion ghec %}is enabled and{% endif %} has not been manually disabled for the repository: {% ifversion ghec %} -* If you are on the {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise_short %} plan, your ability to use {% data variables.copilot.copilot_coding_agent %} is controlled by your enterprise and/or organization administrator. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/adding-copilot-coding-agent-to-enterprise). +* If you are on the {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise_short %} plan, your ability to use {% data variables.copilot.copilot_cloud_agent %} is controlled by your enterprise and/or organization administrator. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-cloud-agent). {% endif %} -* For organization-owned repositories, the availability of {% data variables.copilot.copilot_coding_agent %} in the repository is managed by the organization and/or enterprise administrators. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization). +* For organization-owned repositories, the availability of {% data variables.copilot.copilot_cloud_agent %} in the repository is managed by the organization and/or enterprise administrators. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent). -* For personal repositories, the availability of {% data variables.copilot.copilot_coding_agent %} in the repository is configured in your account settings. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-copilot-coding-agent). +* For personal repositories, the availability of {% data variables.copilot.copilot_cloud_agent %} in the repository is configured in your account settings. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-copilot-cloud-agent). > [!NOTE] -> You can check whether {% data variables.copilot.copilot_coding_agent %} has been enabled for you in the features page of your {% data variables.product.prodname_copilot_short %} settings: [github.com/settings/copilot/features](https://github.com/settings/copilot/features). +> You can check whether {% data variables.copilot.copilot_cloud_agent %} has been enabled for you in the features page of your {% data variables.product.prodname_copilot_short %} settings: [github.com/settings/copilot/features](https://github.com/settings/copilot/features). ## I have an {% data variables.product.prodname_emu %} account and {% data variables.product.prodname_copilot_short %} won't work in my personal repository -{% data reusables.copilot.coding-agent-emu-limitation %} +{% data reusables.copilot.cloud-agent-emu-limitation %} If you have an {% data variables.enterprise.prodname_managed_user %} and try to assign {% data variables.product.prodname_copilot_short %} to an issue in a personal repository, you may see an error message reporting that {% data variables.product.prodname_actions %} are not available for your repository. -To use {% data variables.copilot.copilot_coding_agent %}, you'll need to work with repositories owned by your organization instead of personal repositories. +To use {% data variables.copilot.copilot_cloud_agent %}, you'll need to work with repositories owned by your organization instead of personal repositories. ## {% data variables.product.prodname_copilot_short %} can't create a pull request from {% data variables.copilot.copilot_chat_short %} -If you asked {% data variables.product.prodname_copilot_short %} to create a pull request and it responds that it cannot directly create a pull request, check that {% data variables.copilot.copilot_coding_agent %} is available. +If you asked {% data variables.product.prodname_copilot_short %} to create a pull request and it responds that it cannot directly create a pull request, check that {% data variables.copilot.copilot_cloud_agent %} is available. > [!IMPORTANT] -> {% data reusables.copilot.coding-agent.use-chat-participant-in-vsc %} +> {% data reusables.copilot.cloud-agent.use-chat-participant-in-vsc %} ## I assigned an issue to {% data variables.product.prodname_copilot_short %}, but nothing is happening @@ -66,11 +67,11 @@ If there is a "{% data variables.product.prodname_copilot_short %} started work" ## {% data variables.product.prodname_copilot_short %} won't respond to my pull request comments -{% data reusables.copilot.coding-agent.write-access-required %} +{% data reusables.copilot.cloud-agent.write-access-required %} -If you do have write access, and you mention `@copilot` on a pull request that is assigned to {% data variables.product.prodname_copilot_short %}, the comment is passed to {% data variables.copilot.copilot_coding_agent %}. An eyes emoji (👀) is added to your comment to indicate that {% data variables.copilot.copilot_coding_agent %} has seen your comment. Shortly after, a "{% data variables.product.prodname_copilot_short %} started work" event is added to the pull request timeline. +If you do have write access, and you mention `@copilot` on a pull request that is assigned to {% data variables.product.prodname_copilot_short %}, the comment is passed to {% data variables.copilot.copilot_cloud_agent %}. An eyes emoji (👀) is added to your comment to indicate that {% data variables.copilot.copilot_cloud_agent %} has seen your comment. Shortly after, a "{% data variables.product.prodname_copilot_short %} started work" event is added to the pull request timeline. -If this doesn't happen, {% data variables.product.prodname_copilot_short %} may have been unassigned from the pull request, or you may not have write access. Note that {% data variables.product.prodname_copilot_short %} only responds to mentions in open pull requests. Once a pull request is merged or closed, {% data variables.copilot.copilot_coding_agent %} will not respond to new mentions or comments to better focus on active development work. +If this doesn't happen, {% data variables.product.prodname_copilot_short %} may have been unassigned from the pull request, or you may not have write access. Note that {% data variables.product.prodname_copilot_short %} only responds to mentions in open pull requests. Once a pull request is merged or closed, {% data variables.copilot.copilot_cloud_agent %} will not respond to new mentions or comments to better focus on active development work. ## Based on the agent session logs, {% data variables.product.prodname_copilot_short %} appears to be stuck @@ -84,13 +85,13 @@ If {% data variables.product.prodname_copilot_short %} got stuck while respondin {% data variables.product.prodname_actions %} workflows will not run automatically when {% data variables.product.prodname_copilot_short %} pushes changes to a pull request. -To allow {% data variables.product.prodname_actions %} workflows to run, click the **Approve and run workflows** button in the pull request's merge box. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/reviewing-a-pull-request-created-by-copilot). +To allow {% data variables.product.prodname_actions %} workflows to run, click the **Approve and run workflows** button in the pull request's merge box. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs). ## {% data variables.product.prodname_copilot_short %} is pushing changes which don't pass my CI checks While working on an issue, {% data variables.product.prodname_copilot_short %} has access to its own ephemeral development environment, powered by {% data variables.product.prodname_actions %}, where it can execute automated tests and linters to validate its work before it pushes. -It is most likely to do this if given clear instructions on what to do. The best way to do this is with a `.github/copilot-instructions.md` file. See [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices#adding-custom-instructions-to-your-repository). +It is most likely to do this if given clear instructions on what to do. The best way to do this is with a `.github/copilot-instructions.md` file. See [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results#adding-custom-instructions-to-your-repository). ## There is a warning from {% data variables.product.prodname_copilot %} about the firewall @@ -100,15 +101,15 @@ Limiting access to the internet helps to manage data exfiltration risks, where s If {% data variables.product.prodname_copilot_short %} tries to make a request which is blocked by the firewall, a warning is added to the pull request body (if {% data variables.product.prodname_copilot_short %} is responding to an issue assignment) or to a comment (if {% data variables.product.prodname_copilot_short %} is responding to a comment). The warning shows the blocked address and the command that tried to make the request. - + -For more information, see [AUTOTITLE](/copilot/customizing-copilot/customizing-or-disabling-the-firewall-for-copilot-coding-agent). +For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-firewall). ## {% data variables.product.prodname_copilot_short %} is not picking up attached screenshots -The maximum image size allowed by {% data variables.copilot.copilot_coding_agent %} is 3.00 MiB. Images larger than this will be removed from the request. +The maximum image size allowed by {% data variables.copilot.copilot_cloud_agent %} is 3.00 MiB. Images larger than this will be removed from the request. ## Further reading -* [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices) -* [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent) +* [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment) diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/use-hooks.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-hooks.md similarity index 64% rename from content/copilot/how-tos/use-copilot-agents/coding-agent/use-hooks.md rename to content/copilot/how-tos/use-copilot-agents/cloud-agent/use-hooks.md index a3d92f6addc6..aa8e897d9c6b 100644 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/use-hooks.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-hooks.md @@ -7,21 +7,23 @@ versions: contentType: how-tos category: - Configure Copilot +redirect_from: + - /copilot/how-tos/use-copilot-agents/coding-agent/use-hooks --- -{% data reusables.copilot.coding-agent.hooks-intro %} +{% data reusables.copilot.cloud-agent.hooks-intro %} ## Creating a hook in a repository on {% data variables.product.github %} -{% data reusables.copilot.coding-agent.create-hooks-instructions %} +{% data reusables.copilot.cloud-agent.create-hooks-instructions %} ## Troubleshooting -{% data reusables.copilot.coding-agent.troubleshoot-hooks %} +{% data reusables.copilot.cloud-agent.troubleshoot-hooks %} ## Further reading * For more information about configuring hooks, see [AUTOTITLE](/copilot/reference/hooks-configuration) -* For more information about {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-coding-agent) +* For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) * For more information about {% data variables.copilot.copilot_cli %}, see [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli) -* For information about customizing the agent environment, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment) +* For information about customizing the agent environment, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment) diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/changing-the-ai-model.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/changing-the-ai-model.md deleted file mode 100644 index e91ded5b4abc..000000000000 --- a/content/copilot/how-tos/use-copilot-agents/coding-agent/changing-the-ai-model.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Changing the AI model for GitHub Copilot cloud agent -shortTitle: Changing the AI model -allowTitleToDifferFromFilename: true -intro: 'In supported entrypoints, when starting a task with {% data variables.copilot.copilot_coding_agent %}, you can select the model used.' -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 -contentType: how-tos -category: - - Author and optimize with Copilot ---- - -> [!NOTE] -> For an overview of {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). - -## Introduction - -In supported entrypoints, you can select the model used by {% data variables.copilot.copilot_coding_agent %}. - -You may find that different models perform better, or provide more useful responses, depending on the type of tasks you give {% data variables.product.prodname_copilot_short %}. - -> [!NOTE] -> Model selection for {% data variables.copilot.copilot_coding_agent %} is only supported when assigning an issue to {% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %}, when mentioning `@copilot` in a pull request comment on {% data variables.product.prodname_dotcom_the_website %}, or when starting a task from the agents tab, agents panel, {% data variables.product.prodname_mobile %} or the Raycast launcher. Where a model picker is not available, Auto will be used automatically. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr). - -## Supported models - -The following options are currently available: - -* Auto -{% data reusables.copilot.copilot-coding-agent-auto-models %} -{% data reusables.copilot.copilot-coding-agent-non-auto-models %} - -{% data reusables.copilot.auto-model-option %} - diff --git a/content/copilot/how-tos/use-copilot-agents/copilot-memory.md b/content/copilot/how-tos/use-copilot-agents/copilot-memory.md index 0f70e7fd76b0..3e95891fb99a 100644 --- a/content/copilot/how-tos/use-copilot-agents/copilot-memory.md +++ b/content/copilot/how-tos/use-copilot-agents/copilot-memory.md @@ -13,7 +13,7 @@ category: > [!NOTE] > This feature is currently in {% data variables.release-phases.public_preview %} and is subject to change. -{% data variables.copilot.copilot_memory %} allows {% data variables.product.prodname_copilot_short %} to learn about your codebase, helping {% data variables.copilot.copilot_coding_agent %}, {% data variables.copilot.copilot_code-review_short %}, and {% data variables.copilot.copilot_cli_short %} to work more effectively in a repository. +{% data variables.copilot.copilot_memory %} allows {% data variables.product.prodname_copilot_short %} to learn about your codebase, helping {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_code-review_short %}, and {% data variables.copilot.copilot_cli_short %} to work more effectively in a repository. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-memory). @@ -59,7 +59,7 @@ If the organization belongs to an enterprise, the ability for organization owner If you have an individual {% data variables.product.prodname_copilot_short %} subscription, from a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, {% data variables.copilot.copilot_memory %} is enabled by default. You can disable or re-enable {% data variables.copilot.copilot_memory %} in your personal {% data variables.product.prodname_copilot_short %} settings on {% data variables.product.github %}. -When enabled, {% data variables.copilot.copilot_memory %} will be used in any repository in which you use {% data variables.copilot.copilot_coding_agent %}, {% data variables.copilot.copilot_code-review_short %}, or {% data variables.copilot.copilot_cli_short %}. +When enabled, {% data variables.copilot.copilot_memory %} will be used in any repository in which you use {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_code-review_short %}, or {% data variables.copilot.copilot_cli_short %}. {% data reusables.user-settings.copilot-settings %} 1. Under "Features", scroll down to the setting for **{% data variables.copilot.copilot_memory %}**. diff --git a/content/copilot/how-tos/use-copilot-agents/index.md b/content/copilot/how-tos/use-copilot-agents/index.md index c5b2bd2ac2ae..b7fbf1d6dc07 100644 --- a/content/copilot/how-tos/use-copilot-agents/index.md +++ b/content/copilot/how-tos/use-copilot-agents/index.md @@ -6,7 +6,7 @@ versions: feature: copilot children: - /manage-agents - - /coding-agent + - /cloud-agent - /request-a-code-review - /copilot-memory redirect_from: diff --git a/content/copilot/how-tos/use-copilot-agents/manage-agents.md b/content/copilot/how-tos/use-copilot-agents/manage-agents.md index 7e7496c5a745..c413fc7b688b 100644 --- a/content/copilot/how-tos/use-copilot-agents/manage-agents.md +++ b/content/copilot/how-tos/use-copilot-agents/manage-agents.md @@ -10,7 +10,7 @@ category: - Author and optimize with Copilot --- -{% data reusables.copilot.coding-agent.agent-management-intro %} +{% data reusables.copilot.cloud-agent.agent-management-intro %} ## 1. Select a repository and choose your agent @@ -34,7 +34,7 @@ category: {% data variables.product.prodname_copilot_short %} will start work on the task and begin pushing changes to a new pull request, where it will automatically add you as a reviewer. -For more information on ways to start new agent tasks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr). +For more information on ways to start new agent tasks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr). ## 2. Monitor agent activity @@ -42,7 +42,7 @@ Once the agent starts working, it will continue to update the session log and ov Each session displays its status. Click on a session to open the session log, where you can monitor the agent's progress, see the tools it's using, and track how long the session has been running. -{% data variables.copilot.copilot_coding_agent %} sessions can also be tracked from the {% data variables.product.prodname_cli %}, {% data variables.product.prodname_mobile %}, {% data variables.product.prodname_vscode %}, Raycast, and JetBrains IDEs. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions). +{% data variables.copilot.copilot_cloud_agent %} sessions can also be tracked from the {% data variables.product.prodname_cli %}, {% data variables.product.prodname_mobile %}, {% data variables.product.prodname_vscode %}, Raycast, and JetBrains IDEs. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). ## 3. Redirect agents as needed @@ -71,17 +71,17 @@ You can guide the agent in your local development environment on further changes At the bottom of the agent session view, click the **{% octicon "vscode" aria-label="VS Code" %} Open in {% data variables.product.prodname_vscode_shortname %}** button to launch the session directly in {% data variables.product.prodname_vscode_shortname %}. -{% data reusables.copilot.coding-agent.use-latest-vscode %} +{% data reusables.copilot.cloud-agent.use-latest-vscode %} ### {% data variables.copilot.copilot_cli %} 1. At the bottom of the agent session view, click the dropdown list next to **{% octicon "vscode" aria-label="VS Code" %} Open in {% data variables.product.prodname_vscode_shortname %}**. 1. Click **{% octicon "agent" aria-label="Agent" %} Continue in {% data variables.copilot.copilot_cli %}** to copy the `copilot --resume=SESSION-ID` command to your clipboard. -  +  1. In your terminal, paste and run the command to resume the agent session. ## 5. Review and merge agent code -Once the agent completes a session, you can navigate to the pull request to review the changes. From the pull request, you can scan the diff, request further improvements, or approve and merge the changes. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs). +Once the agent completes a session, you can navigate to the pull request to review the changes. From the pull request, you can scan the diff, request further improvements, or approve and merge the changes. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs). ## 6. Archive agent sessions diff --git a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/configure-runners.md b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/configure-runners.md index 9b5fa71bb83a..d5b5698612c4 100644 --- a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/configure-runners.md +++ b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/configure-runners.md @@ -37,7 +37,7 @@ To configure self-hosted runners for {% data variables.copilot.copilot_code-revi * `api.githubcopilot.com` * `uploads.github.com` * `user-images.githubusercontent.com` -1. In your `copilot-setup-steps.yml` file, set the `runs-on` attribute to your ARC-managed scale set name. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment#preinstalling-tools-or-dependencies-in-copilots-environment). +1. In your `copilot-setup-steps.yml` file, set the `runs-on` attribute to your ARC-managed scale set name. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment#preinstalling-tools-or-dependencies-in-copilots-environment). ```yaml # ... diff --git a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md index b8d019b1f88c..af4667d86ae9 100644 --- a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md +++ b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md @@ -55,9 +55,9 @@ Where possible, {% data variables.product.prodname_copilot_short %}'s feedback i If you're happy with the changes, you can accept a single suggestion from {% data variables.product.prodname_copilot_short %} and commit it, or accept a group of suggestions together in a single commit. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request). -You can also invoke {% data variables.copilot.copilot_coding_agent %} to implement suggested changes. To do this, you must: +You can also invoke {% data variables.copilot.copilot_cloud_agent %} to implement suggested changes. To do this, you must: -* Opt into the {% data variables.release-phases.public_preview %} for {% data variables.copilot.copilot_code-review-tools_short %} and enable {% data variables.copilot.copilot_coding_agent %}. +* Opt into the {% data variables.release-phases.public_preview %} for {% data variables.copilot.copilot_code-review-tools_short %} and enable {% data variables.copilot.copilot_cloud_agent %}. * On review comments from {% data variables.copilot.copilot_code-review %}, click **Implement suggestion**. This creates a draft comment on the pull request, where you can instruct {% data variables.product.prodname_copilot_short %} to address specific feedback. {% data variables.product.prodname_copilot_short %} will create a new pull request against your branch with the suggestions applied. ## Providing feedback on {% data variables.product.prodname_copilot_short %}'s reviews diff --git a/content/copilot/how-tos/use-copilot-for-common-tasks/use-copilot-to-create-or-update-issues.md b/content/copilot/how-tos/use-copilot-for-common-tasks/use-copilot-to-create-or-update-issues.md index fc95d12b7811..6bbf7787ee12 100644 --- a/content/copilot/how-tos/use-copilot-for-common-tasks/use-copilot-to-create-or-update-issues.md +++ b/content/copilot/how-tos/use-copilot-for-common-tasks/use-copilot-to-create-or-update-issues.md @@ -125,7 +125,7 @@ The draft appears in the workbench, where you can review and edit it. To publish ## Assigning issues to {% data variables.product.prodname_copilot_short %} -To assign an issue to {% data variables.product.prodname_copilot_short %}, you need to have {% data variables.copilot.copilot_coding_agent %} enabled. See [AUTOTITLE](/copilot/concepts/coding-agent/about-enabling-coding-agent). +To assign an issue to {% data variables.product.prodname_copilot_short %}, you need to have {% data variables.copilot.copilot_cloud_agent %} enabled. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/access-management). You can assign the issue during creation in one of two ways: diff --git a/content/copilot/reference/agent-session-filters.md b/content/copilot/reference/agent-session-filters.md index ad46a7e06eed..7b74e5d6ff2f 100644 --- a/content/copilot/reference/agent-session-filters.md +++ b/content/copilot/reference/agent-session-filters.md @@ -14,7 +14,7 @@ The following filters are available for the "Agent sessions" view in your enterp | Filter | Description | Example value | | --- | --- | --- | -| `agent` | Displays activity from a specific agent. | `agent:copilot-coding-agent` | +| `agent` | Displays activity from a specific agent. | `agent:copilot-cloud-agent` | | `organization` | Displays activity within a specific organization. | `organization:octocat-org` | | `repository` | Displays activity within a specific repository. | `repository:octocat-repo` | | `status` | Displays agent sessions with a specific status. | `status:in_progress` | diff --git a/content/copilot/reference/copilot-allowlist-reference.md b/content/copilot/reference/copilot-allowlist-reference.md index 3e18f65c4bb0..c6657a2f4919 100644 --- a/content/copilot/reference/copilot-allowlist-reference.md +++ b/content/copilot/reference/copilot-allowlist-reference.md @@ -41,9 +41,9 @@ Depending on the security policies and editors your organization uses, you may n Every user of the proxy server or firewall also needs to configure their own environment to connect to {% data variables.product.prodname_copilot_short %}. See [AUTOTITLE](/copilot/configuring-github-copilot/configuring-network-settings-for-github-copilot). -## {% data variables.copilot.copilot_coding_agent %} recommended allowlist +## {% data variables.copilot.copilot_cloud_agent %} recommended allowlist -The {% data variables.copilot.copilot_coding_agent %} includes a built-in firewall with a recommended allowlist that is enabled by default. The recommended allowlist allows access to: +The {% data variables.copilot.copilot_cloud_agent %} includes a built-in firewall with a recommended allowlist that is enabled by default. The recommended allowlist allows access to: * Common operating system package repositories (for example, Debian, Ubuntu, Red Hat). * Common container registries (for example, Docker Hub, Azure Container Registry, AWS Elastic Container Registry). @@ -51,7 +51,7 @@ The {% data variables.copilot.copilot_coding_agent %} includes a built-in firewa * Common certificate authorities (to allow SSL certificates to be validated). * Hosts used to download web browsers for the Playwright MCP server. -For more information about configuring the {% data variables.copilot.copilot_coding_agent %} firewall, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-firewall). +For more information about configuring the {% data variables.copilot.copilot_cloud_agent %} firewall, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-firewall). The allowlist allows access to the following hosts: diff --git a/content/copilot/reference/custom-agents-configuration.md b/content/copilot/reference/custom-agents-configuration.md index 0994b0e7d20b..54cef61abcfa 100644 --- a/content/copilot/reference/custom-agents-configuration.md +++ b/content/copilot/reference/custom-agents-configuration.md @@ -9,7 +9,7 @@ category: - Configure Copilot --- -This reference article provides detailed configuration information for {% data variables.copilot.custom_agents_short %}. For general information about creating {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). +This reference article provides detailed configuration information for {% data variables.copilot.custom_agents_short %}. For general information about creating {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). {% data reusables.copilot.custom-agents-ide-preview %} @@ -26,9 +26,9 @@ The following table outlines the properties that you can configure for {% data v | `target` | string | Target environment or context for the {% data variables.copilot.copilot_custom_agent_short %} (`vscode` or `github-copilot`). If unset, defaults to both environments. | | `tools` | list of strings, string | List of tool names the {% data variables.copilot.copilot_custom_agent_short %} can use. Supports both a comma separated string and yaml string array. If unset, defaults to all tools. See [Tools](#tools). | | `model` | string | Model to use when this {% data variables.copilot.copilot_custom_agent_short %} executes. If unset, inherits the default model. | -| `disable-model-invocation` | boolean | Disables {% data variables.copilot.copilot_coding_agent %} from automatically using this {% data variables.copilot.copilot_custom_agent_short %} based on task context. When `true`, the agent must be manually selected. Setting `disable-model-invocation: true` is equivalent to `infer: false`. If both are set, `disable-model-invocation` takes precedence. If unset, defaults to `false`. | +| `disable-model-invocation` | boolean | Disables {% data variables.copilot.copilot_cloud_agent %} from automatically using this {% data variables.copilot.copilot_custom_agent_short %} based on task context. When `true`, the agent must be manually selected. Setting `disable-model-invocation: true` is equivalent to `infer: false`. If both are set, `disable-model-invocation` takes precedence. If unset, defaults to `false`. | | `user-invocable` | boolean | Controls whether this {% data variables.copilot.copilot_custom_agent_short %} can be selected by a user. When `false`, the agent cannot be manually selected and can only be accessed programmatically. If unset, defaults to `true`. | -| `infer` | boolean | **{% data variables.release-phases.retired_caps %}**. Use `disable-model-invocation` and `user-invocable` instead. Enables {% data variables.copilot.copilot_coding_agent %} to automatically use this {% data variables.copilot.copilot_custom_agent_short %} based on task context. When `false`, the agent must be manually selected. If unset, defaults to `true`. | +| `infer` | boolean | **{% data variables.release-phases.retired_caps %}**. Use `disable-model-invocation` and `user-invocable` instead. Enables {% data variables.copilot.copilot_cloud_agent %} to automatically use this {% data variables.copilot.copilot_custom_agent_short %} based on task context. When `false`, the agent must be manually selected. If unset, defaults to `true`. | | `mcp-servers` | object | Additional MCP servers and tools that should be used by the {% data variables.copilot.copilot_custom_agent_short %}. **Not used in {% data variables.product.prodname_vscode_shortname %} and other IDE {% data variables.copilot.custom_agents_short %}.** | | `metadata` | object consisting of a name and value pair, both strings | Allows annotation of the agent with useful data. **Not used in {% data variables.product.prodname_vscode_shortname %} and other IDE {% data variables.copilot.custom_agents_short %}.** | @@ -38,14 +38,14 @@ Define the agent's behavior, expertise, and instructions in the Markdown content > [!NOTE] > -> * The `argument-hint` and `handoffs` properties from {% data variables.product.prodname_vscode_shortname %} and other IDE {% data variables.copilot.custom_agents_short %} are currently not supported for {% data variables.copilot.copilot_coding_agent %} on {% data variables.product.prodname_dotcom_the_website %}. They are ignored to ensure compatibility. +> * The `argument-hint` and `handoffs` properties from {% data variables.product.prodname_vscode_shortname %} and other IDE {% data variables.copilot.custom_agents_short %} are currently not supported for {% data variables.copilot.copilot_cloud_agent %} on {% data variables.product.prodname_dotcom_the_website %}. They are ignored to ensure compatibility. > * For more information on {% data variables.copilot.copilot_custom_agent_short %} file structure in {% data variables.product.prodname_vscode_shortname %}, see [{% data variables.copilot.custom_agents_caps_short %} in {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/copilot/customization/custom-agents#_custom-agent-file-structure) in the {% data variables.product.prodname_vscode_shortname %} documentation. ## Tools The {% data variables.copilot.copilot_custom_agent_short %} `tools` property controls which tools are available to your agent, including those from MCP servers. -Your {% data variables.copilot.copilot_custom_agent_short %} will have access to MCP server tools that have been configured in both its {% data variables.copilot.agent_profile %} and/or the repository settings. For more information on configuring MCP servers for cloud agent in a repository, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp). +Your {% data variables.copilot.copilot_custom_agent_short %} will have access to MCP server tools that have been configured in both its {% data variables.copilot.agent_profile %} and/or the repository settings. For more information on configuring MCP servers for cloud agent in a repository, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp). You can configure `tools` using the following approaches: @@ -62,19 +62,19 @@ All unrecognized tool names are ignored, which allows product-specific tools to The following tool aliases are available for {% data variables.copilot.custom_agents_short %}. All aliases are case insensitive: -| Primary alias | Compatible aliases | {% data variables.copilot.copilot_coding_agent_short_cap_c %} mapping | Purpose | +| Primary alias | Compatible aliases | {% data variables.copilot.copilot_cloud_agent_short_cap_c %} mapping | Purpose | | ------------- | -------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | `execute` | `shell`, `Bash`, `powershell` | Shell tools: `bash` or `powershell` | Execute a command in the appropriate shell for the operating system. | | `read` | `Read`, `NotebookRead` | `view` | Read file contents. | | `edit` | `Edit`, `MultiEdit`, `Write`, `NotebookEdit` | Edit tools: e.g. `str_replace`, `str_replace_editor` | Allow LLM to edit. Exact arguments can vary. | | `search` | `Grep`, `Glob` | `search` | Search for files or text in files. | | `agent` | `custom-agent`, `Task` | "{% data variables.copilot.copilot_custom_agent_caps_short %}" tools | Allows a different {% data variables.copilot.copilot_custom_agent_short %} to be invoked to accomplish a task. | -| `web` | `WebSearch`, `WebFetch` | Currently not applicable for {% data variables.copilot.copilot_coding_agent_short %}. | Allows fetching content from URLs and performing a web search | -| `todo` | `TodoWrite` | Currently not applicable for {% data variables.copilot.copilot_coding_agent_short %}. | Creates and manages structured task lists. Not supported in {% data variables.copilot.copilot_coding_agent_short %} today, but supported by {% data variables.product.prodname_vscode_shortname %}. | +| `web` | `WebSearch`, `WebFetch` | Currently not applicable for {% data variables.copilot.copilot_cloud_agent_short %}. | Allows fetching content from URLs and performing a web search | +| `todo` | `TodoWrite` | Currently not applicable for {% data variables.copilot.copilot_cloud_agent_short %}. | Creates and manages structured task lists. Not supported in {% data variables.copilot.copilot_cloud_agent_short %} today, but supported by {% data variables.product.prodname_vscode_shortname %}. | ### Tool names for "out-of-the-box" MCP servers -The following MCP servers are available out-of-box for {% data variables.copilot.copilot_coding_agent %} and can be referenced using namespacing: +The following MCP servers are available out-of-box for {% data variables.copilot.copilot_cloud_agent %} and can be referenced using namespacing: | MCP server name | Available tools | | --------------- | --------------- | @@ -103,18 +103,18 @@ mcp-servers: Prompt with suggestions for behavior and output ``` -The `mcp-servers` property in an {% data variables.copilot.agent_profile %} is a YAML representation of the JSON configuration format used to configure MCP servers for {% data variables.copilot.copilot_coding_agent %}. +The `mcp-servers` property in an {% data variables.copilot.agent_profile %} is a YAML representation of the JSON configuration format used to configure MCP servers for {% data variables.copilot.copilot_cloud_agent %}. -Most sub-properties are the same as the JSON representation. The following sections describe changes from the initial implementation of MCP configuration in {% data variables.copilot.copilot_coding_agent %} that are relevant to {% data variables.copilot.custom_agents_short %}. For more information about the JSON configuration format, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#writing-a-json-configuration-for-mcp-servers). +Most sub-properties are the same as the JSON representation. The following sections describe changes from the initial implementation of MCP configuration in {% data variables.copilot.copilot_cloud_agent %} that are relevant to {% data variables.copilot.custom_agents_short %}. For more information about the JSON configuration format, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp#writing-a-json-configuration-for-mcp-servers). ### MCP server type -For compatibility, the `stdio` type used by Claude Code and {% data variables.product.prodname_vscode_shortname %} is mapped to {% data variables.copilot.copilot_coding_agent_short %}'s `local` type. +For compatibility, the `stdio` type used by Claude Code and {% data variables.product.prodname_vscode_shortname %} is mapped to {% data variables.copilot.copilot_cloud_agent_short %}'s `local` type. ### MCP server environment variables and secrets > [!NOTE] -> If your MCP server requires secrets or environment variables, these must be configured in the {% data variables.product.prodname_copilot_short %} environment in each repository where the {% data variables.copilot.copilot_custom_agent_short %} will be used. For more information on setting up environment variables, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment#setting-environment-variables-in-copilots-environment). +> If your MCP server requires secrets or environment variables, these must be configured in the {% data variables.product.prodname_copilot_short %} environment in each repository where the {% data variables.copilot.copilot_custom_agent_short %} will be used. For more information on setting up environment variables, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment#setting-environment-variables-in-copilots-environment). {% data variables.copilot.copilot_custom_agent_caps_short %} MCP configuration supports the same environment variable and secret replacement capabilities as existing repository-level MCP configurations. Similar to repository-level configurations, secrets and variables can be sourced from the "copilot" environment in the repository's settings. The syntax for referencing these values has been expanded to support common patterns used in {% data variables.product.prodname_actions %} and Claude Code. diff --git a/content/copilot/reference/custom-instructions-support.md b/content/copilot/reference/custom-instructions-support.md index ef8217f66bf3..443212ac859e 100644 --- a/content/copilot/reference/custom-instructions-support.md +++ b/content/copilot/reference/custom-instructions-support.md @@ -36,7 +36,7 @@ WRITING NOTE: The following tables have been written using HTML rather than Mark
-
{% data reusables.copilot.ci-support-repository %}
@@ -80,7 +80,7 @@ WRITING NOTE: The following tables have been written using HTML rather than Mark
-
{% data reusables.copilot.ci-support-repository %}
@@ -152,7 +152,7 @@ WRITING NOTE: The following tables have been written using HTML rather than Mark
-
{% data reusables.copilot.ci-support-repository %}
@@ -192,7 +192,7 @@ WRITING NOTE: The following tables have been written using HTML rather than Mark
-
{% data reusables.copilot.ci-support-repository %}
@@ -232,7 +232,7 @@ WRITING NOTE: The following tables have been written using HTML rather than Mark
-
{% data reusables.copilot.ci-support-repository %}
diff --git a/content/copilot/reference/customization-cheat-sheet.md b/content/copilot/reference/customization-cheat-sheet.md
index 23a07d57a871..5fc9445a25e9 100644
--- a/content/copilot/reference/customization-cheat-sheet.md
+++ b/content/copilot/reference/customization-cheat-sheet.md
@@ -19,11 +19,11 @@ This table shows what each customization feature is and where it lives.
|---------|-----------|-------------------|
| [Custom instructions](/copilot/concepts/prompting/response-customization) | Always-on context that automatically applies to every interaction within its defined scope | `.github/copilot-instructions.md` (repo-wide), `.github/instructions/*.instructions.md` (path-specific), `AGENTS.md` (third-party agents), or personal/org settings via UI on {% data variables.product.github %} |
| [Prompt files](/copilot/concepts/prompting/response-customization?tool=vscode#about-prompt-files) | Reusable, standalone prompt template with input variables | `.github/prompts/*.prompt.md` |
-| [{% data variables.copilot.custom_agents_caps_short %}](/copilot/concepts/agents/coding-agent/about-custom-agents) | Specialist persona with its own instructions, tool restrictions, and context | `.github/agents/AGENT-NAME.md` (repo), `agents/AGENT-NAME.md` in `.github-private` repo (org/enterprise), or user profile |
+| [{% data variables.copilot.custom_agents_caps_short %}](/copilot/concepts/agents/cloud-agent/about-custom-agents) | Specialist persona with its own instructions, tool restrictions, and context | `.github/agents/AGENT-NAME.md` (repo), `agents/AGENT-NAME.md` in `.github-private` repo (org/enterprise), or user profile |
| [{% data variables.copilot.subagents_caps_short %}](/copilot/how-tos/chat-with-copilot/chat-in-ide#using-subagents) | Separate agent spawned by the main agent to handle delegated work in an isolated context | N/A (runtime process, not a user-configured file) |
| [Agent skills](/copilot/concepts/agents/about-agent-skills) | Folder of instructions, scripts, and resources that {% data variables.product.prodname_copilot_short %} loads when relevant to a task | `.github/skills/
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +intro: 'Learn how to get the best results from {% data variables.copilot.copilot_cloud_agent %}.' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot redirect_from: + - /copilot/tutorials/coding-agent/get-the-best-results - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/best-practices-for-using-copilot-to-work-on-tasks - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/best-practices-for-using-copilot-to-work-on-issues - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/best-practices-for-using-copilot-to-work-on-tasks @@ -21,7 +22,7 @@ category: --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). ## Making sure your issues are well-scoped @@ -32,7 +33,7 @@ category: * Directions about which files need to be changed. > [!TIP] -> {% data variables.copilot.copilot_coding_agent %} has the ability to search your codebase, including semantic code search, which helps it find relevant code based on meaning rather than just exact text matches. Even if you don't specify exact file paths in a task, the agent can often discover the right code on its own. +> {% data variables.copilot.copilot_cloud_agent %} has the ability to search your codebase, including semantic code search, which helps it find relevant code based on meaning rather than just exact text matches. Even if you don't specify exact file paths in a task, the agent can often discover the right code on its own. If you pass a task to {% data variables.product.prodname_copilot_short %} by assigning an issue, it's useful to think of the issue you assign to {% data variables.product.prodname_copilot_short %} as a prompt. Consider whether the issue description is likely to work as an AI prompt, and will enable {% data variables.product.prodname_copilot_short %} to make the required code changes. @@ -62,7 +63,7 @@ Issues that you may choose to work on yourself, rather than assigning to {% data ## Researching, planning, and iterating before opening a pull request -Rather than asking {% data variables.product.prodname_copilot_short %} to open a pull request right away, you can use {% data variables.copilot.copilot_coding_agent %} to research a repository, create an implementation plan, and make iterative code changes on a branch first. This lets you review the diff and refine the work before deciding to open a pull request. +Rather than asking {% data variables.product.prodname_copilot_short %} to open a pull request right away, you can use {% data variables.copilot.copilot_cloud_agent %} to research a repository, create an implementation plan, and make iterative code changes on a branch first. This lets you review the diff and refine the work before deciding to open a pull request. This workflow is useful when you want to: @@ -70,7 +71,7 @@ This workflow is useful when you want to: * Agree on an approach with {% data variables.product.prodname_copilot_short %} before any code is written. * Review and iterate on changes before opening a pull request for review. -See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate). +See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/research-plan-iterate). ## Using comments to iterate on a pull request @@ -78,13 +79,13 @@ Working with {% data variables.product.prodname_copilot_short %} on a pull reque Additionally, you can: * Mention `@copilot` in comments on the pull request, explaining what you think is incorrect, or could be improved, and {% data variables.product.prodname_copilot_short %} will push commits directly to the pull request's branch. -* Ask {% data variables.product.prodname_copilot_short %} to resolve merge conflicts on the pull request. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/make-changes-to-an-existing-pr#resolving-merge-conflicts). +* Ask {% data variables.product.prodname_copilot_short %} to resolve merge conflicts on the pull request. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/make-changes-to-an-existing-pr#resolving-merge-conflicts). * Work on the feature branch yourself and push changes to the pull request. After a user with write access mentions `@copilot` in a comment, {% data variables.product.prodname_copilot_short %} will start to make any required changes, and will update the pull request when it's done. Because {% data variables.product.prodname_copilot_short %} starts looking at comments as soon as they are submitted, if you are likely to make multiple comments on a pull request it's best to batch them by clicking **Start a review**, rather than clicking **Add single comment**. You can then submit all of your comments at once, triggering {% data variables.product.prodname_copilot_short %} to work on your entire review, rather than working on individual comments separately. > [!NOTE] -> {% data reusables.copilot.coding-agent.write-access-required %} +> {% data reusables.copilot.cloud-agent.write-access-required %} As {% data variables.product.prodname_copilot_short %} makes changes to the pull request, it will keep the title and body up to date so they reflect the current changes. @@ -94,7 +95,7 @@ By adding custom instructions to your repository, you can guide {% data variable If {% data variables.product.prodname_copilot_short %} is able to build, test and validate its changes in its own development environment, it is more likely to produce good pull requests which can be merged quickly. -{% data variables.copilot.copilot_coding_agent %} supports a number of different types of custom instructions files: +{% data variables.copilot.copilot_cloud_agent %} supports a number of different types of custom instructions files: * `/.github/copilot-instructions.md` * `/.github/instructions/**/*.instructions.md` @@ -108,7 +109,7 @@ For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-reposi To add instructions that apply to all tasks assigned to {% data variables.product.prodname_copilot_short %} in your repository, create a `.github/copilot-instructions.md` file in the root of your repository. This file should contain information about your project, such as how to build and test it, and any coding standards or conventions you want {% data variables.product.prodname_copilot_short %} to follow. Note that the instructions will also apply to {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_code-review_short %}. -The first time you ask {% data variables.product.prodname_copilot_short %} to create a pull request in a given repository, {% data variables.product.prodname_copilot_short %} will leave a comment with a link to automatically generate custom instructions. You can also ask {% data variables.product.prodname_copilot_short %} to generate custom instructions for you at any time using our recommended prompt. See [AUTOTITLE](/copilot/how-tos/configure-custom-instructions/add-repository-instructions?tool=webui#asking-copilot-coding-agent-to-generate-a-copilot-instructionsmd-file). +The first time you ask {% data variables.product.prodname_copilot_short %} to create a pull request in a given repository, {% data variables.product.prodname_copilot_short %} will leave a comment with a link to automatically generate custom instructions. You can also ask {% data variables.product.prodname_copilot_short %} to generate custom instructions for you at any time using our recommended prompt. See [AUTOTITLE](/copilot/how-tos/configure-custom-instructions/add-repository-instructions?tool=webui#asking-copilot-cloud-agent-to-generate-a-copilot-instructionsmd-file). You can also choose to write your own custom instructions at any time. Here is an example of an effective `copilot-instructions.md` file: @@ -175,11 +176,11 @@ When writing Playwright tests, please follow these guidelines to ensure consiste ## Organization-wide custom instructions -{% data variables.copilot.copilot_coding_agent %} leverages your organization's custom instructions as part of its work. {% data variables.copilot.copilot_coding_agent %} first prioritizes repository-wide custom instructions. For more information on how to configure organization custom instructions, see [AUTOTITLE](/copilot/how-tos/configure-custom-instructions/add-organization-instructions). +{% data variables.copilot.copilot_cloud_agent %} leverages your organization's custom instructions as part of its work. {% data variables.copilot.copilot_cloud_agent %} first prioritizes repository-wide custom instructions. For more information on how to configure organization custom instructions, see [AUTOTITLE](/copilot/how-tos/configure-custom-instructions/add-organization-instructions). ## Using the Model Context Protocol (MCP) -You can extend the capabilities of {% data variables.copilot.copilot_coding_agent %} by using MCP. This allows {% data variables.copilot.copilot_coding_agent %} to use tools provided by local and remote MCP servers. The {% data variables.product.github %} MCP server and [Playwright MCP server](https://github.com/microsoft/playwright-mcp) are enabled by default. For more information, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/extending-copilot-coding-agent-with-mcp). +You can extend the capabilities of {% data variables.copilot.copilot_cloud_agent %} by using MCP. This allows {% data variables.copilot.copilot_cloud_agent %} to use tools provided by local and remote MCP servers. The {% data variables.product.github %} MCP server and [Playwright MCP server](https://github.com/microsoft/playwright-mcp) are enabled by default. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp). ## Creating {% data variables.copilot.custom_agents_short %} @@ -191,9 +192,9 @@ Here are some examples of {% data variables.copilot.custom_agents_short %} you c By default, {% data variables.copilot.custom_agents_short %} inherit any MCP server tools that have been configured in the repository, but you can also configure {% data variables.copilot.custom_agents_short %} to only have access to specific tools. -You can use {% data variables.copilot.custom_agents_short %} anywhere you use {% data variables.copilot.copilot_coding_agent %}, including when assigning an issue or prompting with a task. +You can use {% data variables.copilot.custom_agents_short %} anywhere you use {% data variables.copilot.copilot_cloud_agent %}, including when assigning an issue or prompting with a task. -For more information on creating and configuring {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). +For more information on creating and configuring {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). ## Pre-installing dependencies in {% data variables.product.prodname_copilot %}'s environment @@ -203,4 +204,4 @@ If {% data variables.product.prodname_copilot_short %} is able to build, test an To do that, it will need your project's dependencies. {% data variables.product.prodname_copilot_short %} can discover and install these dependencies itself via a process of trial and error - but this can be slow and unreliable, given the non-deterministic nature of large language models (LLMs). -You can configure a `copilot-setup-steps.yml` file to pre-install these dependencies before the agent starts working so it can hit the ground running. For more information, see [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent#preinstalling-tools-or-dependencies-in-copilots-environment). +You can configure a `copilot-setup-steps.yml` file to pre-install these dependencies before the agent starts working so it can hit the ground running. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment#preinstalling-tools-or-dependencies-in-copilots-environment). diff --git a/content/copilot/tutorials/coding-agent/improve-a-project.md b/content/copilot/tutorials/cloud-agent/improve-a-project.md similarity index 82% rename from content/copilot/tutorials/coding-agent/improve-a-project.md rename to content/copilot/tutorials/cloud-agent/improve-a-project.md index d533ba307e63..c7570b8d9ae2 100644 --- a/content/copilot/tutorials/coding-agent/improve-a-project.md +++ b/content/copilot/tutorials/cloud-agent/improve-a-project.md @@ -2,8 +2,8 @@ title: Using GitHub Copilot cloud agent to improve a project shortTitle: Improve a project allowTitleToDifferFromFilename: true -intro: 'Find and fix problems in a project with {% data variables.copilot.copilot_coding_agent %}.' -product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' +intro: 'Find and fix problems in a project with {% data variables.copilot.copilot_cloud_agent %}.' +product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot contentType: tutorials @@ -11,21 +11,23 @@ category: - Author and optimize with Copilot - Improve quality and maintainability - Burn down tech debt +redirect_from: + - /copilot/tutorials/coding-agent/improve-a-project --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). ## Introduction Modern development often starts with good intentions: a quick script, a prototype, maybe an action to automate one small thing. But as projects evolve, those early efforts can become brittle. -This tutorial shows how you can use {% data variables.copilot.copilot_coding_agent %} to improve a mature project, without slowing down your momentum. +This tutorial shows how you can use {% data variables.copilot.copilot_cloud_agent %} to improve a mature project, without slowing down your momentum. In the following sections we'll: * Make sure that the project contains custom instructions that {% data variables.product.prodname_copilot_short %} can use to tailor its responses to your project. -* Make sure there's an environment setup file for {% data variables.copilot.copilot_coding_agent %}, so that it can get started on tasks more quickly by pre-installing your project’s dependencies. +* Make sure there's an environment setup file for {% data variables.copilot.copilot_cloud_agent %}, so that it can get started on tasks more quickly by pre-installing your project’s dependencies. * Get {% data variables.product.prodname_copilot_short %} to look for improvements that could be made to the code, and then create issues for that work. * Delegate the coding work to {% data variables.product.prodname_copilot_short %} by assigning it to an issue. @@ -42,8 +44,8 @@ In the following sections we'll: For more information, see the section "Writing effective custom instructions" in [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=webui#writing-effective-custom-instructions), and the library of examples at [AUTOTITLE](/copilot/tutorials/customization-library/custom-instructions). -1. If there are no custom instructions files in the repository, use {% data variables.copilot.copilot_coding_agent %} to create a `.github/copilot-instructions.md` file, by following the instructions in [AUTOTITLE](/copilot/how-tos/configure-custom-instructions/add-repository-instructions#asking-copilot-coding-agent-to-generate-a-copilot-instructionsmd-file). -1. Review the pull request that {% data variables.copilot.copilot_coding_agent %} creates. Check that the `.github/copilot-instructions.md` file provides {% data variables.product.prodname_copilot_short %} with all of the information it needs to know to work on this project. +1. If there are no custom instructions files in the repository, use {% data variables.copilot.copilot_cloud_agent %} to create a `.github/copilot-instructions.md` file, by following the instructions in [AUTOTITLE](/copilot/how-tos/configure-custom-instructions/add-repository-instructions#asking-copilot-cloud-agent-to-generate-a-copilot-instructionsmd-file). +1. Review the pull request that {% data variables.copilot.copilot_cloud_agent %} creates. Check that the `.github/copilot-instructions.md` file provides {% data variables.product.prodname_copilot_short %} with all of the information it needs to know to work on this project. The file should include: @@ -57,9 +59,9 @@ In the following sections we'll: ## 2. Check for an environment setup file -A `copilot-setup-steps.yml` {% data variables.product.prodname_actions %} workflow file can help {% data variables.copilot.copilot_coding_agent %} to get started on tasks more quickly by pre-installing the dependencies that are used by the project. +A `copilot-setup-steps.yml` {% data variables.product.prodname_actions %} workflow file can help {% data variables.copilot.copilot_cloud_agent %} to get started on tasks more quickly by pre-installing the dependencies that are used by the project. -Creating this file is optional but is a good idea if you use {% data variables.copilot.copilot_coding_agent %} regularly in the repository. +Creating this file is optional but is a good idea if you use {% data variables.copilot.copilot_cloud_agent %} regularly in the repository. 1. In your repository on {% data variables.product.github %}, check that the following file exists: @@ -71,13 +73,13 @@ Creating this file is optional but is a good idea if you use {% data variables.c > A quick way to do this is to copy the above path, go to the main page of your repository and paste the path into the "Go to file" field. 1. If the file exists, open it and check that the steps in the workflow install the correct dependencies for your project. After verifying this, you can skip the remaining steps in this section. -1. If you don't already have a `copilot-setup-steps.yml` file, use the following steps to get {% data variables.copilot.copilot_coding_agent %} to create it for you. +1. If you don't already have a `copilot-setup-steps.yml` file, use the following steps to get {% data variables.copilot.copilot_cloud_agent %} to create it for you. 1. At the top of any page of your repository on the {% data variables.product.github %} website, click **{% octicon "agent" aria-label="Open agents panel" %}**. 1. Copy and paste the following prompt into the Agents dialog: ```text copy - Analyze this repository to understand the dependencies that need to be installed on the development environment to work on the code in this repository. Using this information, and the details about the `copilot-setup-steps.yml` file that are given in https://docs.github.com/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment, add a `.github/workflows/copilot-setup-steps.yml` to this repository. This Actions workflow file should install, in the development environment for {% data variables.copilot.copilot_coding_agent %}, all of the dependencies necessary to work on the code in this repository. Make sure that the workflow job is named `copilot-setup-steps`. + Analyze this repository to understand the dependencies that need to be installed on the development environment to work on the code in this repository. Using this information, and the details about the `copilot-setup-steps.yml` file that are given in https://docs.github.com/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment, add a `.github/workflows/copilot-setup-steps.yml` to this repository. This Actions workflow file should install, in the development environment for {% data variables.copilot.copilot_cloud_agent %}, all of the dependencies necessary to work on the code in this repository. Make sure that the workflow job is named `copilot-setup-steps`. ``` @@ -192,10 +194,10 @@ Now that you have created issues, the next step is to delegate an issue to {% da ## Conclusion -{% data variables.copilot.copilot_coding_agent %} can help you to improve the quality of code in any project, but it's particularly useful for reducing technical debt in a project that has grown organically over many months or years. By using {% data variables.copilot.copilot_coding_agent %}, you can make improvements that you might have struggled to find time for without an AI assistant working on your behalf. +{% data variables.copilot.copilot_cloud_agent %} can help you to improve the quality of code in any project, but it's particularly useful for reducing technical debt in a project that has grown organically over many months or years. By using {% data variables.copilot.copilot_cloud_agent %}, you can make improvements that you might have struggled to find time for without an AI assistant working on your behalf. {% data variables.product.prodname_copilot_short %} doesn't replace you as a developer—you still need to be involved at every step of this process, specifying what you want {% data variables.product.prodname_copilot_short %} to do and carefully reviewing the code it changes or adds—but it does allow you to implement improvements at the same time as you work on other important tasks. ## Next steps -Read this case study on the {% data variables.product.github %} blog: [How the {% data variables.product.github %} billing team uses the {% data variables.copilot.copilot_coding_agent_short %} in {% data variables.product.prodname_copilot %} to continuously burn down technical debt](https://github.blog/ai-and-ml/github-copilot/how-the-github-billing-team-uses-the-coding-agent-in-github-copilot-to-continuously-burn-down-technical-debt/). +Read this case study on the {% data variables.product.github %} blog: [How the {% data variables.product.github %} billing team uses the {% data variables.copilot.copilot_cloud_agent_short %} in {% data variables.product.prodname_copilot %} to continuously burn down technical debt](https://github.blog/ai-and-ml/github-copilot/how-the-github-billing-team-uses-the-cloud-agent-in-github-copilot-to-continuously-burn-down-technical-debt/). diff --git a/content/copilot/tutorials/coding-agent/index.md b/content/copilot/tutorials/cloud-agent/index.md similarity index 72% rename from content/copilot/tutorials/coding-agent/index.md rename to content/copilot/tutorials/cloud-agent/index.md index 39be1b8871f7..4822727d72c7 100644 --- a/content/copilot/tutorials/coding-agent/index.md +++ b/content/copilot/tutorials/cloud-agent/index.md @@ -2,12 +2,14 @@ title: GitHub Copilot cloud agent shortTitle: Cloud agent allowTitleToDifferFromFilename: true -intro: 'Find out how to get great results from {% data variables.copilot.copilot_coding_agent %}.' +intro: 'Find out how to get great results from {% data variables.copilot.copilot_cloud_agent %}.' versions: feature: copilot children: - /get-the-best-results - - /pilot-coding-agent + - /pilot-cloud-agent - /improve-a-project contentType: tutorials +redirect_from: + - /copilot/tutorials/coding-agent --- diff --git a/content/copilot/tutorials/coding-agent/pilot-coding-agent.md b/content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md similarity index 61% rename from content/copilot/tutorials/coding-agent/pilot-coding-agent.md rename to content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md index a9addd16cf84..67797d2e232b 100644 --- a/content/copilot/tutorials/coding-agent/pilot-coding-agent.md +++ b/content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md @@ -1,12 +1,13 @@ --- title: 'Piloting GitHub Copilot cloud agent in your organization' -shortTitle: 'Pilot {% data variables.copilot.copilot_coding_agent_short %}' -intro: 'Follow best practices to enable {% data variables.copilot.copilot_coding_agent %} in your organization.' +shortTitle: 'Pilot {% data variables.copilot.copilot_cloud_agent_short %}' +intro: 'Follow best practices to enable {% data variables.copilot.copilot_cloud_agent %} in your organization.' allowTitleToDifferFromFilename: true versions: feature: copilot -product: '{% data reusables.gated-features.copilot-coding-agent %}' +product: '{% data reusables.gated-features.copilot-cloud-agent %}' redirect_from: + - /copilot/tutorials/coding-agent/pilot-coding-agent - /copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org - /copilot/tutorials/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org - /copilot/tutorials/pilot-copilot-coding-agent @@ -15,30 +16,30 @@ category: - Automate simple user stories - Manage Copilot for a team --- - + -{% data variables.copilot.copilot_coding_agent %} is an autonomous, AI-powered agent that completes software development tasks on {% data variables.product.github %}. Adopting {% data variables.copilot.copilot_coding_agent %} in your organization frees your engineering teams to spend more time thinking strategically and less time making routine fixes and maintenance updates in a codebase. +{% data variables.copilot.copilot_cloud_agent %} is an autonomous, AI-powered agent that completes software development tasks on {% data variables.product.github %}. Adopting {% data variables.copilot.copilot_cloud_agent %} in your organization frees your engineering teams to spend more time thinking strategically and less time making routine fixes and maintenance updates in a codebase. -{% data variables.copilot.copilot_coding_agent %}: +{% data variables.copilot.copilot_cloud_agent %}: * **Joins your team**: Developers can delegate work to {% data variables.product.prodname_copilot_short %} unlike IDE-based agents that require synchronous pairing sessions. {% data variables.product.prodname_copilot_short %} opens draft pull requests for team members to review and iterates based on feedback, as a developer would. -* **Reduces context switching**: Developers working in JetBrains IDEs, {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_vs %}, or {% data variables.product.prodname_dotcom_the_website %} can ask {% data variables.copilot.copilot_coding_agent %} to create a pull request to complete small tasks without stopping what they are currently doing. +* **Reduces context switching**: Developers working in JetBrains IDEs, {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_vs %}, or {% data variables.product.prodname_dotcom_the_website %} can ask {% data variables.copilot.copilot_cloud_agent %} to create a pull request to complete small tasks without stopping what they are currently doing. * **Executes tasks in parallel**: {% data variables.product.prodname_copilot_short %} can work on multiple issues simultaneously, handling tasks in the background while your team focuses on other priorities. ## 1. Evaluate -Before enabling {% data variables.copilot.copilot_coding_agent %} for members, understand how {% data variables.copilot.copilot_coding_agent %} will fit into your organization. This will help you evaluate whether {% data variables.copilot.copilot_coding_agent %} is suitable for your needs and plan communications and training sessions for developers. +Before enabling {% data variables.copilot.copilot_cloud_agent %} for members, understand how {% data variables.copilot.copilot_cloud_agent %} will fit into your organization. This will help you evaluate whether {% data variables.copilot.copilot_cloud_agent %} is suitable for your needs and plan communications and training sessions for developers. -1. Learn about {% data variables.copilot.copilot_coding_agent %}, including the costs, built-in security features, and how it differs from other AI tools your developers may be used to. See [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). -1. Learn about the tasks that {% data variables.copilot.copilot_coding_agent %} is best suited for. These are generally well-defined and scoped issues, such as increasing test coverage, fixing bugs or flaky tests, or updating config files or documentation. See [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices). -1. Consider how {% data variables.copilot.copilot_coding_agent %} fits alongside other tools in your organization's workflows. For an example scenario that walks through how to use {% data variables.copilot.copilot_coding_agent %} alongside other AI features on {% data variables.product.github %}, see [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai). +1. Learn about {% data variables.copilot.copilot_cloud_agent %}, including the costs, built-in security features, and how it differs from other AI tools your developers may be used to. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +1. Learn about the tasks that {% data variables.copilot.copilot_cloud_agent %} is best suited for. These are generally well-defined and scoped issues, such as increasing test coverage, fixing bugs or flaky tests, or updating config files or documentation. See [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results). +1. Consider how {% data variables.copilot.copilot_cloud_agent %} fits alongside other tools in your organization's workflows. For an example scenario that walks through how to use {% data variables.copilot.copilot_cloud_agent %} alongside other AI features on {% data variables.product.github %}, see [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai). ## 2. Secure -All AI models are trained to meet a request, even if they don't have all the information needed to provide a good answer, and this can lead them to make mistakes. By following best practices, you can build on the default security features of {% data variables.copilot.copilot_coding_agent %}. +All AI models are trained to meet a request, even if they don't have all the information needed to provide a good answer, and this can lead them to make mistakes. By following best practices, you can build on the default security features of {% data variables.copilot.copilot_cloud_agent %}. 1. Give {% data variables.product.prodname_copilot_short %} the information it needs to work successfully in a repository using a `copilot-instructions.md` file. See [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot). -1. Set up the {% data variables.product.prodname_copilot_short %} development environment for a repository with access to the tools and package repositories approved by the organization using a `copilot-setup-steps.yml` file and local MCP servers. See [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent) and [AUTOTITLE](/copilot/using-github-copilot/coding-agent/extending-copilot-coding-agent-with-mcp). +1. Set up the {% data variables.product.prodname_copilot_short %} development environment for a repository with access to the tools and package repositories approved by the organization using a `copilot-setup-steps.yml` file and local MCP servers. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment) and [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp). 1. Follow best practices for storing secrets securely. See [AUTOTITLE](/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions). 1. Enable code security features to further lower the risk of leaking secrets and introducing vulnerabilities into the code. See [AUTOTITLE](/code-security/securing-your-organization/enabling-security-features-in-your-organization/creating-a-custom-security-configuration). 1. Configure your branch rulesets to ensure that all pull requests raised by {% data variables.product.prodname_copilot_short %} are approved by a second user with write permissions (a sub-option of "Require a pull request before merging"). See {% ifversion ghec %}[AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance), {% endif %}[AUTOTITLE](/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization) and [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#require-a-pull-request-before-merging). @@ -47,42 +48,42 @@ All AI models are trained to meet a request, even if they don't have all the inf Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 aria-label="link-external" %} -> [!TIP] You need {% data variables.copilot.copilot_pro %}, {% data variables.copilot.copilot_pro_plus %}, {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} to use {% data variables.copilot.copilot_coding_agent %}. +> [!TIP] You need {% data variables.copilot.copilot_pro %}, {% data variables.copilot.copilot_pro_plus %}, {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} to use {% data variables.copilot.copilot_cloud_agent %}. -As with any other change to working practices, it's important to run a trial to learn how to deploy {% data variables.copilot.copilot_coding_agent %} effectively in your organization or enterprise. +As with any other change to working practices, it's important to run a trial to learn how to deploy {% data variables.copilot.copilot_cloud_agent %} effectively in your organization or enterprise. 1. Gather a cross-functional team for the trial to bring different roles, backgrounds, and perspectives to the project. This will make it easier to ensure that you explore a broad range of ways to define issues, assign work to {% data variables.product.prodname_copilot_short %}, and give clear review feedback. 1. Choose an isolated or low-risk repository, for example, one that contains documentation or internal tools. You could create a fresh repository to use as a playground, but {% data variables.product.prodname_copilot_short %} needs context to be successful, so you would need to add a lot of context, including team processes, development environment, and common dependencies. -1. Enable {% data variables.copilot.copilot_coding_agent %} in the repository and optionally enable third-party MCP servers for enhanced context sharing. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization). -1. Create repository instructions and pre-install any tools required in the development environment {% data variables.product.prodname_copilot_short %} uses. See [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent). -1. Identify a few compelling use cases for your organization, for example: test coverage or improving accessibility. See [Choose the right type of tasks to give to Copilot](/copilot/tutorials/coding-agent/best-practices#choosing-the-right-type-of-tasks-to-give-to-copilot) in the best practice guide. +1. Enable {% data variables.copilot.copilot_cloud_agent %} in the repository and optionally enable third-party MCP servers for enhanced context sharing. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent). +1. Create repository instructions and pre-install any tools required in the development environment {% data variables.product.prodname_copilot_short %} uses. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment). +1. Identify a few compelling use cases for your organization, for example: test coverage or improving accessibility. See [Choose the right type of tasks to give to Copilot](/copilot/tutorials/cloud-agent/best-practices#choosing-the-right-type-of-tasks-to-give-to-copilot) in the best practice guide. 1. Use best practice to create or refine issues for {% data variables.product.prodname_copilot_short %} in your pilot repository. 1. Assign issues to {% data variables.product.prodname_copilot_short %} and prepare team members to review its work. 1. Spend time looking at the codebase or documentation in {% data variables.product.prodname_vscode_shortname %} or {% data variables.product.prodname_dotcom_the_website %}, asking {% data variables.product.prodname_copilot_short %} to create a pull request to fix any bugs or small improvements that you identify. -Over the course of the trial, the team should iterate on the repository instructions, installed tools, access to MCP servers, and issue definition to identify how your organization can get the most from {% data variables.copilot.copilot_coding_agent %}. This process will help you identify your organization's best practices for working with {% data variables.product.prodname_copilot_short %} and plan an effective rollout strategy. +Over the course of the trial, the team should iterate on the repository instructions, installed tools, access to MCP servers, and issue definition to identify how your organization can get the most from {% data variables.copilot.copilot_cloud_agent %}. This process will help you identify your organization's best practices for working with {% data variables.product.prodname_copilot_short %} and plan an effective rollout strategy. -In addition to giving you insight into how to set up {% data variables.copilot.copilot_coding_agent %} for success, you'll learn how {% data variables.product.prodname_copilot_short %} uses premium requests and actions minutes. This will be valuable when you come to set and manage your budget for a broader trial or full rollout. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/managing-your-companys-spending-on-github-copilot). +In addition to giving you insight into how to set up {% data variables.copilot.copilot_cloud_agent %} for success, you'll learn how {% data variables.product.prodname_copilot_short %} uses premium requests and actions minutes. This will be valuable when you come to set and manage your budget for a broader trial or full rollout. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/assigning-licenses/managing-your-companys-spending-on-github-copilot). ### Enhancing with MCP -The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to provide {% data variables.copilot.copilot_coding_agent %} with access to different data sources and tools. +The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to provide {% data variables.copilot.copilot_cloud_agent %} with access to different data sources and tools. -{% data variables.copilot.copilot_coding_agent %} has access to the full {% data variables.product.github %} context of the repository it's working in, including issues and pull requests, using the built-in {% data variables.product.github %} MCP server. By default, it's restricted from accessing external data by authentication barriers and a firewall. +{% data variables.copilot.copilot_cloud_agent %} has access to the full {% data variables.product.github %} context of the repository it's working in, including issues and pull requests, using the built-in {% data variables.product.github %} MCP server. By default, it's restricted from accessing external data by authentication barriers and a firewall. -You can extend the information available to {% data variables.copilot.copilot_coding_agent %} by giving it access to local MCP servers for the tools your organization uses. For example, you might want to provide access to local MCP servers for some of the following contexts: +You can extend the information available to {% data variables.copilot.copilot_cloud_agent %} by giving it access to local MCP servers for the tools your organization uses. For example, you might want to provide access to local MCP servers for some of the following contexts: * **Project planning tools**: Allow {% data variables.product.prodname_copilot_short %} direct access to private planning documents that are stored outside {% data variables.product.github %} in tools like Notion or Figma. * **Augment training data**: Each LLM contains training data up to a specific cut-off date. If you're working with fast moving tools, {% data variables.product.prodname_copilot_short %} may not have access to information on new features. You can fill this knowledge gap by making the tool's MCP server available. For example, adding the Terraform MCP server will give {% data variables.product.prodname_copilot_short %} access to the most recently supported Terraform providers. -For more information, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/extending-copilot-coding-agent-with-mcp). +For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/extend-cloud-agent-with-mcp). ## Next steps When you're satisfied with the pilot, you can: -* Enable {% data variables.copilot.copilot_coding_agent %} in more organizations or repositories. -* Identify more use cases for {% data variables.copilot.copilot_coding_agent %} and train developers accordingly. +* Enable {% data variables.copilot.copilot_cloud_agent %} in more organizations or repositories. +* Identify more use cases for {% data variables.copilot.copilot_cloud_agent %} and train developers accordingly. * Continue to collect feedback and measure results. To assess the impact of a new tool, we recommend measuring the tool's impact on your organization's downstream goals. For a systematic approach to driving and measuring improvements in engineering systems, see {% data variables.product.company_short %}'s [Engineering System Success Playbook](https://resources.github.com/engineering-system-success-playbook/). diff --git a/content/copilot/tutorials/copilot-cli-hooks.md b/content/copilot/tutorials/copilot-cli-hooks.md index 4e823ff8f814..02544ec18381 100644 --- a/content/copilot/tutorials/copilot-cli-hooks.md +++ b/content/copilot/tutorials/copilot-cli-hooks.md @@ -693,4 +693,4 @@ Some teams (for example, infrastructure or platform teams) may require broader p ## Further reading -For troubleshooting hooks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/use-hooks#troubleshooting). +For troubleshooting hooks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/use-hooks#troubleshooting). diff --git a/content/copilot/tutorials/customization-library/custom-agents/bug-fix-teammate.md b/content/copilot/tutorials/customization-library/custom-agents/bug-fix-teammate.md index df2529f5c89f..b04d5fced251 100644 --- a/content/copilot/tutorials/customization-library/custom-agents/bug-fix-teammate.md +++ b/content/copilot/tutorials/customization-library/custom-agents/bug-fix-teammate.md @@ -75,6 +75,6 @@ Your goal is to make the codebase more stable and reliable by implementing worki Scan the repository for the most critical bug, then implement a targeted fix and explain your approach. ``` -The agent task will appear on the page below the text box. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions). +The agent task will appear on the page below the text box. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). {% data reusables.copilot.custom-agents-further-reading %} diff --git a/content/copilot/tutorials/customization-library/custom-agents/cleanup-specialist.md b/content/copilot/tutorials/customization-library/custom-agents/cleanup-specialist.md index 8f9095b06ecf..a6a218564765 100644 --- a/content/copilot/tutorials/customization-library/custom-agents/cleanup-specialist.md +++ b/content/copilot/tutorials/customization-library/custom-agents/cleanup-specialist.md @@ -85,6 +85,6 @@ Focus on cleaning up existing code rather than adding new features. Work on both Refactor and clean up any messy or inconsistent code in the `src/utils` directory, then document the improvements you made. ``` -The agent task will appear on the page below the text box. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions). +The agent task will appear on the page below the text box. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). {% data reusables.copilot.custom-agents-further-reading %} diff --git a/content/copilot/tutorials/customization-library/custom-agents/implementation-planner.md b/content/copilot/tutorials/customization-library/custom-agents/implementation-planner.md index 54e2a3cb0b6c..b0355f2deb8e 100644 --- a/content/copilot/tutorials/customization-library/custom-agents/implementation-planner.md +++ b/content/copilot/tutorials/customization-library/custom-agents/implementation-planner.md @@ -89,6 +89,6 @@ Adjust the detail level based on your needs - solo projects might need less form Create a detailed implementation plan for adding user authentication to our web app, including technical approach, phases, and risk assessment. ``` -The agent task will appear on the page below the text box. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions). +The agent task will appear on the page below the text box. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). {% data reusables.copilot.custom-agents-further-reading %} diff --git a/content/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent.md b/content/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent.md index 11b46361c50f..1a0f0a470cfe 100644 --- a/content/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent.md +++ b/content/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent.md @@ -18,9 +18,9 @@ contentType: tutorials ## About {% data variables.copilot.custom_agents_short %} -{% data variables.copilot.custom_agents_caps_short %} are specialized versions of {% data variables.copilot.copilot_coding_agent %} that maintain consistent expertise across entire workflows. Unlike custom instructions that apply broadly, or prompt files for one-time tasks, {% data variables.copilot.custom_agents_short %} are selected for specific tasks and maintain their configuration throughout the workflow. +{% data variables.copilot.custom_agents_caps_short %} are specialized versions of {% data variables.copilot.copilot_cloud_agent %} that maintain consistent expertise across entire workflows. Unlike custom instructions that apply broadly, or prompt files for one-time tasks, {% data variables.copilot.custom_agents_short %} are selected for specific tasks and maintain their configuration throughout the workflow. -For a more in-depth overview, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents). +For a more in-depth overview, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents). ## Your first {% data variables.copilot.copilot_custom_agent_short %} @@ -83,6 +83,6 @@ Test this agent by giving it a task to complete: Please review and improve our README.md file. ``` -The agent task will appear on the page below the text box. The agent will focus specifically on README improvements using its specialized knowledge, creating a pull request in your repository. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions). +The agent task will appear on the page below the text box. The agent will focus specifically on README improvements using its specialized knowledge, creating a pull request in your repository. You can click into the task and follow along with the agent. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). {% data reusables.copilot.custom-agents-further-reading %} diff --git a/content/copilot/tutorials/index.md b/content/copilot/tutorials/index.md index 314c40120a99..bc91db4f59cb 100644 --- a/content/copilot/tutorials/index.md +++ b/content/copilot/tutorials/index.md @@ -7,7 +7,7 @@ versions: children: - /copilot-chat-cookbook - /customization-library - - /coding-agent + - /cloud-agent - /spark - /use-custom-instructions - /enhance-agent-mode-with-mcp diff --git a/content/copilot/tutorials/modernize-java-applications.md b/content/copilot/tutorials/modernize-java-applications.md index e19d3b957d01..74592eb8a9fa 100644 --- a/content/copilot/tutorials/modernize-java-applications.md +++ b/content/copilot/tutorials/modernize-java-applications.md @@ -14,7 +14,7 @@ category: -The {% data variables.product.prodname_copilot %} app modernization extension in {% data variables.product.prodname_vscode %} automates Java upgrades by identifying outdated frameworks, deprecated APIs, and upgrade blockers. {% data variables.copilot.copilot_coding_agent %} applies code changes, updates build files, and resolves build and CVE issues for you. +The {% data variables.product.prodname_copilot %} app modernization extension in {% data variables.product.prodname_vscode %} automates Java upgrades by identifying outdated frameworks, deprecated APIs, and upgrade blockers. {% data variables.copilot.copilot_cloud_agent %} applies code changes, updates build files, and resolves build and CVE issues for you. The recommendations and reporting produced by the extension can help your teams adopt new technologies quickly and reduce technical debt. {% data variables.product.prodname_copilot_short %} guides you through upgrades with actionable steps and summaries, accelerating and securing your migrations while reducing manual effort. @@ -50,7 +50,7 @@ In this example, we'll walk through the high-level steps to modernize a Java app For detailed prerequisites and instructions, see [Quickstart: upgrade a Java project with {% data variables.product.prodname_copilot %} app modernization](https://learn.microsoft.com/en-us/java/upgrade/quickstart-upgrade) in the Microsoft documentation. > [!NOTE] -> During the modernization workflow, you may frequently be prompted by {% data variables.copilot.copilot_coding_agent %} for confirmation before it performs specific actions. +> During the modernization workflow, you may frequently be prompted by {% data variables.copilot.copilot_cloud_agent %} for confirmation before it performs specific actions. ### 1. Open your Java project @@ -89,7 +89,7 @@ Use {% data variables.product.prodname_copilot_short %} to apply or review code If build errors are found, {% data variables.product.prodname_copilot_short %} can enter a fix-and-test loop until the project compiles cleanly. -{% data variables.copilot.copilot_coding_agent %} automated changes can include: +{% data variables.copilot.copilot_cloud_agent %} automated changes can include: * Updating `pom.xml` or `build.gradle` files for new dependency versions. * Generating pull requests or committing changes directly. diff --git a/content/copilot/tutorials/plan-a-project.md b/content/copilot/tutorials/plan-a-project.md index 75c64181a4cc..3c6289608572 100644 --- a/content/copilot/tutorials/plan-a-project.md +++ b/content/copilot/tutorials/plan-a-project.md @@ -104,11 +104,11 @@ If {% data variables.product.prodname_copilot_short %} generates a sub-issue tha ## Next steps -Now that you’ve generated and refined your project issues, you can assign them to the right team members or even to {% data variables.product.prodname_copilot_short %} itself for further assistance. To learn more about how to assign {% data variables.product.prodname_copilot_short %} or contributors to issues, and how to continue planning and implementing your project with {% data variables.product.prodname_copilot_short %}’s agentic features, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/assign-copilot-to-an-issue). +Now that you’ve generated and refined your project issues, you can assign them to the right team members or even to {% data variables.product.prodname_copilot_short %} itself for further assistance. To learn more about how to assign {% data variables.product.prodname_copilot_short %} or contributors to issues, and how to continue planning and implementing your project with {% data variables.product.prodname_copilot_short %}’s agentic features, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr). ## Further reading * [AUTOTITLE](/copilot/how-tos/use-copilot-for-common-tasks/use-copilot-to-create-or-update-issues) -* [AUTOTITLE](/copilot/tutorials/coding-agent/pilot-coding-agent) -* [AUTOTITLE](/copilot/tutorials/coding-agent/get-the-best-results) +* [AUTOTITLE](/copilot/tutorials/cloud-agent/pilot-cloud-agent) +* [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results) * [AUTOTITLE](/copilot/tutorials/speed-up-development-work) diff --git a/content/copilot/tutorials/reduce-technical-debt.md b/content/copilot/tutorials/reduce-technical-debt.md index 11038ed01945..409a63e61f6c 100644 --- a/content/copilot/tutorials/reduce-technical-debt.md +++ b/content/copilot/tutorials/reduce-technical-debt.md @@ -18,7 +18,7 @@ Technical debt accumulates in every codebase: duplicate code, missing tests, out This tutorial is designed to help engineering teams and technical leads reduce technical debt while maintaining the pace at which new features are delivered. You should have: -* A {% data variables.product.prodname_copilot_short %} subscription with access to {% data variables.copilot.copilot_coding_agent %} +* A {% data variables.product.prodname_copilot_short %} subscription with access to {% data variables.copilot.copilot_cloud_agent %} * Admin access to at least one repository * Familiarity with your team's development workflow @@ -27,7 +27,7 @@ This tutorial is designed to help engineering teams and technical leads reduce t By the end of this tutorial, you'll have learned about: * Using {% data variables.product.prodname_copilot_short %} to implement in-the-moment fixes -* Leveraging {% data variables.copilot.copilot_coding_agent %} for large-scale cleanup tasks +* Leveraging {% data variables.copilot.copilot_cloud_agent %} for large-scale cleanup tasks * Creating custom instructions to align {% data variables.product.prodname_copilot_short %} with your team's standards * Measuring the impact of {% data variables.product.prodname_copilot_short %} on your technical debt @@ -111,13 +111,13 @@ By adopting the in-the-moment fix approach, you help to ensure that substandard For more details on using {% data variables.product.prodname_copilot_short %} in your IDE, see [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide). -## Using {% data variables.copilot.copilot_coding_agent %} for large-scale refactoring +## Using {% data variables.copilot.copilot_cloud_agent %} for large-scale refactoring -Some refactoring tasks are just too big to complete while everyone on the team is busy developing new features. In this situation you can use {% data variables.copilot.copilot_coding_agent %} to handle these tasks autonomously. Human effort will still be required—at a minimum for reviewing the changes {% data variables.copilot.copilot_coding_agent %} proposes—but getting {% data variables.product.prodname_copilot_short %} to do the bulk of the work can allow you to carry out large-scale refactoring with much less impact on your team's productivity. +Some refactoring tasks are just too big to complete while everyone on the team is busy developing new features. In this situation you can use {% data variables.copilot.copilot_cloud_agent %} to handle these tasks autonomously. Human effort will still be required—at a minimum for reviewing the changes {% data variables.copilot.copilot_cloud_agent %} proposes—but getting {% data variables.product.prodname_copilot_short %} to do the bulk of the work can allow you to carry out large-scale refactoring with much less impact on your team's productivity. -### When to use {% data variables.copilot.copilot_coding_agent %} +### When to use {% data variables.copilot.copilot_cloud_agent %} -Use {% data variables.copilot.copilot_coding_agent %} for tasks that: +Use {% data variables.copilot.copilot_cloud_agent %} for tasks that: * Touch many files across your codebase * Require systematic changes (like removing old feature flags) @@ -132,7 +132,7 @@ Examples include: * Updating dependency versions * Standardizing import patterns -### Workflow for {% data variables.copilot.copilot_coding_agent %} +### Workflow for {% data variables.copilot.copilot_cloud_agent %} 1. Create a {% data variables.product.prodname_dotcom %} issue describing the refactoring task. @@ -152,7 +152,7 @@ Examples include: ``` 1. Assign the issue to the **Copilot** user. -1. {% data variables.copilot.copilot_coding_agent %} will: +1. {% data variables.copilot.copilot_cloud_agent %} will: * Set up a development environment * Open a draft pull request @@ -162,15 +162,15 @@ Examples include: * Request your review of the pull request 1. Review the pull request just as you would a pull request raised by a human. -1. Leave comments if changes are needed—{% data variables.copilot.copilot_coding_agent %} will update the pull request based on your feedback. +1. Leave comments if changes are needed—{% data variables.copilot.copilot_cloud_agent %} will update the pull request based on your feedback. 1. Iterate in this way until the work is completed correctly. 1. Approve and merge the pull request. -For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr#assigning-an-issue-to-copilot) and [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/review-copilot-prs). +For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr#assigning-an-issue-to-copilot) and [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs). ### Safety guardrails -{% data variables.copilot.copilot_coding_agent %} operates with built-in safety measures: +{% data variables.copilot.copilot_cloud_agent %} operates with built-in safety measures: * It can only push to its own `copilot/*` branches * It cannot merge pull requests—requires your approval @@ -234,7 +234,7 @@ Start small to validate {% data variables.product.prodname_copilot_short %}'s im ### Week 1: Set up and establish baselines -1. Ensure all pilot participants have {% data variables.product.prodname_copilot_short %} access with {% data variables.copilot.copilot_coding_agent %} enabled. +1. Ensure all pilot participants have {% data variables.product.prodname_copilot_short %} access with {% data variables.copilot.copilot_cloud_agent %} enabled. 1. Count the technical debt items in your backlog: * Number of "tech debt", "chore", or similar labeled issues @@ -258,7 +258,7 @@ Start small to validate {% data variables.product.prodname_copilot_short %}'s im * Outdated dependencies 1. Use {% data variables.product.prodname_copilot_short %} in your IDE for quick fixes as you encounter issues. -1. Assign larger cleanup tasks to {% data variables.copilot.copilot_coding_agent %}. +1. Assign larger cleanup tasks to {% data variables.copilot.copilot_cloud_agent %}. 1. Review all {% data variables.product.prodname_copilot_short %}-generated PRs carefully. 1. Provide feedback on suggestions to help {% data variables.product.prodname_copilot_short %} learn your preferences. @@ -268,7 +268,7 @@ After the pilot, measure your results: * How much faster are refactoring pull requests getting merged? * How many review rounds do they require now? -* Which types of code change suggestions, made by {% data variables.copilot.copilot_coding_agent %} in pull requests, did developers accept most often? +* Which types of code change suggestions, made by {% data variables.copilot.copilot_cloud_agent %} in pull requests, did developers accept most often? * Which suggestions needed the most revision? * Are your technical debt metrics improving? @@ -315,21 +315,21 @@ If {% data variables.product.prodname_copilot_short %} consistently suggests cod * Review your custom instructions—they may be too vague or contradictory * Provide more specific context in your prompts * Add examples of good code to your custom instructions -* Leave detailed feedback in pull request reviews to allow {% data variables.copilot.copilot_coding_agent %} to fix the problems +* Leave detailed feedback in pull request reviews to allow {% data variables.copilot.copilot_cloud_agent %} to fix the problems ### Pull requests are too large to review -If {% data variables.copilot.copilot_coding_agent %} creates pull requests that are difficult to review: +If {% data variables.copilot.copilot_cloud_agent %} creates pull requests that are difficult to review: * Break large tasks into smaller, focused issues -* Ask {% data variables.copilot.copilot_coding_agent %} to handle one file or directory at a time +* Ask {% data variables.copilot.copilot_cloud_agent %} to handle one file or directory at a time * Use more specific issue descriptions ### Changes break tests If refactoring introduces test failures: -* Ensure your test suite runs reliably before using {% data variables.copilot.copilot_coding_agent %} +* Ensure your test suite runs reliably before using {% data variables.copilot.copilot_cloud_agent %} * Review {% data variables.product.prodname_copilot_short %} changes carefully before merging * Ask {% data variables.product.prodname_copilot_short %} to update tests along with the code changes @@ -347,7 +347,7 @@ If your team isn't using {% data variables.product.prodname_copilot_short %} for In this tutorial, you learned how to use {% data variables.product.prodname_copilot_short %} to systematically reduce technical debt. You now know how to: * Fix technical debt immediately using {% data variables.product.prodname_copilot_short %} in your IDE -* Assign large refactoring tasks to {% data variables.copilot.copilot_coding_agent %} +* Assign large refactoring tasks to {% data variables.copilot.copilot_cloud_agent %} * Create custom instructions that align {% data variables.product.prodname_copilot_short %} with your team's standards * Run a pilot program to validate the approach * Measure {% data variables.product.prodname_copilot_short %}'s impact on technical debt @@ -367,13 +367,13 @@ After reading this tutorial, do you feel confident you can use {% data variables ## Next steps * **Expand your pilot**: Roll out to more repositories based on your pilot results. -* **Automate dependency updates**: Create recurring issues for {% data variables.copilot.copilot_coding_agent %} to handle dependency updates. +* **Automate dependency updates**: Create recurring issues for {% data variables.copilot.copilot_cloud_agent %} to handle dependency updates. * **Build a refactoring queue**: Label issues in your backlog as good for {% data variables.product.prodname_copilot_short %} then regularly assign a batch of these to {% data variables.product.prodname_copilot_short %} to work on. * **Share best practices**: Document successful prompts and custom instructions for your team. ## Further reading -* [AUTOTITLE](/copilot/using-github-copilot/coding-agent) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent) * [AUTOTITLE](/copilot/tutorials/refactoring-code-with-github-copilot) * [How to use GitHub Copilot in your IDE: Tips, tricks, and best practices](https://github.blog/developer-skills/github/how-to-use-github-copilot-in-your-ide-tips-tricks-and-best-practices/) in the {% data variables.product.company_short %} blog -* [5 ways to integrate GitHub {% data variables.copilot.copilot_coding_agent %} into your workflow](https://github.blog/ai-and-ml/github-copilot/5-ways-to-integrate-github-copilot-coding-agent-into-your-workflow/) in the {% data variables.product.company_short %} blog +* [5 ways to integrate GitHub {% data variables.copilot.copilot_cloud_agent %} into your workflow](https://github.blog/ai-and-ml/github-copilot/5-ways-to-integrate-github-copilot-cloud-agent-into-your-workflow/) in the {% data variables.product.company_short %} blog diff --git a/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md b/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md index 567ce5321cb2..3a6c0bb3f31a 100644 --- a/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md +++ b/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md @@ -135,7 +135,7 @@ Developers **should not**: * [{% data variables.copilot.copilot_chat_dotcom_short %}](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-github) * [{% data variables.product.prodname_copilot_short %} inline suggestions](/copilot/using-github-copilot/getting-code-suggestions-in-your-ide-with-github-copilot) * [{% data variables.copilot.copilot_chat_short %} in the IDE](/copilot/using-github-copilot/copilot-chat/asking-github-copilot-questions-in-your-ide) -* [{% data variables.copilot.copilot_coding_agent %}](/copilot/concepts/about-copilot-coding-agent) +* [{% data variables.copilot.copilot_cloud_agent %}](/copilot/concepts/about-copilot-cloud-agent) ## Metrics to watch diff --git a/content/copilot/tutorials/roll-out-at-scale/enable-developers/integrate-ai-agents.md b/content/copilot/tutorials/roll-out-at-scale/enable-developers/integrate-ai-agents.md index f70d42e7c41f..cdd69e519b4f 100644 --- a/content/copilot/tutorials/roll-out-at-scale/enable-developers/integrate-ai-agents.md +++ b/content/copilot/tutorials/roll-out-at-scale/enable-developers/integrate-ai-agents.md @@ -47,7 +47,7 @@ To hit a tight deadline, you're aiming to speed up each stage of the process, fo {% data variables.product.prodname_copilot_short %} drafts the issues in `https://github.com/copilot`, where the PM can refine them and publish them to the repository. - The PM marks some of the issues as nice-to-haves or maintenance. These may be good candidates for {% data variables.copilot.copilot_coding_agent %}. + The PM marks some of the issues as nice-to-haves or maintenance. These may be good candidates for {% data variables.copilot.copilot_cloud_agent %}.  @@ -108,16 +108,16 @@ To hit a tight deadline, you're aiming to speed up each stage of the process, fo 1. As an additional compliance check, an enterprise owner has created a **{% data variables.copilot.copilot_custom_agent %}** with key context on industry regulations and internal policies. The developer selects the {% data variables.copilot.copilot_custom_agent_short %} at `https://github.com/copilot/agents`, prompting {% data variables.product.prodname_copilot_short %} to carefully review the pull request for compliance and applying any necessary changes before requesting a human review. 1. The developer's colleague reviews and approves the pull request. The work is ready to merge. -## 6. Optimize with {% data variables.copilot.copilot_coding_agent %} +## 6. Optimize with {% data variables.copilot.copilot_cloud_agent %} 1. After the release, the product manager collects customer feedback and identifies an opportunity to improve the widget's suggestions by switching to a more reliable API for weather data. They create an issue to implement this change, and **assign it to {% data variables.product.prodname_copilot_short %}** directly on {% data variables.product.github %}. -1. {% data variables.copilot.copilot_coding_agent %} works in the background and opens a pull request, which the product manager marks as ready for review. +1. {% data variables.copilot.copilot_cloud_agent %} works in the background and opens a pull request, which the product manager marks as ready for review. -  +  1. A developer reviews {% data variables.product.prodname_copilot_short %}'s pull request and leaves feedback, which {% data variables.product.prodname_copilot_short %} incorporates. Finally, the developer merges the pull request. - >[!TIP] {% data variables.copilot.copilot_coding_agent %} comes with default guardrails. For example, {% data variables.product.prodname_copilot_short %} cannot merge pull requests by itself. You can define additional protections for target branches using repository rulesets. + >[!TIP] {% data variables.copilot.copilot_cloud_agent %} comes with default guardrails. For example, {% data variables.product.prodname_copilot_short %} cannot merge pull requests by itself. You can define additional protections for target branches using repository rulesets. 1. Later, while working on a separate feature, the developer notices a small bug in the code for the AI widget. To avoid context switching, the developer instructs {% data variables.product.prodname_copilot_short %} to open a pull request directly from {% data variables.product.prodname_vscode_shortname %}. @@ -155,8 +155,8 @@ To integrate agentic AI features effectively into your workstreams, you'll need | {% data variables.product.prodname_github_models %} playground ({% data variables.release-phases.public_preview %}) | [AUTOTITLE](/github-models/prototyping-with-ai-models#experimenting-with-ai-models-in-the-playground) | | Custom instructions | [AUTOTITLE](/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot?tool=vscode) | | {% data variables.copilot.copilot_code-review_short %} | [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/automatic-code-review) | -| {% data variables.copilot.copilot_custom_agents %} | [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents) | -| {% data variables.copilot.copilot_coding_agent %} | [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org) | +| {% data variables.copilot.copilot_custom_agents %} | [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents) | +| {% data variables.copilot.copilot_cloud_agent %} | [AUTOTITLE](/copilot/tutorials/cloud-agent/pilot-cloud-agent) | | {% data variables.copilot.copilot_autofix_short %} | [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning) | {% endrowheaders %} diff --git a/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md b/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md index 4fe14c764670..898a7aba4c5c 100644 --- a/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md +++ b/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md @@ -74,4 +74,4 @@ If you have created a ruleset targeting {% data variables.copilot.agent_profiles Now that you have established AI managers for your enterprise, help them customize and manage your enterprise's AI experience by sharing the following resources: * [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies) -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/test-custom-agents) diff --git a/content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md b/content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md index f8936d9764b8..ebbf56f7e46e 100644 --- a/content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md +++ b/content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md @@ -48,7 +48,7 @@ Good DevOps practices ensure that your code is automatically tested before being ## 3. Scan code for vulnerabilities -{% data variables.product.prodname_copilot_short %} is already designed to avoid introducing vulnerabilities into your codebase. For example, code created by {% data variables.copilot.copilot_coding_agent %} is automatically scanned for vulnerable patterns and secrets such as API keys. +{% data variables.product.prodname_copilot_short %} is already designed to avoid introducing vulnerabilities into your codebase. For example, code created by {% data variables.copilot.copilot_cloud_agent %} is automatically scanned for vulnerable patterns and secrets such as API keys. However, it is good practice to regularly scan all code for vulnerabilities and secrets, and to prevent developers from introducing vulnerabilities in the first place. diff --git a/content/copilot/tutorials/spark/build-apps-with-spark.md b/content/copilot/tutorials/spark/build-apps-with-spark.md index 4dd3e19b1c7e..53f1cda3405a 100644 --- a/content/copilot/tutorials/spark/build-apps-with-spark.md +++ b/content/copilot/tutorials/spark/build-apps-with-spark.md @@ -175,7 +175,7 @@ Any changes made to your spark prior to repository creation will be added to you There's a two-way sync between your spark and the repository, so changes made in either {% data variables.product.prodname_spark_short %} or the main branch of your repository are automatically reflected in both places. -You can also create issues in your repository and assign them to {% data variables.copilot.copilot_coding_agent %} so it can draft pull requests for fixes and improvements. +You can also create issues in your repository and assign them to {% data variables.copilot.copilot_cloud_agent %} so it can draft pull requests for fixes and improvements. ## Next steps diff --git a/content/copilot/tutorials/vibe-coding.md b/content/copilot/tutorials/vibe-coding.md index 435d43d3a3a5..28d1188dec28 100644 --- a/content/copilot/tutorials/vibe-coding.md +++ b/content/copilot/tutorials/vibe-coding.md @@ -184,7 +184,7 @@ You can now start planning for an initial implementation of your application. It 1. Keep your chat conversation open, as {% data variables.product.prodname_copilot_short %} will use this in the next series of steps. -## Building your application with {% data variables.copilot.copilot_coding_agent %} +## Building your application with {% data variables.copilot.copilot_cloud_agent %} When you think the plan contains enough detail: diff --git a/content/get-started/using-github/github-mobile.md b/content/get-started/using-github/github-mobile.md index bc52e1306f9a..922cf94da3f0 100644 --- a/content/get-started/using-github/github-mobile.md +++ b/content/get-started/using-github/github-mobile.md @@ -38,7 +38,7 @@ The following documentation contains more information about using {% data variab * Using {% data variables.product.prodname_dotcom %} code search on {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/search-github/github-code-search/using-github-code-search#using-github-code-search-on-github-mobile).{% endif %}{% ifversion fpt or ghec %} * Two-factor authentication using {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) and [Authenticating using {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication#verifying-with-github-mobile). {% endif %}{% ifversion copilot-chat-for-mobile %} * Using {% data variables.copilot.copilot_mobile %}, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile).{% endif %}{% ifversion copilot-chat-for-mobile %} -* Assigning issues to {% data variables.product.prodname_copilot_short %} from {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/assign-copilot-to-an-issue).{% endif %} +* Assigning issues to {% data variables.product.prodname_copilot_short %} from {% data variables.product.prodname_mobile %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr).{% endif %} ## Installing {% data variables.product.prodname_mobile %} diff --git a/content/index.md b/content/index.md index b612d0033737..4b8577bb525b 100644 --- a/content/index.md +++ b/content/index.md @@ -112,7 +112,7 @@ childGroups: children: - copilot - copilot/get-started/plans - - copilot/how-tos/use-copilot-agents/coding-agent + - copilot/how-tos/use-copilot-agents/cloud-agent - copilot/tutorials - copilot/tutorials/copilot-chat-cookbook - copilot/tutorials/customization-library diff --git a/content/integrations/concepts/featured-github-integrations.md b/content/integrations/concepts/featured-github-integrations.md index ffecb6467620..5fc755e80854 100644 --- a/content/integrations/concepts/featured-github-integrations.md +++ b/content/integrations/concepts/featured-github-integrations.md @@ -81,6 +81,6 @@ For more information, see [AUTOTITLE](/integrations/how-tos/teams). {% ifversion fpt or ghec %} -You can also integrate the {% data variables.copilot.copilot_coding_agent %} with your Microsoft Teams app, enabling you to use AI-powered coding assistance directly within your team's communication platform. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-teams) for more information. +You can also integrate the {% data variables.copilot.copilot_cloud_agent %} with your Microsoft Teams app, enabling you to use AI-powered coding assistance directly within your team's communication platform. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-teams) for more information. {% endif %} diff --git a/content/integrations/how-tos/slack/integrate-github-with-slack.md b/content/integrations/how-tos/slack/integrate-github-with-slack.md index d954c7751ed2..037c49284faa 100644 --- a/content/integrations/how-tos/slack/integrate-github-with-slack.md +++ b/content/integrations/how-tos/slack/integrate-github-with-slack.md @@ -20,7 +20,7 @@ With the {% data variables.product.github %} integration for Slack, you can: * Get **{% data variables.product.github %} notifications** in Slack channels. * Use **slash commands** to take actions on {% data variables.product.github %}. * Give your team **context** when sharing links to {% data variables.product.github %} activities and properties. -* Initiate a {% data variables.copilot.copilot_coding_agent %} session from Slack, using the context of a Slack thread. +* Initiate a {% data variables.copilot.copilot_cloud_agent %} session from Slack, using the context of a Slack thread. {% data reusables.integrations.github-slack-permissions %} diff --git a/content/integrations/how-tos/slack/use-github-in-slack.md b/content/integrations/how-tos/slack/use-github-in-slack.md index f863ff213ac0..7d1c88c981e9 100644 --- a/content/integrations/how-tos/slack/use-github-in-slack.md +++ b/content/integrations/how-tos/slack/use-github-in-slack.md @@ -42,9 +42,9 @@ To use a slash command, type `/github` followed by the command you want to execu {% ifversion fpt or ghec %} -## Initiating {% data variables.copilot.copilot_coding_agent %} sessions within Slack +## Initiating {% data variables.copilot.copilot_cloud_agent %} sessions within Slack -The {% data variables.product.github %} app also integrates {% data variables.copilot.copilot_coding_agent %} into Slack. You can use this functionality to summon {% data variables.copilot.copilot_coding_agent %} in threads where important discussions are taking place, and ask it to make changes based on the context of those discussions. See: [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-slack). +The {% data variables.product.github %} app also integrates {% data variables.copilot.copilot_cloud_agent %} into Slack. You can use this functionality to summon {% data variables.copilot.copilot_cloud_agent %} in threads where important discussions are taking place, and ask it to make changes based on the context of those discussions. See: [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-slack). {% endif %} diff --git a/content/integrations/how-tos/teams/integrate-github-with-teams.md b/content/integrations/how-tos/teams/integrate-github-with-teams.md index ae0edfa63452..9110289f3071 100644 --- a/content/integrations/how-tos/teams/integrate-github-with-teams.md +++ b/content/integrations/how-tos/teams/integrate-github-with-teams.md @@ -21,7 +21,7 @@ With the {% data variables.product.github %} integration for Teams, you can: * Use **commands** to take actions on {% data variables.product.github %}. * See **previews** when sharing links to {% data variables.product.github %} resources. {% ifversion fpt or ghec %} -* Initiate a {% data variables.copilot.copilot_coding_agent %} session from Teams, using the context of a Teams thread. +* Initiate a {% data variables.copilot.copilot_cloud_agent %} session from Teams, using the context of a Teams thread. {% endif %} {% data reusables.integrations.github-teams-permissions %} diff --git a/content/integrations/how-tos/teams/use-github-in-teams.md b/content/integrations/how-tos/teams/use-github-in-teams.md index 527c390a0fab..43f42f79177d 100644 --- a/content/integrations/how-tos/teams/use-github-in-teams.md +++ b/content/integrations/how-tos/teams/use-github-in-teams.md @@ -87,9 +87,9 @@ You can schedule reminders for pending pull request reviews in channels or in th {% ifversion fpt or ghec %} -## Initiating {% data variables.copilot.copilot_coding_agent %} sessions within Teams +## Initiating {% data variables.copilot.copilot_cloud_agent %} sessions within Teams -The {% data variables.product.github %} app integrates {% data variables.copilot.copilot_coding_agent %} into Teams. You can summon {% data variables.copilot.copilot_coding_agent %} in threads where discussions are taking place and ask it to make changes based on the context of those discussions. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-teams). +The {% data variables.product.github %} app integrates {% data variables.copilot.copilot_cloud_agent %} into Teams. You can summon {% data variables.copilot.copilot_cloud_agent %} in threads where discussions are taking place and ask it to make changes based on the context of those discussions. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-teams). {% endif %} diff --git a/content/integrations/reference/slack-permissions.md b/content/integrations/reference/slack-permissions.md index b846d670d422..d8d74d06b633 100644 --- a/content/integrations/reference/slack-permissions.md +++ b/content/integrations/reference/slack-permissions.md @@ -35,5 +35,5 @@ When you connect your {% data variables.product.github %} account to the {% data |Read access to code| To render code snippets in Slack| |Read access to actions, commit statuses, checks, discussions, issues, metadata, pull requests, and repository projects | To render previews of links shared in Slack| |Write access to actions, issues, deployments, and pull requests | To take action from Slack with the `/github` command and directly from messages| -|Write access to content| To open pull requests authored by {% data variables.copilot.copilot_coding_agent %}| -|Read/write access to workflows|To initiate {% data variables.copilot.copilot_coding_agent %} sessions| +|Write access to content| To open pull requests authored by {% data variables.copilot.copilot_cloud_agent %}| +|Read/write access to workflows|To initiate {% data variables.copilot.copilot_cloud_agent %} sessions| diff --git a/content/integrations/reference/teams-permissions.md b/content/integrations/reference/teams-permissions.md index d1f7e5bd51a9..cd4676801d6b 100644 --- a/content/integrations/reference/teams-permissions.md +++ b/content/integrations/reference/teams-permissions.md @@ -37,11 +37,11 @@ When you connect your {% data variables.product.github %} account to the {% data {% ifversion fpt or ghec %} -## Additional permissions for {% data variables.copilot.copilot_coding_agent %} +## Additional permissions for {% data variables.copilot.copilot_cloud_agent %} |Permission scope|Why we need it| |---|---| -|Write access to content| To open pull requests authored by {% data variables.copilot.copilot_coding_agent %}.| -|Read/write access to workflows| To initiate {% data variables.copilot.copilot_coding_agent %} sessions.| +|Write access to content| To open pull requests authored by {% data variables.copilot.copilot_cloud_agent %}.| +|Read/write access to workflows| To initiate {% data variables.copilot.copilot_cloud_agent %} sessions.| {% endif %} diff --git a/content/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users.md b/content/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users.md index fd8cddda6816..b20b96de0b60 100644 --- a/content/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users.md +++ b/content/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users.md @@ -23,7 +23,7 @@ You can assign multiple people to each issue or pull request, including: yoursel {% ifversion copilot %} -You may also be able to assign {% data variables.product.prodname_copilot_short %} to an issue, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/using-copilot-to-work-on-an-issue). +You may also be able to assign {% data variables.product.prodname_copilot_short %} to an issue, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr). {% endif %} @@ -53,7 +53,7 @@ Both issues and pull requests support up to 10 assignees. ## Assigning an issue to {% data variables.product.prodname_copilot_short %} -If you assign an issue to {% data variables.product.prodname_copilot_short %}, {% data variables.product.prodname_copilot_short %} will work autonomously on the issue, creating a pull request and, when it has finished, requesting that you review the pull request. See [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +If you assign an issue to {% data variables.product.prodname_copilot_short %}, {% data variables.product.prodname_copilot_short %} will work autonomously on the issue, creating a pull request and, when it has finished, requesting that you review the pull request. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). {% endif %} diff --git a/content/migrations/ado/key-differences-between-azure-devops-and-github.md b/content/migrations/ado/key-differences-between-azure-devops-and-github.md index 95db96737481..e0f8893781f5 100644 --- a/content/migrations/ado/key-differences-between-azure-devops-and-github.md +++ b/content/migrations/ado/key-differences-between-azure-devops-and-github.md @@ -87,6 +87,6 @@ For more information, see [AUTOTITLE](/packages/learn-github-packages/introducti ## {% data variables.product.prodname_copilot %} -Hosting your repositories on {% data variables.product.github %} unlocks the full power of {% data variables.product.prodname_copilot_short %}. Your codebase provides {% data variables.product.prodname_copilot_short %} with all the context it needs to answer questions in {% data variables.copilot.copilot_chat_short %}, review and make suggestions in your pull requests, and even make changes on your behalf with {% data variables.copilot.copilot_coding_agent %}. +Hosting your repositories on {% data variables.product.github %} unlocks the full power of {% data variables.product.prodname_copilot_short %}. Your codebase provides {% data variables.product.prodname_copilot_short %} with all the context it needs to answer questions in {% data variables.copilot.copilot_chat_short %}, review and make suggestions in your pull requests, and even make changes on your behalf with {% data variables.copilot.copilot_cloud_agent %}. See [AUTOTITLE](/copilot/get-started/quickstart). diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request.md index 30fa9ac44b0d..171c44814379 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request.md @@ -52,7 +52,7 @@ To reply to an existing line or file comment, you'll need to navigate to the com When you have finished, click **Finish your review** at the top right of the page, leave a summary of your review, and click **Submit review**. -Anyone watching the pull request or repository will receive a notification of your comments. Batching your comments avoids multiple notifications being sent. {% ifversion copilot %}If you are commenting on a pull request created by {% data variables.product.prodname_copilot_short %}, batching your comments prevents {% data variables.product.prodname_copilot_short %} from starting to work on individual comments before you have completed your review. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/using-copilot-to-work-on-an-issue).{% endif %} +Anyone watching the pull request or repository will receive a notification of your comments. Batching your comments avoids multiple notifications being sent. {% ifversion copilot %}If you are commenting on a pull request created by {% data variables.product.prodname_copilot_short %}, batching your comments prevents {% data variables.product.prodname_copilot_short %} from starting to work on individual comments before you have completed your review. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr).{% endif %} ### Resolving conversations diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 8da6f061f447..c20369ed8e64 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -26,7 +26,7 @@ It's best to review changes in a pull request one file at a time: {% ifversion copilot %} -If the pull request was raised by {% data variables.product.prodname_copilot %} then, when you submit your comments, {% data variables.product.prodname_copilot_short %} will carry out more work to respond to your comments and will push a new commit to the pull request with further changes. See [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent). +If the pull request was raised by {% data variables.product.prodname_copilot %} then, when you submit your comments, {% data variables.product.prodname_copilot_short %} will carry out more work to respond to your comments and will push a new commit to the pull request with further changes. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). {% endif %} diff --git a/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md b/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md index f928db8bfd24..e0a78a9b649f 100644 --- a/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md +++ b/content/repositories/creating-and-managing-repositories/creating-a-new-repository.md @@ -44,7 +44,7 @@ category: * You can choose to add a software license for your project. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository).{% endif %} {% data reusables.repositories.select-marketplace-apps %} {% ifversion fpt or ghec %} -1. Optionally, if you have access to {% data variables.copilot.copilot_coding_agent %}, enter a prompt for {% data variables.product.prodname_copilot_short %} to use to populate your repository. After the repository is created, {% data variables.product.prodname_copilot_short %} will open a draft pull request, write the code requested, then request review from you. For more information, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-coding-agent). +1. Optionally, if you have access to {% data variables.copilot.copilot_cloud_agent %}, enter a prompt for {% data variables.product.prodname_copilot_short %} to use to populate your repository. After the repository is created, {% data variables.product.prodname_copilot_short %} will open a draft pull request, write the code requested, then request review from you. For more information, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). {% data reusables.repositories.create-repo %} 1. At the bottom of the resulting Quick Setup page, under "Import code from an old repository", you can choose to import a project to your new repository. To do so, click **Import code**. {% endif %} diff --git a/content/rest/agent-tasks/agent-tasks.md b/content/rest/agent-tasks/agent-tasks.md index c35f159764ee..939ea0c99842 100644 --- a/content/rest/agent-tasks/agent-tasks.md +++ b/content/rest/agent-tasks/agent-tasks.md @@ -1,7 +1,7 @@ --- title: Agent tasks shortTitle: Agent tasks -intro: Use the REST API to start and manage {% data variables.copilot.copilot_coding_agent %} tasks. +intro: Use the REST API to start and manage {% data variables.copilot.copilot_cloud_agent %} tasks. versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 fpt: '*' ghec: '*' diff --git a/content/rest/copilot/copilot-coding-agent-management.md b/content/rest/copilot/copilot-coding-agent-management.md index 271e91f04f60..d54fc572b50e 100644 --- a/content/rest/copilot/copilot-coding-agent-management.md +++ b/content/rest/copilot/copilot-coding-agent-management.md @@ -3,7 +3,7 @@ title: REST API endpoints for Copilot cloud agent management shortTitle: Copilot cloud agent management intro: >- Use the REST API to manage settings for {% data - variables.copilot.copilot_coding_agent %}. + variables.copilot.copilot_cloud_agent %}. versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 fpt: '*' ghec: '*' diff --git a/data/llms-txt-config.yml b/data/llms-txt-config.yml index e2ed119b428e..39b093e606c0 100644 --- a/data/llms-txt-config.yml +++ b/data/llms-txt-config.yml @@ -34,8 +34,8 @@ pinned_pages: - copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp - copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server - copilot/how-tos/provide-context/use-mcp/set-up-the-github-mcp-server - - copilot/how-tos/use-copilot-agents/coding-agent/about-coding-agent - - copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents + - copilot/how-tos/use-copilot-agents/cloud-agent/about-cloud-agent + - copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents - github-cli/github-cli - github-cli/github-cli/quickstart - rest diff --git a/data/reusables/billing/cost-center-allocation.md b/data/reusables/billing/cost-center-allocation.md index 1428f16c0b35..86a1a0974a3f 100644 --- a/data/reusables/billing/cost-center-allocation.md +++ b/data/reusables/billing/cost-center-allocation.md @@ -2,6 +2,6 @@ To allocate metered spending to a cost center, you add repositories, organizatio * For **usage-based** products, like {% data variables.product.prodname_actions %}, cost centers are charged based on the **repositories or organizations** in the cost center, as this is where the usage takes place. * For **license-based** products, like {% data variables.product.prodname_copilot %}, cost centers are charged based on the **users** in the cost center. -* For products billed by **{% data variables.product.prodname_pru %}** usage, like {% data variables.copilot.copilot_coding_agent %}, cost centers are charged based on the **users** in the cost center, or the **organization that granted the user's {% data variables.product.prodname_copilot %} license** if the user isn't directly assigned to a cost center. +* For products billed by **{% data variables.product.prodname_pru %}** usage, like {% data variables.copilot.copilot_cloud_agent %}, cost centers are charged based on the **users** in the cost center, or the **organization that granted the user's {% data variables.product.prodname_copilot %} license** if the user isn't directly assigned to a cost center. Cost centers only apply to metered usage, and do not work with volume or subscription billing. diff --git a/data/reusables/billing/premium-request-analytics-start.md b/data/reusables/billing/premium-request-analytics-start.md index c052161099ae..915b23e7e897 100644 --- a/data/reusables/billing/premium-request-analytics-start.md +++ b/data/reusables/billing/premium-request-analytics-start.md @@ -1,5 +1,5 @@ > [!NOTE] -> Premium request analytics data are available from **August 1, 2025** onward. Separate usage data for features that use premium requests is available from **November 1, 2025** for {% data variables.product.prodname_copilot_short %}, {% data variables.product.prodname_spark_short %}, and {% data variables.copilot.copilot_coding_agent %}. +> Premium request analytics data are available from **August 1, 2025** onward. Separate usage data for features that use premium requests is available from **November 1, 2025** for {% data variables.product.prodname_copilot_short %}, {% data variables.product.prodname_spark_short %}, and {% data variables.copilot.copilot_cloud_agent %}. User-level analytics have different access permissions depending on your role. diff --git a/data/reusables/billing/pru-sku-split-notice.md b/data/reusables/billing/pru-sku-split-notice.md index eeefcba841b9..5a13cc281738 100644 --- a/data/reusables/billing/pru-sku-split-notice.md +++ b/data/reusables/billing/pru-sku-split-notice.md @@ -1 +1 @@ -Premium requests for {% data variables.product.prodname_spark_short %} and {% data variables.copilot.copilot_coding_agent %} are tracked in dedicated SKUs from November 1, 2025. This provides better cost visibility and budget control for each AI product. +Premium requests for {% data variables.product.prodname_spark_short %} and {% data variables.copilot.copilot_cloud_agent %} are tracked in dedicated SKUs from November 1, 2025. This provides better cost visibility and budget control for each AI product. diff --git a/data/reusables/code-quality/fix-findings-with-coding-agent.md b/data/reusables/code-quality/fix-findings-with-cloud-agent.md similarity index 64% rename from data/reusables/code-quality/fix-findings-with-coding-agent.md rename to data/reusables/code-quality/fix-findings-with-cloud-agent.md index 974b8cb7fbd4..03d4f4add638 100644 --- a/data/reusables/code-quality/fix-findings-with-coding-agent.md +++ b/data/reusables/code-quality/fix-findings-with-cloud-agent.md @@ -1,13 +1,13 @@ -Alternatively, if you have a {% data variables.product.prodname_copilot_short %} license, you can delegate the remediation work to {% data variables.copilot.copilot_coding_agent %}. Comment on the pull request mentioning `@{% data variables.product.prodname_copilot_short %}` and request that {% data variables.product.prodname_copilot_short %} fix the detected issues. +Alternatively, if you have a {% data variables.product.prodname_copilot_short %} license, you can delegate the remediation work to {% data variables.copilot.copilot_cloud_agent %}. Comment on the pull request mentioning `@{% data variables.product.prodname_copilot_short %}` and request that {% data variables.product.prodname_copilot_short %} fix the detected issues. - + {% data variables.product.prodname_copilot_short %} responds with an eyes emoji (👀) to your comment, starts a new agent session, and opens a pull request with the necessary fixes. -You can track {% data variables.copilot.copilot_coding_agent %}'s work: +You can track {% data variables.copilot.copilot_cloud_agent %}'s work: * In the pull request, the summary is updated as work progresses. -* Using the [agents page](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) or session logs, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/track-copilot-sessions). +* Using the [agents page](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) or session logs, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). -You need a {% data variables.product.prodname_copilot_short %} license to invoke {% data variables.copilot.copilot_coding_agent %}. +You need a {% data variables.product.prodname_copilot_short %} license to invoke {% data variables.copilot.copilot_cloud_agent %}.
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 aria-label="link-external" %} diff --git a/data/reusables/copilot/change-the-ai-model-copilot-coding-agent.md b/data/reusables/copilot/change-the-ai-model-copilot-cloud-agent.md similarity index 83% rename from data/reusables/copilot/change-the-ai-model-copilot-coding-agent.md rename to data/reusables/copilot/change-the-ai-model-copilot-cloud-agent.md index 6eed3e0c72c0..c5c10f4e88b4 100644 --- a/data/reusables/copilot/change-the-ai-model-copilot-coding-agent.md +++ b/data/reusables/copilot/change-the-ai-model-copilot-cloud-agent.md @@ -1 +1 @@ -You can change the model {% data variables.product.prodname_copilot_short %} uses. You may find that different models perform better, or provide more useful responses, depending on the type of task you give Copilot. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/changing-the-ai-model). +You can change the model {% data variables.product.prodname_copilot_short %} uses. You may find that different models perform better, or provide more useful responses, depending on the type of task you give Copilot. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). diff --git a/data/reusables/copilot/cloud-agent-emu-limitation.md b/data/reusables/copilot/cloud-agent-emu-limitation.md new file mode 100644 index 000000000000..890be043a382 --- /dev/null +++ b/data/reusables/copilot/cloud-agent-emu-limitation.md @@ -0,0 +1,3 @@ +{% data variables.copilot.copilot_cloud_agent %} is not available in personal repositories owned by {% data variables.enterprise.prodname_managed_users %}. This is because {% data variables.copilot.copilot_cloud_agent %} runs on {% data variables.product.company_short %}-hosted runners, which are not available to personal repositories owned by {% data variables.enterprise.prodname_managed_users %}. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners). + + diff --git a/data/reusables/copilot/coding-agent-required-hosts.md b/data/reusables/copilot/cloud-agent-required-hosts.md similarity index 83% rename from data/reusables/copilot/coding-agent-required-hosts.md rename to data/reusables/copilot/cloud-agent-required-hosts.md index 623d382d795f..70239a95533f 100644 --- a/data/reusables/copilot/coding-agent-required-hosts.md +++ b/data/reusables/copilot/cloud-agent-required-hosts.md @@ -1,8 +1,8 @@ * `uploads.github.com` * `user-images.githubusercontent.com` -* `api.individual.githubcopilot.com` (if you expect {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} users to use {% data variables.copilot.copilot_coding_agent %} in your repository) -* `api.business.githubcopilot.com` (if you expect {% data variables.copilot.copilot_business_short %} users to use {% data variables.copilot.copilot_coding_agent %} in your repository) -* `api.enterprise.githubcopilot.com` (if you expect {% data variables.copilot.copilot_enterprise_short %} users to use {% data variables.copilot.copilot_coding_agent %} in your repository) +* `api.individual.githubcopilot.com` (if you expect {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} users to use {% data variables.copilot.copilot_cloud_agent %} in your repository) +* `api.business.githubcopilot.com` (if you expect {% data variables.copilot.copilot_business_short %} users to use {% data variables.copilot.copilot_cloud_agent %} in your repository) +* `api.enterprise.githubcopilot.com` (if you expect {% data variables.copilot.copilot_enterprise_short %} users to use {% data variables.copilot.copilot_cloud_agent %} in your repository) * If you are using the {% data variables.product.prodname_openai_codex %} third-party agent (for more information, see [AUTOTITLE](/copilot/concepts/agents/about-third-party-agents)): * `npmjs.org` * `npmjs.com` diff --git a/data/reusables/copilot/coding-agent-settings.md b/data/reusables/copilot/cloud-agent-settings.md similarity index 71% rename from data/reusables/copilot/coding-agent-settings.md rename to data/reusables/copilot/cloud-agent-settings.md index 939f9c001f03..246489e5e4fc 100644 --- a/data/reusables/copilot/coding-agent-settings.md +++ b/data/reusables/copilot/cloud-agent-settings.md @@ -1 +1 @@ -1. In the sidebar, under "Code, planning, and automation", click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**, and then click **{% data variables.copilot.copilot_coding_agent_short_cap_c %}**. +1. In the sidebar, under "Code, planning, and automation", click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**, and then click **{% data variables.copilot.copilot_cloud_agent_short_cap_c %}**. diff --git a/data/reusables/copilot/cloud-agent-validation-tools-intro.md b/data/reusables/copilot/cloud-agent-validation-tools-intro.md new file mode 100644 index 000000000000..4c466781bf21 --- /dev/null +++ b/data/reusables/copilot/cloud-agent-validation-tools-intro.md @@ -0,0 +1 @@ +By default, {% data variables.copilot.copilot_cloud_agent %} checks code it generates for security issues and gets a second opinion on its code with {% data variables.copilot.copilot_code-review_short %}. It attempts to resolve issues identified prior to completing the pull request. This improves code quality and reduces the likelihood of the code generated by {% data variables.copilot.copilot_cloud_agent %} introducing problems such as hardcoded secrets, insecure dependencies, and other vulnerabilities. \ No newline at end of file diff --git a/data/reusables/copilot/coding-agent-workflow-run-approval-default.md b/data/reusables/copilot/cloud-agent-workflow-run-approval-default.md similarity index 77% rename from data/reusables/copilot/coding-agent-workflow-run-approval-default.md rename to data/reusables/copilot/cloud-agent-workflow-run-approval-default.md index 1b7685a58775..8af988bb35ef 100644 --- a/data/reusables/copilot/coding-agent-workflow-run-approval-default.md +++ b/data/reusables/copilot/cloud-agent-workflow-run-approval-default.md @@ -4,6 +4,6 @@ By default, {% data variables.product.prodname_actions %} workflows will not run To allow {% data variables.product.prodname_actions %} workflows to run, click the **Approve and run workflows** button in the pull request's merge box. - + -Optionally, you can configure {% data variables.copilot.copilot_coding_agent %} to allow {% data variables.product.prodname_actions %} workflows to run without human intervention. \ No newline at end of file +Optionally, you can configure {% data variables.copilot.copilot_cloud_agent %} to allow {% data variables.product.prodname_actions %} workflows to run without human intervention. \ No newline at end of file diff --git a/data/reusables/copilot/cloud-agent/agent-management-intro.md b/data/reusables/copilot/cloud-agent/agent-management-intro.md new file mode 100644 index 000000000000..0d83cdc866cd --- /dev/null +++ b/data/reusables/copilot/cloud-agent/agent-management-intro.md @@ -0,0 +1 @@ +When utilizing {% data variables.product.github %}'s agentic features, you can use the **Agents** tab within a repository that has {% data variables.copilot.copilot_cloud_agent %} enabled to initiate, monitor, and manage agent sessions without leaving your workflow. You can also use the [Agents page](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) to view and start agent sessions. To learn how to enable {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/access-management). diff --git a/data/reusables/copilot/coding-agent/create-hooks-instructions.md b/data/reusables/copilot/cloud-agent/create-hooks-instructions.md similarity index 91% rename from data/reusables/copilot/coding-agent/create-hooks-instructions.md rename to data/reusables/copilot/cloud-agent/create-hooks-instructions.md index d72fc05da5d2..adc4994ffb59 100644 --- a/data/reusables/copilot/coding-agent/create-hooks-instructions.md +++ b/data/reusables/copilot/cloud-agent/create-hooks-instructions.md @@ -1,4 +1,4 @@ -1. Create a new `hooks.json` file with the name of your choice in the `.github/hooks/` folder of your repository. The hooks configuration file **must be present** on your repository's default branch to be used by {% data variables.copilot.copilot_coding_agent %}. For {% data variables.copilot.copilot_cli %}, hooks are loaded from your current working directory. +1. Create a new `hooks.json` file with the name of your choice in the `.github/hooks/` folder of your repository. The hooks configuration file **must be present** on your repository's default branch to be used by {% data variables.copilot.copilot_cloud_agent %}. For {% data variables.copilot.copilot_cli %}, hooks are loaded from your current working directory. 1. In your text editor, copy and paste the following hook template. Remove any hooks you don't plan on using from the `hooks` array. diff --git a/data/reusables/copilot/coding-agent/custom-allowlist-add-entries.md b/data/reusables/copilot/cloud-agent/custom-allowlist-add-entries.md similarity index 100% rename from data/reusables/copilot/coding-agent/custom-allowlist-add-entries.md rename to data/reusables/copilot/cloud-agent/custom-allowlist-add-entries.md diff --git a/data/reusables/copilot/cloud-agent/enabling-for-orgs-and-enterprises.md b/data/reusables/copilot/cloud-agent/enabling-for-orgs-and-enterprises.md new file mode 100644 index 000000000000..b7c148c2e207 --- /dev/null +++ b/data/reusables/copilot/cloud-agent/enabling-for-orgs-and-enterprises.md @@ -0,0 +1,3 @@ +For {% data variables.copilot.copilot_for_business %} and {% data variables.copilot.copilot_enterprise %} subscribers, the ability to use {% data variables.copilot.copilot_cloud_agent %} is controlled by policy settings defined at the organization level. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent). + +If the organization is owned by an enterprise, enablement may be controlled at the enterprise level. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-cloud-agent). diff --git a/data/reusables/copilot/coding-agent/hooks-intro.md b/data/reusables/copilot/cloud-agent/hooks-intro.md similarity index 75% rename from data/reusables/copilot/coding-agent/hooks-intro.md rename to data/reusables/copilot/cloud-agent/hooks-intro.md index e848233e02f8..6d91fd40fcfd 100644 --- a/data/reusables/copilot/coding-agent/hooks-intro.md +++ b/data/reusables/copilot/cloud-agent/hooks-intro.md @@ -1 +1 @@ -Hooks allow you to extend and customize the behavior of {% data variables.product.prodname_copilot %} agents by executing custom shell commands at key points during agent execution. For a conceptual overview of hooks—including details of the available hook triggers—see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-hooks). +Hooks allow you to extend and customize the behavior of {% data variables.product.prodname_copilot %} agents by executing custom shell commands at key points during agent execution. For a conceptual overview of hooks—including details of the available hook triggers—see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-hooks). diff --git a/data/reusables/copilot/coding-agent/mcp-brief-intro.md b/data/reusables/copilot/cloud-agent/mcp-brief-intro.md similarity index 81% rename from data/reusables/copilot/coding-agent/mcp-brief-intro.md rename to data/reusables/copilot/cloud-agent/mcp-brief-intro.md index bf2c963ce4ba..0975dde4ee95 100644 --- a/data/reusables/copilot/coding-agent/mcp-brief-intro.md +++ b/data/reusables/copilot/cloud-agent/mcp-brief-intro.md @@ -1,3 +1,3 @@ The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to connect AI models to different data sources and tools, enabling them to work together more effectively. -You can use MCP to extend the capabilities of {% data variables.copilot.copilot_coding_agent %} by connecting it to other tools and services. +You can use MCP to extend the capabilities of {% data variables.copilot.copilot_cloud_agent %} by connecting it to other tools and services. diff --git a/data/reusables/copilot/coding-agent/monitoring-progress-heading.md b/data/reusables/copilot/cloud-agent/monitoring-progress-heading.md similarity index 82% rename from data/reusables/copilot/coding-agent/monitoring-progress-heading.md rename to data/reusables/copilot/cloud-agent/monitoring-progress-heading.md index 53e9a58d4dec..b748afe30e10 100644 --- a/data/reusables/copilot/coding-agent/monitoring-progress-heading.md +++ b/data/reusables/copilot/cloud-agent/monitoring-progress-heading.md @@ -1,3 +1,3 @@ ## Monitoring progress -You can view your current and past {% data variables.product.prodname_copilot_short %} sessions from the agents panel, [agents page](https://github.com/copilot/agents), {% data variables.product.prodname_vscode %}, and more. See [AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions). +You can view your current and past {% data variables.product.prodname_copilot_short %} sessions from the agents panel, [agents page](https://github.com/copilot/agents), {% data variables.product.prodname_vscode %}, and more. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions). diff --git a/data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md b/data/reusables/copilot/cloud-agent/new-agent-task-form-instructions.md similarity index 94% rename from data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md rename to data/reusables/copilot/cloud-agent/new-agent-task-form-instructions.md index 95b0e976c598..82e6f5bf653e 100644 --- a/data/reusables/copilot/coding-agent/new-agent-task-form-instructions.md +++ b/data/reusables/copilot/cloud-agent/new-agent-task-form-instructions.md @@ -5,7 +5,7 @@ 1. Optionally, select a base branch for {% data variables.product.prodname_copilot_short %}'s pull request. {% data variables.product.prodname_copilot_short %} will create a new branch based on this branch, then push the changes to a pull request targeting that branch. {% data reusables.copilot.optional-select-custom-agent-dotcom %} -{% data reusables.copilot.optional-select-copilot-coding-agent-model %} +{% data reusables.copilot.optional-select-copilot-cloud-agent-model %} 1. Click **{% octicon "paper-airplane" aria-label="Start task" %}** or press Enter. {% data variables.product.prodname_copilot_short %} will start a new session, which will appear in the list below the prompt box. {% data variables.product.prodname_copilot_short %} will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification. diff --git a/data/reusables/copilot/coding-agent/raycast-intro.md b/data/reusables/copilot/cloud-agent/raycast-intro.md similarity index 62% rename from data/reusables/copilot/coding-agent/raycast-intro.md rename to data/reusables/copilot/cloud-agent/raycast-intro.md index 7c7bfa345150..bc60e1543365 100644 --- a/data/reusables/copilot/coding-agent/raycast-intro.md +++ b/data/reusables/copilot/cloud-agent/raycast-intro.md @@ -1 +1 @@ -[Raycast](https://www.raycast.com/) is an extensible launcher for Windows and macOS. With the {% data variables.product.prodname_copilot %} extension for Raycast, you can start and track {% data variables.copilot.copilot_coding_agent %} tasks and watch session logs live wherever you are on your computer. +[Raycast](https://www.raycast.com/) is an extensible launcher for Windows and macOS. With the {% data variables.product.prodname_copilot %} extension for Raycast, you can start and track {% data variables.copilot.copilot_cloud_agent %} tasks and watch session logs live wherever you are on your computer. diff --git a/data/reusables/copilot/coding-agent/raycast-oauth-access-restrictions.md b/data/reusables/copilot/cloud-agent/raycast-oauth-access-restrictions.md similarity index 100% rename from data/reusables/copilot/coding-agent/raycast-oauth-access-restrictions.md rename to data/reusables/copilot/cloud-agent/raycast-oauth-access-restrictions.md diff --git a/data/reusables/copilot/coding-agent/raycast-setup.md b/data/reusables/copilot/cloud-agent/raycast-setup.md similarity index 100% rename from data/reusables/copilot/coding-agent/raycast-setup.md rename to data/reusables/copilot/cloud-agent/raycast-setup.md diff --git a/data/reusables/copilot/coding-agent/troubleshoot-hooks.md b/data/reusables/copilot/cloud-agent/troubleshoot-hooks.md similarity index 100% rename from data/reusables/copilot/coding-agent/troubleshoot-hooks.md rename to data/reusables/copilot/cloud-agent/troubleshoot-hooks.md diff --git a/data/reusables/copilot/coding-agent/use-chat-participant-in-vsc.md b/data/reusables/copilot/cloud-agent/use-chat-participant-in-vsc.md similarity index 100% rename from data/reusables/copilot/coding-agent/use-chat-participant-in-vsc.md rename to data/reusables/copilot/cloud-agent/use-chat-participant-in-vsc.md diff --git a/data/reusables/copilot/coding-agent/use-latest-vscode.md b/data/reusables/copilot/cloud-agent/use-latest-vscode.md similarity index 100% rename from data/reusables/copilot/coding-agent/use-latest-vscode.md rename to data/reusables/copilot/cloud-agent/use-latest-vscode.md diff --git a/data/reusables/copilot/cloud-agent/what-is.md b/data/reusables/copilot/cloud-agent/what-is.md new file mode 100644 index 000000000000..0c836f670268 --- /dev/null +++ b/data/reusables/copilot/cloud-agent/what-is.md @@ -0,0 +1 @@ +{% data variables.copilot.copilot_cloud_agent %} is an AI-powered software development agent that can work autonomously on issues or developer requests. It raises draft pull requests to propose a fix and iterates on the changes in response to feedback. diff --git a/data/reusables/copilot/coding-agent/write-access-required.md b/data/reusables/copilot/cloud-agent/write-access-required.md similarity index 100% rename from data/reusables/copilot/coding-agent/write-access-required.md rename to data/reusables/copilot/cloud-agent/write-access-required.md diff --git a/data/reusables/copilot/code-review/custom-instructions-limit.md b/data/reusables/copilot/code-review/custom-instructions-limit.md index 27650d27175f..86ec2eb08fc1 100644 --- a/data/reusables/copilot/code-review/custom-instructions-limit.md +++ b/data/reusables/copilot/code-review/custom-instructions-limit.md @@ -1,3 +1,3 @@ > [!NOTE] -> * {% data variables.copilot.copilot_code-review_short %} only reads the first 4,000 characters of any custom instruction file. Any instructions beyond this limit will not affect the reviews generated by {% data variables.copilot.copilot_code-review_short %}. This limit does not apply to {% data variables.copilot.copilot_chat_short %} or {% data variables.copilot.copilot_coding_agent %}. +> * {% data variables.copilot.copilot_code-review_short %} only reads the first 4,000 characters of any custom instruction file. Any instructions beyond this limit will not affect the reviews generated by {% data variables.copilot.copilot_code-review_short %}. This limit does not apply to {% data variables.copilot.copilot_chat_short %} or {% data variables.copilot.copilot_cloud_agent %}. > * {% data reusables.copilot.code-review.custom-instructions-branch %} diff --git a/data/reusables/copilot/coding-agent-emu-limitation.md b/data/reusables/copilot/coding-agent-emu-limitation.md deleted file mode 100644 index 3d1199a1562f..000000000000 --- a/data/reusables/copilot/coding-agent-emu-limitation.md +++ /dev/null @@ -1,3 +0,0 @@ -{% data variables.copilot.copilot_coding_agent %} is not available in personal repositories owned by {% data variables.enterprise.prodname_managed_users %}. This is because {% data variables.copilot.copilot_coding_agent %} runs on {% data variables.product.company_short %}-hosted runners, which are not available to personal repositories owned by {% data variables.enterprise.prodname_managed_users %}. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/using-github-hosted-runners/about-github-hosted-runners). - - diff --git a/data/reusables/copilot/coding-agent-validation-tools-intro.md b/data/reusables/copilot/coding-agent-validation-tools-intro.md deleted file mode 100644 index 321d22afb437..000000000000 --- a/data/reusables/copilot/coding-agent-validation-tools-intro.md +++ /dev/null @@ -1 +0,0 @@ -By default, {% data variables.copilot.copilot_coding_agent %} checks code it generates for security issues and gets a second opinion on its code with {% data variables.copilot.copilot_code-review_short %}. It attempts to resolve issues identified prior to completing the pull request. This improves code quality and reduces the likelihood of the code generated by {% data variables.copilot.copilot_coding_agent %} introducing problems such as hardcoded secrets, insecure dependencies, and other vulnerabilities. \ No newline at end of file diff --git a/data/reusables/copilot/coding-agent/agent-management-intro.md b/data/reusables/copilot/coding-agent/agent-management-intro.md deleted file mode 100644 index 6cdf8cd973ea..000000000000 --- a/data/reusables/copilot/coding-agent/agent-management-intro.md +++ /dev/null @@ -1 +0,0 @@ -When utilizing {% data variables.product.github %}'s agentic features, you can use the **Agents** tab within a repository that has {% data variables.copilot.copilot_coding_agent %} enabled to initiate, monitor, and manage agent sessions without leaving your workflow. You can also use the [Agents page](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) to view and start agent sessions. To learn how to enable {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/access-management). diff --git a/data/reusables/copilot/coding-agent/enabling-for-orgs-and-enterprises.md b/data/reusables/copilot/coding-agent/enabling-for-orgs-and-enterprises.md deleted file mode 100644 index 373348271612..000000000000 --- a/data/reusables/copilot/coding-agent/enabling-for-orgs-and-enterprises.md +++ /dev/null @@ -1,3 +0,0 @@ -For {% data variables.copilot.copilot_for_business %} and {% data variables.copilot.copilot_enterprise %} subscribers, the ability to use {% data variables.copilot.copilot_coding_agent %} is controlled by policy settings defined at the organization level. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/adding-copilot-coding-agent-to-organization). - -If the organization is owned by an enterprise, enablement may be controlled at the enterprise level. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-copilot-coding-agent-in-your-enterprise). diff --git a/data/reusables/copilot/coding-agent/what-is.md b/data/reusables/copilot/coding-agent/what-is.md deleted file mode 100644 index af011f6b662c..000000000000 --- a/data/reusables/copilot/coding-agent/what-is.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.copilot.copilot_coding_agent %} is an AI-powered software development agent that can work autonomously on issues or developer requests. It raises draft pull requests to propose a fix and iterates on the changes in response to feedback. diff --git a/data/reusables/copilot/copilot-coding-agent-auto-models.md b/data/reusables/copilot/copilot-cloud-agent-auto-models.md similarity index 100% rename from data/reusables/copilot/copilot-coding-agent-auto-models.md rename to data/reusables/copilot/copilot-cloud-agent-auto-models.md diff --git a/data/reusables/copilot/copilot-coding-agent-non-auto-models.md b/data/reusables/copilot/copilot-cloud-agent-non-auto-models.md similarity index 100% rename from data/reusables/copilot/copilot-coding-agent-non-auto-models.md rename to data/reusables/copilot/copilot-cloud-agent-non-auto-models.md diff --git a/data/reusables/copilot/custom-agents-further-reading.md b/data/reusables/copilot/custom-agents-further-reading.md index 9658aa2ea14f..84ce885c8a51 100644 --- a/data/reusables/copilot/custom-agents-further-reading.md +++ b/data/reusables/copilot/custom-agents-further-reading.md @@ -1,5 +1,5 @@ ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents) -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents) +* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents) * [AUTOTITLE](/copilot/reference/custom-agents-configuration) diff --git a/data/reusables/copilot/custom-instructions-org-support.md b/data/reusables/copilot/custom-instructions-org-support.md index 05f71b655372..1d3b5cc5c31d 100644 --- a/data/reusables/copilot/custom-instructions-org-support.md +++ b/data/reusables/copilot/custom-instructions-org-support.md @@ -1,2 +1,2 @@ > [!NOTE] -> **Support:** Organization custom instructions are currently only supported for {% data variables.copilot.copilot_chat_short %} on {% data variables.product.prodname_dotcom_the_website %}, {% data variables.copilot.copilot_code-review_short %} on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.copilot.copilot_coding_agent %} on {% data variables.product.prodname_dotcom_the_website %}. +> **Support:** Organization custom instructions are currently only supported for {% data variables.copilot.copilot_chat_short %} on {% data variables.product.prodname_dotcom_the_website %}, {% data variables.copilot.copilot_code-review_short %} on {% data variables.product.prodname_dotcom_the_website %} and {% data variables.copilot.copilot_cloud_agent %} on {% data variables.product.prodname_dotcom_the_website %}. diff --git a/data/reusables/copilot/custom-instructions-path.md b/data/reusables/copilot/custom-instructions-path.md index 8a7e0a30c8a6..2412c0fe000b 100644 --- a/data/reusables/copilot/custom-instructions-path.md +++ b/data/reusables/copilot/custom-instructions-path.md @@ -29,9 +29,9 @@ * `src/**/*.py` - will recursively match all `.py` files in the `src` directory. For example, `src/foo.py`, `src/foo/bar.py`, and `src/foo/bar/baz.py`. * `**/subdir/**/*.py` - will recursively match all `.py` files in any `subdir` directory at any depth. For example, `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py`, and `deep/parent/subdir/nested/qux.py`, but _not_ `foo.py` at a path that does not contain a `subdir` directory. -1. Optionally, to prevent the file from being used by either {% data variables.copilot.copilot_coding_agent %} or {% data variables.copilot.copilot_code-review_short %}, add the `excludeAgent` keyword to the frontmatter block. Use either `"code-review"` or `"coding-agent"`. +1. Optionally, to prevent the file from being used by either {% data variables.copilot.copilot_cloud_agent %} or {% data variables.copilot.copilot_code-review_short %}, add the `excludeAgent` keyword to the frontmatter block. Use either `"code-review"` or `"cloud-agent"`. - For example, the following file will only be read by {% data variables.copilot.copilot_coding_agent %}. + For example, the following file will only be read by {% data variables.copilot.copilot_cloud_agent %}. ```markdown --- @@ -40,6 +40,6 @@ --- ``` - If the `excludeAgent` keyword is not included in the front matterblock, both {% data variables.copilot.copilot_code-review_short %} and {% data variables.copilot.copilot_coding_agent %} will use your instructions. + If the `excludeAgent` keyword is not included in the front matterblock, both {% data variables.copilot.copilot_code-review_short %} and {% data variables.copilot.copilot_cloud_agent %} will use your instructions. 1. Add your custom instructions in natural language, using Markdown format. Whitespace between instructions is ignored, so the instructions can be written as a single paragraph, each on a new line, or separated by blank lines for legibility. diff --git a/data/reusables/copilot/differences-cfi-cfb-table.md b/data/reusables/copilot/differences-cfi-cfb-table.md index b17202870aa1..2214a4bfe130 100644 --- a/data/reusables/copilot/differences-cfi-cfb-table.md +++ b/data/reusables/copilot/differences-cfi-cfb-table.md @@ -14,7 +14,7 @@ | Agents | {% data variables.copilot.copilot_free_short %} | {% data variables.copilot.copilot_student_short %} | {% data variables.copilot.copilot_pro_short %} | {% data variables.copilot.copilot_pro_plus_short %} | {% data variables.copilot.copilot_business_short %} | {% data variables.copilot.copilot_enterprise_short %} | | --- | --- | --- | --- | --- | --- | --- | -| {% data variables.copilot.copilot_coding_agent %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | +| {% data variables.copilot.copilot_cloud_agent %} | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | Agent mode | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | {% data variables.product.prodname_copilot_short %} code review | Only "Review selection" in {% data variables.product.prodname_vscode_shortname %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | | Model Context Protocol (MCP) | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | {% octicon "check" aria-label="Included" %} | diff --git a/data/reusables/copilot/mcp/cloud-agent-limitations.md b/data/reusables/copilot/mcp/cloud-agent-limitations.md new file mode 100644 index 000000000000..54f609ba86d5 --- /dev/null +++ b/data/reusables/copilot/mcp/cloud-agent-limitations.md @@ -0,0 +1,3 @@ +> [!NOTE] +> * {% data variables.copilot.copilot_cloud_agent %} only supports tools provided by MCP servers. It does not support resources or prompts. +> * {% data variables.copilot.copilot_cloud_agent %} does not currently support remote MCP servers that leverage OAuth for authentication and authorization. diff --git a/data/reusables/copilot/mcp/coding-agent-limitations.md b/data/reusables/copilot/mcp/coding-agent-limitations.md deleted file mode 100644 index 92b8cf568f14..000000000000 --- a/data/reusables/copilot/mcp/coding-agent-limitations.md +++ /dev/null @@ -1,3 +0,0 @@ -> [!NOTE] -> * {% data variables.copilot.copilot_coding_agent %} only supports tools provided by MCP servers. It does not support resources or prompts. -> * {% data variables.copilot.copilot_coding_agent %} does not currently support remote MCP servers that leverage OAuth for authentication and authorization. diff --git a/data/reusables/copilot/optional-select-copilot-coding-agent-model.md b/data/reusables/copilot/optional-select-copilot-cloud-agent-model.md similarity index 72% rename from data/reusables/copilot/optional-select-copilot-coding-agent-model.md rename to data/reusables/copilot/optional-select-copilot-cloud-agent-model.md index 7e14bea59112..4ff7d3c3b39a 100644 --- a/data/reusables/copilot/optional-select-copilot-coding-agent-model.md +++ b/data/reusables/copilot/optional-select-copilot-cloud-agent-model.md @@ -1 +1 @@ -1. Optionally, if you are a {% data variables.copilot.copilot_pro %} or {% data variables.copilot.copilot_pro_plus %} user, you can use the dropdown menu to select the model that {% data variables.product.prodname_copilot_short %} will use. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/changing-the-ai-model). \ No newline at end of file +1. Optionally, if you are a {% data variables.copilot.copilot_pro %} or {% data variables.copilot.copilot_pro_plus %} user, you can use the dropdown menu to select the model that {% data variables.product.prodname_copilot_short %} will use. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). \ No newline at end of file diff --git a/data/reusables/copilot/optional-select-custom-agent-dotcom.md b/data/reusables/copilot/optional-select-custom-agent-dotcom.md index f623ea42a80f..485199a6bb2d 100644 --- a/data/reusables/copilot/optional-select-custom-agent-dotcom.md +++ b/data/reusables/copilot/optional-select-custom-agent-dotcom.md @@ -1,2 +1,2 @@ -1. Optionally, you can click {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} to open the agent dropdown menu, if you want to assign an agent or a {% data variables.copilot.copilot_custom_agent_short %} with specialized behavior and tools. You can select an existing {% data variables.copilot.copilot_custom_agent_short %} from your repository, organization, or enterprise. You can also click **{% octicon "plus" aria-label="Plus button" %} Create an agent** to create a new {% data variables.copilot.agent_profile %} in your selected repository and branch. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). +1. Optionally, you can click {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} to open the agent dropdown menu, if you want to assign an agent or a {% data variables.copilot.copilot_custom_agent_short %} with specialized behavior and tools. You can select an existing {% data variables.copilot.copilot_custom_agent_short %} from your repository, organization, or enterprise. You can also click **{% octicon "plus" aria-label="Plus button" %} Create an agent** to create a new {% data variables.copilot.agent_profile %} in your selected repository and branch. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). > [!NOTE] Third-party coding agents are available in the {% data variables.copilot.copilot_pro_plus %} and {% data variables.copilot.copilot_enterprise_short %} plans. diff --git a/data/reusables/copilot/optional-select-custom-agent-generic.md b/data/reusables/copilot/optional-select-custom-agent-generic.md index 01cf636de879..4e59de73ccc0 100644 --- a/data/reusables/copilot/optional-select-custom-agent-generic.md +++ b/data/reusables/copilot/optional-select-custom-agent-generic.md @@ -1 +1 @@ -1. Optionally, select a {% data variables.copilot.copilot_custom_agent_short %} with specialized behavior and tools from the dropdown menu. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). \ No newline at end of file +1. Optionally, select a {% data variables.copilot.copilot_custom_agent_short %} with specialized behavior and tools from the dropdown menu. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents). \ No newline at end of file diff --git a/data/reusables/copilot/repository-custom-instructions-types.md b/data/reusables/copilot/repository-custom-instructions-types.md index 8cc5d7bb9711..9fbbf1ebbbaf 100644 --- a/data/reusables/copilot/repository-custom-instructions-types.md +++ b/data/reusables/copilot/repository-custom-instructions-types.md @@ -1,4 +1,4 @@ You can create repository custom instructions in two ways: * **Repository-wide instructions**: Create a single `copilot-instructions.md` file at the repository root that applies to all files in the repository. -* **Path-specific instructions**: Create one or more `.instructions.md` files with an `applyTo` field that apply only to specific files or directories. Path-specific instructions are currently supported for **{% data variables.copilot.copilot_chat_short %}** in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and **{% data variables.copilot.copilot_coding_agent %}**. +* **Path-specific instructions**: Create one or more `.instructions.md` files with an `applyTo` field that apply only to specific files or directories. Path-specific instructions are currently supported for **{% data variables.copilot.copilot_chat_short %}** in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, and **{% data variables.copilot.copilot_cloud_agent %}**. diff --git a/data/reusables/copilot/setup-next-steps.md b/data/reusables/copilot/setup-next-steps.md index 7bb6f25d2d08..9a4a493a63bd 100644 --- a/data/reusables/copilot/setup-next-steps.md +++ b/data/reusables/copilot/setup-next-steps.md @@ -1,4 +1,4 @@ * **Explore self-service license management options**. Many successful rollouts use a self-service model where developers can claim a license without approval. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/setting-up-a-self-serve-process-for-github-copilot-licenses). * **Learn how to plan and implement an effective enablement process to drive {% data variables.product.prodname_copilot_short %} adoption**. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company). * **Enhance the development experience by enabling and training developers on the latest features**. For example, share context with {% data variables.copilot.copilot_spaces %}, enable {% data variables.copilot.copilot_code-review_short %} on pull requests, and allow developers to experiment with prompts using {% data variables.product.prodname_github_models %}. For an example showing how these features fit together, see [AUTOTITLE](/copilot/tutorials/rolling-out-github-copilot-at-scale/enabling-developers/integrating-agentic-ai). -* **Add {% data variables.copilot.copilot_coding_agent %} as a team member for asynchronous issue work**. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/enabling-developers/using-copilot-coding-agent-in-org). +* **Add {% data variables.copilot.copilot_cloud_agent %} as a team member for asynchronous issue work**. See [AUTOTITLE](/copilot/tutorials/cloud-agent/pilot-cloud-agent). diff --git a/data/reusables/enterprise-onboarding/identify-role-requirements.md b/data/reusables/enterprise-onboarding/identify-role-requirements.md index df9d22db338b..f58f371fbe03 100644 --- a/data/reusables/enterprise-onboarding/identify-role-requirements.md +++ b/data/reusables/enterprise-onboarding/identify-role-requirements.md @@ -66,7 +66,7 @@ For more information about what apps can do, see [AUTOTITLE](/apps/creating-gith ## 6. Assign tasks to agents -Another way to delegate frequent, time-consuming tasks is to assign work to {% data variables.copilot.copilot_coding_agent %}. You can define custom agents for specific roles in your enterprise. Custom agents are created using Markdown files called "agent profiles," which define the instructions and tools the agent needs to perform a task. For example, you could create a {% data variables.copilot.copilot_custom_agent_short %} for writing README files or generating unit tests. +Another way to delegate frequent, time-consuming tasks is to assign work to {% data variables.copilot.copilot_cloud_agent %}. You can define custom agents for specific roles in your enterprise. Custom agents are created using Markdown files called "agent profiles," which define the instructions and tools the agent needs to perform a task. For example, you could create a {% data variables.copilot.copilot_custom_agent_short %} for writing README files or generating unit tests. For more information, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents). diff --git a/data/reusables/gated-features/copilot-cloud-agent.md b/data/reusables/gated-features/copilot-cloud-agent.md new file mode 100644 index 000000000000..2c9d695c6323 --- /dev/null +++ b/data/reusables/gated-features/copilot-cloud-agent.md @@ -0,0 +1 @@ +{% data variables.copilot.copilot_cloud_agent %} is available with the {% data variables.copilot.copilot_pro %}, {% data variables.copilot.copilot_pro_plus %}, {% data variables.copilot.copilot_for_business %} and {% data variables.copilot.copilot_enterprise %} plans. The agent is available in all repositories stored on {% data variables.product.github %}, except repositories owned by {% data variables.enterprise.prodname_managed_users %} and where it has been explicitly disabled. diff --git a/data/reusables/gated-features/copilot-coding-agent.md b/data/reusables/gated-features/copilot-coding-agent.md deleted file mode 100644 index 3d3477b05b19..000000000000 --- a/data/reusables/gated-features/copilot-coding-agent.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.copilot.copilot_coding_agent %} is available with the {% data variables.copilot.copilot_pro %}, {% data variables.copilot.copilot_pro_plus %}, {% data variables.copilot.copilot_for_business %} and {% data variables.copilot.copilot_enterprise %} plans. The agent is available in all repositories stored on {% data variables.product.github %}, except repositories owned by {% data variables.enterprise.prodname_managed_users %} and where it has been explicitly disabled. diff --git a/data/reusables/repositories/rulesets-bypass-step.md b/data/reusables/repositories/rulesets-bypass-step.md index 0583e4064575..a9dad6526282 100644 --- a/data/reusables/repositories/rulesets-bypass-step.md +++ b/data/reusables/repositories/rulesets-bypass-step.md @@ -10,7 +10,7 @@ You can grant certain roles, teams, or apps bypass permissions {% ifversion push * {% data variables.product.prodname_github_apps %} * {% data variables.product.prodname_dependabot %}. For more information about {% data variables.product.prodname_dependabot %}, see [AUTOTITLE](/code-security/getting-started/dependabot-quickstart-guide). {%- ifversion ghec %} -* {% data variables.copilot.copilot_coding_agent %}. For more information about {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-coding-agent#limitations-in-copilot-coding-agents-compatibility-with-other-features). +* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#limitations-in-copilot-cloud-agents-compatibility-with-other-features). {%- endif %} 1. To grant bypass permissions for the ruleset, in the "Bypass list" section, click **{% octicon "plus" aria-hidden="true" aria-label="plus" %} Add bypass**. diff --git a/data/variables/copilot.yml b/data/variables/copilot.yml index 3aaa08d30264..6b1717990d2f 100644 --- a/data/variables/copilot.yml +++ b/data/variables/copilot.yml @@ -44,10 +44,10 @@ copilot_code-review-tools-preview_cap: 'New tools (public preview) in GitHub Cop copilot_code-review-tools_short: 'tools in Copilot code review' copilot_code-review-tools_cap_short: 'Tools in Copilot code review' -## Copilot cloud agent (previously coding agent / Padawan) -> {% data variables.copilot.copilot_coding_agent %} -copilot_coding_agent: 'Copilot cloud agent' -copilot_coding_agent_short: 'cloud agent' -copilot_coding_agent_short_cap_c: 'Cloud agent' +## Copilot cloud agent (previously coding agent / Padawan) -> {% data variables.copilot.copilot_cloud_agent %} +copilot_cloud_agent: 'Copilot cloud agent' +copilot_cloud_agent_short: 'cloud agent' +copilot_cloud_agent_short_cap_c: 'Cloud agent' copilot_cloud_agent_tmp: 'Copilot cloud agent (formerly Copilot coding agent)' ## Short for "Copilot Extensions agent" -> {% data variables.copilot.copilot_agent_short %} diff --git a/src/ai-tools/README.md b/src/ai-tools/README.md index 4c9d7ef7225f..63a55d31d929 100644 --- a/src/ai-tools/README.md +++ b/src/ai-tools/README.md @@ -56,7 +56,7 @@ npm run ai-tools -- --refine versioning --files content/path/to/file.md Refine versioning in a file: ```bash -npm run ai-tools -- --files content/copilot/tutorials/coding-agent/get-the-best-results.md --refine versioning +npm run ai-tools -- --files content/copilot/tutorials/cloud-agent/get-the-best-results.md --refine versioning ``` Refine intro: diff --git a/src/ai-tools/prompts/intro.md b/src/ai-tools/prompts/intro.md index b6aec3c14da7..95e7b7488f87 100644 --- a/src/ai-tools/prompts/intro.md +++ b/src/ai-tools/prompts/intro.md @@ -38,8 +38,8 @@ Use this context to create specific, product-focused intros rather than generic **Content Summarization vs. Title Restatement**: ❌ **Avoid title restatement, corporate language, and version-specific Liquid**: -- Title: "Piloting GitHub Copilot coding agent in your organization" -- Poor intro: "Follow best practices to enable {% data variables.copilot.copilot_coding_agent %} in your organization" +- Title: "Piloting GitHub Copilot cloud agent in your organization" +- Poor intro: "Follow best practices to enable {% data variables.copilot.copilot_cloud_agent %} in your organization" - Also poor: "Implement a comprehensive Copilot rollout strategy covering license management, environment setup, training programs, and adoption metrics to drive successful enterprise-wide GitHub Copilot deployment and maximize developer productivity" ❌ **Avoid starting with similar words/phrases as the title**: @@ -48,12 +48,12 @@ Use this context to create specific, product-focused intros rather than generic - Better: "Use {% data variables.product.prodname_copilot %} chat and code completion to research syntax, practice coding, and master new programming languages faster" ✅ **Use concise, developer-friendly language ({% data variables.* %} OK)**: -- Better intro: "Evaluate use cases, configure security settings, and run pilot trials to deploy {% data variables.copilot.copilot_coding_agent %} in your org" +- Better intro: "Evaluate use cases, configure security settings, and run pilot trials to deploy {% data variables.copilot.copilot_cloud_agent %} in your org" ❌ **Avoid overly long lists and colon constructions**: - Too long: "Scope issues, pick suitable tasks, iterate via PR comments, add repo instructions, enable MCP tools, and preinstall dependencies" - Colon problem: "Learn a new programming language with {% data variables.product.prodname_copilot %}: use {% data variables.copilot.copilot_chat_short %} to research syntax and tooling, build and explain small programs with {% data variables.product.prodname_copilot_short %} code completion, and translate familiar code to compare patterns" -- Better: "Scope tasks, configure custom instructions, and iterate on pull requests to improve {% data variables.copilot.copilot_coding_agent %} performance" +- Better: "Scope tasks, configure custom instructions, and iterate on pull requests to improve {% data variables.copilot.copilot_cloud_agent %} performance" - Better: "Use {% data variables.product.prodname_copilot %} features like chat and code completion to research syntax, build programs, and learn new programming languages faster" ## Quality Checklist