Skip to main content

工具全表

这一页穷举专家在对话中可以调用的每个工具及其参数。工具是模型的动作接口——模型看不到工具就调不了,工具没在本轮激活就等于不存在。 阅读方式:先在 插件全表 确认某个插件本轮是否激活,再来这里查它注入了哪些工具、参数怎么传。
多数工具用 action 复用签名(一个 browser 工具承载 12 个动作),而不是拆成十几个独立工具。原因是工具数量直接吃系统提示词的上下文预算,且工具越多模型选错的概率越高。代价是参数表变长且大部分参数对某个具体 action 无意义。

沙箱工具(不属于任何插件)

沙箱模式非 none始终可用,不需要勾任何插件。这是最常被误解的一组——用户以为”没开插件就不会动文件”,实际上文件读写是基础能力。
editold_string 必须与文件内容逐字符精确匹配,包括缩进和空白。模型改大文件时最常见的失败就是这里——它凭记忆拼 old_string 而不是先 read。你看到反复的 edit 失败重试,多半是这个原因。lspread_lintspaths 留空时,检查本轮会话写过或改过的每个文件

计划模式专属

plan_write 的路径不可配置是刻意的:计划模式滤掉了所有写世界的工具,如果 plan_write 能指定路径,它立刻退化成一个通用写入口,模式隔离就破了。

浏览器(profy-browser

action 取值:navigatescreenshotsnapshotclicktypefillscrollpress_keytabsset_htmlevaluatego_back 传错会拿到:
refsnapshot 返回的元素句柄,只对那次快照有效。页面一变就必须重新 snapshot 取新 ref,否则点到错的元素或直接失败。 细粒度变体(browser_click / browser_fill / browser_navigate / browser_press_key / browser_scroll / browser_snapshot / browser_tabs / browser_take_screenshot / browser_type)在部分链路里单独暴露,参数与聚合版一致。

Chrome 扩展(profy-chrome

需要 chrome_connected: true profy-browser 的关键差别:Chrome 操作的是你自己的浏览器,带你的登录态。所以它有四级权限门禁,涉及金融与账号操作一律阻断。

电脑操作(profy-computer

需要 desktop_connected: true action 取值:screenshotclickdouble_clicktypescrolldragkeypressinvoke_menumovewaitcursor_positionlist_windowsget_window_statelaunch_applist_appsget_accessibility_treebring_to_frontset_valuecheck_permissions 细粒度变体:clickdragkeymouse_movescreenshotscrolltype_textlist_windowsget_window_state check_permissions 值得先调一次——macOS 辅助功能权限没给的话,后面每个动作都会失败,而失败信息不一定指向权限。

创意生成(profy-creative

自动可用,不需要勾选。 read 这个 action 常被忽略:它让模型看见已生成的图/视频,是”生成 → 自检 → 重生成”闭环的关键一步。缺了它模型只能凭 prompt 想象产出效果。 计费按 计费公式per_callduration_second 计。

搜索(profy-search

需要 enable_web_search: true 签名极简是有意的:搜索结果必须在返回前做单条内容截断 + 结果数上限,参数放开会让并行多次搜索直接把上下文打爆。

记忆(profy-memory

需要 enable_memory: true memory_type 取值:preferencefactskillhabiteventcontextconstraintdecisionentityscope 取值:user(个人)、expert(该专家专属)。 传错 action 会拿到:
开发者平台的终端用户(通过 /v1/* API 调用)整个工具被拒绝。原因是记忆按平台用户隔离,终端用户不是平台身份,写进去会串号。

知识库(profy-knowledge

platform 留空时搜索全部已连接平台。写操作(create / append)取决于该平台适配器是否实现,未实现会明确报能力不支持而不是静默失败。

技能(profy-skill

name 用限定名:builtin/docxuser/nuwaexpert/my-skill。裸名在不冲突时自动解析。 executeresource_typescript / reference / asset / template / workflow脚本是黑盒执行——只回 stdout/stderr,源码不进上下文。这是刻意的:技能脚本动辄几百行,全塞进去会挤掉真正要处理的数据。

委托与调度

schedule 的 action 只有 addsearch
  • add 必填 title + prompt + scheduled_date(ISO,如 2025-03-15)+ scheduled_timeHH:MM
  • repeat_typeno-repeat / daily / weekly / monthly
  • dependency_strategy:前置任务失败时 skipcontinue
  • searchstatus 过滤:pending / running / completed / paused / all
传错 action:❌ Invalid action 'xxx'. Must be 'add' or 'search'. 没有 delete / update。改定时任务要去产品界面,不能靠对话。 delegate 默认分离执行(detached)——发出去就不阻塞当前对话。

人机交互(profy-message

专家需要你做选择时调它,前端渲染成选择卡片。这是唯一能中断执行等你回答的机制。

建站(profy-sites

需要 sandbox_mode != none
deploy 不会发布。真正的发布唯一入口是 UI 上的部署弹窗。专家调 deploy 只是把请求推给你确认——这是刻意的单向门,避免专家自作主张上线。

可视化(profy-visualize

画布(profy-canvas

concurrency 默认 1 是保守选择——并发跑 DAG 会同时触发多个计费生成任务。

视频制作(profy-movie

exclusive: true,开启时其他插件不加载。 movie 的 action 是流水线阶段:briefscriptstoryboardstrategyassemblecaptionexporttimeline_edit 的 action:insert_clipremove_cliptrimsplit 等。

飞书(profy-feishu

需要 has_feishu_client: true 写操作需要用户授权,未授权时返回授权标记引导你发 /auth。详见 飞书工具集

报关(profy-customs

录制回放(profy-record-and-replay

需要 desktop_connected: true

蒸馏与进化(内部)

evolution_log 的参数:action(只能是 suggest_skill_improvement)、skill_namesummarydiff_summaryimproved_contentbefore_scoresafter_scoresimproved_dimensions。评分规则见 自进化

四个 office 插件没有工具

profy-docx / profy-pdf / profy-pptx / profy-xlsx 的 manifest 里 tools 为空。它们通过技能文档 + 沙箱预装库工作,专家用 bash 执行脚本。查具体方法见各自单页。

相关页面

插件全表

哪些工具本轮会被激活

技能目录

工具之外的方法层

限额表

超时、条数、体积上限

计费公式

工具调用怎么计费
核对日期 2026-08-11。来源:services/agent-runtime/src/base/tools/sandbox.pyservices/agent-runtime/src/plugins/builtin/*/tools/*.py。默认值直接取自各工具的 Field(default=...)