---
{
  "id": "platform.expert.knowledge-management",
  "topic": "expert",
  "title": "Expert 知識來源管理",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "創作者自己的 Expert 知識庫支援文字與 File Center source、不可變 replacement version、有界 indexing，以及需確認的刪除與整庫重建。",
  "content": "七個管理操作是 `list_knowledge`、`add_knowledge`、`upload_knowledge`、`replace_knowledge`、`delete_knowledge`、`reindex_knowledge` 與 `rebuild_knowledge`。每個操作都驗證 Action owner 確實擁有該 Expert，且一律不可在 public surface 執行。`list_knowledge` 回傳 source metadata；Action 會刻意省略 Web editor 的 legacy compatibility chunk projection。\n\n`add_knowledge` 接受 1–50,000 個文字字元。`upload_knowledge` 只收 File Center `fileId`，絕不收 inline bytes，因此 Action arguments 保持在 64 KiB 內。支援 UTF-8 `.txt`／`.md` 與有效 PDF；檔案上限 10 MiB，抽取後文字上限 100,000 字元。Shared-workspace 檔案還必須有 executing Agent 的明示 read grant。格式不支援、不可存取、內容與格式不符或超限時，都會在建立 source 前失敗。\n\n新增與替換內容都會做 safety scan。通過的內容會切 chunk，並透過 LlmGateway 產生 embedding；provider 不可用時，add 可依 canonical service policy 儲存 degraded source。Replace 會建立新的 immutable source version。`reindex_knowledge` 只重建單一 source index。`delete_knowledge` 與整庫 `rebuild_knowledge` 使用 UserConfirm + Strict，因為它們會移除或 bulk rewrite runtime knowledge。只有 Action result 回報實際 scan 與 index state 後，才可宣稱成功。\n",
  "aliases": [
    "Expert 知識庫",
    "Expert source",
    "上傳 Expert PDF",
    "重新索引 Expert",
    "重建 Expert 知識",
    "File Center Expert 知識"
  ],
  "tags": [
    "expert",
    "knowledge",
    "file-center",
    "embeddings",
    "safety"
  ],
  "relatedActions": [
    "arinova.expert.list_knowledge",
    "arinova.expert.add_knowledge",
    "arinova.expert.upload_knowledge",
    "arinova.expert.replace_knowledge",
    "arinova.expert.delete_knowledge",
    "arinova.expert.reindex_knowledge",
    "arinova.expert.rebuild_knowledge"
  ],
  "relatedActionPrefixes": [
    "arinova.expert."
  ],
  "url": "https://docs.arinova.ai/zh-tw/kb/expert/knowledge-management/"
}
---

七個管理操作是 `list_knowledge`、`add_knowledge`、`upload_knowledge`、`replace_knowledge`、`delete_knowledge`、`reindex_knowledge` 與 `rebuild_knowledge`。每個操作都驗證 Action owner 確實擁有該 Expert，且一律不可在 public surface 執行。`list_knowledge` 回傳 source metadata；Action 會刻意省略 Web editor 的 legacy compatibility chunk projection。

`add_knowledge` 接受 1–50,000 個文字字元。`upload_knowledge` 只收 File Center `fileId`，絕不收 inline bytes，因此 Action arguments 保持在 64 KiB 內。支援 UTF-8 `.txt`／`.md` 與有效 PDF；檔案上限 10 MiB，抽取後文字上限 100,000 字元。Shared-workspace 檔案還必須有 executing Agent 的明示 read grant。格式不支援、不可存取、內容與格式不符或超限時，都會在建立 source 前失敗。

新增與替換內容都會做 safety scan。通過的內容會切 chunk，並透過 LlmGateway 產生 embedding；provider 不可用時，add 可依 canonical service policy 儲存 degraded source。Replace 會建立新的 immutable source version。`reindex_knowledge` 只重建單一 source index。`delete_knowledge` 與整庫 `rebuild_knowledge` 使用 UserConfirm + Strict，因為它們會移除或 bulk rewrite runtime knowledge。只有 Action result 回報實際 scan 與 index state 後，才可宣稱成功。