智能体内置能力
除了插件提供的 GIS 工具,OpenGeodex 的智能体自带一组通用能力:读写文件、运行脚本、联网搜索、识图、记忆、通知等。你不需要记住这些能力的名字,只要知道它“能做什么、什么时候会问你”,就能放心地把任务交给它。
打开「设置 → 行为 → 会话中显示工具调用」后,对话里每次调用能力都会显示为一行记录,标明能力名称、状态和用时;需要你确认的操作始终显示,不受这个开关影响。
一览
| 能力 | 能做什么 | 是否需要你确认 |
|---|---|---|
| 读取文件 | 读文本、CSV、代码、配置、日志 | 不需要 |
| 浏览与查找文件 | 列目录、按文件名找、按内容搜 | 不需要 |
| 写入与修改文件 | 新建、覆盖、局部修改、批量修改、复制 | 需要(写操作审批) |
| 申请文件访问范围 | 访问你拖进来或写出路径的外部位置 | 每个新位置都需要,自动批准也不跳过 |
| 命令行(Git Bash) | ls、find、grep、wc、awk 等快速查询 | 只读查询不需要;写文件、联网或不认识的命令需要 |
| 运行脚本(沙箱) | Python、Node、Git Bash、cmd、PowerShell 脚本 | 联网执行每次都需要 |
| Python 环境 | 查看已装的包,安装缺少的包 | 安装需要 |
| 识图 | 识别图片里的文字、版面、表格 | 不需要 |
| 地图成品检查 | 检查地图图片的文字是否缺字、乱码、截断、压盖 | 不需要 |
| 流程图 | 把复杂任务的处理过程画成流程图 | 不需要 |
| 联网搜索 | 搜索网页 | 不需要 |
| 网页抓取 | 读取网页正文 | 不需要 |
| 知识库检索 | 查你导入的资料 | 不需要 |
| 保存记忆 | 记住偏好、知识和做法 | 需要 |
| 更新项目记忆 | 记录项目里的约定 | 需要 |
| 技能 | 加载技能、建议并沉淀新技能 | 保存新技能需要 |
| 连接器列表 | 查看已配置的连接器(看不到密码和 Key) | 不需要 |
| 系统信息 | 时间、操作系统、CPU、内存、磁盘、OpenGeodex 版本 | 不需要 |
| 发送通知 | 往飞书、企业微信、钉钉群发消息 | 需要,且只在你明确要求时 |
| 任务编排 | 任务确认、可见计划、委派专家、按需加载 MCP 工具 | 不需要 |
读取与查找文件
- 读取:自动识别 UTF-8 和 GBK 编码,长文件一次最多读 500 行,分段读完。Shapefile、GeoTIFF 等空间数据和二进制文件不当作文本读,而是交给 GDAL、DuckDB 等插件处理;
- 浏览:在会话产物目录里,它能看到「原始数据」「过程数据」「制图资料」「最终成果」「临时文件」这几个文件夹(见产物与表格);项目源文件夹以只读方式列出;
- 查找:按文件名通配(例如所有
*.shp)或按内容搜索关键词。
能访问的范围只有会话产物目录、项目源文件夹和你授权过的位置,其他位置需要先经过文件访问范围确认。
写入与修改文件
新建文件、覆盖、局部修改、批量修改多个文件和复制文件都属于写操作,执行前会弹出「写操作审批」卡片。
- 写入是原子的:要么完整写成,要么保持原样,不会留下半截文件;
- 智能体修改前会核对文件有没有被别人改过,发现变化会重新读取,避免覆盖你刚做的修改;
- 批量修改一次最多 64 处,合并在一张审批卡片里;任何一处失败,已经改的会全部回退;
- 项目源文件夹是只读的,基于源数据的成果写到会话产物目录。
命令行(Git Bash)
安装包自带 Git Bash,智能体用它快速查看和统计数据:列文件、查找、搜索内容、计数汇总、查看文件头尾、比较差异。
- 只读的查询立即执行;
- 会写文件、联网,或者识别不出的命令,执行前会请你确认;
- 同一会话里的命令共享一个临时工作目录,要交给你的文件会被拷到产物目录。
运行脚本(沙箱)
复杂的处理由智能体写成脚本,在沙箱里运行,支持 Python、Node.js、Git Bash、cmd 和 PowerShell,优先使用安装包自带的运行时。
| 项目 | 规则 |
|---|---|
| 权限 | 受限的低完整性账户运行,只能写自己的临时工作目录,写好的文件由 OpenGeodex 拷到会话产物目录 |
| 能读什么 | 会话产物目录、项目源文件夹、你授权过的位置 |
| 读不到什么 | 配置文件(含模型密钥)、登录状态和会话数据库 |
| 联网 | 默认不联网,需要联网的执行每次单独请你确认,不受「本会话批准」影响(开了「自动批准」时直接放行) |
| 超时 | 默认 30 秒,最长 1800 秒 |
| 内存 | 默认 4096 MB |
| 输出 | 屏幕输出最多保留 64 KB,大结果写成文件 |
| 不做的事 | 不会通过脚本操控 Word、Excel、WPS 等办公软件 |
超时和内存上限在「设置 → 沙箱」调整。技能里附带的脚本会在沙箱里以 ./skill/ 目录提供给智能体使用。
Python 环境
OpenGeodex 管理一个独立的 Python 环境,不影响你电脑上已有的 Python。脚本缺少某个包时,智能体先查看环境里装了什么,再请你确认后安装(用 uv 安装,速度较快)。它不会改动系统 Python 或你的其他环境。
识图
让智能体看懂截图、扫描件、表格照片和地图图片:
| 模式 | 返回 | 适合 |
|---|---|---|
| 文字 | 按阅读顺序的纯文本 | 只要内容 |
| 版面 | 文字加每一块的位置 | 排版还原、按位置定位 |
| 表格 | 还原行、列和合并单元格的 HTML 表格 | 扫描表格、统计表、表单 |
支持 png、jpg、webp、bmp、tif,单张不超过 20 MB;GIF 等格式或超出大小的图片会被拒绝,智能体会请你换一张,不会自己转换绕过限制。识别方式(本地、第三方接口、对话模型)在设置 → 识图里选择,关闭时智能体无法识别图片内容,会提示你去开启。
地图成品检查
智能体出图后,会对照图上应该出现的文字(标题、图例、地名、比例尺等)做一次检查:
- 用文字识别比对缺字、乱码、文字截断和互相压盖;
- 可用时再请多模态模型从版面上复核一遍;
- 结果分“通过 / 警告 / 失败”。失败时它会修正后最多复查一次;警告不阻止交付,会在回复里告诉你。
配合内置技能「地图成品自检清单」使用,见技能。
流程图
复杂任务结束后,你可以让它“把处理过程画成流程图”,它会生成一张 SVG 流程图放进产物目录。配合内置技能「复杂任务处理过程说明与流程图」使用。
联网搜索与网页抓取
- 搜索:使用「设置 → 集成 → 联网搜索」里启用的引擎(DuckDuckGo、Tavily、Brave、SearXNG、DeepSeek)。默认用第一个启用的,结果不理想时换下一个,也可以同时搜索全部引擎;默认返回 5 条,最多 20 条;
- 抓取:把网页正文读成整齐的文本。方式有 Obscura(本机浏览器抓取,不需要 Key,适合国内网页)、DeepSeek 和 Firecrawl(云端,需要 Key)。默认方式抓不到时依次换用其他已配置的方式。
知识库检索
遇到标准、规范、分级、指标这类问题,智能体会先查你的知识库。你说得口语化也没关系,它会换成规范里的说法再查,例如把“地形倾斜程度”换成“坡度分级”。
记忆与项目记忆
- 保存记忆:在对话里说“记住:……”,或它发现值得长期保留的信息时,会请你确认后保存。每条记忆标题不超过 30 字、内容不超过 200 字,分为语义(知识与偏好)、流程(做事步骤)、会话(仅当前会话)等类别;
- 项目记忆:在项目里形成的约定(坐标系、命名规则、数据口径等)记在项目记忆里,每条不超过 240 字,项目里的其他会话会继续沿用。
在「设置 → 记忆」可以查看和删除,见记忆与个人档案。
技能
- 加载:任务匹配某个技能时,智能体自动加载它,按里面的步骤和要求做;
- 建议沉淀:一次任务顺利完成、过程中摸索出值得复用的做法时(绕过弯路、调过难调的参数、做过专门的校验),它会在对话末尾弹出「建议沉淀为技能」卡片,由你决定是否保存;
- 沉淀确认:你让它“把这套做法存成技能”时,它会弹出「沉淀技能确认」卡片,写明技能名称和触发条件,可以「查看技能内容」后决定「保存技能」或「不保存」。同名的用户技能会被覆盖。
连接器与系统信息
- 连接器列表:智能体能看到你配置了哪些连接器、是否可用,但看不到密码和 Key,凭据只在调用插件时注入;
- 系统信息:当前时间、操作系统、CPU、内存、磁盘、OpenGeodex 版本。处理大数据前它会先看看内存和磁盘够不够。
发送通知
只有你明确要求时(例如“做完了发到我们的企业微信群”),智能体才会往「设置 → 通知」里配置好的飞书、企业微信或钉钉群机器人发一条文字消息,发送前请你确认。长任务结束自动通知由「设置 → 通知」的「通知时机」控制,与这里无关。
任务编排
这些能力决定智能体“怎么做事”,在对话里以卡片和进度的形式出现: