Restructure Copilot cloud agent docs into client-focused articles (#61355)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: timrogers <116134+timrogers@users.noreply.github.com>
Co-authored-by: Tim Rogers <me@timrogers.co.uk>
Co-authored-by: SiaraMist <siaramist@github.com>
Co-authored-by: Siara <108543037+SiaraMist@users.noreply.github.com>

Author: 3 people

content/code-security/tutorials/improve-code-quality/improve-recent-merges.md

@@ -72,7 +72,7 @@ There is a delay while the {% data variables.copilot.copilot_cloud_agent_short %
 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/cloud-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/copilot-on-github/use-copilot-agents/manage-and-track-agents).
 
 ### Open your own pull requests
 

content/copilot/concepts/agents/cloud-agent/agent-management.md

@@ -37,7 +37,7 @@ From the Agents tab, you can:
 * **Kick off new agent tasks**: Select an AI model of your choice, and optionally choose from third-party agents or {% data variables.copilot.custom_agents_short %} best suited for the task. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions).
 * **Monitor live session logs**: Once the agent starts working, you can click any agent session to open the session log and follow its progress and thought process in real time.
 * **Track active sessions**: You can view all active agent sessions that have been started in the repository.
-* **Steer agents mid-session**: If you realize you didn't scope a request correctly, or want the agent to use a specific tool or service, you can step in and provide **steering input** without stopping the run. Steering uses **one premium request** per message. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions#steering-a-copilot-session-from-the-agents-tab).
+* **Steer agents mid-session**: If you realize you didn't scope a request correctly, or want the agent to use a specific tool or service, you can step in and provide **steering input** without stopping the run. Steering uses **one premium request** per message. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents#steer-an-agent-session).
 * **Open a session in {% data variables.product.prodname_vscode_shortname %} or {% data variables.copilot.copilot_cli %}**: When you want to start working on changes to an agent session in your local development environment, click **{% octicon "vscode" aria-label="VS Code" %} Open in {% data variables.product.prodname_vscode_shortname %}** or **{% octicon "agent" aria-label="Agent" %} Continue in {% data variables.copilot.copilot_cli %}** to bring the session to your local machine.
     {% data reusables.copilot.cloud-agent.use-latest-vscode %}
 * **Review and merge agent code**: Once the agent completes a session, you can jump to the pull request to review the changes, request further improvements, or approve and merge. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/review-copilot-prs).

content/copilot/concepts/agents/cloud-agent/risks-and-mitigations.md

@@ -24,7 +24,7 @@ Where possible, {% data variables.product.github %} has applied appropriate miti
 * **{% data variables.product.prodname_codeql %}** is used to identify code security issues.
 * Newly introduced dependencies are checked against the **{% data variables.product.prodname_advisory_database %}** for malware advisories, and for any CVSS-rated High or Critical vulnerabilities.
 * **{% data variables.product.prodname_secret_scanning_caps %}** is used to detect sensitive information such as API keys, tokens, and other secrets.
-* Details about the analysis performed and the actions taken by {% data variables.copilot.copilot_cloud_agent %} can be reviewed in the session log. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).
+* Details about the analysis performed and the actions taken by {% data variables.copilot.copilot_cloud_agent %} can be reviewed in the session log. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).
 
 Optionally, you can disable one or more of the code quality and security validation tools used by {% data variables.copilot.copilot_cloud_agent %}. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings).
 
@@ -58,4 +58,4 @@ To mitigate this risk, {% data variables.copilot.copilot_cloud_agent %} is desig
 * {% data variables.copilot.copilot_cloud_agent %}'s commits are authored by {% data variables.product.prodname_copilot_short %}, with the developer who assigned the issue or requested the change to the pull request marked as the co-author. This makes it easier to identify code generated by {% data variables.copilot.copilot_cloud_agent %} and who started the task.
 * {% data variables.copilot.copilot_cloud_agent %}'s commits are signed, so they appear as "Verified" on {% data variables.product.github %}. This provides confidence that the commits were made by {% data variables.copilot.copilot_cloud_agent %} and have not been altered.
 * Session logs and audit log events are available to administrators.
-* The commit message for each agent-authored commit includes a link to the agent session logs, for code review and auditing. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).
+* The commit message for each agent-authored commit includes a link to the agent session logs, for code review and auditing. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).

content/copilot/concepts/completions/code-referencing.md

@@ -56,7 +56,7 @@ If you, or your organization, have allowed suggestions that match public code, t
 
 ### Code referencing for {% data variables.copilot.copilot_cloud_agent %}
 
-When {% data variables.product.prodname_copilot_short %} generates code that matches code in a public {% data variables.product.github %} repository, this is indicated in the agent session logs with a link to display details of the matched code. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).
+When {% data variables.product.prodname_copilot_short %} generates code that matches code in a public {% data variables.product.github %} repository, this is indicated in the agent session logs with a link to display details of the matched code. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).
 
 {% endwebui %}
 

content/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment.md

@@ -98,7 +98,7 @@ Your `copilot-setup-steps.yml` file will automatically be run as a normal {% dat
 
 Once you have merged the yml file into your default branch, you can manually run the workflow from the repository's **Actions** tab at any time to check that everything works as expected. For more information, see [AUTOTITLE](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/manually-running-a-workflow).
 
-When {% data variables.product.prodname_copilot_short %} starts work, your setup steps will be run, and updates will show in the session logs. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).
+When {% data variables.product.prodname_copilot_short %} starts work, your setup steps will be run, and updates will show in the session logs. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).
 
 If any setup step fails by returning a non-zero exit code, {% data variables.product.prodname_copilot_short %} will skip the remaining setup steps and begin working with the current state of its development environment.
 

content/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents.md

