教學：在 Azure SRE Agent 中上傳知識文件

在這個教學中，你會將知識文件上傳到 Azure SRE 代理程式，讓它在未來調查時能參考這些文件。 你會學會如何透過聊天直接將調查結果儲存到知識設定，以及如何透過入口網站介面上傳現有檔案。

在本教學課程中，您將瞭解如何：

  • 將調查轉換成可重複使用的 Runbook，並儲存至 [知識設定]
  • 確認上傳的內容是否已被索引並可搜尋
  • 透過入口網站上傳個別檔案或資料夾
  • 測試你的客服人員能否在新對話中取得上傳的內容

預計時間：10分鐘

先決條件

  • 一個處於運行中狀態的Azure SRE代理
  • 代理程式的寫入權限
  • 代理執行模式設定為 審查 或 自主

步驟一：從調查開始

最優秀的知識文件來自真實調查。 與其從零開始創作內容，不如捕捉經紀人已經學到的東西。

  1. 前往 sre.azure.com 選擇您的經紀人。
  2. 在左側邊欄的 [聊天] 下方，尋找先前的調查對話串，也就是代理程式診斷或解決問題的任何對話，然後加以選取。

如果你還沒有調查主題，可以開始新的聊天室，請你的專員進行調查。

Investigate high memory usage on our container apps

等待調查完成後，再進行第二步。

步驟二：請你的經紀人製作一份跑手簿

在相同的調查對話串中，要求您的 Agent 將其發現整理成執行手冊，並儲存到「知識」設定。 要具體說明檔名。

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. 將調查情境整合成結構化的執行手冊。
  2. 產生如根本原因分析、診斷步驟、緩解措施及升級觸發點等章節。
  3. 將文件儲存到知識設定並確認上傳。

客服確認文件已被保存，並提供下載連結。 您的執行手冊現在已儲存在 Knowledge settings 中，並已建立索引以供搜尋。

Checkpoint

  • 探員從調查中產生了結構化的跑手冊。
  • 代理人確認文件已被保存。

步驟 3：在知識設定中驗證

  1. 在左側邊欄，選擇 建構器 擴展該區塊。
  2. 選擇 知識設定。

知識設定頁面會以表格顯示你的文件，並列檔案名稱、狀態、類型和最後修改。 當文件已被索引並準備搜尋時， 狀態 欄顯示 ✓ 已索引 。

如果狀態顯示 待處理，請選擇 重新整理。 索引通常會在幾秒內完成。

Checkpoint

  • 已導航至 建構者→知識設定
  • 文件顯示為 ✓ 索引 狀態

步驟四：透過入口網站上傳檔案

你可以直接上傳單一檔案或整個資料夾。 此方法適用於團隊已有的執行手冊、文件或參考資料。

上傳個別檔案

  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. 確認對話框列出要移除的文件。 請選取刪除，確認刪除。

當你刪除文件時，你會將它們從客服人員的知識設定中移除，這些文件就不再出現在搜尋結果中。

備註

你無法在原地編輯知識文件。 要更新文件，請上傳一個同檔名的新版本。 新版本取代了舊版本。

您學到的內容

  • 你的代理可以將真實的調查轉換為結構化的執行手冊，並儲存到知識設定中。
  • 你可以透過 Builder → 知識設定中的入口網站介面手動上傳檔案。 它支援多種格式，包括 PDF、Office 文件和圖片。
  • 系統會索引上傳的文件進行語意搜尋，並且這些文件會在所有未來的對話中被查閱。
  • 要更新文件，請使用相同的檔名上傳文件。

Troubleshooting

錯誤 原因 修正
「代理記憶已停用」 無法上傳文件。」 你的代理沒有啟用知識設定 聯絡你的管理員以啟用知識設定
「我沒有你的知識設置的寫入權限。」 客服找不到上傳工具 請重新說明你的要求：「將它儲存至知識庫設定中的 filename.md」
「檔案副檔名無效。 只允許使用.md和 .txt 檔案。」 檔名不以 .md 或 .txt 結尾（聊天上傳） 請在要求代理保存時使用.md或.txt擴充套件。
「文件內容超過最大 16MB」 內容過於龐大，無法容納單一文件 拆分成多個較小的文件
「檔名不能是空的」 未提供檔名 在提示中包含一個檔名（例如， runbook.md）
資源 您學到什麼
上傳知識文件 這是如何運作以及為什麼重要
創造技能 建立與知識文件相輔相成的程序性技能
技能 技能與知識如何協同運作
ADO 維基知識 將即時維基內容連結為知識來源
  • Last updated on