工具参考
本页列出 Anyy resident runtime 可以暴露给模型的工具。Toolsets 决定工具是否可见；工具可见后，risk、approval、ChangePlan 和 audit policy 仍然生效。
工具选择规则见 Toolsets Reference。
当前 runtime catalog 可通过 /tools、/toolsets 或 dashboard 的 /dashboard/tools 页面查看。
默认 Runtime 工具
当对应 toolset 被选中时，这些工具可由内置 runtime 暴露。
| Toolset | Tools | 说明 |
|---|---|---|
web | web_search、web_fetch、web_extract | 公共 web 搜索和 HTTP(S) 获取。Extraction 会阻止 private/internal network URLs。 |
sessions | session_search | 在当前 session scope 中搜索近期 sessions 和历史消息。 |
memory | memory | 结构化长期 memory 编辑工具，支持 add、replace、remove。 |
tasks | task_create、task_list、task_update、task_complete | 持久个人任务。写操作会被审计。 |
automation | automation_list、automation_create、automation_update、automation_delete、automation_run、automation_history | Scheduled automations 和 reminders。Script cron jobs 不暴露给模型 automation tools。 |
messaging | messaging_status、message_receipt、notify_user、send_message | 用户可见通知，以及 current-user/current-origin 消息。不能向任意外部联系人发送。 |
skills | skills_list、skill_view、skill_manage | Skill 发现、查看、reload 和 managed-skill 操作。skill_manage 会在 gateway skill resolver/manager 可用时出现；更底层的 registry-only 构建可能只暴露 list/view。具体 action 取决于 skill root policy。 |
file | read_file、write_file、search_files、patch | Workspace/local file 操作。写入和 patch 是高影响操作，会被 policy gate。 |
terminal | bash、process | Shell 执行和托管后台进程控制。高影响操作使用 ChangePlan gate。 |
tts | text_to_speech | 配置 TTS provider 后生成 audio artifact。 |
clarify | clarify | 通过当前 surface 向用户询问缺失信息。 |
subagents | delegate_task、background_job、subagent_list、subagent_history、subagent_cancel | 委托、异步子 Agent 工作、子任务控制。 |
clarify 和 subagents 工具由 gateway service 追加，因此可能不会出现在底层 registry-only 测试里。
可选 Connector 工具
只有当对应 connector 或 service 接入 runtime 时，这些工具才会出现：
| Toolset | Tools | 何时可见 |
|---|---|---|
email | email_status、email_search、email_get、email_draft、email_send | Email connector 已接入 runtime。email_send 需要 approval。 |
calendar | calendar_status、calendar_list、calendar_get、calendar_draft、calendar_create、calendar_update、calendar_cancel | Calendar connector 已接入 runtime。Create、update、cancel 需要 approval。 |
artifact | artifact_list、artifact_inspect、artifact_pin | Runtime artifact service 可用，且当前 turn 选择或获得 artifact toolset。有附件的 turn 可以自动获得它，除非该 turn 显式提供了 toolsets。 |
media_generation | image_generate | Image generation provider/service 已配置。 |
computer_use | computer_use | 通过 computer-use setup 路径启用。 |
mcp-<server> | mcp_<server>_<tool> | MCP server 已启用，且选择了对应 toolset。 |
browser | Anyy browser tools | Browser integration 已启用并激活。 |
mcp-browser | Raw MCP browser tools | 仅用于显式 MCP 诊断，不由 browser setup 默认激活。 |
不要把可选工具写成始终可用。如果 connector 未配置，runtime 不会暴露对应 toolset。
Risk 和审批摘要
Descriptor risk values 包括 read、runtime-low、runtime-high、config-low、
config-high、credential-high、dangerous 和 force-required。Approval policy
values 是 none、hook、always。Execution policy values 是 direct、audit、
confirm、change_plan 和 force_change_plan。
| 类别 | 示例 | 行为 |
|---|---|---|
| Direct read | web_search、session_search、task_list、email_search、calendar_list | 不需要 approval；适用时作为 runtime read 审计。 |
| 审计的低风险变更 | task_create、automation_create、memory、notify_user | 默认不需要用户 approval，但会记录 audit events。 |
| 需要确认的 connector mutation | email_send、calendar_create、calendar_update、calendar_cancel | Connector mutation replay 前需要 approval。 |
| ChangePlan-gated host operation | bash、process kill、write_file、patch | 状态改变前需要 ChangePlan 或 policy hook approval。 |
具体策略还可能受 MCP server policy 和 tool_governance.overrides 影响。
Output Budgets
每个 descriptor 都可以设置 output_budget.visible_chars 和 output_budget.stored_chars。
Visible output 会在回到当前 turn 前被截断。Stored output 可以为 history、audit 或后续读取保留更多细节。
如果成功的 visible result 超过 visible budget，Anyy 可以把完整输出持久化到
ANYY_TOOL_RESULTS_DIR；未设置该环境变量时使用 /tmp/anyy-results。Visible result
会变成一个简短的 <persisted-output> 预览，metadata 会记录 persisted_output_path 和
persisted_output_bytes。
工具说明
Web
web_search 返回公共搜索结果。web_fetch 获取一个公共 HTTP(S) URL。web_extract 从最多五个公共 HTTP(S) URLs 提取可读内容，并阻止 private/internal network URLs。
Memory
普通 memory surface 只有一个工具，名为 memory。它接受 action、target、content 和 old_text。底层 memory maintenance tools 不属于默认模型可见 runtime。
Automation
Automation tools 使用 canonical schedule object：
{"type": "every", "mode": "interval", "interval": "30m"}
它们会拒绝 legacy 顶层 schedule 字段，例如 when、every、cron 和 recurring。
见 定时任务（Cron）。
Subagents
delegate_task 是同步工具，会把子任务摘要返回给父 turn。background_job 是异步工具，会返回 background_job_id。控制工具可以列出、查看和取消当前 session 拥有的子任务。
Terminal 和 Process
bash 执行 shell 命令。搭配 background=true 时，它会创建托管后台进程。process 可以 list、poll、log、wait、kill、write、submit 或 close 由 Anyy 创建的托管进程任务。
process 不是通用主机进程查看器。
Email 和 Calendar
Email 和 calendar 工具由 connector 支撑。Read/status 工具是 direct reads。Draft 工具创建 connector draft，不发送。发送邮件和修改日历事件需要 approval。
本参考只描述模型可见的 tool contracts。如果构建没有提供 email 或 calendar connector，runtime 中不会出现这些 toolsets。