在 Azure SRE 代理中連結知識

當 Azure SRE 代理能使用團隊用來排除系統故障的相同情境時,效果會更好。 連結運行手冊、文件、網頁和資料庫,讓你的業務員在調查時能參考,而不必從零開始。

小提示

  • 使用 Builder > 知識庫 將檔案、網頁和資料庫集中管理。
  • 索引知識在調查和聊天期間會自動可用。
  • 你可以直接上傳文件、在聊天中附加檔案,或連接資料庫以進行來源感知分析。
  • 最有用的知識來源是團隊已經依賴的,例如跑手冊、架構筆記、故障排除指南和原始碼。

為什麼知識很重要

你的代理程式已可透過可觀察性工具和已連線的系統,取得內建的 Azure 內容。 它在預設情況下並不具備你團隊的內部知識。 該知識包括說明共同復原步驟的 Runbook、識別共用相依的架構說明,或是揭示哪個部署引入迴歸的存放庫。

當你連結這些資訊時,你的經紀人可以:

  • 在事件發生時查閱團隊操作手冊。
  • 重複使用團隊已記錄的故障排除步驟。
  • 將症狀與原始碼及部署情境相關聯。
  • 回答問題時,請使用與人類相同的文件和參考資料。

管理知識庫中的知識

使用 Builder > Knowledge base 來管理你經紀人的知識來源。

該頁面會列出每個來源及其:

  • Name
  • 現況
  • Type
  • 最後修改 日期

有三種來源類型可供選擇:

來源類型 它所提供的是什麼 如何新增
Files 運行手冊、故障排除指南、架構文件與參考資料 透過入口網站上傳,或在聊天時請客服存檔
網頁 外部文件、內部維基網址與狀態頁面 新增頁面網址,讓客服能索引內容
存儲庫 原始碼、部署檔案與基礎設施定義 連線至 GitHub 或 Azure DevOps 存放庫

檢查索引狀態與新鮮度

每個知識來源顯示以下其中一種狀態:

狀態 Meaning
已建立索引 內容經過處理並可搜尋
擱置 內容仍在處理中
未被索引 處理失敗或來源無法被索引

當來源已建立索引後,將滑鼠懸停在狀態指示器上方,即可查看 建立時間 時間戳記。 這個時間戳記在你想確認執行簿或文件的最新版本是否被處理時非常有用。

上傳文件

當你希望未來對話中資訊能保持可用時,先上傳文件。

典型範例包括:

  • 事件操作手冊
  • 升級指南
  • 建築參考
  • 疑難排解核對清單

你可以透過入口網站上傳檔案,或請客服將對話內容儲存到知識庫。

關於支援的檔案格式與限制,請參見 「上傳知識文件」。

完整工作流程請參閱 「上傳知識文件」。

在聊天中分享檔案

當你想在一次對話中立即提供客服人員的上下文時,可以使用聊天附件。 此方法對於截圖、日誌、設定檔及其他有助於主動故障排除的資料非常有用。

小提示

如果你在聊天中附加的檔案應成為長期知識,請要求代理程式將其儲存到「知識」設定中。 客服人員可以上傳副本,讓內容被索引並在後續對話中搜尋。

下表比較了長期知識上傳與臨時聊天附件:

劇本 上傳至知識庫 分享到聊天室
適用對象 你希望在未來對話中可供使用的操作手冊、流程和文件 你現在就要讓經紀人分析的檔案
儲存範圍 代理人層級,且可在未來的對話中搜尋 執行緒層級且可於當前交談中使用
如何添加 在入口網站上傳或請客服存檔 拖放、從剪貼簿貼上,或在聊天中使用+
可以成為長期的知識 已經具備長期知識 是的,如果你要求代理程式儲存它

欲了解更多資訊,請參閱 聊天中分享檔案

新增網頁

當重要的指引不在上傳的檔案或資料庫中時,請新增網頁。

好的候選者包括:

  • 內部維基條目
  • 公開產品文件
  • 服務狀態頁面
  • 團隊維護的參考頁面

在你新增網址後,代理人會索引該頁面內容,以便在未來調查時能參考該資訊。

連接資料庫

當您的代理程式需要可感知原始碼的內容脈絡時,請連線至 GitHub 或 Azure DevOps 存放庫。

連結的儲存庫協助代理人:

  • 搜尋原始碼中的錯誤模式
  • 將事件與近期代碼變更相關聯
  • 參考部署與設定檔案
  • 在根本原因分析時使用資料庫內容

要連接原始碼,請參見 「連接原始碼」。

選擇正確的知識來源

使用與你需要上下文相符的來源類型:

如果你需要連線...... 請使用...
以檔案形式儲存的操作手冊或故障排除指南 上傳知識文件
一個正在進行的調查截圖、日誌或檔案 在聊天中分享檔案
GitHub 或 Azure DevOps 存放庫 連接原始碼
外部系統如 Datadog 或 Splunk MCP 連接器