知识服务¶
Obsy Copilot 可以把当前会话中的分析结果整理为平台笔记或 Runbook，也可以检索官方产品文档并回答使用问题。笔记适合保存已经形成的结论，Runbook 适合沉淀可重复执行的操作流程，产品文档问答则用于获得与官方文档一致的使用说明。
创建笔记与 Runbook¶
完成故障排查、日志分析、查询解释或方案讨论后，可以把当前会话中有长期价值的内容整理为笔记或 Runbook，避免再次手动复制和重新组织。
| 内容类型 | 适用内容 | 示例 |
|---|---|---|
| 普通笔记 | 结论、背景信息、查询说明、分析记录等参考内容 | 一次故障的原因分析与影响范围 |
| Runbook | 可重复使用的处置流程，通常包括前置条件、操作步骤、验证方式，以及必要的回退或升级路径 | checkout-api 超时的标准排查与恢复流程 |
触发方式¶
可以通过以下方式进入创建流程：
- 主动生成：在对话中输入“把上面的分析生成笔记”“将最近一条链路分析保存为笔记”，或明确要求“把这次
checkout-api超时排查整理为 Runbook”； - Obsy Copilot 建议：当对话已经形成较完整的分析结果或操作流程时，Obsy Copilot 可能提示是否需要整理为笔记或 Runbook。
需要限定范围时，请明确说明要整理的对象、内容和类型。例如，“将最近一条分析生成笔记”只整理最近的实质性结果，“将当前会话整理为笔记”可以覆盖当前会话中可沉淀的多项内容；创建 Runbook 时，建议同时说明适用对象、触发条件和期望保留的验证步骤。
创建流程¶
- Obsy Copilot 检查当前账号是否具有笔记创建权限；
- 根据指定范围和内容类型整理草稿，并在确认卡中展示标题、内容范围、章节和标签等信息；
- 检查确认卡，确认无误后同意创建；
- 创建成功后，Obsy Copilot 返回结果卡片。点击名称即可打开对应的笔记或 Runbook，无需关闭当前对话。
草稿可以引用会话中已经存在的查询和图表摘要，但不会把完整原始日志、超大查询结果或无关历史内容直接写入笔记或 Runbook。
查找和维护¶
您可以让 Obsy Copilot 按名称或内容查找已有笔记与 Runbook，并继续读取、更新或删除。例如：
搜索结果会先展示标题、类型、标签等基础信息。需要查看或修改时，Obsy Copilot 再读取完整 Markdown 内容。
创建后不能更改内容类型。普通笔记不能直接转换为 Runbook，Runbook 也不能改为普通笔记；如需调整类型，请按目标类型重新创建内容。
Runbook 不会自动执行
Runbook 是用于沉淀和复用操作步骤的知识内容，不是自动化执行引擎。后续按照 Runbook 处理问题时，实际的数据查询、配置修改或处置动作仍受当前账号权限、工具权限和操作确认规则约束。
注意
- 创建笔记需要当前账号具有笔记模块的创建权限，无权限时需联系管理员开通；
- 用户确认前只会生成草稿，不会创建真实的笔记或 Runbook；
- 当前会话内容不足时，Obsy Copilot 会说明需要补充的信息或仅整理已有结论；
- 创建后请核对关键结论、操作步骤、查询引用和对象范围，再用于后续分享或处置。
产品文档问答¶
产品文档问答能力会检索平台官方帮助文档，用于回答功能说明、入口位置、配置规则、操作步骤和常见排障问题，并在必要时提供对应文档链接。
可用于处理以下产品问题：
- 不清楚某项功能的作用或入口；
- 需要安装、接入、创建或配置步骤；
- 希望确认字段、默认值、版本要求或使用限制；
- 配置后没有数据或没有生效，需要按顺序排查；
- 希望获得对应的官方帮助文档。
提交产品问题¶
直接描述希望完成的任务，并写明相关产品、模块和问题阶段。例如：
复杂问题可以同时说明最终目标和当前进度，Obsy Copilot 会按前置条件、操作步骤和验证方式组织答案。如果只需要文档链接，也可以明确输入“相关文档在哪里”。
答案与文档引用¶
Obsy Copilot 会基于检索到的文档整理答案，并在需要时给出可访问的站点链接。对于配置与排障问题，答案会优先说明执行顺序、限制条件和验证方式。
产品文档问答只提供说明，不会替用户创建、修改、删除、安装或部署资源。检索结果不足以确认某项规则时，Obsy Copilot 会明确说明证据不足，而不是使用通用知识补全文档中没有的结论。