Skip to content

Agent数据规范

ACP定义了Agent的数据规范,遵循此数据规范可以保证Agent在智能体互联网中被发现,可以最便捷的实现迁移(相同身份多设备部署以实现Agent服务负载均衡)与复制(不同身份本地部署,实现Agent服务级分享),让Agent输出数据的分享更容易。

ACP文件目录概览

ACP路径/                          # ACP根目录

├── Certs                        # 证书有关存储文件夹
│   └── Root/                    # 私有根证书存储区

└── AIDs/                        # 智能体身份管理目录
    └── [aid_name]/              # 具体AID身份目录(如 weather_agent.ap1.net)

        ├── public/              # 公有数据存储区(Agent对外公开的数据)
        │   ├── config.json      # 定义Web访问配置
        │   ├── agentprofile.json # 声明智能体元数据
        │   ├── index.html       # Agent默认Web访问入口页面
        │   └── [aid_name].crt   # Agent的AID证书文件

        ├── private/             # 私有数据存储区
        │   ├── certs/           # 身份证书库
        │   │   ├── [aid_name].crt  # AID身份证书(X.509格式)
        │   │   └── [aid_name].key  # 加密私钥文件
        │   │
        │   └── data/            # 私有数据仓库
        │       ├── session_cache/   # 会话临时数据
        │       └── knowledge_base/  # 非公开知识库

        └── agent/               # agent的执行程序/项目工程文件/依赖库

详细说明

  1. ACP路径/ 由Agent自行指定
  2. ACP路径/Certs/Root/ 保存私有根证书
  3. ACP路径/AIDs/[aid_name] 保存本地身份的Agent的所有数据,这个路径被称为AID路径
  4. AID路径/public 这是Agent的公有数据,公有数据会被同步到接入点的存储服务上,其他Agent验证身份后,可以访问该路径下的所有文件
  5. 公有数据/config.json 可以配置免身份验证https可直接访问的文件和路径列表,可以配置agent是否允许接入点暴露其存在,是否允许被Agent搜索引擎收录
  6. 公有数据/agentprofile.json 定义了Agent的元数据,他定义了Agent的功能、行为、授权等,Agent搜索引擎以及其他的Agent根据agentprofile.json来决定与此Agent的交互逻辑
  7. 公有数据/index.html 是aid作为网址通过浏览器访问时可以看到页面
  8. 公有数据/[aid_name].crt Agent的身份证书文件,用于身份验证
  9. AID路径/private 这是Agent的私有数据,私有数据仅限于本地访问,不会被同步到接入点的存储服务上或者被其他Agent访问到
  10. 私有数据/certs 其下存储AID的身份证书文件以及加密的私钥文件
  11. 私有数据/data Agent的私有数据仓库,可以存储会话记录、知识库文件
  12. AID路径/agent 保存agent运行所需的所有文件,打包该路径即可完成复制操作

安全访问控制策略

  1. public/目录:允许其他agent通过HTTPS只读访问,需要验证aid
  2. public/config.json可配置浏览器可直接匿名访问的文件或者路径列表
  3. 除public目录,其他路径均不能被外部程序访问

Released under the Apache 2.0 License.