工具与技能设置

自主规划式智能体支持从 MCP内置工具技能 三个维度扩展执行能力。其中,内置工具提供通用基础操作能力,MCP 服务负责接入标准化外部能力,技能用于沉淀可复用的任务经验与工作方式。通过统一管理这些能力,您可以按业务场景灵活组合智能体的执行链路。

MCP工具管理

MCP 管理页用于统一维护智能体可调用的 MCP 服务,支持导入已有服务、创建自定义服务,以及对服务进行启用、停用、编辑和删除等操作。只有处于启用状态的 MCP 服务,才会在任务规划与执行阶段被智能体选用。

导入服务

自主规划式智能体支持将 SuperMap AgentX Server 产品中内置的 MCP 服务与“AgentX Server 管理服务”>“MCP 服务管理”中已添加的 MCP 服务一键导入到当前智能体中,统一管理与调用。

在设置界面依次点击“MCP”>“导入服务”,在服务列表中选择需要导入的服务后,点击“新增”按钮即可完成导入。需要注意的是,同一个服务不支持重复导入。

新建服务

如果现有服务无法满足需求,您也可以按需新建外部 MCP 服务。在设置界面依次点击“MCP”>“新建服务”,填写以下内容:

  • 服务名称:填写接入的 MCP 服务名称;
  • 描述:说明该服务的来源、用途与适用场景,便于后续管理与识别;
  • 协议类型:选择 MCP 服务所使用的协议类型,支持 SSE 模式和 STDIO 模式;
    • SSE 模式:Server-Sent Events(SSE,服务器发送事件)是一种基于 HTTP 协议的技术,允许服务器向客户端单向、实时地推送数据,通过 URL 地址配置即可使用;
    • STDIO 模式:通过本地进程间通信实现,客户端以子进程形式启动服务器,双方通过 stdin/stdout 交换 JSON-RPC 消息,适合内网环境或本地工具调用场景。
      • 指令:支持 npx、uv 命令;
      • 参数:支持输入多个参数,如有多个参数,请使用逗号分隔,例如 -m, mcp_server
      • 环境变量:支持配置多个环境变量。

添加 MCP 服务后,还可在列表中继续进行启用、停用、编辑或删除操作。建议仅保留当前业务实际需要的服务,避免无关服务参与任务规划。

内置 MCP 服务说明

自主规划式智能体内置的 MCP 服务为8类GPA MCP 工具集,提供空间数据处理与分析的核心 GIS 服务,建议在执行地图制图、空间分析、栅格分析、数据处理等任务时重点启用。

MCP 服务名称 能力类别 用途说明
gpa-mcp-v2-common GPA 通用工具集 提供数据集检索、元信息查看、任务状态查询等基础能力,是 GIS 任务定位数据和检查执行状态的通用入口。
gpa-mcp-v2-typeconversion GPA 类型转换工具集 提供空间数据类型、维度和结构转换能力,用于在不同数据类型或处理链路之间衔接输入输出。
gpa-mcp-v2-datatools GPA 数据迁移工具集 提供多格式数据互操作与交换能力,适用于数据导入、导出、迁移和结果交付。
gpa-mcp-v2-vectoranalyst GPA 矢量分析工具集 提供基于矢量数据的空间关系判断、缓冲区、叠置、裁剪、擦除等空间分析能力。
gpa-mcp-v2-dataprocess GPA 数据处理工具集 提供字段计算、属性关联、几何处理、数据清理、拆分合并等空间数据加工能力。
gpa-mcp-v2-mosaic GPA 镶嵌数据集工具集 面向海量多源影像数据,提供镶嵌数据集组织、管理和处理能力。
gpa-mcp-v2-datamanager GPA 数据管理工具集 提供空间数据组织、维护、复制、删除、投影转换和中间结果清理等数据管理能力。
gpa-mcp-v2-rasteranalyst GPA 栅格分析工具集 提供栅格数据分析与处理能力,包括坡度坡向、插值、密度、等值线面、距离和路径等分析。

内置工具管理

工具页用于管理系统内置工具的启停状态。内置工具为智能体提供浏览器操作、截图采集、文件读写、命令执行、内容搜索、时间获取、图表生成等基础能力,是完成通用任务的重要执行单元。

页面以卡片方式展示全部内置工具,并在标题区域显示工具总数。每张工具卡片中可查看工具名称、功能简介与当前状态;点击卡片底部开关,即可快速启用或停用对应工具,右上角“刷新”按钮可用于同步最新状态。

  • 浏览器、桌面截图、查看图片:适用于页面操作、截图采集与图像理解场景;
  • 读取文件、写入文件、编辑文件、文件搜索、内容搜索:适用于本地文件处理与内容检索场景;
  • 执行命令、当前时间、设置时区、Token 使用:适用于系统操作、时间信息获取与运行统计查询场景;
  • 生成图表、发送文件等:适用于结果输出与任务交付场景。

内置工具说明

