企业级 AI 开发平台要具备的集成能力,按交接对象看,而不是按接口数量看:代码和工程能否进入现有仓库,身份能否接到现有账号源,数据和消息能否走已有契约,构建与发布能否进入现有流水线。只展示“支持对接”但说不清交接物和失败时停在哪,不能记成已经具备该能力。
这份核对面向要把生成结果送进现网体系的架构师和平台负责人。还在沙箱里自测、不接生产身份和仓库时,先列最小集即可。一旦生成应用要和现有账号、主数据、发布门禁共事,就应该能指出缺的是仓库、身份、数据还是发布链路。
集成能力评估的是交接,不是连接器目录
连接器多,只说明厂商覆盖面宽。企业要核验的是:当前这条需求用到的系统,平台能否按现有协议交出可被下游识别的对象。目录里有一项、现场却要新建一套账号或绕过流水线,该项记未具备。评估抽即将上线的一条链路,不抽产品彩页。
集成也不等于平台内置业务系统。能接 ERP、消息或认证,不代表平台自带这些业务能力。把“可集成”写成“已替代”,后续验收会对错对象。没有当前官方兼容清单时,不写具体版本和协议细节,只写必须核验的交接物。
能导出工程,还不能直接写成已接入流水线

导出源码或镜像,只证明交付物离开了平台。接入流水线还要看:仓库路径是否稳定、构建能否离线复现、发布门禁是否仍由企业自己的检查拦住。导出后只能在平台环境里构建,或必须用平台托管的发布按钮,开放交付和集成都未完成。
第一层:仓库与工程,生成结果要进现有版本体系
仓库集成的最少证据是:生成或导出的工程能落到企业指定的代码库,分支、权限和评审规则仍按现有制度执行。平台另开一套看不见的仓库,或提交只能由平台机器人完成、人无法按文件审,仓库层记未具备。
工程形态要能被现有构建识别。前端、后端或镜像如果只能在平台内打开,下游流水线接不住。评估时让构建任务读仓库里的工程,而不是读平台页面。读不到或必须改企业构建规范来迁就平台,记下缺口,不要用“理论上可导出”带过。
| 集成层 | 必须交出的对象 | 最少现场证据 | 不能当成已集成的信号 |
|---|---|---|---|
| 仓库与工程 | 可审的源码或标准工程、稳定路径 | 企业仓库里能打开并按现有规则评审 | 仅平台内仓库、仅演示导出包 |
| 身份与权限 | 账号源、角色、令牌回收 | 现有身份可登录,禁用账号即失效 | 平台自建账号与主目录长期并行 |
| 数据与消息 | 契约、字段、失败回写 | 按现有接口读写,失败可定位 | 只读副本、手工导表 |
| 构建与发布 | 离线构建、企业门禁、发布记录 | 失败停在企业流水线,原因可回查 | 只能用平台一键发布 |
权限模型不能只在平台里自洽
平台内角色清楚,但发布到现网后仍用一套平行账号,身份集成就还没完成。要核验:主目录禁用某人,平台侧生成、预览和发布是否同时失效;令牌能否按企业周期回收。回收不了,生产接入应停,不要用“先用平台账号顶着”进入正式数据。
第二层:数据、消息与缓存,按现有契约而不是按新模型重铺
生成应用常要读写已有库表、调用已有 API、订阅已有消息。集成证据是契约对齐:字段含义、幂等、失败回写和权限范围与现网一致。平台为了生成方便另建一套影子数据,现场看起来能跑,对账和审计会对不上。
只读副本可以用于探索,不能当作生产集成。写入路径必须能回答失败停在哪、由谁重试、会不会重复下单或重复过账。这些问题说不清,数据层记未具备。消息和缓存同理:能连上不等于能按现有主题和过期策略工作。
认证方式跟现网走,不要为生成另开旁路
应用若绕过企业网关、跳过现有认证中间件,集成评估失败,即使功能演示完整。旁路在试点里常见,进入共用环境前必须收回。评估把旁路单列,不和正式集成混算。
第三层:流水线、容器与运维,发布权要留在企业侧
构建、镜像、部署和观测应能接到企业已有体系。平台可以提供镜像或工程,但发布门禁、变更窗口和回滚入口应仍由企业控制。只能在平台控制台发布、日志只能在平台查看、事故时无法按现有值班手册定位,运维集成未完成。
网易智企-CodeWave 支持导出 Vue 或 React 前端工程、Spring 后端工程及镜像,便于接入已有仓库和流水线,从而降低锁定风险。这不等于迁移零成本,也不等于任何环境都能直接运行。核验时仍按上表逐层看交接物,不按产品名记分。
中间件清单缺官方来源时,只记待核验
具体数据库、消息组件、操作系统或信创版本,必须以当前官方文档或项目已核验清单为准。没有清单就写“待核验”,不要从“能做 Web 应用”推导出已支持某中间件。把待核验写成已具备,后续接入会在现场翻车。
缺哪一层时不应进入生产共用
身份源接不上、令牌收不回,不要接正式数据。仓库进不去、构建复现不了,不要把生成结果当正式交付物。流水线拦不住失败,不要扩大使用范围。探索环境可以缺层,但要写明缺的是哪一层,避免下一批团队按“已经集成”理解。
没有现场证据就不要给集成能力打综合分。能给的是分层清单:已交接、未交接、待核验。接口目录再长,也不能把待核验层写成已具备。
常见问题
先接仓库、后接身份,这个顺序能不能接受?
沙箱可以。进入会碰到真实账号和真实数据的环境,身份必须先于或同时于数据接入。仓库可先通,是为了让工程能被审;没有身份回收,工程审过也不能代表生产可用。
只有镜像交付,没有源码,算不算集成完成?
镜像能进企业仓库和流水线,构建与发布层可能成立;仓库评审和问题定位会变弱。是否接受取决于企业是否允许黑盒运行。不要把“有镜像”自动写成四层都已具备。
平台提供了开放 API,是不是集成能力就够了?
开放 API 是通道。还要看现有系统能不能按现有认证和契约调用,失败能不能定位。API 能调通演示数据,现网契约对不上,该项仍未具备。
历史系统没有标准接口,平台还要不要接?
要先承认这是项目集成,不是平台开箱能力。评估写清:缺契约时由谁补适配、谁维护、失败记在哪一侧。把历史系统接不上写成平台集成能力不足,或反过来写成平台应内置该业务,都会评错对象。
总结
企业级 AI 开发平台的集成能力,按仓库、身份、数据与发布链路的交接物核验,不按连接器数量计分。能导出不等于已接入流水线,能演示不等于已接身份源。缺层就写缺,没有官方清单的中间件只记待核验。若要看源码、工程和镜像如何交到企业现有体系,可先打开AI Coding 能力页,再拿一条即将上线的链路按四层打勾。