识别资源,而不只是文件名
多个系统中都可能存在名为“报告.pdf”的文件。Galaris 用 URI 标识来源及控制访问的服务。智能体先发现可用资源类型,再选择操作。
| 地址 | 资源 |
|---|---|
document:// |
HTML 文档、JSON Dataset 与附件集合 |
memory:// |
有权访问的知识 |
galaris:// |
任务、目标、周期、流程等已开放对象 |
console:// |
已启用控制台的主目录文件 |
mail:// |
指定邮件的附件 |
| 已连接工具的 URI | 相应服务的文件,如 Nextcloud 或消息附件 |
| 公开 HTTPS | 在服务限制内读取或传输网页资源 |
在正确范围内检索与编辑
通用工具涵盖列表、元数据、文件名或正文搜索、分页读取、创建、替换、追加、局部修改、复制、移动和删除。每个资源服务声明自身支持的操作。
读取可使用游标继续;修改在需要时检查版本前置条件。受保护的业务对象仍遵循各自规则,不能用文件操作绕过所属模块的管理。
直接复制到目标位置
智能体可以把消息附件复制到文档或连接的存储中,无需虚构中间本地路径。目标集合可以保留原文件名,覆盖已有文件必须明确指定。
收到的媒体保留接收它的工具标识。当库必须读取本地字节时,Galaris 会创建受限临时副本;该副本不会成为智能体新的持久存储空间。
在上下文中打开文件
阅读器支持相应格式,包括文本、图片、PDF、音频、视频、HTML 页面和 3D 场景。预览与转换取决于资源类型。Galaris 链接会打开对应对象,同时检查权限。
找回输入和交付物
任务的 Working Set 保留输入资源、生成文件及最终交付物,并附带工具证据。已经产生的文件可以重新交付,无需再次调用模型。
只有 console:// 空间要求启用控制台。文档与其他资源服务的文件使用各自的连接。
阅读文件并理解中断的传输
Markdown 附件有渲染阅读器;代码、JSON 和文本保留源码视图,支持复制及下载。3D 预览在限制范围内支持 GLB、独立 glTF、OBJ、STL 和 PLY,不替代 CAD 软件。
先下载再上传的复制中,上传前下载被拒绝不会改变目标。开始写入后出错则可能留下未知结果。恢复时需区分两种情况,避免再次写入。
HTML 文档与 JSON Dataset
document:// 也标识 Dataset。智能体通过 file_create 并指定 document_type="dataset" 创建数据文档;默认类型仍为 HTML。类型在创建时确定,写入、复制到已有目标或恢复版本都不会改变它。
读取与编辑使用实际 JSON 行。每次修改都验证完整 JSON 并检查预期版本。file_append 是文本拼接,不是追加一条数据记录。文档应用向数组追加记录时使用 Dataset SDK。将 JSON 资源复制到 Documents 集合会创建 Dataset。

