跳到主要内容

内置工具参考

Built-in Tools 是 Anyy 在模型 Turn 中可以选择的操作。Dashboard → Tools 会显示当前实例的最终清单,以及 Source、Toolset、Risk、Execution Policy、Approval Policy 和 Enabled State。

文件与终端

ToolToolset用途
readfile读取文本文件或指定范围
lsfile列出目录
findfile查找路径
grepfile搜索文件内容
writefile创建或替换文件
editfile定点编辑文本
apply_patchfile应用结构化的多文件 Patch
bashterminal在当前 Working Directory 执行 Shell Command
processterminal与已经跟踪的后台进程交互

Read 通常直接执行;文件修改和 Shell 会经过风险分析、Approval、ChangePlan、Audit、路径规则和 Session Mode。

会话、记忆和任务

ToolToolset用途
session_searchsessions在当前 Scope 搜索过去的 Profile Sessions
tool_result_readCore分段读取已经保存的 Tool Result Evidence
clarifyclarify暂停当前 Run,向用户提出一个结构化问题
memorymemoryUSER.md/MEMORY.md 执行 Add、Replace、Remove
task_createtasks创建持久个人任务
task_listtasks查询与筛选任务
task_updatetasks修改任务字段或状态
task_completetasks完成任务并可附 Note

memory 只适合长期事实和偏好,不应用来保存临时进度、复制资料或 Secrets。

Role Onboarding

Tool可用条件用途
role_onboarding_complete当前 Session 的 Role 仍处于 Pending/Active Onboarding 时提议最终 SOUL.md,并在用户批准后写入

Onboarding 完成后,后续 Session Catalog 不再出现这项 Tool。

自动化与消息

ToolsToolset用途
automation_listautomation_historyautomation查看 Schedules 与 Run History
automation_create/update/delete/runautomation管理或触发定时工作
messaging_statusmessaging查看可用 Delivery Routes
notify_usermessaging通过当前 Runtime Route 通知用户
send_messagemessaging从受支持 Channel 发送消息/附件
message_receiptmessaging查看 Delivery Receipt

Outbound Delivery 仍取决于 Channel Account、Conversation Scope、Access Policy 与 Adapter Capability。

Artifacts 与生成媒体

ToolToolset可用条件
artifact_list/inspect/pin/exportartifactArtifact Service 活动时
image_generatemedia_generation已配置图片生成
text_to_speechtts已配置 TTS Route

artifact_export 会把 Workspace 相对路径的文件交付为临时附件,不移动或删除源文件。

Web 与 Browser

ToolToolset用途
web_searchweb通过配置的 Provider 搜索公开网页
web_fetchweb获取一个公开 HTTP(S) URL 的可读内容
web_extractweb把多个公开 URL 抽取为结构化结果
browser_navigatebrowser导航托管 Browser
browser_observebrowser读取当前页面的有限表示
browser_screenshotbrowser截取页面或元素
browser_wait_forbrowser等待文本、消失或时间
browser_actbrowser根据最近 Observe Ref 点击或输入
browser_status/tabs/closebrowser查看和管理 Browser Session

Browser Backend Enabled 且 Healthy 时才会出现这些工具。Navigate/Act 仍保留 Confirmation、Policy 与 Audit。

Skills 与委派

ToolToolset用途
skills_listskill_viewskills发现并读取已启用 Skill
skill_manageskills安装、创建、Patch、编辑、删除、回滚、Reload 或维护 Managed Skill Supporting Files
delegate_tasksubagents执行一个或一组有边界的 Child Tasks
background_jobsubagents启动独立后台工作
subagent_list/history/cancelsubagents查看或停止 Child Work

Profile 的 Managed Skill Service 可用时,Catalog 会出现 skill_manage。它属于经过 Audit 的高风险配置 Tool,但不会单独弹出 Approval;System Skills 仍然不可修改。Dashboard/CLI 继续提供由用户明确发起的 Install、Rollback、Remove 与 Enable/Disable 流程。自动复盘如何使用这个 Tool,见 Skills

MCP Tools

Enabled MCP Server 会提供隔离 Toolset,例如 mcp-docs。Tool Names 来自 Server Live Catalog 与 Include List,不属于这份静态 Built-in 清单。

Enable 前先 Probe 并检查工具;Remote Tool 同样接受 Anyy Governance,也可能要求 Approval。

可见不等于有权限

Tool 已显示,仍可能因 Credential、Backend Health、Profile/Session Toolset、Scope 或 Approval 而不可用。

精确可用性以 Live Catalog 为准

本页描述稳定的用户级分组。Dashboard → Tools 和当前 Session Catalog 才反映 Optional Service、MCP 与当前配置。

相关说明见 Toolsets文件与终端Approvals 与 ChangePlans