内置工具管理
工具页用于管理系统内置工具的启停状态。内置工具为智能体提供浏览器操作、截图采集、文件读写、命令执行、内容搜索、时间获取、图表生成、知识检索、地图可视化等基础能力,是完成通用任务的重要执行单元。
页面以卡片方式展示全部内置工具,并在标题区域显示工具总数。每张工具卡片中可查看工具名称、功能简介与当前状态;点击卡片底部开关,即可快速启用或停用对应工具,右上角“刷新”按钮可用于同步最新状态。
内置工具说明
| 工具名称 | 调用标识 | 用途说明 |
|---|---|---|
| 浏览器 | browser_use | 使用浏览器进行自动化操作,适用于访问网页、填写表单、检索在线资料和获取页面内容。 |
| 桌面截图 | desktop_screenshot | 获取桌面或窗口截图,用于界面状态确认、操作结果采集和视觉分析。 |
| 编辑文件 | edit_file | 使用查找替换修改文件内容(替换所有匹配项) |
| 执行命令 | execute_shell_command | 执行系统命令,适用于调用本地程序、运行脚本、检查环境和处理工程文件。该工具支持单独配置异步执行。 |
| 生成图表 | generate_chart | 生成可视化图表,适用于统计结果展示。 |
| 柱状图 | generate_column_chart | 生成柱状图,适用于分类数据对比和数量差异展示。 |
| 条形图 | generate_bar_chart | 生成条形图,适用于横向比较多个类别或指标。 |
| 折线图 | generate_line_chart | 生成折线图,适用于趋势变化、时间序列和连续指标展示。 |
| 面积图 | generate_area_chart | 生成面积图,适用于趋势变化及累积量展示。 |
| 饼图 | generate_pie_chart | 生成饼图,适用于占比、构成和结构关系展示。 |
| 直方图 | generate_histogram_chart | 生成直方图,适用于数值分布、频次区间和数据离散程度展示。 |
| 雷达图 | generate_radar_chart | 生成雷达图,适用于多维度能力、指标或对象对比。 |
| 表格 | generate_table | 生成表格,适用于结构化数据明细、统计结果和清单型内容展示。 |
| 当前时间 | get_current_time | 获取当前时间和时区信息,用于时间敏感任务、日志记录和周期任务判断。 |
| Token 使用 | get_token_usage | 获取 Token 使用统计,帮助评估当前任务或会话的模型调用消耗。 |
| 文件搜索 | glob_search | 按文件名模式查找文件,适用于定位项目文件、批量查找资源和缩小处理范围。 |
| 内容搜索 | grep_search | 按内容搜索文件,支持正则表达式和上下文,适用于定位关键字、函数、配置项和文档片段。 |
| 知识检索 | knowledge_investigator | 使用当前智能体绑定的知识库检索问题相关知识,适用于解释业务术语、项目资料、产品概念和能力边界等需要证据支撑的回答。 |
| 地图可视化* | map_visualize | 根据空间分析结果生成或调整地图可视化结果,支持基础地图、单值专题图、分段专题图、热力图、聚合图、统计图表、OD 图、3D 柱状图和 3D 热力图。对于使用 -1000 自定义坐标系的数据,地图按约定范围进行归一化示意展示,不表示真实地理位置。 |
| 读取文件 | read_file | 读取指定路径的文件内容,支持按行读取,适用于查看配置、代码、日志和文档。 |
| 发送文件 | send_file_to_user | 将文件发送给用户,系统可自动识别文件类型,适用于交付报告、图表、压缩包或处理结果。 |
| 设置时区 | set_user_timezone | 设置用户时区,保证时间计算、定时任务和结果展示与用户所在地区一致。 |
| 启动子任务 | spawn_subagent | 在当前工作区中启动临时子任务,适用于需要拆出独立分析、检索或处理步骤的复杂任务。 |
| 查看图片 | view_image | 加载图片并交给上下文模型分析,适用于截图理解、图片内容识别和视觉检查。 |
| 写入文件 | write_file | 将内容写入指定路径的文件,适用于生成文档、保存代码、输出配置或记录中间结果。 |
| 提交给智能体 | submit_to_agent | 向另一个已配置智能体提交后台任务,通常在主控编排智能体场景下可见,用于多智能体任务委派。 |
| 检查智能体任务 | check_agent_task | 查看后台智能体任务的执行状态,通常与“提交给智能体”配合使用,用于跟踪委派任务进度。 |
建议根据当前业务场景按需启用工具,以减少无关工具被规划器选中的概率,提升任务执行的聚焦度与稳定性。
1、不同智能体可见的内置工具可能不同。提交给智能体、检查智能体任务等委派类工具主要面向主控编排智能体;普通智能体页面中未展示的工具,表示当前智能体不可直接管理或不适用于当前能力边界。
2、当前版本的地图可视化功能中,由于技术实现尚未完全统一,存在两条不同的制图路径:
- 通过已发布的数据服务或地图服务绘制基础地图;
- 通过查询数据直接上图,生成单值专题图等多种专题图。
在现阶段,这两条路径仍在迭代优化中,尚未合并。因此,当您制作某一类可视化内容时,智能体可能会误判或走到另一条制图路径,导致制图失败或结果不符合预期。该问题并非您的操作错误,而是当前功能实现上的暂时性限制。我们正在推进将两条路径统一为“通过服务上图”,后续版本中该问题将得到解决,届时制图流程会更加稳定、清晰。