工具与 Toolset
Tool 是 Anyy 完成任务时可以调用的能力。Toolset 则是一组相关工具;模型轮次开始前,Anyy 会选择合适的 Toolsets,避免把所有集成一次性暴露给模型。
在 Dashboard 查看工具
进入 Dashboard → Tools,当前 Profile 可以显示:
| 分类 | 包含内容 |
|---|---|
| Built-in | Anyy 内置工具与实际治理信息 |
| MCP | 已启用 MCP Server 当前提供的工具 |
| Image | 图片理解与生成路由 |
| Video | 视频理解路由 |
| Voice | TTS 与 STT 路由 |
| Web Search | 获取最新公开信息的搜索 Backend |
| Browser | 托管 Playwright 能力或兼容 MCP 连接 |
打开 Built-in 或 MCP Tool,可以检查:
- Source 和 Toolset;
- Description 与 Input Schema;
- Risk;
- Approval/Execution Policy;
- Timeout;
- Visible/Stored Output Budget。
Input Schema 是 Anyy 调用该工具必须遵守的参数契约。MCP Schema 来自实时 Server Catalog;远程工具范围应在 MCP 集成中管理。
默认可见 Toolsets
| Toolset | 典型能力 |
|---|---|
artifact | 列出、检查、Pin 和导出 Session 文件 |
web | 公开网页搜索与读取 |
sessions | 搜索当前 Profile 的历史 Session |
memory | Profile Memory 操作 |
tasks、automation | 任务、提醒与定时工作 |
clarify | 信息不足时提出结构化问题 |
file、terminal | Workspace 文件与受治理的命令执行 |
messaging | 带 Channel Context 的消息操作 |
skills | 发现并使用已安装 Skills |
subagents | 委派、后台工作和 Child 控制 |
tts | 已配置 TTS 时生成语音回复 |
Runtime 可能安装更多组,但 Optional Capability 不等于默认可见。
Dashboard 不提供“任意开关所有默认 Toolset”的通用编辑器。受支持的功能流程会一致地调整目录,例如启用 Browser 时加入对应 Toolset,激活 MCP Server 时可以加入 mcp-NAME。
调整运行限制
受支持的 Tool Detail 只允许修改资源边界:
- Visible characters:最多投射到对话中的字符数;
- Stored characters:最多保留的字符数,且不能小于 Visible;
- Timeout:100 到 600,000 毫秒。
保存会提交高风险 Configuration ChangePlan;批准前不会应用。
Risk、Approval Policy、Execution Policy、Enabled State、Description 和 Schema 都是只读项。资源调优不能借机降低工具安全契约。
更长输出会消耗上下文与存储。优先缩小调用范围或生成文件 Artifact;确实被截断时,再只调整对应 Tool。
配置能力 Backend
Dashboard 中的能力卡片分别负责设置和健康检查:
- 联网搜索:选择 Provider、Endpoint 与凭据并验证;
- 浏览器:启用本机托管 Playwright,或连接可信 LAN Endpoint;
- 媒体理解、图像生成、语音与听写:使用各自专用模型路由。
浏览器和外部服务工具可能访问真实环境与数据,应遵循页面给出的警告与验证步骤。
CLI 检查和 Probe:
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
anyy browser status
anyy browser doctor
MCP Toolsets
每个已激活 MCP Server 使用独立组,例如 mcp-docs。Include/Exclude List 会在激活前限制远程 Tools;新建或刷新的 Session 只接收选择后的 Catalog。
MCP 配置不能覆盖 Tool 的 Risk、Approval、Timeout、Audit 与 Output Budget。
Session、Skill 与可见性
Session 可以保存明确的 Toolset 选择。Skill 可以请求需要的组,但 Runtime 仍会执行 Policy Filter;Child Session 只能获得 Parent 已经允许的工具。
当前 Turn 带附件时,Anyy 可以临时加入 artifact,读取本 Session Scope 内的文件。
Backend 已配置,不代表旧 Session 一定马上看到。启用能力后,先在 Tools 页面确认;Catalog 没变化时,新建 Session 再试。
看得到 Tool 不会绕过 Risk、Approval、ChangePlan、Audit、Credential 或 Path Control。Toolset 只缩小和组织目录,本身不授予 Authority。
常见问题
| 现象 | 处理方法 |
|---|---|
| Tool 存在但 Disabled | 检查对应 Backend 和 Toolset |
| MCP Tool 缺失 | Probe、Include、Enable、Activate 后 Reload MCP |
| 保存后一直 Pending | 到 Approvals 审核 ChangePlan |
| 输出被截断 | 查看 Stored Result,或只提高这个 Tool 的预算 |
| 已配置 Tool 在 Session 中不可见 | 确认 Toolset 已激活,再新建 Session |
| Browser 改完仍不可用 | 运行 anyy browser doctor,修复后刷新 Session |
| Child 缺少某个 Tool | Parent Catalog 或 Child Policy 没有允许 |
| Tool 可见但仍要审批 | Approval 与 Toolset Visibility 相互独立 |