跳到主要内容

工具与 Toolset

Tool 是 Anyy 完成任务时可以调用的能力。Toolset 则是一组相关工具;模型轮次开始前,Anyy 会选择合适的 Toolsets,避免把所有集成一次性暴露给模型。

在 Dashboard 查看工具

进入 Dashboard → Tools,当前 Profile 可以显示:

分类包含内容
Built-inAnyy 内置工具与实际治理信息
MCP已启用 MCP Server 当前提供的工具
Image图片理解与生成路由
Video视频理解路由
VoiceTTS 与 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
memoryProfile Memory 操作
tasksautomation任务、提醒与定时工作
clarify信息不足时提出结构化问题
fileterminalWorkspace 文件与受治理的命令执行
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 中的能力卡片分别负责设置和健康检查:

浏览器和外部服务工具可能访问真实环境与数据,应遵循页面给出的警告与验证步骤。

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
保存后一直 PendingApprovals 审核 ChangePlan
输出被截断查看 Stored Result,或只提高这个 Tool 的预算
已配置 Tool 在 Session 中不可见确认 Toolset 已激活,再新建 Session
Browser 改完仍不可用运行 anyy browser doctor,修复后刷新 Session
Child 缺少某个 ToolParent Catalog 或 Child Policy 没有允许
Tool 可见但仍要审批Approval 与 Toolset Visibility 相互独立