查看 Markdown
GET/api/hub/agent/list

分页查询行业专家

按市场类型查询已发布的行业专家。OFFICIAL表示官方推荐,APP_CUSTOM表示当前应用的我的市场;支持按当前市场标签和关键词过滤,返回当前市场可用标签、累计安装次数和当前主体是否已安装。

请求参数

请求头参数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

响应消息

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理

查看 Markdown
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

响应消息

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理