教學：將知識文件上傳到 Azure SRE 代理

在這個教學中，你用兩種方法將知識文件上傳到 Azure SRE 代理的知識庫：一是請代理從調查中建立 runbook，二是透過入口網站介面上傳檔案。

您的代理人能捕捉調查中發現的知識並儲存以備未來使用，自動建立機構知識。 欲了解更多資訊，請參閱 「上傳知識文件」。

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

• 將調查轉換為結構化的執行手冊，並將其儲存至知識庫
• 透過入口網站介面手動上傳檔案
• 確認上傳的文件是否已索引且可用
• 確認代理確實能在新對話中取得已上傳的知識

預計時間：15分鐘

先決條件

開始之前，請確保您已準備以下項目：

• A Azure SRE Agent in Running state.
• 對代理設定寫入權限。
• 代理執行模式設定為 審查 或 自主。

從調查開始

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

1. 前往 sre.azure.com 選擇您的經紀人。
2. 在左側邊欄的聊天下方，找到先前的調查對話串，其中您的 Agent 曾診斷或解決某個問題，然後選取該對話串。

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

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 the knowledge base as high-memory-runbook.md

您的代理人執行以下操作：

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

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

小提示

請指定一個帶有 .md 或 .txt 副檔名的檔案名稱。 這會控制文件在知識庫中的命名方式，方便日後查找。

備註

如果你的經紀人處於 審核 模式，會在執行上傳前先徵求你的同意。 選擇 批准 以繼續。

此時，請確認以下幾點：

• Agent 已根據調查產生結構化執行手冊。
• 代理人確認文件已被保存。

在知識庫中驗證文件

請前往知識庫確認你的文件是否已被索引。

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

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

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

透過入口網站上傳檔案

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

1. 在 知識庫 頁面，選擇 新增檔案。
2. 將檔案拖入投放區，或選擇 瀏覽檔案 以選擇一個。
3. 選擇 新增檔案 來上傳。

入口網站接受以下檔案類型：

• 文字：.md，.txt，.csv，.json，.xml，.yaml，.yml，.log，.ini，.cfg，.conf，.config，.properties
• 文件：.pdf， .docx， ， .pptx.xlsx.doc.ppt.xls
• 圖片：.png， .jpg， .jpeg， .gif.bmp.webp.tiff.tif

每個檔案最大大小為 16 MB，每次上傳最多可達 100 MB。

在新的交談中測試擷取

確認客服能找到並使用上傳的文件。

1. 在側邊欄選擇 「新聊天串 」。
2. 問一個你上傳的文件應該能回答的問題。

例如：

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

您的 Agent 會搜尋知識庫、找到您上傳的執行手冊，並在回應中參考它。 這證明該知識已被索引並可檢索。

在事件發生後擷取知識

解決任何問題後，請你的代理人保留所學：

Create a runbook from the steps we just used to resolve this incident.
Include the root cause, investigation steps, and the fix.
Save it as incident-12345-resolution.md in the knowledge base.

隨著時間推移，這建立了一個可搜尋的機構知識圖書館。 每一次過去的事件都成為未來事件的資源。

更新現有文件

上傳一份與前一個檔名相同的文件以取代先前版本：

Update the high-memory-runbook.md document in the knowledge base.
Add a new section about container memory limits as a common cause.

透過 CLI 進行批次上傳

使用CLI一次匯入多份文件：

# Upload a single file
srectl doc upload --file ./runbooks/high-memory-guide.md

# Upload all .md and .txt files in a folder (recursive)
srectl doc upload --file ./runbooks

Troubleshooting

請使用以下表格解決知識文件上傳的常見問題。

錯誤	原因	修正
「代理記憶已停用」 無法上傳文件。」	你的代理程式沒有啟用知識庫。	聯絡你的管理員以啟用知識庫。
「我沒有寫入你的知識庫的權限。」	客服找不到上傳工具。	請重新表述你的請求：「將它存到知識庫，作為 filename.md」
「檔案副檔名無效。 只允許使用.md和 .txt 檔案。」	檔名不以 .md 或 .txt （聊天上傳）結尾。	當要求代理存檔時，請使用.md或.txt擴充功能。
「文件內容超過最大 16MB」	內容太大，無法用單一文件呈現。	拆分成多個較小的文件。
「檔名不能是空的」	沒有提供檔名。	在提示詞中包含一個檔名（例如， runbook.md）。

下一個步驟

學習記憶與知識

相關內容

• 上傳知識文件（功能）
• Azure DevOps wiki knowledge
• 記憶與知識