From 7d4dd8735c8b30473f2d0d3cf2ba6e5e29c09c3b Mon Sep 17 00:00:00 2001 From: Katie Geer Date: Wed, 4 Feb 2026 15:50:59 -0800 Subject: [PATCH] docs: Add missing AI features (Dec. 2025) (#48418) - Update AI docs with missing features we shipped in December 2025 - Apply new brand voice to new docs Release Notes: - N/A *or* Added/Fixed/Improved ... --------- Co-authored-by: Claude Opus 4.5 --- docs/src/ai/agent-panel.md | 19 +++++++++++++++++++ docs/src/ai/llm-providers.md | 23 ++++++++++++++++++++++- docs/src/ai/mcp.md | 2 ++ docs/src/ai/tools.md | 8 ++++++++ 4 files changed, 51 insertions(+), 1 deletion(-) diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md index 69f9da85c89aa92111f5954c1fc2ce6f6aa653ef..f6aeee100885bd18c2102c9b110a0d14a2de21f5 100644 --- a/docs/src/ai/agent-panel.md +++ b/docs/src/ai/agent-panel.md @@ -47,6 +47,19 @@ Every time the model performs an edit, you should see a "Restore Checkpoint" but The checkpoint button appears even if you interrupt the thread midway through an edit, as this is likely a moment when you've identified that the agent is not heading in the right direction and you want to revert back. +### Context Menu {#context-menu} + +Right-click on any agent response in the thread view to access a context menu with the following actions: + +- **Copy Selection**: Copies the currently selected text as Markdown (available when text is selected). +- **Copy This Agent Response**: Copies the full text of the agent response you right-clicked on. +- **Scroll to Top / Scroll to Bottom**: Scrolls to the beginning or end of the thread, depending on your current position. +- **Open Thread as Markdown**: Opens the entire thread as a Markdown file in a new tab. + +### Navigating the Thread {#navigating-the-thread} + +In long conversations, use the scroll button at the bottom of the panel to jump to your most recent prompt. + ### Navigating History {#navigating-history} To quickly navigate through recently updated threads, use the {#kb agent::ToggleNavigationMenu} binding when focused on the panel's editor, or click the menu icon button at the top right of the panel. @@ -54,6 +67,8 @@ Doing that will open a dropdown that shows you your six most recently updated th To view all historical conversations, reach for the `View All` option from within the same menu or via the {#kb agent::OpenHistory} binding. +Thread titles are auto-generated based on the conversation content. To regenerate a title, open the ellipsis menu in the top right of the panel and select "Regenerate Thread Title". + ### Following the Agent {#following-the-agent} Follow the agent as it reads and edits files by clicking the crosshair icon at the bottom left of the panel. Your editor will jump to each file the agent touches. @@ -138,6 +153,8 @@ You can explore the exact tools enabled in each profile by clicking on the profi Alternatively, you can also use either the command palette, by running {#action agent::ManageProfiles}, or the keybinding directly, {#kb agent::ManageProfiles}, to have access to the profile management modal. +Use {#kb agent::CycleModeSelector} to switch between profiles without opening the modal. + #### Custom Profiles {#custom-profiles} You can also create a custom profile through the Agent Profile modal. @@ -150,6 +167,8 @@ Zed will store this profile in your settings using the same profile name as the All custom profiles can be edited via the UI or by hand under the `agent.profiles` key in your `settings.json` file. +To delete a custom profile, open the Agent Profile modal, select the profile you want to remove, and click the delete button. + ### Tool Approval Zed's Agent Panel surfaces the `agent.always_allow_tool_actions` setting that, if turned to `false`, will require you to give permission to any editing attempt as well as tool calls coming from MCP servers. diff --git a/docs/src/ai/llm-providers.md b/docs/src/ai/llm-providers.md index cb4ae360781c8cc8da7e72d727a1c9c0bdaa7fe0..f224890b5da57d4d5b3be8d2a6d38bc1c2e0e9ca 100644 --- a/docs/src/ai/llm-providers.md +++ b/docs/src/ai/llm-providers.md @@ -59,7 +59,7 @@ Your IAM policy should look similar to: } ``` -With that done, choose one of the two authentication methods: +With that done, choose one of the three authentication methods: #### Authentication via Named Profile (Recommended) @@ -87,6 +87,27 @@ To do this: 3. Open the Agent Configuration with (`agent: open settings`) and go to the Amazon Bedrock section 4. Copy the credentials from Step 2 into the respective **Access Key ID**, **Secret Access Key**, and **Region** fields. +#### Authentication via Bedrock API Key + +Amazon Bedrock also supports [API Keys](https://docs.aws.amazon.com/bedrock/latest/userguide/api-keys-use.html), which authenticate directly without requiring IAM users or named profiles. + +1. Create an API Key in the [Amazon Bedrock Console](https://console.aws.amazon.com/bedrock/) +2. Open the Agent Configuration with (`agent: open settings`) and go to the Amazon Bedrock section +3. Enter your Bedrock API key in the **API Key** field and select your **Region** + +```json [settings] +{ + "language_models": { + "bedrock": { + "authentication_method": "api_key", + "region": "your-aws-region" + } + } +} +``` + +The API key itself is stored securely in your OS keychain, not in your settings file. + #### Cross-Region Inference The Zed implementation of Amazon Bedrock uses [Cross-Region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) to improve availability and throughput. diff --git a/docs/src/ai/mcp.md b/docs/src/ai/mcp.md index 7e5c840d25ee78aaa76517a8dfa32776fef230dd..e149225b81f567cf64a84c1c930d881bd6cbf290 100644 --- a/docs/src/ai/mcp.md +++ b/docs/src/ai/mcp.md @@ -9,6 +9,8 @@ Zed uses the [Model Context Protocol](https://modelcontextprotocol.io/) to inter Zed currently supports MCP's [Tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) and [Prompts](https://modelcontextprotocol.io/specification/2025-11-25/server/prompts) features. We welcome contributions that help advance Zed's MCP feature coverage (Discovery, Sampling, Elicitation, etc). +Zed also handles the `notifications/tools/list_changed` notification from MCP servers. When a server adds, removes, or modifies its available tools at runtime, Zed automatically reloads the tool list without requiring a server restart. + ## Installing MCP Servers ### As Extensions diff --git a/docs/src/ai/tools.md b/docs/src/ai/tools.md index 7e8bc50398e80b227a089f113616ab1b1d1e8fd6..eb386b901d423c21f4af65c7cd1c8be4a5ba8153 100644 --- a/docs/src/ai/tools.md +++ b/docs/src/ai/tools.md @@ -64,6 +64,14 @@ Deletes a file or directory (including contents recursively) at the specified pa Edits files by replacing specific text with new content. +### `restore_file_from_disk` + +Reloads a file from disk, discarding any unsaved changes in the buffer. + +### `save_file` + +Saves a buffer's current contents to disk, preserving unsaved changes before the agent modifies the file. + ### `move_path` Moves or renames a file or directory in the project, performing a rename if only the filename differs.