让每次 Zaru 运行只用到它需要的连接

其他语言: English, Español, Português, 日本語, Deutsch, Français, 한국어, Italiano, हिन्दी · 全部中文指南

声明:Zaru 由 100monkeys AI, Inc. 开发,因此请把这篇指南当作开发方的说明来读。它由我们的一个 AI 智能体根据 Zaru 文档的 Profiles 页面(2026 年 10 月 29 日阅读)和本站的文字起草,并经公司审阅;这个简体中文版是英文原版指南的译文。下面引用的每条规则和每条提示都是那个页面的原句,保留英文原文,译文附在旁边。它没有说明某件事如何运作的地方,我们直接说明,而不去描述它。

一旦 Zaru 掌握了你的邮箱、日历和一个 GitHub token,问题就变成:某个对话、运行或定时任务可以碰其中哪些。配置文件(profile)用一个选择回答这个问题:一组有名字的连接,加上它们可以使用的工具。没有配置文件、也没有选择连接的运行,一个都碰不到。本指南创建一个配置文件,收窄它的工具,并在对话、定时任务和 MCP 客户端中使用它。

配置文件是什么

文档的说法:配置文件是 "your own named set of connections (a mailbox, a calendar account, a Carbon Forge (formerly Nuclear Notes) token, a GitHub token and so on, any number of any kind) with a list of the tools they may use, and optional defaults."(你自己命名的一组连接,例如一个邮箱、一个日历账号、一个 Carbon Forge(原名 Nuclear Notes)token、一个 GitHub token 等,任意数量、任意种类,加上它们可以使用的工具列表和可选的默认值。)让它有用的规则就印在 Profiles 页面的列表上方:"A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none."(运行、定时任务或 API 密钥只能触及配置文件列出的连接。没有配置文件,就一个也触及不到。)

第 1 步:创建账号,连接你使用的服务

点击 Get Zaru free(免费使用 Zaru);注册只需要名字和邮箱。按本站的说明,从 Vault 连接你的邮箱和日历。配置文件只能列出你已经拥有的连接,所以先连接。

第 2 步:打开 Vault 里的 Profiles

列表位于 /vault/profiles,显示每个配置文件的连接和工具数量。点击 New profile(新建配置文件)。之后编辑配置文件用的也是同一个表单。

第 3 步:按工作命名,并选择连接

名称为 1 到 64 个字符,在你的配置文件中唯一。按工作命名,而不是按账号:文档自己的示例叫 "Fundraising"。然后勾选这项工作需要的连接;表单按类型分组列出。你之后撤销或删除的连接会继续以 removed 列出,配置文件会显示 "A connection in this profile was removed."(这个配置文件中的一个连接已被移除。)

第 4 步:收窄工具范围

每一项都是一个确切的工具名,例如 mail.reply,或写成 <family>.* 的一个工具族,例如 carbon-forge.*。空列表表示 "All tools these connections allow"(这些连接允许的所有工具)。文档的示例配置文件允许:

"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]

表单会给需要等你批准的工具标上 "Needs your approval"(需要你的批准)。配置文件只能收窄:你的套餐不允许的条目会被拒绝,提示为 "A profile can only narrow the tools your plan allows; <pattern> is not one of them."(配置文件只能收窄你的套餐允许的工具;<pattern> 不在其中。)

第 5 步:了解配置文件不会改变什么

配置文件管辖的是其连接所属工具族的工具:mail.*、calendar.*,以及其他服务提供方的工具族,例如 github.*。fs.*、cmd.run 或 web.* 这类工具不受配置文件管辖,只由安全上下文决定。而且被允许的工具仍然要经过审批关卡。mail.send、mail.reply、mail.forward、mail.delete 和 mail.archive 无论配置文件怎么写都会等你回答。所以一个有 mail.reply 而没有 mail.send 的配置文件,允许运行在一个会话里回复(每条回复都等你批准),并立即拒绝发送新邮件。

第 6 步:加上默认值

三个可选字段可以省去重复输入:默认的 repository,即你的一个 git 仓库绑定;默认的 Carbon Forge 工作区,用于 "when a Carbon Forge call names none"(某次 Carbon Forge 调用没有指定工作区时);以及用于这个配置文件上对话的 instructions,最多 4,000 个字符。Zaru 会被告知配置文件的名称、工作区和你的指令。

第 7 步:在对话中选择它

打开聊天输入框上方的对话面板。它的 Context 部分依次列出 None、Profiles,然后是按类型分组的连接。选择一个配置文件会清除已选的连接,输入框上方的一行显示 "Profile: <name>"。配置文件随对话保存,所以之后的轮次和它们启动的运行都使用它。一次运行只带一个配置文件或一组选定的连接,不会两者兼有:"Choose one profile, or choose connections without a profile; not both."(选择一个配置文件,或不用配置文件而选择连接;不能两者都选。)

第 8 步:用于定时任务和 API 密钥

定时任务表单保存一个配置文件或一组选定的连接,不会两者兼有,配置文件的仓库和工作区会填入表单。在 Settings → API Keys 中,每个密钥所在行选择它的配置文件,第一项是 None。没有配置文件的密钥触及不到你的任何连接。

第 9 步:在 MCP 客户端中选择它

客户端在其连接的每个请求中发送配置文件,放在一个只含保留键 @profile 的请求头里:

x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}

这个 id 是文档的示例;请使用你自己配置文件的 id。@profile 与任何其他键同时出现,会得到 400。

第 10 步:读懂一次拒绝

每次受管辖的调用都会按配置文件在那一刻的状态检查。不在其中的工具会以 TOOL_NOT_IN_PROFILE 被拒绝:"This tool is not in the profile chosen for this run."(这个工具不在为本次运行选择的配置文件中。)Zaru Web 会显示一张链接到该配置文件的卡片,你可以加入这个工具,也可以不加。由另一个运行启动的运行,永远不会超出那个运行所选的连接。在某个配置文件的运行上做出的 "Always allow"(始终允许)选择只适用于该配置文件,删除配置文件就会撤销它。

文档没有说明的

在哪里找到 MCP 请求头所需的配置文件 id。REST 响应中带有它;页面没有说 Zaru Web 是否显示它。
如何在 MCP 客户端自己的设置里选择配置文件。页面给出了请求头的格式,没有给出客户端的配置。
编辑配置文件是否会改变一次正在进行的运行。调用按 "as it stands at that moment"(那一刻的状态)检查,但连接在运行开始时就归属于这次运行。
本站没有提到配置文件;文档是唯一来源。