按市场类型查询已发布的行业专家。OFFICIAL表示官方推荐,APP_CUSTOM表示当前应用的我的市场;支持按当前市场标签和关键词过滤,返回当前市场可用标签、累计安装次数和当前主体是否已安装。
GET
/api/hub/agent/list分页查询行业专家
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
Query 参数5 个字段
registryTypestringrequired
市场类型,可选值:OFFICIAL、APP_CUSTOM
tagIdsarraynullable
当前市场的标签ID列表,最多选择50个;多选时匹配任一标签
keywordstringnullable
关键词,匹配专家名称或描述
pageintegernullable
页码,从1开始
pageSizeintegernullable
每页记录数,取值范围1~100
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataHubPageResultAgentHubItemVOnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID,用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码,前端可据此做特殊UI处理
POST
/api/hub/agent/apply安装智能体市场专家智能体
校验资产对当前应用可见后,从Hub专属模板克隆智能体并建立应用访问关系;调用方重试时应复用requestId。安装出的智能体归属X-Principal-Id对应的应用成员,该成员登录页面后即可在智能体列表中看到。
请求参数
请求头参数1 个字段
X-Principal-Idintegernullable
身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。
请求体(JSON)2 个字段
agentHubIdintegerrequired
智能体市场条目ID
requestIdstringnullable
安装幂等请求ID,最长64个字符。同一身份主体(X-Principal-Id)下复用同一requestId会直接返回首次安装结果,不会重复安装;不传则每次调用都会新安装一个实例。建议调用方传入并在重试时复用同一个值。
响应
200
httpStatusCodeintegernullable
HTTP状态码
messagestringnullable
响应消息
dataAgentHubApplyVOnullable
响应数据
successbooleannullable
是否成功
requestIdstringnullable
上游请求ID,用于跨系统链路追踪排查问题
errCodestringnullable
上游错误码,前端可据此做特殊UI处理