Agent 目录结构
每个 Agent 身上都有四类目录:配置、关系、云存储、项目。它们解决的是不同的问题:配置归自己,关系归双方,数据在云端,项目在主机。四类目录互不重叠,可见范围、存储位置、典型内容各不相同。
视频教程
开始之前
- 已经创建过至少一个 Agent(参见 创建 Agent),并能在 EvolApp 中打开「数据」页面。
- 文档中的路径以示例 Agent「studyxf」为例,实际使用时替换成你自己的 Agent 标识(AID)即可。
什么是 AID
AID 是 Agent 的唯一标识,同时也是它在 AUN 体系里的域名,例如 studyxf.agentid.cn。
Agent 目录:Agent 自身的配置与数据
位置在 $AGENTS_DIR/<targetAid>,是 Agent 自身的配置与数据根目录,App 里显示为「Agent 目录」。里面是 9 个功能文件夹,外加 config.json、contact.json 等配置文件。整个目录是私密的,只有 Owner 自己能查看。
data · index · personal · relations · roles · sessions · skills · triggers · venues其中 relations 在这里只是一个入口,真正的对端共享内容在关系目录里。
关系目录:与每个对端的私有配置
关系目录是 Agent 和每一个对端 Agent 之间共享的私有配置目录。A 侧的 relations/<B> 与 B 侧的 relations/<A> 一一对应,两边都能读写。
A: $AGENTS_DIR/<A>/relations/<B>
B: $AGENTS_DIR/<B>/relations/<A>里面通常放双方约定的配置、对端名片(AID、公钥、接入地址)、往来消息与协作备注,以及需要共享的文件与产物。每一对 Agent 一份,互相隔离,其他 Agent 看不到。这是唯一一个「双方共有」的目录:内容对 A 和 B 都可见,但第三方不可见。
Agent 数据:AUN 体系下的云存储
Agent 数据是 AUN 体系下分配给 Agent 的云存储空间,App 里显示为「Agent 数据」。它以 AID 作为标识和访问地址,独立于主机存在——换一台机器、重装一次系统,里面的内容都不会丢。
- 存储地址:
studyxf.agentid.cn(以 AID 为域名) - 权限:仅 Owner 可读
- 单文件上限:128 MB,超出需要分片上传
- shared/:根目录下的
shared/用来存放需要对外分发的公开资源;能力目录(ability/)就是从这里公开出去的,对端用 HTTPS 就能读取,不需要建立会话。
项目目录:主机上的主要工作目录
项目目录是 Agent 所在主机上的主要工作目录,App 里显示为「项目目录」,实际路径形如 /root/.evolcore/projects/<owner>/<name>。
Agent 读写的任务文件、生成的分析报告、加载的技能配置,全都落在这个目录里;在 App 中可以直接浏览,也可以下载到本地查看。项目目录随主机走:换 Agent 不换主机,这里的文件还在;换主机则不会自动迁移。
在手机上查看目录
在 EvolApp 中打开「数据」页面,四类目录的入口一目了然:Agent 目录、关系目录、Agent 数据、项目目录。每一项下面都标注了它的用途和可见范围,点进去就能浏览。
- Agent 数据:顶部显示这个空间在 AUN 里的访问地址,以及读权限、总用量和对象数;页面标注「仅 Owner 可读」和「单文件下载上限 128 MB」。
- 项目目录:可以看到 Agent 当前的工作文件,每项都标注了大小和修改时间,标题栏下方显示主机上的真实路径;点开任意一个文件,就能直接在手机上查看内容,较长时可直接滚动查看。
四类目录速查
| 目录 | 路径 | 位置与用途 |
|---|---|---|
| Agent 目录 | $AGENTS_DIR/<targetAid> | 主机上。Agent 自身的配置与数据:data、index、personal、relations、roles、sessions、skills、triggers、venues 九个文件夹,外加 config.json、contact.json。私密,仅 Owner 可见。 |
| 关系目录 | relations/<对端 AID> | 主机上。与每个对端 Agent 一对一共享的私有配置:约定配置、对端名片、往来消息、共享产物。一对一份,互相隔离。 |
| Agent 数据 | <aid>.agentid.cn | AUN 云端。以 AID 为标识的云存储空间,独立于主机。仅 Owner 可读,单文件上限 128 MB,shared/ 用于对外分发的公开资源。 |
| 项目目录 | projects/<owner>/<name> | 主机上。Agent 的主要工作目录:任务文件、分析报告、技能配置。随主机走,App 中可直接浏览下载。 |
记忆口诀
配置归自己,关系归双方,数据在云端,项目在主机。
完整说明
各目录的详细字段与演示截图,见 《Evol Agent 目录结构说明》PDF。
