Update agent documentation #9122
Conversation
|
Clearly describe differences between local and background - see also microsoft/vscode#280412 (comment) |
bamurtaugh
left a comment
bamurtaugh
left a comment
There was a problem hiding this comment.
These changes are fantastic, thank you so much @ntrogh! Left a few questions / suggestions.
| * `Run the research agent as a subagent to research the best auth methods for this project.` | ||
| * `Use the plan agent in a subagent to create an implementation plan for myfeature. Then save the plan in plans/myfeature.plan.md` | ||
|
|
||
| ## Agent Sessions |
There was a problem hiding this comment.
Should we consider keeping this heading, and then just linking to the copilot/agents/overview page?
|
|
||
| Visual Studio Code supports multiple types of AI-powered agents that can assist with coding tasks, from interactive conversations to autonomous multi-step workflows. Agents in VS Code can operate locally within the editor, run in the background, or remotely in the cloud. The Agents view provides a central interface to manage and track all your agent interactions, across these different environments. | ||
|
|
||
| This article provides an overview of the various agent types, how to create and manage agent sessions, delegate tasks between agents, and track their progress. |
There was a problem hiding this comment.
Maybe a screenshot here of the Agents view would help with the text-heavy intro you mention?
There was a problem hiding this comment.
Yes! There needs to be hero image/video here.
|
@rebornix can you chime in for the limitations of "Background" and "Cloud" compared to "Local". I.e. what exactly is possible in these runtimes around
|
|
@bpasero thanks for the ping. Will provide feedback here. |
|
@bamurtaugh Updated with most of your comments (hero screenshot/video not yet bc of issues). Deployed updated version to vnext env. |
bamurtaugh
left a comment
bamurtaugh
left a comment
There was a problem hiding this comment.
Added a few comments based on the latest product changes, thanks so much!
docs/copilot/agents/overview.md
Outdated
|
|
||
| ## Agents view | ||
|
|
||
| The **Agents view** provides a centralized interface for tracking and managing your agent sessions, both local in VS Code and in other environments, such as Copilot coding agent, GitHub Copilot CLI, or OpenAI Codex. |
There was a problem hiding this comment.
We'll want to update this section based on the latest single view, where users get Recent Sessions and can expand (via manual dragging or the button on the right) to get a nice side-by-side with all sessions:
Some buttons of note:
docs/copilot/agents/overview.md
Outdated
| To open the **Agents** view, run the **Agents: Focus on Agents View** command from the Command Palette (`kb(workbench.action.showCommands)`). | ||
|
|
||
| You can open the Agents view in a separate view in the Primary Side Bar, or alongside the Chat view in the Secondary Side Bar. Configure the location via the `setting(chat.agentSessionsViewLocation)` setting: | ||
|
|
||
| * `single-view`: show Agents view alongside Chat view in Secondary Side Bar | ||
| * `view`: show Agents view in Primary Side Bar | ||
| * `disabled`: hide the Agents view |
docs/copilot/agents/overview.md
Outdated
| ### Filter agent sessions | ||
|
|
||
| By default, the Agents view shows all sessions, except archived sessions. Use the **Filter Agent Sessions** dropdown to filter sessions by: |
There was a problem hiding this comment.
The filter location / interaction has now changed a bit:
docs/copilot/agents/overview.md
Outdated
| 1. Open the Agents view | ||
|
|
There was a problem hiding this comment.
I wonder if we want to update this guidance a bit, to point to the + (since we don't have the same exact interaction as in the other dedicated Agents single view):
docs/copilot/agents/overview.md
Outdated
|
|
||
| When you delegate a session, VS Code creates a new agent session of the selected type, carrying over the full conversation history and context. You can then continue interacting with the new agent to complete the task. | ||
|
|
||
| ## Open session details |
There was a problem hiding this comment.
I think we may want to update this section a bit, based on the latest UX here. Sessions will open in the sidebar by default (rather than a separate chat editor), and there's now the chat titlebar and back arrow button:
Expanded session list version:
bamurtaugh
left a comment
bamurtaugh
left a comment
There was a problem hiding this comment.
A few final minor comments. Thank you so much!
|
Closing this PR - updates merged into |
No description provided.