你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
代理自带 Azure 的可观测性功能,但每个团队都有其独特的上下文:运行手册、架构文档、内部 Wiki 页面和代码存储库。 通过使用知识库,可以在一个位置管理所有这些知识库,以便代理可以在调查期间引用它们。
小窍门
关键要点
- 建设者 > 知识库 是管理所有知识源(包括文件、网页和存储库)的中心位置。
- 上传 Runbook 和文档、按 URL 添加网页或连接源代码存储库。
- 您的代理在调查过程中会自动利用索引知识。
- 代理拥有的相关知识越多,其响应就会越快越准确。
为什么知识很重要
您的代理通过 Azure 的可观测性和集成工具,开箱即用。 但每个团队都有独特的上下文:Runbook、体系结构文档、内部 Wiki 和代码存储库,其中包含快速解决事件所需的机构知识。
当代理有权访问此知识时,它可以:
- 在事件期间引用团队的 Runbook,而不是从头开始。
- 将生产问题与存储库中的特定代码更改相关联。
- 应用团队已记录的故障排除步骤。
知识库
使用门户中的 知识库 页(生成器>知识库)管理代理的知识。 可以上传文件、添加网页和查看连接的存储库。
下表描述了三种类型的知识源。
| 源类型 | 它提供的内容 | 如何添加 |
|---|---|---|
| 文件 | 运行手册、故障排除指南、架构文档、配置参考 | 通过门户上传、拖放,或者让代理在对话期间创建它们 |
| 网页 | 外部文档、状态页、内部 Wiki URL | 按 URL 添加。 代理对给定 URL 的内容编制索引。 |
| 存储库 | 根本原因分析、部署配置、基础结构即代码的源代码 | 连接 GitHub 或 Azure Repos |
每个条目显示其名称、索引状态(索引、挂起或未编制索引)、类型和上次修改日期。
上传文档
代理可以在对话期间创建和上传知识。 要求它从您解决的问题中保存一个运行手册,并自动存储文档。 还可以直接通过门户上传文件。
有关支持的文件格式和大小限制,请参阅 “上传知识文档:支持的文件格式”。 有关文件类型、限制和代理生成的文档的完整详细信息,请参阅 “上传知识文档”。
在聊天中共享文件
可以使用拖放、从剪贴板粘贴或 + 按钮在聊天线程中直接附加文件。 线程存储聊天附件,并为代理提供即时上下文进行分析。
小窍门
想要永久保留文件?
在聊天中附加文件后,请让代理: “将此保存到知识设置。 代理从线程中读取文件,并将副本上传到知识库,使其在所有将来的对话中进行索引和搜索。 原始文件也保留在线程中。
下表比较了在聊天中上传知识文档和共享文件。
| 上传知识 | 在聊天中共享文件 | |
|---|---|---|
| Where | 创建 > 知识库,或在聊天中提问 | 聊天消息输入(+、拖放、粘贴) |
| 存储 | 代理级别:已编制索引,可跨所有线程进行搜索 | 线程级别:该会话中可用 |
| 最适用于 | Runbook、体系结构文档、希望代理在每个将来的对话中引用的过程 | 现在需要分析的屏幕截图、日志、配置文件 |
| 提升到知识 | 已经在那里 | 询问代理:“将此内容保存到知识库设置”,从而将内容复制到代理级存储。 |
| 格式 | 28 种类型,包括文档、数据、图像 | 31 种类型,包括代码、脚本、基础结构、Web |
| 大小限制 | 每个文件 16 MB,每个上传 100 MB | 每个文件 10 MB,总计 50 MB,5 个文件 |
连接源代码
连接 GitHub 或 Azure DevOps 存储库,以便代理可以读取代码、搜索错误,并将部署与事件相关联。 知识库显示具有克隆和索引状态的存储库。
- 若要连接 GitHub 存储库,请参阅 Connect 源代码。
- 若要连接 Azure DevOps 存储库,请参阅 设置 Azure DevOps 连接器。