能力指南：跑通之后如何深入

已经完成第一轮对话后，从下面选择当前需求。每个专题按“基本概念 → SDK 接入 → 进阶 / 治理”展开，不需要一次读完。

我想做什么	先读	然后深入
换模型，理解提供商、绑定和配置	模型接入	模型能力、路由与治理
定义助手职责、可用工具和预算	智能体	子智能体额度与结果
查询订单、设备或触发业务操作	业务工具	注解工具、回调协议
接内部资料与现有检索服务	知识库	知识接入路线
接入现有登录、租户与数据权限	应用与身份	业务权限与可信上下文、文档权限
发布新版本、切默认入口、回退	版本与发布	声明式注册、批次预检
理解会话、审批、断线与取消	会话与运行	前端方法、事件协议
在对话中展示业务卡片	自定义 UI	React / Vue 自定义状态层

学習建议

第一轮对话只需要默认智能体。接入业务时通常先增加一个 READ 工具，再增加知识 Provider，最后接正式权限与发布策略。

UI 卡片、子智能体、向量索引、多候选路由和费用账本都是按需扩展。它们不会因为安装 SDK 自动成为你的业务能力，也不应该阻挡最小聊天接入。

代码、控制台与参考各用在哪里

模型、智能体和业务能力优先通过后台 SDK 声明；普通聊天通过前端 SDK。专题中的 JSON 用来解释 Registry 字段，手工注册用于已有系统或治理场景，不要求在管理平台逐项照抄。

控制台操作从独立操作手册进入，底层 HTTP 与兼容接口查接口参考。