通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：将知识文档上传到 Azure SRE 代理

在本教程中，您可以通过两种方法将知识文档上传到您的 Azure SRE 代理的知识设置：一是通过让代理根据调查创建运行手册，二是通过门户用户界面上传文件。

代理可以捕获在调查期间发现的知识，并将其存储以供将来使用，因此它会自动构建机构知识。 有关详细信息，请参阅 “上传知识文档”。

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

  • 将调查转换为结构化的运行手册，并将其保存到知识库设置中。
  • 通过门户 UI 手动上传文件
  • 验证上传的文档是否已编制索引且可用
  • 确认智能体在新对话中检索已上传的知识

估计时间：15 分钟

先决条件

在开始之前，请确保拥有以下资源和权限：

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

从调查开始

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

  1. 转到 sre.azure.com 并选择代理。
  2. 在 “聊天”下的左侧栏中，找到代理诊断或解决问题的上一个调查线程，然后选择它。

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

Investigate high memory usage on our container apps

等待调查完成，然后继续执行下一步。

从调查创建 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 现在存储在知识库配置中，并已编入搜索索引。

此时，请确认以下信息：

  • 代理从调查中生成了一本结构化的运行手册。
  • 代理确认文档已保存。

在知识设置中验证

转到 知识设置 以确认文档已编制索引。

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

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

“知识设置”页的屏幕截图，其中显示了“索引”状态的上传文件、“文件名”、“状态”、“类型”和“上次修改”列。

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

通过门户上传文件

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

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

“上传”对话框显示支持文件格式的拖放区域，最大大小为 100 MB。

门户接受知识 设置的许多文件类型，包括文本文件、文档和图像。 有关支持的扩展和大小限制的完整列表，请参阅 “上传知识文档”。

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

在新对话中测试检索

确认代理可以找到和使用上传的文档。

  1. 在边栏中选择 “新建聊天线程 ”。
  2. 提出一个您的上传文档可以回答的问题。

例如：

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

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

删除知识文档

若要从 知识设置中删除文档，请使用以下步骤。

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

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

注释

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

故障排除

使用下表解决知识文档上传的常见问题。

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

相关内容

资源 说明
上传知识文档 上传知识文档的工作原理及其重要原因。
技能 技能和知识如何协同工作。
Azure DevOps Repos 连接器 将实时 Wiki 内容作为知识源进行连接。
  • Last updated on