观测云笔记焕新上线：人与智能体的共同知识库

你刚花了一个小时解决了一个 Redis 故障。三个月后，一模一样的问题又来了。上次的排障记录？大概率还在某个同事的本地 Markdown 文件里，文件名大概长这样：redis-issue-202603-final-v2-really-final.md。你@了那位同事，他没回。于是，你又从头排查了一遍。

说白了，这就是知识的“蒸发”。现在不仅人类面临这个问题，连智能体也在重复“学习”同一个故障。观测云笔记，就是冲着这个痛点来的。

笔记是什么？

观测云笔记可以理解为可观测数据基础设施里，一个专门承载知识的层级。它的核心数据结构大致如下：

// notebookV2.ts
interface NotebookV2 {
  ...
  content           // Markdown，支持 chart block
  tags            // 普通标签，比如 "copilot", "redis"
  tagKV // 关联业务标签，比如 service: inner-api
  createdSource //用于标记手工或 AI 创建来源
  etag   // 并发控制，防止覆盖
  ...
}

几个关键的设计理念：

• tagKV：它不再是一个单纯的 #标签 ，而是精确关联到某个具体的 service、host、dashboard、database 等业务实体。你在 inner-api 服务的详情页看到的“笔记”，本质上就是该服务自己的“记忆”。
• chart block：笔记里可以直接内嵌图表和当时的 DQL 查询语句。这意味着，任何一个结论背后，都有真实跑出来的数据作为证据。
• etag / ifMatch：解决多人协作时的覆盖问题。保存前会检查版本，避免静默覆盖，保证知识资产安全。
• createdSource：追踪知识的来源。是人工撰写的、Obsy AI Copilot 生成的，还是观测 AI Agent Teams 创建的，一目了然。这不仅方便追溯，也明确了质量责任。

人、Obsy AI Copilot、Guance AI Agent Teams，如何共同玩转笔记？

人类：把故障处理经验，变成团队的资产

1、故障复盘

故障处理完，写一篇复盘笔记：

标题：frontend-proxy 5xx 排查记录
标签：service: frontend-proxy, alert: high-error-rate
内容：
- 14:23 告警触发，错误率从 0.1% 飙升至 12%
- 14:25 定位到 upstream 连接超时
- 14:30 调整 nginx proxy_timeout，恢复
- 根因：上次部署引入了新的上游服务，未调整超时配置

生成的笔记会自动绑定业务标签 service: frontend-proxy。三个月后，如果同一个服务再次告警，新同事打开服务详情页，在“相关笔记”里就能直接找到这篇记录——不用再满世界问人了。

2、轻松搜索

当 frontend-proxy 出现接口异常，你写成了笔记。下次任何人检索“frontend-proxy 异常”，这篇笔记就会排在搜索结果最前面。

3、图表证据保全

笔记里可以嵌入当时的查询和图表。如果有人隔段时间来问“当时查的哪个指标？用的什么 DQL？”，打开笔记，当时的分析路径和图表证据都还在。

4、自由的团队协作

• 笔记可以设为“仅自己可见”，作为排故过程中的临时记录或个人参考。
• 也可以公开给团队或工作空间，成为团队知识库的一部分，沉淀经过验证的经验。
• 多人同时编辑时，系统会检测冲突并给出提示，保证内容不被意外覆盖。

Obsy AI Copilot：辅助人类沉淀高价值分析结果

Obsy AI Copilot 在分析完告警、日志、仪表板后，会自动判断这次结论是否值得沉淀，并给出一个结构化的建议。你确认后，它就会自动创建一篇笔记。举个例子，当它分析出某个仪表板数据缺失时，会生成一篇《xxx仪表板数据缺失分析》：

• 结论：16 个图表均无有效数据
• 根因：模板变量 #{service} 未绑定，查询条件无法匹配
• 建议：整理绑定模板变量，验证数据采集

这篇笔记会自动绑定到具体的 dashboard 上。今后任何人在查看该仪表板时，都能在“相关笔记”里看到这份诊断。

Guance AI Agent Teams：让笔记成为智能体的长期记忆

笔记会成为 AI Agent 团队不断迭代、持续更新的长期记忆层。

Agent 在处理问题前，会按照 service、host、alert、incident、tagKV 等维度，自动召回相关的笔记，从中学习人类的处理经验，从而提高自身执行任务的准确度。

简单来说，这是一个正向循环：人用笔记沉淀经过验证的问题处理经验，Obsy AI Copilot 辅助人类创建并沉淀高价值的分析结果，最后，Agent Teams 将这些笔记转化为团队可持续复用的长期记忆，进而提升 AI 自动处理问题的能力。

现在开始使用

在观测云控制台找到「笔记」模块，点击「新建笔记」，或者打开右上角的「Obsy AI」，让 Obsy AI Copilot 帮你生成第一份 AI 笔记，看看它是如何结构化地呈现分析结果的。

笔记，让经验留下来，让 Agent 学会用。