Agent Introduction

内核 Agent

内核 Agent 让用户以自己的平台凭证执行已注册能力。它不是管理员后门：Agent 只能调用当前 凭证能发现的 Capability，不能扩大权限，也不会跳过 route guard、配额、幂等和审计。

管理员先配置模型提供方并启用 Agent。调用者随后可通过 /api/v1/agent/* 查询状态、读取可用模型、创建 run、查看步骤、恢复或取消 run，并处理审批。

平台 Capability 工具来自 capability registry；同一项平台能力也可以被 /api/v1 或 MCP 调用。 Agent 还可纳入管理员配置的外部 MCP 工具和隔离动作，它们分别有独立的配置、schema 与执行授权边界， 不等同于 /api/v1 的公开 Capability。新增自动化能力请先阅读 Agent Surface。

责任边界

• 内核负责身份、策略、审批、审计、运行记录和工具分发；创建、继续和取消 run 必须使用平台 API Key，不能使用浏览器会话。
• 插件负责声明可公开的能力，并保证其原始 route 的鉴权和业务校验正确。
• 插件的领域操作说明、安装和配置由插件仓库 Wiki 维护。