入门 Zed Industries 2026-09-14 17:42:19 · 0 阅读

第21章 Agent 设置详解：Zed AI 提供商、外部 Agent 与 MCP 服务器配置指南

Agent 设置位于设置编辑器中的 AI 部分，用于配置模型提供商、外部 Agent 和 MCP 服务器。通过 {#action agent::OpenSettings} 打开它（也可在 Agent Panel 右上角菜单中找到），可直接跳转至 AI 页面。你还可以通过 {#action zed::OpenSettings} 并在侧边栏中选择 AI 到达同一页面。

在 AI 页面中，LLM 提供商、外部 Agent 和 MCP 服务器均在常规部分下，各自拥有独立的子页面。

入口	打开方式	用途
设置编辑器	{#action agent::OpenSettings}	AI 设置：LLM 提供商、外部 Agent、MCP 服务器及相关页面
设置文件	{#action zed::OpenSettingsFile}	直接编辑 JSON 及 UI 未公开的设置项

有关通用设置机制，请参阅配置 Zed。

LLM 提供商

LLM 提供商 部分用于配置 Zed AI 功能的模型提供商，包括 Zed Agent、Inline Assistant、Git 提交信息生成、线程摘要及其他基于模型的功能。

使用此部分可以：

登录受支持的基于订阅的提供商
输入提供商 API 密钥
添加兼容 OpenAI 的提供商
移除提供商

有关模型访问路径和特定提供商的设置，请参阅 LLM 提供商。

功能专属设置

部分 Zed AI 功能在 settings.json 中拥有独立的模型或提示词设置，包括：

agent.inline_assistant_model
agent.commit_message_model
agent.thread_summary_model
agent.compaction_model
agent.subagent_model
agent.commit_message_instructions
agent.inline_alternatives

使用 agent.commit_message_instructions 设置仅适用于生成的 Git 提交信息的指令：

{
  "agent": {
    "commit_message_instructions": "使用 Conventional Commits 格式：<type>(<scope>): <description>。"
  }
}

针对特定功能的模型示例，参见 Feature-specific Models。

自动压缩（Automatic Compaction）

当对话接近所选模型的上下文窗口上限时，Zed Agent 可以自动压缩过长的对话线程。压缩会总结较早的消息，让对话无需另起新线程即可继续。

自动压缩默认开启，在对话达到模型上下文窗口的 90% 时触发。你可以在 settings.json 中修改阈值或关闭该功能：

{
  "agent": {
    "auto_compact": {
      "enabled": true,
      "threshold": "90%"
    }
  }
}

threshold 可以是以下几种取值：

取值	含义
百分比字符串，如 `90%`	对话占用模型上下文窗口达到该百分比时压缩。
正整数，如 `100000`	已消耗的 token 数达到该值时压缩。
负整数，如 `-20000`	模型上下文窗口中剩余 token 少于该值时压缩。

0 不是有效阈值。阈值无效时，Zed 会回退到 90%。

你也可以随时在 Agent Panel 的消息输入框中输入 /compact 手动压缩对话。关于 token 用量和压缩行为的更多信息，参见 Token Usage and Compaction。

压缩模型（Compaction Model）

默认情况下，上下文压缩（包括 /compact 和自动压缩）使用对话当前所选的模型。设置 agent.compaction_model 可以改用其他模型：

{
  "agent": {
    "default_model": {
      "provider": "anthropic",
      "model": "claude-opus-4-6"
    },
    "compaction_model": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-5"
    }
  }
}

注意事项：

为确保行为可预测，配置模型的上下文窗口应不小于线程主模型的上下文窗口。

外部 Agent

外部 Agent 部分用于配置集成 ACP 的 Agent。

使用 Add Agent 可以：

从注册表安装
添加自定义 Agent

有关配置详情和支持范围，请参阅外部 Agent。

MCP 服务器

MCP 服务器 页面用于配置连接到 Zed 的 Model Context Protocol 服务器。

使用页头中的 Add Server 可以：

添加本地服务器
添加远程服务器
从扩展安装

每个已配置的服务器条目都提供以下选项：

Configure（齿轮）按钮，用于编辑服务器
Uninstall（垃圾桶）按钮，用于移除服务器
开关，用于启用或禁用服务器

有关 MCP 配置、身份验证、服务器状态及 Agent 路径边界，请参阅 MCP。

任务	前往
选择在 Zed Agent 线程中可用的工具	Agent 配置
控制工具调用是被允许、拒绝还是需确认	工具权限
配置可复用的任务指令	技能
配置始终生效的个人或项目指令	说明（Instructions）
配置编辑预测服务商	编辑预测（Edit Prediction）
关闭 AI	AI 快速入门
编辑原始 settings JSON	配置 Zed

特定功能模型

Zed 支持为 Inline Assistant、Git 提交生成、线程摘要和子代理配置特定功能的模型。当某些工作流需要使用不同模型时，可在设置中进行配置。

有关模型访问信息，请参阅 LLM 服务商；完整的设置参考请见所有设置。

模型温度

大多数 Zed AI 功能使用所选模型的默认生成行为。若需为特定服务商、模型或“服务商/模型”组合设置温度，请使用 agent.model_parameters。

{
  "agent": {
    "model_parameters": [
      {
        "provider": "anthropic",
        "model": "claude-sonnet-4-5",
        "temperature": 0.2
      }
    ]
  }
}

Zed 从后往前检查匹配项。条目可省略 provider 或 model 字段以扩大应用范围。如需配置服务商特定的模型选项（如自定义模型条目、上下文窗口或网关路由），请参阅 LLM 服务商及各服务商的搭建页面。