帮你快速理解、总结文档立即下载

对接第三方知识库教程

最近更新时间:2026-10-09 14:19:31
我的收藏

实践背景

监控能说明当前发生了什么,但服务名、依赖关系、业务影响、处置顺序和审批边界,往往沉淀在企业自己的文档中:
服务与业务能力映射。
错误码和依赖说明。
应急预案与处置 SOP。
降级矩阵和历史复盘。
责任边界与审批规则。
通过 ima 知识库 Skill,AI 可以提取当前故障特征,检索相关文档,再回到实时数据验证,而不是直接照抄一条历史结论。

实践内容

同一故障,两种结论

这次对照实验的时间窗为15:20 - 16:00。用户反馈首页和商品详情打开变慢、猜你喜欢加载很久、商品列表偶尔卡住,同时有人观察到“广告服务 CPU 很高”;加购、结账和支付正常。
两个会话使用相同的 APM、Prometheus 和 CLS 能力;其中一个额外接入 ima 知识库。知识库包含三篇文档:服务资源与业务能力映射、商品目录 PostgreSQL 依赖处置 SOP、商品浏览与推荐降级矩阵。
两边看到的实时现象一致:product-catalog 的 GetProduct 从4ms 上升到2200ms,sql.conn.query 从0.89ms 上升到约915ms;recommendation 和 frontend 同步变慢,购物车、支付和广告服务保持正常。最终结论却不同:

未接知识库
接入 ima 知识库
最终根因
“PostgreSQL 连接池耗尽”,将数据库实例当成根因。

“product-catalog 到共享 PostgreSQL 的网络访问路径异常”,数据库实例本身无异常。

判定依据
看到 DB span 变慢,但未继续区分网络路径与数据库实例。

依据约 915ms 的恒定延迟和正常的 PostgreSQL 服务端指标,按 SOP 归因为网络路径问题。

处置建议
调大连接池、重启 Pod、入口限流。

先推荐降级、缓存兜底和限制重试,再由网络或平台方恢复路径;禁止重启 PostgreSQL 和盲目扩容。

责任与影响边界
输出服务级受影响清单。

说明商品浏览、详情和推荐受影响,结账被级联拖慢,购物车、支付和广告不受影响,并标注责任方与审批要求。

未接知识库的会话并不是没有找到瓶颈:它识别了 sql.conn.query 延迟、排除了广告干扰,也确认购物车和支付正常。它缺少的是企业沉淀的判定规则:应用侧 DB span 变慢、数据库服务端指标正常时,应优先怀疑访问路径,而不是直接归因数据库实例。
知识库的增量也不止技术归因。它把技术资源翻译成业务影响和处置动作:商品目录异常首先影响商品浏览、详情和推荐;结账可能被级联拖慢,但购物车和支付保持独立;止血应先降级再修路径;不同动作分别由推荐、商品平台、网络或数据库团队负责,并遵守相应审批边界。
说明:
监控数据告诉 AI 哪个服务变慢;企业知识把服务名翻译成影响哪些业务、外部依赖归谁管、先降级还是先修路径,以及什么不能动。

ima 知识库 Skill 与平台知识库的区别

两种方式可以并存。无论选哪种,都要按用户、角色和项目校验访问权限,不要把密钥、账号和个人信息写进知识内容。
AI 工作台自带知识库适合沉淀与某个数字分身强绑定、需要在工作台内持续维护的资料。
ima 知识库 Skill 适合连接企业已在 ima 中运营的知识资产,不必迁移原有文档和检索体系。

配置指引

准备 Skill

ima 知识库 Skill 属于第三方官方 Skill,不需要重新编写。在 ima skill 官网 获取官方安装包后,进入上传并安装流程。

上传并安装

1. 进入 AI 工作台 > 扩展中心 > Skill 技能 页面,单击 Skill 技能页签中的+ 自定义 Skill。

2. 上传包含 SKILL.md 的文件夹或 ZIP 包。
说明:
文件夹或 ZIP 不超过200MB。
3. 单击确定,等待安全检测。
4. 安装成功后,在自定义分类中确认 Skill 可见。

配置 Skill 到数字分身

1. 进入 AI 工作台 > 数字分身管理 页面,创建或编辑目标数字分身,在分身配置中添加 ima Skill。
2. 完成分身配置后,进入目标分身的分身详情 > 集成配置,按照页面指引添加阿里云授权环境变量。
环境变量
说明
IMA_OPENAPI_APIKEY
IMA 的 AccessKey ID。
IMA_OPENAPI_CLIENTID
IMA 的 AccessKey Secret。

发起会话

在左侧导航栏选择 AI 工作台 > 工作面板,在页面顶部选择目标数字分身,切换至会话列表页签,新建会话。
1. 选择需要使用的 ima Skill 和其他可观测 Skill。
2. 输入问题,建议包括明确的资源对象、范围和查询问题。
3. 查看分析过程的工具调用和会话结果。

创建数字分身并绑定能力

2. 填写身份定义和业务范围。
3. 按需选择或创建资源地图。
4. 在集成配置中添加 APM、Prometheus、CLS、ima 知识库 Skill 和知识库。
5. 配置完成后单击创建并启用。