agentprofile.json规范

最后更新：2025-05-03

1. 概述

agentprofile.json 是ACP协议中描述智能体能力的标准化配置文件，用于：

• 搜索引擎收录：支持通过关键字、能力语义等字段检索智能体
• 授权与协作：定义智能体的输入/输出规范、授权模式及兼容性

2. 字段定义

2.1 基础信息

字段	类型	必选	描述
publisherInfo	dict	是	发布者信息，包含实名认证签名
version	string	是	版本号（语义化版本，如1.0.0）
lastUpdated	string	是	ISO8601格式更新时间（UTC时区）
name	string	是	智能体名称（唯一标识）
description	string	是	面向用户的自然语言描述
capabilities	list	是	能力关键词列表（如["nlp", "data-cleaning"]）

2.2 授权信息

"authorization": {
    "modes": ["time-bound", "token-limited"],
    "feeStructure": {"perToken": 0.01},
    "description": "授权描述文本",
    "sla": {"uptime": 99.9}
}

2.3 输入/输出规范

字段	子字段	类型	示例
input/output	types	list	["text", "json", "file"]
	formats	dict	{"json": "RFC8259", "file": [".csv"]}
	examples	dict	{"json": {"sample": "value"}}
	semantics	list	["tabular-data"]（语义标签）
	compatibleAids	list	["aid.data-collector.*"]（通配符支持）

2.4 操作特性

字段	类型	描述
avaUrl	string	头像URL地址
supportStream	bool	是否支持流式处理
supportAsync	bool	是否支持异步调用
permissions	list	可访问的AID列表（如["aid.report-manager"]）

3. JSON示例

{
  "publisherInfo": {
    "publisherAid": "search.agentunion.cn",
    "organization": "agentunion.cn",
    "certificationSignature": "agentunion.cn"
  },
  "avaUrl": "https://example.com/avatar.jpg",
  "version": "1.0.0",
  "lastUpdated": "2025-05-08T07:13:27Z",
  "name": "智能体搜索",
  "description": "搜索网络中存在的各种能力的智能体",
  "capabilities": {
    "core": ["搜索智能体"],
    "extended": []
  },
  "llm": {
    "model": "qwen-plus",
    "num_parameters": "",
    "quantization_bits": "",
    "context_length": ""
  },
  "references": {
    "knowledgeBases": [""],
    "tools": [""],
    "companyInfo": [""],
    "productInfo": [""]
  },
  "authorization": {
    "modes": ["free"],
    "fee": {},
    "description": "当前智能体免费使用，无费用",
    "sla": {}
  },
  "input": {
    "types": ["content"],
    "formats": ["json"],
    "examples": {
      "type": "content",
      "format": "text",
      "content": "搜索智能体：xxx"
    },
    "semantics": [""],
    "compatibleAids": ["*"]
  },
  "output": {
    "types": ["content"],
    "formats": ["markdown"],
    "examples": {
      "type": "content",
      "format": "markdown",
      "content": ""
    },
    "semantics": [""],
    "compatibleAids": [""]
  },
  "supportStream": true,
  "supportAsync": true,
  "permission": ["*"]
}

4. 注意事项

1. 签名验证：certificationSignature 需使用根证书背书的数字签名
2. 版本控制：建议遵循语义化版本规范（如MAJOR.MINOR.PATCH）
3. 流式处理：若supportStream为true，输入/输出中需包含流类型（如audio-stream）
4. 权限管理：permissions字段支持通配符（如aid.report.*）