工具集参考
工具集是模型可见工具的分组。它决定某一轮会把哪些工具展示给模型；它不是权限边界。工具被选中后， 风险、审批、审计和执行策略仍然生效。
主要配置字段是 config.yaml 里的 toolsets.default。
toolsets:
default:
- web
- sessions
- memory
- tasks
- automation
- clarify
- file
- messaging
- skills
- subagents
- terminal
- tts
省略 toolsets.default 时，Anyy 使用上面的内置默认列表。存在该字段时，新 session
会把 profile 默认工具集复制到 session metadata。已经存在的 session 保留自己的工具集列表。
配置格式
提交配置时推荐使用 YAML list：
toolsets:
default:
- web
- sessions
- memory
- terminal
加载器也接受用逗号、空格、tab、换行分隔的字符串，但 list 形式更容易 review，也不容易被意外拆分。
重复项和空项会被忽略。未知工具集名称可以出现在列表中，但除非扩展、active skill、MCP server 或运行时能力提供了同名工具集，否则不会暴露任何内置工具。
默认可见工具集
新 profile 默认可见的工具集：
| 工具集 | 用途 |
|---|---|
web | 公共 web 搜索和读取工具。 |
sessions | 会话召回和会话级操作。 |
memory | 结构化长期 memory 编辑工具。 |
tasks | 任务和提醒辅助工具。 |
automation | 定时或重复自动化辅助工具。 |
clarify | 工具缺少必要信息时向用户提问。 |
file | 工作区文件读写和搜索工具。 |
messaging | 渠道和消息投递工具。 |
skills | Skill 发现和运行时工具。 |
subagents | 委派、后台任务和 subagent 控制工具。 |
terminal | Shell/process 执行工具。 |
tts | 文本转语音输出工具。 |
具体工具列表可能随能力启用状态变化，但默认工具集名称由产品契约和测试固定。当前 runtime
没有内置 home 工具集。
可选工具集
可选工具集需要被配置、命令 metadata、运行时条件或 setup 命令显式选中。
| 工具集 | 如何变为可见 |
|---|---|
computer_use | 通过 anyy computer-use enable 启用；不会被 skill metadata 自动激活。 |
artifact | 只在当前 turn 有附件或 artifact 时加入。 |
mcp-<server> | MCP server 工具集被激活或选中时加入。 |
browser | 启用 Browser integration 时由 browser setup 加入，暴露 Anyy 管理的浏览器工具。 |
mcp-browser | Raw MCP browser 后端工具集，仅用于显式 MCP 诊断，不由 browser setup 默认加入。 |
computer_use 不在内置默认列表中，因为它代表更高影响面的能力。启用它会同时更新对应配置块和
toolsets.default。
选择顺序
每一轮中，Anyy 按以下顺序解析工具集：
- 显式 turn metadata
toolsets对当前 turn 优先。 - 接着考虑 active skill toolsets。它们可以合并到普通 profile-derived session defaults， 或在 session 没有已保存列表时合并到内置 defaults。
- 如果 session 已保存的
toolsets列表与当前 profile default 不同，Anyy 会把它视为刻意收窄， 不再合并 active-skill toolsets。 - 没有 active skill additions 时，已有 session 使用 session metadata 中保存的
toolsets。 - 没有显式或已保存列表时，使用内置默认可见列表。
Active skills 可以把工具集加入普通 profile 默认值，但不会加入 computer_use。如果当前 turn
已经提供显式工具集列表，active-skill 工具集不会被隐式加入。
当前 turn 有附件时，Anyy 可能加入运行时 artifact 工具集，让附件相关工具可用。该 runtime
addition 不适用于已经显式提供 toolsets metadata 的 turn。
Session 与渠道
新的 resident session 会在创建时复制 profile 默认工具集。更新 toolsets.default 影响未来
session，不会改写已经运行的 session。
渠道 session 使用和 gateway session 相同的选择规则。渠道可以携带 metadata 来收窄某一轮或某个 session，但没有单独的 channel-only 工具集命名空间。
CLI 创建 cron job 时有自己的 --toolsets 选项。该选项控制定时任务运行时可用的工具，不会改写
toolsets.default。
MCP 工具集
每个配置的 MCP server 都会贡献一个由 server id 生成的工具集：
mcp-<sanitized-server-id>
例如 server id GitHub.Prod 会变成 mcp-github_prod。来自该 server 的工具使用
mcp_<server>_<tool> 前缀，并且只有选中了对应 MCP 工具集时才会加载。
使用 anyy mcp add ... --activate-toolset 或
anyy mcp configure ... --activate-toolset，可以把已启用 MCP server 的工具集加入
toolsets.default。激活要求 server 已启用且 include 列表非空。
如果某个 session 在加入 MCP 工具集之前已经保存了旧默认列表，该 session 不会自动获得 MCP 工具。 请开启新 session，或在当前 turn 显式选择工具集。
治理边界
工具集只控制可见性。可见工具仍可能因为自身描述符、MCP server 策略或
tool_governance.overrides 条目而需要审批、审计、确认或 ChangePlan。
要修改风险或审批行为，请修改工具策略，而不是只改工具集列表。