diff --git a/learn/agents/1-using-tools-with-agents.md b/learn/agents/1-using-tools-with-agents.md index 7d2c1ee8c3..fdc51e3f8e 100644 --- a/learn/agents/1-using-tools-with-agents.md +++ b/learn/agents/1-using-tools-with-agents.md @@ -14,6 +14,9 @@ Keywords: # Using tools with agents + + + Tools are how agents act on your request. They search your workspace, read files, edit code, run terminal commands, fetch web content, and call external services. In this guide, you will start with a small task, choose only the tools the task needs, and decide when to use a tool set, approvals, or sandboxing. ## Prerequisites diff --git a/learn/agents/2-extending-agents-with-mcp-servers.md b/learn/agents/2-extending-agents-with-mcp-servers.md index 279eca4105..ffff30c84c 100644 --- a/learn/agents/2-extending-agents-with-mcp-servers.md +++ b/learn/agents/2-extending-agents-with-mcp-servers.md @@ -14,6 +14,8 @@ Keywords: # Extending agents with MCP servers + + MCP servers connect agents to external tools and data sources. In this guide, you will install an MCP server, use one of its tools in chat, choose the right configuration scope, and decide when to sandbox the server. ## Prerequisites diff --git a/learn/agents/3-agent-plugins.md b/learn/agents/3-agent-plugins.md index 3bd735d917..b3f8b8125a 100644 --- a/learn/agents/3-agent-plugins.md +++ b/learn/agents/3-agent-plugins.md @@ -14,6 +14,9 @@ Keywords: # Agent plugins + + + Agent plugins bundle multiple customizations into one installable package. In this guide, you will inspect a plugin before installing it, use a plugin-provided command, and decide when a plugin is a better fit than separate local customizations. ## Prerequisites diff --git a/learn/agents/4-using-third-party-agents-in-vs-code.md b/learn/agents/4-using-third-party-agents-in-vs-code.md index 8b75dede33..377b02c36c 100644 --- a/learn/agents/4-using-third-party-agents-in-vs-code.md +++ b/learn/agents/4-using-third-party-agents-in-vs-code.md @@ -14,6 +14,9 @@ Keywords: # Using third-party agents in VS Code + + + Third-party agents let you use provider-specific agent experiences inside VS Code. In this guide, you will choose between local and cloud sessions, start a Claude or Codex session, and pick a permission mode that matches the task. ## Prerequisites diff --git a/learn/toc.json b/learn/toc.json index d54b27a4dd..4a393b4dbb 100644 --- a/learn/toc.json +++ b/learn/toc.json @@ -13,7 +13,7 @@ ] }, { - "name": "Customizations", + "name": "Agent Customizations", "area": "customizations", "description": "Learn how to shape AI in VS Code around your workflow using custom agents, instructions, skills, prompt files, and hooks.", "topics": [ @@ -28,7 +28,7 @@ ] }, { - "name": "Agents", + "name": "Agent Extensions", "area": "agents", "description": "Learn how to use tools, MCP servers, plugins, and third-party agents to extend agent workflows in VS Code.", "topics": [ @@ -38,4 +38,4 @@ ["Using third-party agents in VS Code", "/learn/agents/4-using-third-party-agents-in-vs-code"] ] } -] \ No newline at end of file +]