智能体面板
智能体面板让您能够与多种大语言模型及编程智能体进行交互，这些智能助手可协助完成各类任务，包括代码生成、代码库理解，以及撰写邮件、文档等日常事务。
您可以通过以下方式开启面板：在命令面板中使用agent: new thread指令，或直接点击状态栏中的✨（星芒）图标。
快速开始
若您是首次使用智能体面板，需要先完成至少一个LLM服务商或外部智能体的配置。具体可通过以下方式实现：
- 订阅我们的专业版服务，即可使用我们托管的模型服务
- 配置自有API密钥，支持直接配置Anthropic等模型服务商密钥，或通过OpenRouter等模型网关接入
- 使用外部智能体工具，例如Gemini命令行工具或Claude代码助手
功能总览
配置好大语言模型服务商或外部智能体后，在消息编辑器中输入内容并按下enter即可提交提示词。
若需更多输入空间，可通过shift-alt-escape|shift-alt-escape扩展消息编辑器。
提交后您将看到响应流实时返回，并显示模型为满足您的需求正在使用的工具。 此时起，您便可使用下文列出的多项支持功能。
请注意：对于外部智能体（如Gemini CLI或Claude Code），目前暂不支持部分功能——例如_从历史记录恢复线程_、检查点、令牌用量显示、_模型选择_等。预计未来将逐步支持全部功能。
创建新线程
默认情况下，智能体面板使用 Zed 第一方智能体。
要更改此设置，请前往智能体面板右上角的加号按钮，选择其他选项。 您可以选择创建新的文本线程，或者若已连接外部智能体，也可与它们创建新对话线程。
编辑消息
您发送给AI的所有消息均可编辑。 点击包含您消息的卡片，即可调整提示内容或添加新上下文后重新提交。
检查点
每次AI执行编辑操作后，您会在消息顶部看到“恢复检查点”按钮，此功能可将代码库回滚至该条消息处理前的状态。
即使您在中途中断编辑进程，检查点按钮依然会出现——这通常意味着您发现智能体偏离正确方向，需要撤销至先前状态。
历史记录导航
要快速浏览最近打开的对话线程，可在聚焦面板编辑器时使用 cmd-shift-j|ctrl-shift-j 快捷键，或点击面板右上角的菜单图标按钮，下拉菜单将显示最近六个对话记录。
此菜单中的项目功能类似标签页，关闭它们并不会删除对话内容，仅会将其从最近列表中移除。
若需查看全部历史对话记录，可通过同一菜单中的View All选项，或使用 cmd-shift-h|ctrl-shift-h 快捷键实现。
追踪智能助手动态
Zed 原生内置了协同编辑功能，这一设计理念同样适用于与AI的协作。当智能助手在代码库中进行读取和编辑时，点击面板左下角的"十字准星"图标按钮即可实时追踪其操作轨迹。
您也可在提交消息时，通过 cmd/ctrl 修饰键配合 enter 快捷键实现相同功能。
接收通知提醒
如果您向智能体发送提示后转向其他任务，将Zed置于后台运行，当它完成响应时，您可以通过以下方式获得通知：
- 屏幕右上角出现的视觉通知
- 声音提示
根据您的偏好，这些通知可以同时使用或单独启用。
您可以通过agent.notify_when_agent_waiting和agent.play_sound_when_agent_done设置键来自定义通知行为，包括完全关闭通知功能。
审阅更改
当智能体完成对项目的修改后，面板会显示已编辑的文件及其数量。
要查看具体被修改的文件，您可以展开消息编辑器上方的折叠栏，或点击Review Changes按钮（shift-ctrl-r|shift-ctrl-r）——该操作将打开包含所有变更内容的多缓冲区标签页。
你可以选择接受或拒绝每一个单独的变更块，也可以一次性处理智能助手所做的全部更改。
编辑差异也会显示在独立的缓冲区中。如果你的活动标签页中有AI所做的编辑，你将看到与多缓冲区中相同的接受/拒绝控件。
添加上下文
虽然Zed智能助手能高效自主地读取代码库以获取相关文件、目录及其他上下文信息，但我们仍建议手动添加上下文，这能有效提升AI响应速度与回答质量。
如需添加文件、目录、符号、历史对话记录、规则文件甚至网页作为上下文，请在编辑器中输入@来引用这些内容。
智能助手面板同样支持通过粘贴图片添加上下文信息。
令牌使用说明
Zed会在面板消息编辑器的个人资料选择器附近，显示当前活跃线程消耗的token数量。根据您添加上下文的条目数量，token消耗量可能快速增加。
当接近模型的上下文窗口限制时，消息编辑器下方会出现提示横幅，建议开启新线程并将当前对话总结后作为上下文添加。 您也可以随时通过右上角的"智能助手选项"菜单，对进行中的线程执行此操作。
切换模型
完成LLM供应商配置后（可通过自定义API密钥或Zed托管模型实现），您可以通过点击消息编辑器的模型选择器，或使用cmd-alt-/|ctrl-alt-/快捷键在不同模型间切换。
同一个模型可能由多个服务商提供——例如 Claude Sonnet 4 可通过 Zed Pro、OpenRouter、Anthropic 官方等渠道获取。请确保在模型选择器中，通过模型左侧标识确认已为所选模型指定正确的**服务商**。
工具使用
全新智能体面板支持工具调用功能，可实现自主编辑操作。 Zed 内置了多种工具，支持模型执行代码库检索、文件编辑、命令运行等任务。
您还可通过 MCP 服务器扩展可用工具集。
配置集
配置集可作为工具的分组方式。 Zed 提供三种内置配置集，并支持创建任意数量的自定义配置集。
内置配置集
Write：具备完整工具权限的配置方案，允许大语言模型写入文件并执行终端命令。此方案默认启用所有内置工具功能。Ask：仅启用读取工具的配置方案。最适合在无需担心智能体修改代码的情况下，对代码库进行咨询问答。Minimal：无工具权限的配置方案。适用于无需访问代码库的常规对话场景。
您可通过以下路径查看各配置方案的具体工具设置：点击配置选择按钮 > Configure Profiles… > 选择目标配置方案。
自定义配置方案
通过配置选择器中的Configure Profiles…选项即可创建自定义配置。
在此界面，您可以选择Add New Profile全新创建，或基于现有配置创建分支方案——自定义名称并灵活配置工具组合。
你也可以覆盖内置配置文件。
选择内置配置文件后，在配置文件选择器中导航至Configure Tools，然后选择你需要的工具。
Zed会将此配置文件以默认名称存储在你的设置中，覆盖原有配置。
所有自定义配置文件均可通过界面手动编辑，或在settings.json文件的assistant.profiles键下进行修改。
工具授权
Zed的代理面板会显示agent.always_allow_tool_actions设置，若将其调整为false，则任何编辑尝试及来自MCP服务器的工具调用都需要获得你的授权。
你可以通过在settings.json中修改该键值为true，或通过代理面板的设置视图来调整此配置。
模型支持
工具调用功能需要每个模型及模型供应商单独支持。 因此，尽管存在工具配置，某些模型在Zed中可能尚不具备调用能力。若您选择的模型属于此类情况，界面会显示"无可用工具"的标识。
所有Zed托管模型均默认支持工具调用功能。
MCP服务器
与内置工具类似，部分模型可能无法支持特定MCP服务器包含的所有工具。Zed界面将通过模型选择器旁显示的警告图标对此进行提示。
文本会话
"文本会话"以纯文本形式呈现您与大型语言模型的对话记录。通过文本会话模式，您可以完全掌控对话数据：自由删改模型回复、切换对话角色身份，或在对话前段插入更多上下文内容。
对于长期使用我们产品的用户而言，文本线程作为最初的助手面板——用户因其提供的控制权而青睐有加。我们暂无弃用文本线程的计划，但需注意：若希望AI能自主编写代码库内容，该功能仅在新版且当前默认的"线程"模式中提供。
错误与调试
若出现任何错误或大型语言模型响应异常，协助Zed团队调试的最佳方式是使用agent: open thread as markdown操作，并将相关数据作为附件提交至GitHub问题报告。
当焦点位于面板编辑器时，您还可通过点击"踩"按钮右侧的文件图标按钮，以Markdown格式开启线程。
意见反馈
Zed支持对智能体响应进行评分，以便收集反馈并持续优化。
请注意，对回复进行评分会将与该回复相关的数据发送至 Zed 的服务器。 关于 Zed 在 AI 改进、隐私和安全方面的具体措施，请参阅 AI 改进 和 隐私与安全。 如果您不希望数据保存在 Zed 的服务器上，请勿进行评分。除非您明确对回复进行评分，否则我们不会为改进我们的智能代理服务收集数据。
您可以通过在每条回复末尾的“赞/踩”按钮对 LLM 的回复进行评分，这是帮助影响 Zed 系统提示和工具下一次更新的最佳方式。若选择“踩”，将出现一个新的文本框，供您补充具体说明。
您可以在智能代理回复后的任意时间点提供反馈，同一对话线程中可多次提交。