你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
团队解决的每个事件都会产生有价值的知识：哪里出了问题、哪些命令解决了问题，以及下次首先要检查什么。 但这种知识存在于聊天线程、工程师记忆和事后分析中，没有人在凌晨三点阅读它。
你的团队有运行手册，但它们已经过时了。 在昨晚的事件中发现的修复程序？ 它只在某人的脑子里，或者埋在一段聊天记录中，到下周就消失地无影无踪了。 下次发生同一问题时，不同的工程师从头开始。
代理如何解决此问题
代理可以使用 “上传知识文档 ”工具在对话期间将文档上传到知识设置。 当代理发现修补程序、创建故障排除指南或合成调查发现时，它会直接存储该知识。 这种方法使这些信息在今后的每一次对话中都可被搜索到。
Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to Knowledge settings.
您的代理会生成一个结构化的操作手册，并在几秒钟内上传。 文档会自动编制索引，并可供未来的调查搜索。
前后
| 之前 | 之后 | |
|---|---|---|
| 知识捕获 | 事后：工程师编写操作手册（也许） | 你的智能体在问题解决时捕获解决方案 |
| 开始记录 | 编写运行手册需要30到60分钟 | 秒。 您的代理会在线生成并上传内容。 |
| 知识新鲜度 | 运行手册在几周内就会变得过时。 | 知识设置随着每次解决方案而增长 |
| 可及性 | 知识停滞在工程师的脑海中或聊天记录中 | 您的代理可在所有将来的对话中进行搜索 |
| 格式一致性 | 因作者而异 | 每次编写文档都要结构化、一致 |
这有什么不同
与手动上传不同，代理会主动创建知识。 无需记住记录所学内容，因为代理会将其作为对话的一部分执行。
与聊天历史记录不同，上传的文档已为语义搜索编制索引。 几个月后出现类似的问题时，您的代理智能模块会通过自动化检索快速找到相关的操作手册，而不是靠滚动查看旧的线程。
与 Wiki 连接器不同，上传的文档不需要外部服务。 知识直接存在于代理的 Knowledge 设置中，可在不同步延迟的情况下立即获得。
工作原理
上传知识文档工具接受三个参数：
| 参数 | 必需 | 说明 |
|---|---|---|
| 文件名 | 是的 | 具有 .md 或 .txt 扩展的名称（例如 database-pool-runbook.md） |
| Content | 是的 | Markdown 或纯文本格式的完整文档文本 |
| 触发器索引 | 可选（默认值： true） |
是否使文档立即可搜索 |
代理上传文档时：
- 验证 文件名和内容（每个文件最多 16 MB）。
- 将文档存储在你的代理的知识库设置中。
- 为语义搜索的内容编制索引。
- 确认 上传成功消息。
注释
如果已存在具有相同文件名的文档，则新内容将替换它。 此过程使代理可以轻松更新知识。 使用相同的名称上传文档以刷新内容。
支持的文件格式
代理通过三种方法处理文件，每个方法支持不同的格式。
聊天附件
将文件拖动到任何聊天中，为代理提供即时上下文进行分析 - 对脚本、配置文件、网络跟踪等进行故障排除。
| 类别 | Extensions |
|---|---|
| 映像 |
.png、.jpg、.jpeg、.gif、.webp、.svg |
| 文档 |
.txt、.md、.pdf、.docx、.pptx、.xlsx |
| 数据和配置 |
.json、.csv、.log、.yaml、.yml、.xml、.ini、.conf、.env |
| Web 和网络 |
.html、.har |
| 代码和脚本 |
.ts、.js、.py、.sh、.sql、.kql |
| 基础结构 |
.bicep、.tf |
限制： 每个文件 10 MB 。每条消息总计 50 MB •每条消息 5 个文件
知识参数上传
若要在将来的对话中保留代理引用的文档，请通过 Builder → Knowledge settings → Add 文件上传文件。 系统为上传的文件编制语义搜索索引。
| 类别 | Extensions |
|---|---|
| 映像 |
.png、.jpg、.jpeg、.gif、.webp、.bmp、.tiff、.tif |
| 文档 |
.txt、.md、.pdf、.docx、.pptx、.xlsx、.doc、.ppt、.xls |
| 数据和配置 |
.json、.csv、.log、.yaml、.yml、.xml、.ini、.conf、.cfg、.config、.properties |
限制： 每个文件 16 MB 。每个上传 100 MB
文件夹上传
若要一次性上传所有受支持的文件，请将整个文件夹拖到上传放置区域。 此过程包括嵌套子文件夹中的文件。 门户会自动从文件夹层次结构中提取每个文件，并筛选掉不受支持的文件类型。
文件夹上传的工作原理：
- 系统将嵌套子文件夹中的所有文件提取到平面列表中。
- 系统仅包含支持扩展名的文件，并无提示地筛选不受支持的类型。
- 系统会去重处理不同子文件夹中具有重复名称的文件，只保留第一个文件。
- 系统逐个上传和索引每个文件进行搜索。
注释
上传的文件在知识源中显示为单个文档。 不保持原始文件夹层次结构。 文件在 runbooks/networking/dns-troubleshooting.md 处看起来像 dns-troubleshooting.md。
知识设置上传接受旧版 Office 格式（.doc、.ppt、.xls）和其他聊天附件不支持的图像格式（.bmp、.tiff、.tif）。 聊天附件支持知识设置不支持的代码、脚本、基础结构和 Web 格式。
代理生成的文档
当代理在对话期间（使用 上传知识文档 工具）创建文档时，它会生成 .md 或 .txt 文件并将其直接保存到 Knowledge 设置。 当你要求智能体“将此另存为 runbook”时，该过程将发生。
示例：捕获事件知识
在事件调查期间，请询问您的代理人：
We just resolved the high CPU issue on web-app-prod. It was caused by a memory leak in the connection pool. Create a troubleshooting guide from what we learned and upload it to Knowledge settings.
您的代理生成了一个结构化的故障排除指南，包含以下内容：
- 界定故障步骤：如何识别故障。
- 快速缓解：立即采取措施来减少影响。
- 根本原因分析：要调查的内容。
- 解决步骤：有效的解决方案。
- 预防：如何避免重复。
下次发生类似的 CPU 问题时，代理会在调查期间自动引用本文档，将一名工程师的经验转化为共享团队知识。
所需内容
| 要求 | 详细信息 |
|---|---|
| 代理版本 | 26.1.57.0 或更高版本 |
| 知识设置 | 在你的智能体上启用 |
| 写入权限 | 代理需要对知识设置具有写访问权限 |
| 运行模式 | 审阅或自治。 写入操作需要在审阅模式下获得批准 |
限制
| 类型 | 聊天附件 | 知识参数上传 | 代理工具 |
|---|---|---|---|
| 最大文件大小 | 10 MB | 16 MB | 16 MB |
| 最大值 | 每条消息 50 MB | 上传文件大小限制为 100 MB | 不適用 |
| 最大文件数 | 每条消息 5 个 | 无限制（总大小上限为 100 MB） | 每次操作 1 个 |
| 文件夹上传 | 不支持 | • 拖动文件夹以同时上传所有文件 | 不支持 |
| 支持的扩展 | 31 | 28 | 2 （.md， .txt） |
| 文件名字符 | 不適用 | 字母、数字、连字符、下划线、点 | 相同 |
| 最大文件名长度 | 不適用 | 1,024 个字符 | 相同 |
何时使用其他选项
| 情景 | 更好的方法 |
|---|---|
| 连接保持同步的实时 Wiki 内容 | ADO Wiki 知识 |
| 上传二进制文件（PDF、Word、图像） | 通过 生成器→知识设置上传→添加文件 |
| 一次性批量导入多个文档 | 通过 Builder → 知识设置上传多个文件，→添加文件 |
| 自动使代码存储库保持最新状态 | 连接GitHub或 ADO 连接器 |
相关功能
| 能力 | 新增的内容 |
|---|---|
| ADO Wiki 知识 | 连接自动更新的实时 Wiki 内容 |
| 根本原因分析 | 调查问题并记录结果 |