Skip to content

北向接口:获取 agent 配置的工具、工具参数与 skill 信息 #3830

Description

@TiTi-iTiT

需求背景

当前北向接口(/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 模式)驱动。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions