文件管理：標籤及元資料
知識庫文件管理：用標籤分類文件與 FAQ、用元資料控制檢索範圍與參考資料權限，以及與標籤過濾、查詢元資料的關係。
由於知識庫中可能有大量的文件或 FAQ 需要管理，MaiAgent 提供標籤管理、元資料管理功能，讓您能夠分類、整理大量的文件及 FAQ。
標籤管理
當您的知識庫包含大量資料時，標籤系統能幫助您快速整理文件、FAQ 屬性，或用於控制參考資料權限。例如：
產品資料知識庫 (依照產品資訊分類)
|-- #帳篷
|-- #4人帳
|-- #三季帳
|-- #SnowPeak教學內容知識庫 (依照權限等級分類)
|-- #非會員
|-- #一般會員
|-- #VIP新增標籤
點擊新增按鈕
輸入標籤名稱
按下新增後，剛剛輸入的標籤就會顯示如下，包含 ID、名稱等
為文件加入標籤
標籤新增完畢後，接著進入文件頁面
點擊編輯檔案資訊
選擇標籤
依照文件需求不同，加上對應標籤 (您可以選擇多個標籤)
如此一來，加入的標籤就會顯示在對應的文件後：
為 FAQ 新增標籤
若您希望能為 FAQ 增加層級分類或標籤管理，您可以：
進入知識庫內的 FAQ 管理介面，選擇要編輯的 FAQ 後，點擊編輯按鈕
選擇要加入的標籤，加入後按下「確定」
加入後的標籤就會出現在 FAQ 欄位中
標籤權限存取控制
您可依照標籤的不同，控制不同用戶看到不同內容，如 VIP 客戶能看到更進階的產品教學示範，非會員只能看到通用教學示範等。
若希望某個 Agent 在所有對話平台都預設只參考特定標籤的檔案，不用逐次呼叫帶參數，請改在 Agent 設定頁設定，詳見 知識庫標籤過濾。
標籤過濾的條件分成「組內」與「組間」兩層，介面上以白話呈現：同一組標籤之間選「包含所有標籤（AND）」或「包含任一標籤（OR）」，多組條件之間選「每一組都要符合（AND）」或「符合任一組即可（OR）」。舊版介面顯示為 AND／OR 按鈕，意思相同。以下用兩個例子說明。
包含所有標籤（AND）
「包含所有標籤（AND）」只開放同時符合這一組每個標籤的內容。
例如：此對話是和非會員的教學相關對話，就可以使用標籤篩選，只開放同時符合「非會員」及「教學」標籤的文件讓 Agent 使用。
如圖：篩選後 Agent 僅能使用初級露營的文件，避免透露不相關的訊息給非會員對話使用。
包含任一標籤（OR）
若是和會員的對話，則可以改用「包含任一標籤（OR）」，讓符合一般會員或非會員的文件都能讓 Agent 參考使用：
會員就能看見比非會員多的文件內容，達到權限分級。
篩選結果請參考：與 Agent 對話（Agent 市集）
文件元資料管理
什麼是元資料？
元資料就像是文件的「身分證」，記錄文件的詳細資訊，幫助系統更好地管理和使用這些文件。
如：初級露營.pdf
為什麼要使用元資料？
在資料龐雜的情況下，使用元資料能協助您更方便、迅速地維護資料品質，協助您：
提升管理效率
快速識別文件狀態和版本資訊
批量管理大量文件時更有條理
減少人工查找和確認的時間
確保內容品質
使用最新文件版本
追蹤文件更新歷史和版本狀態
確保 Agent 使用最新且已審核的內容
記錄下次檢核日期，定期篩出該複查的文件
文件沒有到期日，元資料也不會自動提醒
知識庫文件沒有「有效期限」欄位：文件上傳後會一直被檢索，直到您刪除或更新它。「下次檢核」這類元資料只是您自己記錄的值，平台不會依它寄送提醒、通知管理員、自動加標籤，也不會在日期到了之後停止檢索這份文件。要做定期複查，請自行排程：
在 元資料管理 建立
next_review這類日期欄位，並為文件填值（新上傳的文件可用預設值自動帶入）。複查時用 批量管理元資料 下載整個知識庫的元資料 Excel，依該欄位排序或篩選，找出已到期的文件。
對到期的文件更新內容或刪除，再把新的檢核日期填回去上傳。
另一個做法是把「版本狀態」做成標籤（例如 已審核、待複查），並用 知識庫標籤過濾 讓 Agent 只參考已審核的文件；複查中的文件改掛 待複查 標籤，就不會被檢索到。
元資料管理頁：欄位、預設值與檢索時使用
元資料欄位要先在知識庫設定頁左側的 「元資料管理」 定義，之後才能在各文件與 FAQ 填值。頁面上方的說明寫明用途：「元資料欄位可以為文件提供額外的結構化資訊，幫助更好地組織和檢索內容。設定全域預設值後，新上傳的文件將自動套用這些預設。」清單欄位：
欄位名稱
元資料的 key，例如 url、version
類型
預設＝系統內建欄位；自定＝您用 「新增自定欄位」 建立的欄位
欄位描述
給管理者看的用途說明
預設值
新上傳的文件自動套用的值；未設定顯示「(無)」
檢索設定
打勾代表已開啟 「檢索時使用」
操作
編輯、刪除（需有知識庫編輯／刪除權限）
按 「新增自定欄位」 或 「編輯」 時要填：
欄位名稱：只能以字母開頭，包含字母、數字和底線，不超過 50 個字元。
欄位描述：選填，不超過 200 個字元，例如「引用文件跳轉連結」。
預設值：選填。畫面提示「設定全域預設值，新上傳的文件將自動套用此預設」；已上傳的文件不會回填，要補值請用批量管理元資料。
檢索時使用：開啟後，畫面說明是「檢索時將此資訊送給 LLM 作為回答判斷及參考」——也就是檢索到某個片段時，會把這份文件的這個元資料值一併交給 Agent。適合「文件版本」「適用地區」「生效日期」這類會影響答案的資訊；只用來做自訂連結映射的
url這類欄位不必開，可以省 token。
編輯欄位會影響所有已使用此欄位的文件；刪除欄位後，所有文件中此欄位的資料都會被移除，無法復原。
為文件新增元資料
進入文件頁面，點擊編輯文件資訊：
切換至元資料分頁並輸入元資料對應
MaiAgent 採用 key-value 對應存取元資料
輸入後點擊「新增元資料」鍵，加入剛剛輸入的鍵值對應關係(可以一次加入多個元資料)。
新增完成後就能看見剛剛加入的元資料出現在欄位中。
為 FAQ 新增元資料
進入知識庫內的 FAQ 管理介面，選擇要編輯的 FAQ 後，點擊編輯按鈕
切換至元資料頁面，輸入後點按新增元資料
全數輸入完畢後按下「確定」
新增的元資料就會出現在 FAQ 列表中
自訂連結映射
url 在元資料系統中為保留字，如設定 url: https://...您指定的網址 ，則您設定的 url 網址就會在對話中檢視引用片段時覆蓋原有的檔案位置，改為開啟您指定的網址。
範例情境：品牌春季促銷活動
原始設定：
使用效果： 當用戶在對話中問到「春季促銷活動有什麼優惠？」時：
AI 會引用這個知識片段回答問題
用戶點擊引用來源時，不會開啟內部檔案位置
而是直接跳轉到
https://www.yourstore.com/spring-sale-2025官網活動頁面用戶可以立即看到最新的活動詳情、購買按鈕、倒數計時等動態內容
實用場景：
網站公告：
url: https://www.company.com/announcements/system-maintenance產品規格頁：
url: https://www.product.com/specs/model-x1客服政策：
url: https://support.company.com/return-policy活動報名：
url: https://events.company.com/register/webinar-2025
這樣設定的好處是讓 AI 回答更具實用性 —— 不只提供資訊，還能引導用戶直接前往相關頁面採取行動，提升用戶體驗和轉換率。
未設定 url 前
如下，未設定 url 值前點按引用節點，點按任何一個節點(如：初級露營.pdf)就能夠查看原始文件 (您可以在對話平台中設定是否要讓使用者下載原始文件檔案)：
設定 url 後 (以 Google 為示範)
再次點按引用的節點檔案 (露營注意事項.txt)，就不會顯示文件預覽，而是覆蓋成開啟 Google 首頁：
當您在元資料中設定 url 欄位後，使用者在對話中看到 Agent 引用該文件時，可以直接點擊跳轉至您設定的連結，獲得更完整的資訊
最後更新於
這有幫助嗎？