工具全表
这一页穷举专家在对话中可以调用的每个工具及其参数。工具是模型的动作接口——模型看不到工具就调不了,工具没在本轮激活就等于不存在。 阅读方式:先在 插件全表 确认某个插件本轮是否激活,再来这里查它注入了哪些工具、参数怎么传。多数工具用 action 复用签名(一个
browser 工具承载 12 个动作),而不是拆成十几个独立工具。原因是工具数量直接吃系统提示词的上下文预算,且工具越多模型选错的概率越高。代价是参数表变长且大部分参数对某个具体 action 无意义。沙箱工具(不属于任何插件)
沙箱模式非none 时始终可用,不需要勾任何插件。这是最常被误解的一组——用户以为”没开插件就不会动文件”,实际上文件读写是基础能力。
计划模式专属
plan_write 的路径不可配置是刻意的:计划模式滤掉了所有写世界的工具,如果 plan_write 能指定路径,它立刻退化成一个通用写入口,模式隔离就破了。
浏览器(profy-browser)
action 取值:navigate、screenshot、snapshot、click、type、fill、scroll、press_key、tabs、set_html、evaluate、go_back。
传错会拿到:
ref 是 snapshot 返回的元素句柄,只对那次快照有效。页面一变就必须重新 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 取值:screenshot、click、double_click、type、scroll、drag、keypress、invoke_menu、move、wait、cursor_position、list_windows、get_window_state、launch_app、list_apps、get_accessibility_tree、bring_to_front、set_value、check_permissions。
细粒度变体:click、drag、key、mouse_move、screenshot、scroll、type_text、list_windows、get_window_state。
check_permissions 值得先调一次——macOS 辅助功能权限没给的话,后面每个动作都会失败,而失败信息不一定指向权限。
创意生成(profy-creative)
自动可用,不需要勾选。
read 这个 action 常被忽略:它让模型看见已生成的图/视频,是”生成 → 自检 → 重生成”闭环的关键一步。缺了它模型只能凭 prompt 想象产出效果。
计费按 计费公式 的 per_call 或 duration_second 计。
搜索(profy-search)
需要 enable_web_search: true。
签名极简是有意的:搜索结果必须在返回前做单条内容截断 + 结果数上限,参数放开会让并行多次搜索直接把上下文打爆。
记忆(profy-memory)
需要 enable_memory: true。
memory_type 取值:preference、fact、skill、habit、event、context、constraint、decision、entity。
scope 取值:user(个人)、expert(该专家专属)。
传错 action 会拿到:
知识库(profy-knowledge)
platform 留空时搜索全部已连接平台。写操作(create / append)取决于该平台适配器是否实现,未实现会明确报能力不支持而不是静默失败。
技能(profy-skill)
name 用限定名:builtin/docx、user/nuwa、expert/my-skill。裸名在不冲突时自动解析。
execute 的 resource_type 取 script / reference / asset / template / workflow。脚本是黑盒执行——只回 stdout/stderr,源码不进上下文。这是刻意的:技能脚本动辄几百行,全塞进去会挤掉真正要处理的数据。
委托与调度
schedule 的 action 只有 add 与 search:
add必填title+prompt+scheduled_date(ISO,如2025-03-15)+scheduled_time(HH:MM)repeat_type:no-repeat/daily/weekly/monthlydependency_strategy:前置任务失败时skip或continuesearch的status过滤:pending/running/completed/paused/all
❌ Invalid action 'xxx'. Must be 'add' or 'search'.
没有 delete / update。改定时任务要去产品界面,不能靠对话。
delegate 默认分离执行(detached)——发出去就不阻塞当前对话。
人机交互(profy-message)
专家需要你做选择时调它,前端渲染成选择卡片。这是唯一能中断执行等你回答的机制。
建站(profy-sites)
需要 sandbox_mode != none。
可视化(profy-visualize)
画布(profy-canvas)
concurrency 默认 1 是保守选择——并发跑 DAG 会同时触发多个计费生成任务。
视频制作(profy-movie)
exclusive: true,开启时其他插件不加载。
movie 的 action 是流水线阶段:brief → script → storyboard → strategy → assemble → caption → export。
timeline_edit 的 action:insert_clip、remove_clip、trim、split 等。
飞书(profy-feishu)
需要 has_feishu_client: true。
写操作需要用户授权,未授权时返回授权标记引导你发
/auth。详见 飞书工具集。
报关(profy-customs)
录制回放(profy-record-and-replay)
需要 desktop_connected: true。
蒸馏与进化(内部)
evolution_log 的参数:action(只能是 suggest_skill_improvement)、skill_name、summary、diff_summary、improved_content、before_scores、after_scores、improved_dimensions。评分规则见 自进化。
四个 office 插件没有工具
profy-docx / profy-pdf / profy-pptx / profy-xlsx 的 manifest 里 tools 为空。它们通过技能文档 + 沙箱预装库工作,专家用 bash 执行脚本。查具体方法见各自单页。
相关页面
插件全表
哪些工具本轮会被激活
技能目录
工具之外的方法层
限额表
超时、条数、体积上限
计费公式
工具调用怎么计费
核对日期 2026-08-11。来源:
services/agent-runtime/src/base/tools/sandbox.py、services/agent-runtime/src/plugins/builtin/*/tools/*.py。默认值直接取自各工具的 Field(default=...)。
