实例深度运维
智能体实例是平台对外提供服务的运行时单元——绑定一个智能体的某个版本 + 一个资源池，部署到 K8s 后通过 Gateway 暴露给终端用户。
实例的日常入口在智能体工作台「部署」页签（实例表格 + 暂停/恢复/销毁/升级/回滚）。本页对应的实例详情页是深度运维视图，提供 Pod 状态、实时日志、监控曲线、渠道与 API Key 的完整管理能力。
入口
智能体管理 → 单击智能体卡片进入工作台 → 「部署」页签 → 单击实例行的详情（或日志直达运行时页签）。
前提条件
调试实例不会出现在这里，它常驻工作台「调试」页签中。
创建并部署实例
进入智能体工作台的「部署」页签，单击新建实例。
创建向导已预选当前智能体。
在向导中填写：
- 名称：对外展示的名字（如"客服助手-生产"）
- 版本：默认选中定义当前发布版本，可改选历史版本
- 资源池：选择已建好的资源池（Dify 实例选"外部"跳过）
- 所属用户组：选实例归属的组（决定可见性与 LiteLLM Key 归属）
（可选，Hermes 引擎实例）配置运行时开关：
- 运行模式：默认「独立运行」，每位终端用户独享一套引擎环境；改选「共享运行」后多个用户共用一个引擎，资源占用大幅降低，适合大规模用户接入。运行模式在创建后不可更改，两种模式的实例可并存。共享运行暂不支持云浏览器
- 云浏览器：启用后智能体可操作独立浏览器，用户可经云桌面接管（共享运行下不可用）
- 命令沙箱：启用后智能体的终端命令在独立沙箱中执行，与引擎运行环境隔离。展开后可配置沙箱镜像（留空用平台默认）、CPU / 内存 / 磁盘规格与空闲回收时长。每位终端用户分配独立沙箱，命令产物自动保留到实例数据卷，跨会话可继续使用
单击保存。工作台「部署」页签的实例表出现新实例。
实例需要引擎成功部署（状态「运行中」）后才正式上线——上线前终端门户中不可见，上线后终端用户即可通过终端门户或 API 访问。
单击实例行的详情进入实例详情页，单击右上角部署按钮。
底部出现 4 步部署进度面板：启动中 → 创建 Pod → 等待运行 → 就绪。页面每 2 秒轮询一次，最长 3 分钟。失败可单击重试。
部署完成后，状态变为「运行中」（实心绿色标签），终端用户可通过终端门户或 API 访问该实例。
预期结果
- 实例表与详情页显示状态标签「运行中」
- 详情页头部 Agent ID 可复制，用于 API 调用
升级到新版本
当智能体发布了新版本（如 v1.1 增加了天气技能），运行中的实例可热升级：
- 在智能体工作台「部署」页签，找到要升级的实例行。
- 在行尾更多操作中单击升级版本（或进入实例详情页，单击头部版本号旁的升级按钮）。
- 确认后，新版本的人设/技能会热加载到运行中的 Pod，无需重建 Pod（Hermes/OpenClaw 支持；Dify 外部模式走 Dify 平台自身更新）。
版本回滚
在智能体工作台「部署」页签的更多操作中单击回滚，可将生产实例一键切回任意历史版本并自动重新部署。
暂停 vs 完全回收
| 需求 | 操作 | 效果 |
|---|---|---|
| 暂停（释放计算，保留现场，可快速恢复） | 工作台「部署」页签或详情页 → 暂停 | 状态变「已挂起」 |
| 完全回收（清 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 过滤