您的客服人員會在對話中直接上傳執行手冊、故障排除指南及文件至知識庫，捕捉機構知識。 當您的客服人員發現解決方案或解決事件時，會產生結構化文件並索引語意搜尋，讓未來的調查都能受益於過去的解決方案。
小提示
你的代理程式會在對話中自動建立並上傳運行簿，無需手動管理檔案。 系統會索引文件進行語意搜尋，讓所有未來調查都能取得。 事件解決自動成為組織知識。
你的代理人如何捕捉知識
您的客服人員可在對話中使用 「上傳知識文件 」工具將文件上傳至知識庫。 當你的客服發現解決方法、製作故障排除指南或綜合調查結果時，會直接儲存這些資訊，並讓未來每次通話都能搜尋。
Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to the knowledge base.
你的代理程式會產生結構化的運作手冊，並在幾秒內上傳。 該文件會自動被索引，並可搜尋以供未來調查使用。
前後比較
下表比較了使用 上傳知識文件 工具前後的知識擷取工作流程。
| 適用範圍 | 之前 | 之後 |
|---|---|---|
| 知識擷取 | 事件後：工程師可能會撰寫操作手冊。 | 你的代理人會即時捕捉修正過程 |
| 是時候記錄下來了 | 花了30到60分鐘寫一本運維手冊 | 秒數：您的 Agent 會產生並上傳內嵌內容 |
| 知識新鮮度 | 操作手冊幾週內就會失效 | 知識庫隨著每次解決方案而不斷成長。 |
| 無障礙設施 | 知識卡在工程師腦中或對話串裡 | 你的經紀人可在所有未來對話中搜尋 |
| 格式一致性 | 因作者而異 | 每次都有結構化且一致的文件 |
這點有什麼不同
與手動上傳不同，您的代理人會主動創造知識。 你不需要記得記錄你學到的東西。 你的經紀人會在對話中做這件事。
與聊天歷史不同，上傳的文件會被索引用於語意搜尋。 數個月後，當類似問題再次發生時，您的 Agent 會透過智慧擷取，自動找到相關的執行手冊，而不是靠捲動舊對話串。
與維基連接器不同，上傳的文件不需要外部服務。 這些知識直接儲存在你的客服人員知識庫中，能即時取得，沒有同步延遲。
運作方式
上傳知識文件工具接受三個參數。
| 參數 | Required | 說明 |
|---|---|---|
| 檔案名稱 | 是的 | 名稱需使用 .md 或 .txt 副檔名 (例如，database-pool-runbook.md) |
| Content | 是的 | 完整文件文字（Markdown或純文字格式） |
| 啟動索引 | 可選（預設： true） |
是否要立即讓文件可搜尋 |
當你的經紀人上傳文件時：
- 代理程式會驗證檔名和內容（每個檔案最多 16 MB）。
- 代理人會將文件儲存在你的代理人的知識庫中。
- 代理人會索引內容以進行語意搜尋。
- 客服人員會以成功訊息確認上傳。
備註
如果已有同檔名的文件存在，新內容會取代它。 使用相同名稱上傳以更新內容。
支援的檔案格式
這個上載知識文件的工具支援由您的代理程序內嵌產生的基於文字的格式。
| 格式 | 擴充功能 | 最適合用於 |
|---|---|---|
| Markdown | .md |
執行手冊與包含格式和標題的故障排除指南 |
| 純文字 | .txt |
簡單的筆記、日誌、原始文件 |
備註
當你透過 API 或 CLI 上傳檔案時，可以使用更多文字格式，包括 CSV、JSON、YAML 和日誌檔案。 上傳 API 支援二進位格式（PDF、Word、Excel、PowerPoint）及圖片。 客戶代理工具專注於 .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 the knowledge base.
您的代理人會產生一份結構化的故障排除指南，內容包括：
- 界定範圍的步驟：如何辨識問題
- 快速緩解措施：立即採取行動以減少影響
- 根本原因分析：調查重點
- 解決步驟：有效的解決方法
- 預防：如何避免復發
下一次類似的 CPU 問題發生時，您的代理會在調查時自動參考此文件，將一位工程師的經驗轉化為團隊共享的知識。
先決條件
在使用上傳知識文件工具之前，請確保你符合以下要求。
| 需求 | 詳細資料 |
|---|---|
| 代理程式版本 | 26.1.57.0 或更新版本 |
| 知識庫 | 已在您的代理程式上啟用 |
| 寫入權限 | 你的代理需要寫入知識庫的權限 |
| 執行模式 | 審核或自主（撰寫動作需在審核模式下核准） |
限制
以下限制適用於已上傳的知識文件。
| Limit | 價值 |
|---|---|
| 檔案大小上限 | 每份文件 16 MB |
| 支援的擴充功能 |
.md 與 .txt |
| 檔名字元 | 字母、數字、連字號、底線、點（無 /、 \、 ?、 #） |
| 最大檔名長度 | 1,024 個字元 |
使用其他專案時的時機
下表描述了不同方法較為合適的情境。
| 案例 | 更好的方法 |
|---|---|
| 連線到可保持同步的即時 Wiki 內容 | Azure DevOps wiki knowledge |
| 上傳二進位檔案（PDF、Word、圖片） | 透過 Builder > 知識庫 > 手動上傳 新增檔案 |
| 一次大量匯入多份文件 | 使用 srectl doc upload --file <path> CLI 指令 |