业务适配器与社区配方
业务适配器在源业务系统一侧提供明确的接入层：声明允许 Agent 使用的操作、验证中枢签名、恢复可信主体，再调用原有服务层做最终权限和业务校验。
| 形式 | 放在哪里 | 适合什么情况 |
|---|---|---|
| 业务侧 SDK | 业务系统代码中 | 需要生成工具 spec、验签、签发身份票据或调用中枢 |
| 独立适配器 | 单独仓库或业务插件 | 某类产品有稳定扩展点，希望单独安装和升级 |
| 社区配方 | 文档、示例 spec 与验证脚本 | 需要参考接入结构，但仍要按自己的版本和权限模型实现 |
业务侧 SDK 不等于 Agent Client SDK。前者服务于业务后端的声明、验签与身份建立；后者服务于本地 Agent 的浏览器授权、连接与工具调用。
当前公开参考
Section titled “当前公开参考”- CRMEB 适配器 是独立项目，发布与 Core 分开管理。
- Core
v0.10.0包含 RuoYi-Vue-Pro 参考配方 和 JeecgBoot 参考配方。配方提供接入结构、示例声明与验证步骤，可按所用业务版本和权限模型调整。
一条适配路径
Section titled “一条适配路径”- 选择一条可核对结果的读取能力和一条可回滚写能力。
- 为每个动作定义稳定
operationId、参数 Schema 和 ACC 治理声明。 - 在业务后端验证签名、主体、租户、资源归属和实时业务状态。
- 只向中枢发布所需工具 spec，并在路由中再次裁剪允许范围。
- 用固定测试账号验证成功、越权拒绝、重复请求和审批恢复。
- 把适配器版本、兼容业务版本与维护者责任写清楚。
选择与维护社区接入
Section titled “选择与维护社区接入”选择社区发行版、连接器或配方时，查看其安装说明、兼容业务版本、测试范围和问题反馈入口。通用改进可以贡献上游，行业专用逻辑可以在独立项目中维护。