團隊解決的每一個事件都會產生寶貴的知識：問題出在哪裡、哪些指令解決了問題，以及下次該先檢查哪些事項。 但這些知識散落在聊天對話串、工程師記憶，以及凌晨 3 點沒人會讀的事後檢討中。
你的團隊有操作手冊，但這些手冊會過時。 昨晚事件中發現的解決方案？ 它可能存在某個人的腦海中，或埋藏在一段對話中，下週就會消失在畫面中。 下一次同樣問題發生時，工程師會從頭開始。
你的經紀人如何解決這個問題
您的客服人員可在對話時使用 「上傳知識文件 」工具，將文件上傳到知識設定。 當你的客服人員發現解決方法、製作故障排除指南，或綜合調查結果時，會直接儲存這些資訊。 這種方式讓未來每次對話都能搜尋到相關資訊。
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分鐘 | 秒。 你的經紀人會即時生成並上傳。 |
| 知識新鮮度 | 操作手冊幾週內就會失效 | Knowledge settings 會隨著每次解決方法持續成長 |
| 無障礙設施 | 知識卡在工程師腦中或對話串裡 | 你的經紀人可在所有未來對話中搜尋 |
| 格式一致性 | 因作者而異 | 每次都有結構化且一致的文件 |
這點有什麼不同
與手動上傳不同，您的代理人會主動創造知識。 你不需要記得記錄你學到的東西，因為你的經紀人會把這些當作對話的一部分。
與聊天歷史不同，上傳的文件會被索引用於語意搜尋。 數個月後，當類似問題再次發生時，您的 Agent 會透過智慧擷取，自動找到相關的執行手冊，而不是靠捲動舊對話串。
與維基連接器不同，上傳的文件不需要外部服務。 這些知識直接存在於你客服人員的知識設定中，立即可用且不會有同步延遲。
運作方式
上傳知識文件工具接受三個參數：
| 參數 | Required | 說明 |
|---|---|---|
| 檔案名稱 | 是的 | 名稱需使用 .md 或 .txt 副檔名 (例如，database-pool-runbook.md) |
| Content | 是的 | 完整文件文字（Markdown或純文字格式） |
| 啟動索引 | 可選（預設： true） |
是否要立即讓文件可搜尋 |
當你的經紀人上傳文件時：
- 驗證 檔名與內容（每個檔案最高可達 16 MB）。
- 將文件儲存 在你代理人的知識設定中。
- 將內容索引 以進行語意搜尋。
- 會以成功訊息確認上傳。
備註
如果已有相同檔名的文件存在，則新內容會取代它。 這個流程讓你的代理人更容易更新知識。 使用相同名稱上傳文件以刷新內容。
支援的檔案格式
您的代理人透過三種方式處理檔案，每種方式都支援不同格式。
聊天附件
將檔案拖入任何聊天室，讓你的客服人員即時獲得分析所需的資訊——故障排除腳本、設定檔、網路追蹤等。
| 類別 | 擴充功能 |
|---|---|
| Images |
.png、.jpg、.jpeg、.gif、.webp、.svg |
| Documents |
.txt、.md、.pdf、.docx、.pptx、.xlsx |
| 資料與配置 |
.json、.csv、.log、.yaml、.yml、.xml、.ini、.conf、.env |
| 網站與網路 |
.html、.har |
| 程式碼與腳本 |
.ts、.js、.py、.sh、.sql、.kql |
| 基礎設施 |
.bicep、.tf |
限制： 每個檔案 10 MB ·每則訊息總共 50 MB ·每則訊息可包含5個檔案
知識設定上傳
若要持續保存文件，供代理人未來對話參考，請透過 建構器上傳檔案→知識設定→新增檔案。 系統會索引上傳的檔案以進行語意搜尋。
| 類別 | 擴充功能 |
|---|---|
| Images |
.png、.jpg、.jpeg、.gif、.webp、.bmp、.tiff、.tif |
| Documents |
.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）。 聊天附件支援程式碼、腳本、基礎設施和網頁格式，這些是知識設定無法提供的。
代理人產生的文件
當你的客服人員在對話中（使用 「上傳知識文件 」工具）建立文件時，會產生 .md 檔案 .txt 並直接儲存到知識設定中。 這個過程會發生在你請代理人「將此存為運行手冊」時。
範例：捕捉事件知識
在事件調查過程中，請詢問您的代理人：
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 維基知識 |
| 上傳二進位檔案（PDF、Word、圖片） | 透過 Builder 上傳 →知識設定 →新增檔案 |
| 一次大量匯入多份文件 | 透過 Builder 上傳多個檔案 →知識設定→新增檔案 |
| 自動保持程式碼庫的最新狀態 | 連接 GitHub 或 ADO 連接器 |
相關功能
| 能力 | 它增加了什麼 |
|---|---|
| ADO 維基知識 | 連結自動更新的即時維基內容 |
| 根本原因分析 | 調查問題並記錄發現 |