跳到主要内容

工具集

工具集用于让某一轮的模型可见工具列表保持聚焦。常见工具集包括 web、memory、 terminal、messaging、subagents 和 mcp-docs。

工具集控制的是可见性，不是信任边界。即使工具可见，它仍可能需要审批、审计、确认或 ChangePlan。

默认可见工具集​

新 profile 使用 Anyy 的内置默认可见列表：

toolsets:
  default:
    - web
    - sessions
    - memory
    - tasks
    - automation
    - clarify
    - file
    - messaging
    - skills
    - subagents
    - terminal
    - tts

省略 toolsets.default 时，Anyy 使用该内置列表。定义了 toolsets.default 时， 新 session 会把 profile 列表复制到自己的 session metadata。

已有 session 会保留自己已经存储的列表。想让默认工具集变更干净生效，请开启新 session。

启用与禁用工具集​

本构建没有单独的 anyy toolsets enable 命令。工具集通常由拥有它的功能启用，或通过编辑 toolsets.default 调整。

常见路径：

需求路径
修改普通默认工具集编辑 config.yaml 中的 toolsets.default。
添加 MCP server 的工具使用 anyy mcp add ... --activate-toolset 或 anyy mcp configure ... --activate-toolset。
启用 computer use使用 anyy computer-use enable。
给 cron job 更窄的工具集创建 cron 时使用 --toolsets 选项。

提交配置时推荐 YAML list：

toolsets:
  default:
    - web
    - memory
    - terminal

未知工具集名称不会导致配置加载失败，但除非运行时 provider 提供同名工具集，否则不会暴露内置工具。当前内置 runtime 不提供 home 工具集。

按入口区分的工具集​

Gateway、Dashboard chat、CLI 创建的 session 和消息渠道都使用同一套选择规则。Turn 可以携带显式 toolsets metadata；该列表对当前 turn 优先。否则 Anyy 使用 session 已保存的 toolsets metadata。如果 session 没有已保存列表，则使用内置默认可见列表。

Profile default 通常是在创建新 session 时复制到 session metadata 中影响后续 turn。它不会在每次 send 时改写旧 session。

Active skills 可以在当前 turn 使用普通 profile-derived session defaults 或内置 defaults 时，加入自己 metadata 声明的工具集。它们不会加入 computer_use，也不会扩宽已经带有显式工具集列表的 turn，或被刻意收窄过的 session 列表。

有附件的 turn 可以获得运行时 artifact 工具集，让附件相关工具只在需要时可见。如果该 turn 显式提供了 toolsets metadata，Anyy 不会隐式加入 artifact。

消息平台工具集​

消息渠道没有单独的 channel-only 工具集命名空间。Telegram 或其他渠道 session 使用和 resident gateway session 相同的已保存 session 默认值。

如果某个渠道工作流不应暴露太宽的工具集，请收窄该渠道使用的 session 或 role metadata。不要只依赖渠道名称作为工具策略。

MCP 工具集​

每个 MCP server 都会得到一个由 server id 生成的工具集：mcp-<server>。例如 server id GitHub.Prod 会变成 mcp-github_prod。

只有选中对应 MCP 工具集时，MCP 工具才会加载。这避免了“只要 server 出现在 config.yaml 里就自动对模型可见”。

使用：

anyy mcp add docs --command CMD --enable --include search --activate-toolset
anyy mcp configure docs --include search,read_doc --enable --activate-toolset

激活要求 MCP server 已启用且 include 列表非空。字段级 MCP 策略见 MCP 配置参考。

Computer Use 工具集​

computer_use 有意不在默认可见列表里。它是影响面更高的能力，也不会被 skill metadata 自动激活。

请通过 setup 命令启用它，让 Anyy 同时写入相关能力配置并更新 toolsets.default：

anyy computer-use enable

禁用时请使用对应 computer-use 流程，或从 toolsets.default 移除 computer_use 并清理相关能力配置。

精确字段行为和选择顺序见工具集参考。