识别资源,而不只是文件名
galaris://documentation/集合提供对已授权产品资料的只读访问。目录工具还提供智能体当前资料的地址,通过引用读取可以避免保存过期资料副本。
多个系统中都可能存在名为“报告.pdf”的文件。Galaris 用 URI 标识来源及控制访问的服务。智能体先发现可用资源类型,再选择操作。
| 地址 | 资源 |
|---|---|
document:// |
HTML 文档、JSON Dataset 与附件集合 |
memory:// |
有权访问的知识 |
galaris:// |
任务、目标、周期、流程等已开放对象 |
console:// |
已启用控制台的主目录文件 |
mail:// |
指定邮件的附件 |
| 已连接工具的 URI | 相应服务的文件,如 Nextcloud 或消息附件 |
| 公开 HTTPS | 在服务限制内读取或传输网页资源 |
在正确范围内检索与编辑
通用工具涵盖列表、元数据、文件名或正文搜索、分页读取、创建、替换、追加、局部修改、复制、移动和删除。每个资源服务声明自身支持的操作。
读取可使用游标继续;修改在需要时检查版本前置条件。受保护的业务对象仍遵循各自规则,不能用文件操作绕过所属模块的管理。
直接复制到目标位置
智能体可以把消息附件复制到文档或连接的存储中,无需虚构中间本地路径。目标集合可以保留原文件名,覆盖已有文件必须明确指定。
收到的媒体保留接收它的工具标识。当库必须读取本地字节时,Galaris 会创建受限临时副本;该副本不会成为智能体新的持久存储空间。
复用 AFFiNE 工作空间中的文件
为 AFFiNE 配置的连接工具可以读取工作空间文件的元数据,并下载、复制或上传文件。资源地址保留工具代码、工作空间与 blob 键,同时遵守访问权限和下载限制。此传输针对附件,不会同步全部 AFFiNE 页面。
在上下文中打开文件
阅读器支持相应格式,包括文本、图片、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。
找回文件,无需记住位置
每个智能体的私有目录让获授权列表和搜索中遇到的文件与目录可被检索。可选择关闭索引、兼容供应方默认的仅已知文件,或在支持时递归发现。Nextcloud 支持发现;Console、AFFiNE 和 Grav 只处理已知地址。Mail 不参与索引;消息收到的文件在接收时加入目录。
Dream 逐步遍历目录,保存进度并支持继续。默认每周重新扫描,也可选择每天或关闭。在 Dream → 索引中查看覆盖范围、启动或取消扫描,并重试修复。
同一资源,多个副本
通过完整字节的指纹识别严格相同的副本。对于同一智能体,副本可共用一条记录,保留多个位置、描述、笔记与来源。修改后的副本拥有独立身份;移除一个位置不会删除其他位置。每次读取重新检查源文件访问权限,不同智能体之间的身份保持分离。
文档、附件和已索引文件可按格式提供缩略图与预览:图像、PDF、Office、电子表格、音频、视频、Markdown、代码或 3D。不支持预览的格式仍可下载。探索记忆与来源。

