Updates for agentic development (#9871)

* Fix button labels

* Update post-download and docs homepage

* Add cost guide to toc

* Update toc

* Update CTA cards

Author: ntrogh

build/docs-homepage.json

@@ -2,15 +2,15 @@
   "getStarted": {
     "title": "Get started with AI agents",
     "description": "Hand off tasks to autonomous AI agents that iterate until the job is done. Run them locally, in the background, or in the cloud, with your choice of AI provider. Track all sessions without leaving VS Code.",
-    "link": "/docs/agents/agents-tutorial",
+    "link": "/docs/getstarted/getting-started",
     "image": "/assets/docs/agents/getting-started/agent-mode-selection-2.png"
   },
   "featured": [
     {
       "icon": "codicon-lightbulb",
-      "title": "Learn about the agent loop",
-      "description": "Understand the core concepts of how AI agents plan, act, and iterate to complete tasks.",
-      "link": "/docs/agents/concepts/agents"
+      "title": "Optimize your AI usage",
+      "description": "Tips to help you get the most out of AI agents, while optimizing for cost and performance.",
+      "link": "/docs/agents/guides/optimize-usage"
     },
     {
       "icon": "codicon-debug",

build/post-download.json

@@ -14,17 +14,17 @@
     },
     {
       "type": "documentation",
-      "title": "AI core concepts",
-      "description": "Get an overview of the core concepts and how AI agents work in VS Code.",
-      "link": "/docs/copilot/concepts/overview",
-      "image": "/assets/docs/copilot/concepts/agent-loop.png"
+      "title": "Optimize your AI usage",
+      "description": "Tips to help you get the most out of AI agents, while optimizing for cost and performance.",
+      "link": "/docs/agents/guides/optimize-usage",
+      "image": "/assets/docs/agents/optimize-usage-guide/copilot-status-dashboard.png"
     },
     {
       "type": "tutorial",
       "title": "Build and test with browser agent tools",
       "description": "Let AI build web apps and automatically verify them in the integrated browser, catching and fixing bugs on its own.",
-      "link": "/docs/copilot/guides/browser-agent-testing-guide",
-      "image": "/assets/docs/copilot/browser-agent-testing-guide/browser-testing-hero.png"
+      "link": "/docs/agents/guides/browser-agent-testing-guide",
+      "image": "/assets/docs/agents/browser-agent-testing-guide/browser-testing-hero.png"
     }
   ]
 }

docs/agent-native/toc.json

@@ -89,6 +89,7 @@
         "topics": [
             ["Prompt Examples", "/docs/agents/guides/prompt-examples"],
             ["Context Engineering", "/docs/agents/guides/context-engineering-guide"],
+            ["Optimize AI Credit Usage", "/docs/agents/guides/optimize-usage"],
             ["Customize AI", "/docs/agents/guides/customize-copilot-guide"],
             ["Test-Driven Development", "/docs/agents/guides/test-driven-development-guide"],
             ["Edit Notebooks with AI", "/docs/agents/guides/notebooks-with-ai"],

docs/agents/images/optimize-usage-guide/copilot-status-dashboard.png

@@ -14,20 +14,6 @@ You build a simple personal portfolio page with HTML, CSS, and JavaScript. The p
 > [!TIP]
 > If you prefer a video to learn about Visual Studio Code, you can watch the [Getting Started video](https://www.youtube.com/watch?v=f8_uF_IDV50) on our YouTube channel.
 
-<div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Explore agent types">
-Follow a hands-on tutorial to explore different agent types like local, CLI, and cloud agents.
-
-* [Start tutorial](/docs/agents/agents-tutorial.md)
-
-</div>
-
-<!-- <div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Watch the introduction video">
-Learn about the key features of Visual Studio Code in our introduction video.
-
-* [Watch video](https://www.youtube.com/watch?v=f8_uF_IDV50)
-
-</div> -->
-
 ## Prerequisites
 
 * [Download and install Visual Studio Code on your computer](https://code.visualstudio.com/download)
@@ -56,10 +42,10 @@ Agents work in the context of a folder, also known as a *workspace*. You start b
 
 ## Build with the Agents window
 
-<div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Explore the Agent window">
-Learn more about agent-first development with the Agents window in VS Code.
+<div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Explore the Agents window">
+Use the Agents window to run and monitor agent sessions across your projects from a single place in VS Code.
 
-* [Start tutorial](/docs/agents/agents-window.md)
+* [Learn about the Agents window](/docs/agents/agents-window.md)
 
 </div>
 
@@ -170,10 +156,10 @@ Before you commit the agent's work, review what changed. The **Changes** panel l
 
 ## Write code with agents in the editor
 
-<div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Explore agents in VS Code">
-Learn more about using agents to support for coding workflow in VS Code.
+<div class="docs-action" data-show-in-doc="false" data-show-in-sidebar="true" title="Explore the Chat view">
+Use the Chat view alongside your editor to let agents assist you with coding tasks in your active workspace.
 
-* [Start tutorial](/docs/agents/chat-view.md)
+* [Learn about the Chat view](/docs/agents/chat-view.md)
 
 </div>