教程：在 Azure SRE 代理中上传知识文档

在本教程中，你将知识文档上传到 Azure SRE 代理，以便在将来的调查期间引用它们。 了解如何通过聊天将调查结果直接保存到知识设置中，以及如何通过门户 UI 上传现有文件。

本教程中，您将学习如何：

• 将调查转换为可重用 Runbook 并将其保存到“知识”设置
• 验证上传的内容是否已编制索引并可搜索
• 通过门户上传单个文件或文件夹
• 测试代理是否可以在新对话中检索上传的内容

估计时间：10 分钟

先决条件

• 处于 “正在运行” 状态的 Azure SRE 代理
• 智能体的写入权限
• 代理运行模式设置为 “审阅 ”或 “自治”

步骤 1：从调查开始

最好的知识文档来自真正的调查。 不必从头创建内容，而是捕捉代理已经学习的内容。

1. 转到 sre.azure.com 并选择代理。
2. 在 “聊天”下的左侧栏中，找到以前的调查线程（代理诊断或解决问题的任何对话），然后选择它。

如果还没有调查线程，请启动新的聊天，并要求代理调查某些内容：

Investigate high memory usage on our container apps

等待调查完成，然后继续执行步骤 2。

步骤 2：要求代理创建运维手册

在同一个调查线程中，要求你的智能体将其发现转换为 Runbook 并保存到知识设置。 具体说明文件名。

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

您的代理：

1. 将调查上下文综合为结构化 Runbook。
2. 生成根本原因分析、诊断步骤、缓解措施和事态升级触发器等部分。
3. 将文档保存到知识设置并确认上传。

代理确认文档已保存并提供下载链接。 你的 runbook 现在存储在知识设置中，并已编入索引以供搜索。

Checkpoint

• 代理已根据调查生成了结构化的 Runbook。
• 代理确认文档已保存。

步骤 3：在知识设置中验证

1. 在左侧边栏中，选择 “生成器 ”以展开分区。
2. 选择 “知识设置”。

“知识设置”页面以表格形式显示您的文档，表格包括“文件名”、“状态”、“类型”和“上次修改”列。 “状态”列显示为✓ 已索引，表明文档已编制索引并准备好进行搜索。

如果状态显示 “挂起”，请选择“ 刷新”。 索引通常在几秒钟内完成。

Checkpoint

• 导航到 Builder → 知识设置
• 文档显示为✓ 已索引状态

步骤 4：通过门户上传文件

可以直接上传单个文件或整个文件夹。 此方法适用于团队已有的运行手册、文档或参考材料。

上传单个文件

1. 在 “知识源 ”页上，选择“ 添加文件”。
2. 将文件拖到放置区域，或选择 浏览文件 以选择一个文件。
3. 选择添加文件以进行上传。

上传文件夹

还可以将整个文件夹（包括嵌套子文件夹）拖到放置区域。

1. 在 “知识源 ”页上，选择“ 添加文件”。
2. 将文件夹从文件管理器直接拖到放置区域。
3. 门户从文件夹及其子文件夹中提取所有受支持的文件，然后在对话框中列出它们。
4. 查看文件列表 - 通过选择每个文件旁边的删除图标删除任何不需要的文件。
5. 选择 “添加文件 ”以上传所有列出的文件。

门户会自动筛选出扩展名不受支持的文件。 有关支持的扩展和大小限制的完整列表，请参阅 “上传知识文档”功能页。

每个文件的最大文件大小为 16 MB，每个上传最多 100 MB。

注释

上传文件夹时，门户不会保留文件夹结构 - 子文件夹中的文件显示为单个文档。 如果不同子文件夹中的文件共享相同的名称，则仅上传第一个文件。

Checkpoint

• 已选择 “添加文件 ”，并看到“上传”对话框。
• 上传文件或成功拖动文件夹。
• 文件在知识源中显示状态为已索引。

步骤 5：在新对话中测试检索

启动新的聊天线程并提出上传的文档应回答的问题：

What are the steps for troubleshooting high memory usage on container apps?

代理搜索 知识设置，查找已上传的运行手册，并在响应中引用它。 此过程确认知识已编制索引并可检索。

Checkpoint

• 启动新的聊天线程
• 询问了与上传的内容相关的问题
• 代理在其响应中引用了上传的文档

删除知识文档

1. 转到 生成器 → 知识设置。
2. 在文档列表中，使用复选框选择一个或多个文档。
3. 在工具栏中选择 “删除 ”。
4. 确认对话框列出了要删除的文档。 选择“删除”以确认。

删除文档时，将从代理的知识设置中删除它们，并且它们不再显示在搜索结果中。

注释

无法就地编辑知识文档。 若要更新文档，请上传具有相同文件名的新版本。 新版本替换了以前的版本。

已了解的内容

• 智能体能够将真实的调查转化为结构化的 Runbook，并保存到“知识”设置中。
• 可以通过 生成器→知识设置中的门户 UI 手动上传文件。 它支持多种格式，包括 PDF、Office 文档和图像。
• 系统为上传的文档编制语义搜索索引，并且它们可在将来的所有对话中使用。
• 若要更新文档，请使用同一文件名上传文档。

故障排除

Error	原因	修复
“代理内存已禁用。 无法上传文档。”	智能体上未启用知识设置	请与管理员联系以启用知识设置
“我没有对你的知识设置的写入权限”	代理找不到上传工具	请重新表述您的请求：“将其保存到知识设置中，命名为 filename.md”
“文件扩展名无效。 仅允许 .md 和 .txt 文件。	文件名不以 .md 或 .txt 结尾（用于聊天上传）	在要求代理保存时，使用.md或.txt扩展。
“文档内容超出最大大小 16MB”	单个文档的内容太大	拆分为多个较小的文档
“文件名不能为空”	未提供文件名	在提示中包含文件名（例如 runbook.md）

Related

资源	学习内容
上传知识文档	工作原理及其重要原因
创建技能	构建补充知识文档的过程技能
技能	技能和知识如何协同工作
ADO Wiki 知识	将实时 Wiki 内容作为知识源进行连接