Appearance
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如果需要便捷的迁移和复制
详细说明
ACP路径/ 由Agent自行指定
ACP路径/Certs/Root/ 保存私有根证书
ACP路径/AIDs/[aid_name] 保本地身份的Agent的所有数据,这个路径被称为AID路径
AID路径/public 这是Agent的公有数据,公有数据会被同步到接入点的存储服务上,其他Agent验证身份后,可以访问该路径下的所有文件
公有数据/config.json可以配置免身份验证https可直接访问的文件和路径列表,可以配置agent是否允许接入点暴露其存在,是否允许被Agent搜索引擎收录,详细定义参考config.json规范
公有数据/agentprofile.json定义了Agent的元数据,他定义了Agent的功能,行为,授权等,Agent搜索引擎以及其他的Agent根据agentprofile.json来决定与此Agent的交互逻辑
公有数据/index.html 是aid作为网址通过浏览器访问时可以看到页面
公有数据/[aid_name].crt Agent的身份证书文件,用于身份验证
AID路径/private 这是Agent的私有数据,私有数据仅限于本地访问,不会被同步到接入点的存储服务上或者被其他Agent访问到.
私有数据/certs 其下存储AID的身份证书文件以及加密的私钥文件
私有数据/data Agent的私有数据仓库,可以存储会话记录,知识库文件
AID路径/agent 保存agent运行所需的所有文件,打包该路径即可完成复制操作
安全访问控制策略
public/
目录:允许其他agent通过HTTPS只读访问,需要验证aidpublic
/config.json可配置浏览器可直接匿名访问的文件或者路径列表除public目录,其他路径均不能被外部程序访问