工具名称 调用标识 用途说明
浏览器 browser_use 使用浏览器进行自动化操作,适用于访问网页、填写表单、检索在线资料和获取页面内容。
桌面截图 desktop_screenshot 获取桌面或窗口截图,用于界面状态确认、操作结果采集和视觉分析。
编辑文件 edit_file 使用查找替换修改文件内容(替换所有匹配项)
执行命令 execute_shell_command 执行系统命令,适用于调用本地程序、运行脚本、检查环境和处理工程文件。
生成图表 generate_chart 生成可视化图表,适用于统计结果展示。
当前时间 get_current_time 获取当前时间和时区信息,用于时间敏感任务、日志记录和周期任务判断。
Token 使用 get_token_usage 获取 Token 使用统计,帮助评估当前任务或会话的模型调用消耗。
文件搜索 glob_search 按文件名模式查找文件,适用于定位项目文件、批量查找资源和缩小处理范围。
内容搜索 grep_search 按内容搜索文件,支持正则表达式和上下文,适用于定位关键字、函数、配置项和文档片段。
读取文件 read_file 读取指定路径的文件内容,支持按行读取,适用于查看配置、代码、日志和文档。
发送文件 send_file_to_user 将文件发送给用户,系统可自动识别文件类型,适用于交付报告、图表、压缩包或处理结果。
设置时区 set_user_timezone 设置用户时区,保证时间计算、定时任务和结果展示与用户所在地区一致。
查看图片 view_image 加载图片并交给上下文模型分析,适用于截图理解、图片内容识别和视觉检查。
写入文件 write_file 将内容写入指定路径的文件,适用于生成文档、保存代码、输出配置或记录中间结果。

建议根据当前业务场景按需启用工具,以减少无关工具被规划器选中的概率,提升任务执行的聚焦度与稳定性。

技能管理

技能页用于管理自主规划式智能体可调用的技能。技能通常将角色约束、使用方式、输入输出约定等说明封装为可复用能力,帮助智能体在特定场景下更稳定地完成任务。

技能页面显示管理员在技能管理处分配的智能体,支持启用或停用已有技能,也支持通过导入、上传和新建三种方式扩展技能库。

查看与启停技能

技能页面同样采用卡片式布局展示全部技能。您可以在卡片中查看技能名称、简介、来源标签(如 builtin)与当前启用状态,并通过卡片底部开关按需启用或停用技能。系统内置技能可开箱即用,导入或上传的技能也会统一显示在技能列表中,便于集中管理。

导入技能

点击“导入技能”后,可通过技能 URL 从技能仓库或代码托管平台快速导入技能。当前界面支持多个常见技能来源地址,输入合法的技能 URL 后即可执行导入,适合复用公开发布或团队共享的技能。

上传技能

点击“上传技能”后,可选择本地技能文件上传。系统支持直接上传 SKILL.md 文件,也支持上传包含 SKILL.md 的技能压缩包(.zip 格式)。当技能除说明文档外还包含脚本、模板或其他资源文件时,建议使用上传方式。

新建技能

点击“新建技能”后,可在编辑面板中直接填写技能名称与技能内容,快速创建仅包含单个技能文档的技能。页面提供文档编辑、预览与“AI 优化”等辅助能力,便于完善技能说明。需要注意的是,“新建技能”仅适用于单文档技能;如果技能包中还包含其他文件,请使用“上传技能”。

技能创建、上传或导入完成后,可结合实际任务决定是否启用。对于临时性或场景约束较强的技能,建议按需开启,避免在无关任务中被误触发。

内置技能说明

技能名称 用途说明
gpa-mcp-routing 当任务涉及数据集目录检索、查询检索、空间关系、空间分析、栅格分析、数据处理或地图制图时,负责判断应调用的 GPA MCP 工具能力类别。
map-render 当用户要求修改地图图层视觉样式时使用,可识别样式修改意图并生成符合 Mapbox GL 规范的样式变更指令。
browser_visible 当需要控制 browser_use 的浏览器启动方式时使用,可将浏览器以可见方式启动,便于人工观察或调试页面操作。
channel_message 用于主动向用户、会话或外部频道发送消息,适合任务进度通知、结果提醒和需要主动沟通的长任务。
cron 用于创建和管理未来执行或周期执行任务,支持查看、暂停、恢复、删除和立即运行定时任务。
docx 用于创建、读取、编辑和处理 Word 文档,适合生成报告、整理文档结构、处理目录、标题和页眉页脚等内容。
file_reader 用于读取和总结文本类文件,并在需要时识别 PDF、Office、图片、压缩包等文件类型,辅助选择合适工具处理。
make_plan 用于请求增强型 Agent 生成分步骤、可落地的执行计划,并由当前智能体按计划执行复杂任务。
news 用于从指定新闻网站查找最新新闻,适用于政治、财经、社会、国际、科技、体育、娱乐等资讯检索场景。
pdf 用于处理 PDF 文件,包括读取或提取文本和表格、合并拆分、旋转页面、添加水印、创建或填写 PDF 等操作。
pptx 用于处理 PowerPoint 文件,支持创建演示文稿、读取解析、提取内容、编辑幻灯片和输出演示材料。
xlsx 用于处理电子表格文件,支持读取、编辑、修复、计算公式、添加列和处理 .xlsx、.xlsm、.csv、.tsv 等表格数据。