MSG 公链业务模块详解

⬅ 返回 MSG 白皮书层级目录

Agent API 能力表面

知识网络定位

当前页面已进入跨页知识网络层：不仅展示本页拓扑，还明确它在整站里的分类、被哪些页面引用、又继续指向哪些专题与证据页。

打开知识网络总览

状态：部分实现分组：开发者与接口出链：6 回链：3 相邻推荐：8

金库多签阈值注册中心规范键接口查询状态

这页继续通向

AI Agent 智能接入 AI 控制平面与主链执行入口 AI 权限与制度控制面 RPC 与 API 接口 SDK 与开发者能力表面可信结论专章

这些页面会回到本页

AI Task L2 与回执证明闭环 SDK 与开发者能力表面白皮书总拓扑母图

Agent API 能力表面快查

当前状态：OpenAPI 与端点分组真实存在，但成熟度不一关键边界：部分分类仍有 Stub，不能把接口表面当成交付完成定位：把 Agent 的“可调用能力表面”单独从控制面里拆出来

回 AI Agent：看路由、事件、执行器与 Stub 返回回控制平面：看接口表面如何映射到主链执行入口回制度控制：看高风险接口为何还不能裸放权回 RPC：看 REST / JSON-RPC / gRPC 如何承接底层执行下一页：看开发者如何通过 SDK 消费这些能力表面可信边界：看哪些端点不能越级写成已完成


flowchart LR
    classDef implemented fill:#dcfce7,stroke:#166534,color:#14532d,stroke-width:2px;
    classDef partial fill:#ffedd5,stroke:#9a3412,color:#7c2d12,stroke-width:2px;
    classDef planned fill:#dbeafe,stroke:#1d4ed8,color:#1e3a8a,stroke-width:2px,stroke-dasharray: 5 3;
    classDef audit fill:#ede9fe,stroke:#6d28d9,color:#4c1d95,stroke-width:2px;

    OpenAPI["docs/api/agent_openapi.yaml
MSG Chain AI Agent API"] --> Query["Query
account / balance / tx / block / batch"]
    OpenAPI --> Wallet["Wallet
写操作需 API Key"]
    OpenAPI --> Events["Events
history / subscribe"]
    OpenAPI --> Registry["Registry
agent 注册与发现表面"]
    OpenAPI --> MPC["MPC
多签 / 签名编排"]
    OpenAPI --> Stub["DeFi / Oracle / Payment / Bridge
存在 Stub 或开发中端点"]
    Query --> Verdict["当前结论
Agent API 表面真实存在，但能力成熟度不均匀
应明确区分真实可用、部分实现与 Stub"]
    Wallet --> Verdict
    Events --> Verdict
    Registry --> Verdict
    MPC --> Verdict
    Stub --> Verdict

    class OpenAPI,Query,Events,Wallet,Registry,MPC partial
    class Stub planned
    class Verdict audit

📄 当前真实表面: OpenAPI 已把 Agent 能力分组暴露

// docs/api/agent_openapi.yaml 当前可见分组：
// - Query
// - Wallet
// - NFT
// - Events
// - Registry
// - MPC
//
// 同时文档显式说明：
// - 写操作端点需 API Key
// - Stub 端点会返回 X-MSG-Stub: true
// - message 字段包含 "stub - not yet implemented"

📄 可信边界: 不能把 OpenAPI 表面等同成全部能力已实现

// 当前不能越级宣称：
// 1. OpenAPI 中出现的全部端点都已可生产使用
// 2. DeFi / Payment / Bridge 等已形成真实闭环
// 3. Agent API 已完全覆盖人类可执行的链上动作
//
// 当前最准确口径：
// - 接口表面真实存在
// - 能力成熟度分层明显
// - 仍需结合 ai_control_plane / ai_policy_capability 看边界

📄 表达原则: 白皮书系统应把接口表面与真实成熟度分开

// 这页在白皮书系统里的职责：
// 1. 告诉读者现在有哪些 Agent API 分类
// 2. 告诉读者哪些是真实可用，哪些仍是 Stub
// 3. 把接口层接回控制面、制度面、任务层和开发者表面
//
// 这页不负责证明某个高风险动作已完成真实验收。

Agent API 能力表面

知识网络定位

这页继续通向

这些页面会回到本页

相邻概念推荐

Agent API 能力表面快查