模块与服务

模块把可复用业务能力以市场版本、属性定义、方法和用户域的方式交付给应用。

模块是百积木复用业务能力的主要方式。一个模块通常包含市场版本、属性定义、用户域、可调用方法和运行时安装记录。

模块版本

市场模块发布后会形成版本记录，已安装用户是否升级取决于运行时安装记录。批量升级时需要先 dry-run，再确认目标版本和影响范围。

属性定义描述模块接入需要的 token、租户 ID、回调地址等配置。生产属性变更必须能够从运行时 current 状态读回验证。

方法定义决定智能体或外部服务可调用的能力。新增、删除或改参时要同步更新 market module definition，并确认运行时可见方法列表。

POST /api/module/{moduleId}/methods/{methodName}

版本和运行时是两层状态

市场版本说明平台可提供什么能力，运行时安装记录说明某个用户当前实际使用哪个版本。排查模块问题时两层都要看。