需求背景
当前北向接口(/nb/v1)已提供 agent 列表、agent 详情、知识库等查询能力,但缺少获取 agent 配置中“工具(tool)、工具参数(tool params)、skill”的接口。外部调用方(伙伴 / 集成系统)在发起对话前无法获知某个已发布 agent 实际挂载了哪些工具、各工具的可配置参数定义,以及启用了哪些 skill,导致调用方难以做参数预填、能力发现与编排。
目标
提供北向接口,支持按 agent 名称查询其配置的工具、工具参数、skill 等信息,供外部系统做能力发现与集成。
范围
- 新增只读查询接口,复用现有 /nb/v1/agents/{agent_name}/... 子资源模式(参考 knowledge-bases)。
- 仅暴露已发布且调用方可见的 agent;鉴权复用北向 Bearer API Key,tenant 隔离。
- 不修改现有 chat/run 等执行路径;不影响前端内部接口。
验收标准
- 新增 GET /nb/v1/agents/{agent_name}/tools 返回工具及其参数定义。
- 新增 GET /nb/v1/agents/{agent_name}/skills 返回启用的 skill 实例。
- agent 不存在返回 404;参数校验失败返回 400。
- 补充对应单元测试。
备注
由 github-dev-workflow(Full 模式)驱动。
需求背景
当前北向接口(/nb/v1)已提供 agent 列表、agent 详情、知识库等查询能力,但缺少获取 agent 配置中“工具(tool)、工具参数(tool params)、skill”的接口。外部调用方(伙伴 / 集成系统)在发起对话前无法获知某个已发布 agent 实际挂载了哪些工具、各工具的可配置参数定义,以及启用了哪些 skill,导致调用方难以做参数预填、能力发现与编排。
目标
提供北向接口,支持按 agent 名称查询其配置的工具、工具参数、skill 等信息,供外部系统做能力发现与集成。
范围
验收标准
备注
由 github-dev-workflow(Full 模式)驱动。