JECloud AI 烟花是一个 AI 智能体，干活时接入你的灵象环境，通过平台接口建表、装修、绑事件。把它「跑起来」涉及接入方式和环境配置，下面讲清关键点；真正落到你机房的细节对接，建议预约工程师一起做。
一、接入方式：必须是「常驻长连接」
烟花连接灵象环境用的是有状态会话——登录一次，后续操作都保持在同一条连接上。所以接入方式必须是常驻长连接：
- ✅ 正确：用常驻连接挂上烟花，登录后会话一直保持在这条连接上。
- ❌ 错误：用「每次调用都新建一条连接」的无状态方式——会出现登录成功、下一步就掉登录态，反复要求重登。
一句话自检：如果烟花「登录后立刻掉线/反复要重登」，几乎都是接入方式不对（用了无状态连接），不是烟花本身的问题。换成常驻连接即可。
二、看板/大屏部署：要先开「部署开关」
烟花自写的前端看板（KPI 大屏、报表页）属于进阶能力，默认是关的，需要先在部署配置里开启「双门」：
- 把部署开关置为开启；
- 配好看板文件的落地目录。
两者都齐了，烟花才会进入看板的设计与部署；否则它会婉拒、不动手。看板文件只会落在指定目录内（结构性沙箱），不会乱碰其它文件。
三、起服务后的自检顺序
环境接好后，建议按这个顺序确认：
- 确认登录态：能正常登录、且操作几步不掉线（验证常驻连接生效）。
- 探一次现场：让烟花盘点一个已有模块，能正常返回数据 = 接口通。
- 再交付任务：从一个小功能（建表/装修）开始，验证整链路。
四、常见报错怎么归因（别一股脑归到烟花身上）
| 现象 | 多半是什么 | 怎么办 |
|---|---|---|
| 登录成功、下一步就掉登录态 | 接入方式是无状态连接 | 换成常驻长连接 |
| 登录直接报 5xx / 网关超时 | 灵象后端/上游超时（连接本身是通的） | 先确认灵象网页能不能登录，是后端的事 |
| 查询返回空 | 不一定是故障，可能是查询条件/位置不对 | 先核对查的对象对不对，别急着判定「接口坏了」 |
| 看板任务被婉拒 | 部署开关没开 | 先开部署双门再试 |
提醒
以上是接入与排错的要点。具体到你机房的环境部署、服务配置、连接方式落地，建议预约工程师按你的实际环境一对一对接，会更稳更快。