Skip to content

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

ACP文件目录概览

ACP路径/ # ACP根目录

├── Certs # 证书有关存储文件夹

│ └── Root/ # 私有根证书存储区

└── AIDs/ # 智能体身份管理目录

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

├── public/ # 公有数据存储区(Agent对外公开的数据,AID作为域名访问实际映射的根路径)

│ ├── config.json

│ │ └── 字典,用途:定义Web访问配置

│ │ 字段:

│ │

│ ├── agentprofile.json

│ │ └── 用途:声明智能体元数据

│ │ 字段示例:{ "name": "气象服务", "version": "2.1.0" }

│ │

│ ├── 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的执行程序/项目工程文件/依赖库,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搜索引擎收录,详细定义参考config.json规范

  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目录,其他路径均不能被外部程序访问

ACP 智能体通信协议文档