@@ -1,18 +1,26 @@
 ---
-title: Manage and track {% data variables.copilot.copilot_cloud_agent %} sessions
-shortTitle: Manage and track agents
-intro: 'Monitor your agent''s progress in real time, steer it with follow-up prompts, and stop or archive sessions.'
-product: '{% data reusables.gated-features.copilot-cloud-agent %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
+title: Managing agent sessions
+shortTitle: Manage agent sessions
+intro: 'Monitor an agent''s progress in real time, steer it with follow-up prompts, and stop or archive sessions.'
 versions:
   feature: copilot
 contentType: how-tos
+allowTitleToDifferFromFilename: true
 category:
   - Author and optimize with Copilot
 redirect_from:
   - /copilot/how-tos/use-copilot-agents/manage-agents
+  - /copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions
+  - /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
+  - /copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions
+  - /copilot/how-tos/agents/copilot-coding-agent/track-copilot-sessions
+  - /copilot/how-tos/agents/coding-agent/track-copilot-sessions
 ---
 
-Use the agents panel on {% data variables.product.github %} to start, monitor, and manage agent sessions across your repositories.
+Use the agents panel on {% data variables.product.github %} to monitor and manage agent sessions across your repositories.
 
 ## Monitor agent activity
 

content/copilot/how-tos/copilot-on-github/use-copilot-agents/review-copilot-output.md

@@ -2,7 +2,7 @@
 title: Review output from {% data variables.product.prodname_copilot_short %}
 shortTitle: Review {% data variables.product.prodname_copilot_short %} output
 allowTitleToDifferFromFilename: true
-intro: '{% data variables.product.prodname_copilot_short %} pull requests deserve the same thorough review as any contribution. Mention `@copilot` to request changes, or push commits directly to the branch.'
+intro: '{% data variables.product.prodname_copilot_short %} pull requests deserve the same thorough review as any contribution.'
 product: '{% data reusables.gated-features.copilot-cloud-agent %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
 versions:
   feature: copilot
@@ -14,9 +14,6 @@ redirect_from:
   - /copilot/how-tos/agents/copilot-coding-agent/reviewing-a-pull-request-created-by-copilot
   - /copilot/how-tos/agents/copilot-coding-agent/review-copilot-prs
   - /copilot/how-tos/agents/coding-agent/review-copilot-prs
-  - /copilot/how-tos/copilot-on-github/use-copilot-agents/iterate-with-copilot
-  - /copilot/how-tos/use-copilot-agents/coding-agent/make-changes-to-an-existing-pr
-  - /copilot/how-tos/use-copilot-agents/cloud-agent/make-changes-to-an-existing-pr
 contentType: how-tos
 category: 
   - Author and optimize with Copilot
@@ -29,26 +26,7 @@ When {% data variables.product.prodname_copilot_short %} finishes a coding task
 > [!IMPORTANT]
 > If your repository requires pull request approvals, **your approval of a {% data variables.product.prodname_copilot_short %} pull request won't count** toward the required number. Another reviewer must approve the pull request before it can be merged.
 
-Mention `@copilot` in a pull request comment to request changes. By default, {% data variables.product.prodname_copilot_short %} pushes commits directly to the pull request branch. To create a separate pull request instead, describe that in your comment. You can also check out the branch and push changes yourself.
-
-Batch review comments instead of submitting them individually. When submitting a pull request comment (not a review or review comment) through the {% data variables.product.github %} web interface, select a model with the model picker. {% data variables.product.prodname_copilot_short %} uses the model from the original pull request by default.
-
-{% data reusables.copilot.cloud-agent.write-access-required %}
-
-When {% data variables.product.prodname_copilot_short %} starts a new session in response to your comment, an eyes emoji (👀) reaction appears on the comment. A "Copilot has started work" event appears in the pull request timeline.
-
-![Screenshot of a pull request timeline with a review comment with the eyes reaction and a "Copilot started work" timeline event.](/assets/images/help/copilot/cloud-agent/comment-to-agent-on-pr.png)
-
-{% data variables.product.prodname_copilot_short %} remembers context from previous sessions on the same pull request, so follow-up requests are faster and more reliable. If the pull request was created by a {% data variables.copilot.copilot_custom_agent_short %}, mentioning `@copilot` continues using that same agent.
-
-## Resolve merge conflicts
-
-You can ask {% data variables.product.prodname_copilot_short %} to resolve merge conflicts on a pull request in two ways:
-
-* **Using the "Fix with {% data variables.product.prodname_copilot_short %}" button**: If a pull request has merge conflicts, click the **Fix with {% data variables.product.prodname_copilot_short %}** button that appears in the merge box.
-* **Using an @copilot mention**: Mention `@copilot` in a comment on the pull request and ask it to fix the conflicts—for example, "@copilot resolve the merge conflicts on this PR."
-
-{% data variables.product.prodname_copilot_short %} analyzes the conflicting changes, resolves them, and verifies that the build, tests, and linter still pass. It then requests your review so you can confirm the resolution before merging.
+To request changes from {% data variables.product.prodname_copilot_short %} on its pull request, mention `@copilot` in a comment, or push commits directly to the branch. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github).
 
 ## Manage {% data variables.product.prodname_actions %} workflow runs
 

content/copilot/how-tos/get-code-suggestions/find-matching-code.md

@@ -233,7 +233,7 @@ To see details of the matching code:
 
 ## View code references for {% data variables.copilot.copilot_cloud_agent %}
 
-When {% data variables.product.prodname_copilot_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated in the agent session logs with a link to display details of the matched code. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/track-copilot-sessions).
+When {% data variables.product.prodname_copilot_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated in the agent session logs with a link to display details of the matched code. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).
 
 {% endwebui %}