实例深度运维
智能体实例是平台对外提供服务的运行时单元——绑定一个智能体的某个版本 + 一个资源池，部署到 K8s 后通过 Gateway 暴露给终端用户。Dify 等外接引擎是例外：实例运行在外部平台，不占资源池也不产生 Pod，绑定的是外部平台上的应用（见应用绑定）。
实例的日常入口在智能体工作台「部署」页签（实例表格 + 暂停/恢复/销毁/升级/回滚）。本页对应的实例详情页是深度运维视图，提供 Pod 状态、实时日志、监控曲线、渠道与 API Key 的完整管理能力。
入口
智能体管理 → 单击智能体卡片进入工作台 → 「部署」页签 → 单击实例行的详情（或日志直达运行时页签）。
前提条件
调试实例不会出现在这里，它常驻工作台「调试」页签中。
创建并部署实例
一个智能体只对应一个生产实例，它随发布自动创建与部署，无需单独新建：
进入智能体工作台的「版本」页签，单击发布，填写版本说明后提交。
首次发布时系统自动创建并部署生产实例：
- 容器引擎（Hermes / OpenClaw 等）：可在发布弹窗内展开「实例配置」设置资源池与运行参数（运行模式 / 云浏览器 / 命令沙箱，默认折叠，一般无需改动）
- Dify 等外接引擎：无需资源池，但需要先完成应用绑定（可在弹窗内顺带完成，或提前在「构建 → 应用绑定」中绑定）
发布提交后自动进入部署，底部出现 4 步部署进度面板：启动中 → 创建 Pod → 等待运行 → 就绪（外部引擎无部署过程，即刻上线）。
部署完成后，状态变为「运行中」（实心绿色标签），终端用户可通过终端门户或 API 访问该实例。
后续如需调整运行参数，在「部署」页签的部署配置卡单击编辑运行配置（保存后重启生效）。
预期结果
- 实例表与详情页显示状态标签「运行中」
- 详情页头部 Agent ID 可复制，用于 API 调用
升级到新版本
当智能体发布了新版本（如 v1.1 增加了天气技能），运行中的实例可热升级：
- 在智能体工作台「部署」页签，找到要升级的实例行。
- 在行尾更多操作中单击升级版本（或进入实例详情页，单击头部版本号旁的升级按钮）。
- 确认后，新版本的人设/技能会热加载到运行中的 Pod，无需重建 Pod（Hermes/OpenClaw 支持；Dify 外接实例没有 Pod，应用与模型更新在 Dify 平台侧生效，平台随发布同步绑定）。
版本回滚
在智能体工作台「部署」页签的更多操作中单击回滚，可将生产实例一键切回任意历史版本并自动重新部署。
暂停 vs 完全回收
本节适用于容器引擎实例。外接引擎实例运行在外部平台，没有 Pod 可暂停或回收。
| 需求 | 操作 | 效果 |
|---|---|---|
| 暂停（释放计算，保留现场，可快速恢复） | 工作台「部署」页签或详情页 → 暂停 | 状态变「已挂起」 |
| 完全回收（清 Pod 释放资源，数据归档 MinIO） | 工作台「部署」页签或详情页 → 销毁 | 状态变「已归档」，K8s 资源清理，数据已备份 |
| 恢复已挂起实例 | 工作台「部署」页签或详情页 → 恢复 | 从「已挂起」回到「运行中」 |
销毁不可逆
销毁会清理 K8s 资源，但数据已归档到 MinIO（SUSPEND 时自动触发归档）。归档后实例记录仍在，可查看历史数据，但不能重新启动——如需再次上线，到「版本」页签重新发布即可自动重建实例。
排查实例异常
实例跑出问题时（响应慢、报错、不响应），按以下顺序排查：
1. 看运行状态标签
实例状态即运行状态：待部署/部署中/运行中/已挂起/异常/已归档。
如果状态是异常（红色），继续下一步。
2. 看 Pod 状态
在实例详情页单击运行时 Tab，看 Pod 表格：
- Pod 状态为 CrashLoopBackOff（红色）：引擎启动失败，看日志
- Pod 状态为 Pending（黄色）：资源不够，Pod 调度不上去，检查资源池容量
- 重启次数 > 0（黄色高亮）：Pod 反复重启，看日志找原因
3. 看实时日志
在「运行时」Tab，单击有问题的 Pod 行的查看日志。
在弹出的日志抽屉中：
- 来源：默认看 engine stdout（引擎日志）；Gateway 相关问题切到 gateway per-profile
- Profile：选要看的 Profile 配置
- 尾行数：200 / 500 / 1000 / 2000 行
- 自动刷新：开启后定时拉新日志
根据日志报错定位问题（如模型 API Key 失效、技能凭证错误、资源不足等）。
4. 看监控曲线
单击监控 Tab，看 CPU / 内存 / 请求数 / Token 数 1h / 6h / 24h / 7d 趋势：
5. 看 API Key
单击API Keys Tab，确认实例的有效 Key：
- 每实例最多 10 个 Key
- 创建 Key 后明文仅展示一次，需立即复制保存
- Key 失效会导致 API 调用 401，可在API Key 管理页封禁/吊销/重建
接入 IM 渠道
让终端用户从企微/飞书/钉钉对话触发该实例：
- 进入实例详情页，单击渠道 Tab。
- 选择 IM 类型（企业微信 / 飞书 / 钉钉）。
- 填写对应凭证字段（企微：corpid / secret / token / aes_key；飞书：app_id / app_secret；钉钉：app_key / app_secret）。
- 单击保存，开关自动启用。
- HTTP 渠道（Webhook 触发）单独开关，与 IM 渠道独立。
也可以在智能体工作台「版本」页签的发布渠道配置卡片中单击配置，直接打开对应渠道的配置表单。
详见 IM 渠道架构。
后续步骤
- 创建 API Key 调用实例 — 用 sk- 风格 Key 通过 OpenAI SDK 调用
- 排查调用慢在哪 — 链路追踪
- 查看实例的用量 — 按 Agent 过滤