Tools

打开 Dashboard → Tools，先确认当前 Profile，再检查所需能力。这里展示可供运行时使用的库存；当前对话向模型声明了哪些工具，还取决于会话选择和作用域。

找到对应入口

页面分类	可做的操作
Built-in	查看内置定义；进入 Codemode 设置
MCP	查看已启用 Server 当前提供的工具
Image、Video	配置图片理解、图片生成和视频理解模型路由
Voice	配置语音识别与语音合成路由
Web Search	配置公开网页搜索后端

打开一条内置或 MCP 工具，可以核对来源、Toolset、描述、输入 Schema、超时以及可见／存储输出预算。定义和预算在这里只读。MCP 的远端定义来自 Server 目录，要改变暴露方式请到 MCP。

结果被截短时，应按照结果提示继续读取，或用 tool_result_read 读取可完整检查的逻辑结果引用；页面有预算值不代表每次结果都保存了完整正文。详见内置工具参考。

配置 Codemode

入口是 Tools → Built-in → codemode。它让模型用 JavaScript 调用当前会话已有工具；脚本用法和模型 API 见 Codemode。页面上的两种保存操作作用不同。

给后续会话设置默认值

在 Profile 区域选择启用方式和模式，点击 Save：

启用方式	含义
Use current tool selection	沿用工具选择和 MCP 自动激活规则，不等于关闭
Enable	为新会话默认选择添加 Codemode
Disable	为新会话显式排除 Codemode

on 保留直接工具入口，也允许脚本；only 隐藏请求中可由脚本调用的直接声明，这些工具仍可通过 Codemode 使用。模式是 Profile 共享设置，在下一次准备请求时采用，不修改已准备的请求。模式本身不会激活 Codemode，也不是 Role。

保存 Profile 默认值不会重选已有会话。其它工具规则和排除项保持其作用；若单独修改 Codemode 必须同时改变其它规则，保存会失败并保留原配置。

页面区分 Applied 与 Saved, not yet applied。手工编辑配置文件后，应在这里明确保存，或重启 Gateway；Provider reload 不负责发布工具设置。

修改一个已有会话

1. 在 Session override 选择目标会话并查看状态。
2. 等待会话空闲，且没有排队输入。
3. 选择启用／停用，再点击 Apply to Session。
4. 查看返回状态，确认操作生效。

该操作只切换 Codemode，保留会话其它活动工具和选择规则；不会扩大受限会话原有的允许清单。因此 Profile 默认已经启用时，旧的受限会话仍可能拒绝启用。Not loaded yet 表示尚未观察到该会话的常驻工具状态，不能据此判断已经关闭。会话没有单独的模式字段。

MCP 与工具搜索是否一起改变

不会。MCP 配置可在规则允许时自动激活 Codemode；沿用当前选择会保留这个行为，显式排除仍然优先。停用 Codemode 不会停用 MCP 或 tool_search；已允许且活动的工具搜索仍能发现间接 MCP 工具。页面会提示剩余可用路径。

工具搜索说明下一请求激活语义；CLI 参数与手工配置见 Toolset 工具组。

配置和检查能力后端

Web Search 卡片可以选择 Provider、Endpoint 和凭据并验证。图片、视频与语音卡片复用模型配置入口，配置各自路由。

CLI 可查看或检查同一套能力：

anyy tools list
anyy tools websearch
anyy tools image --probe
anyy tools image generation --probe
anyy tools video understanding --probe
anyy tools voice tts --probe
anyy tools voice stt --probe

后端已配置，不代表已有会话会立即声明该工具。先确认后端可用，再核对 Profile、Toolset 和会话选择；Codemode 则使用上面的会话专用操作。

常见问题

现象	排查位置
页面列出工具，对话却看不到	会话活动选择、工具组和父任务限制
MCP 工具缺失	Server 是否启用、连接状态、Exposure 和发现工具
Codemode 的 Profile 保存成功，旧会话仍关闭	对目标空闲会话另外执行 Apply to Session
输出只剩摘要	结果的继续读取提示、逻辑引用与实际保留方式