tennnzo說明文件

Agent

知識庫

知識庫是 Agent 寫稿前讀的定案知識，例如世界觀、角色、口氣與教訓。這頁說明條目的內容與狀態、自動定案開關、怎麼核准或退回提案、編輯與版本歷史，以及設定知識來源。

知識庫存的是 Agent 寫稿前要讀的定案知識：品牌的世界觀、角色設定、說話口氣、貼文格式、受眾、策略，以及踩過的坑。Agent 只讀「定案」的條目，所以知識庫寫得越清楚，稿子越不用一改再改。

知識庫只有內部成員看得到，客戶看不到。從側欄「Agent」底下的「知識庫」進入。側欄上的數字是等人審的草稿數。

知識庫是整個組織共用的。在某個工作區裡，會列出這個工作區各專案的條目，加上不分專案的共用條目（見 組織、工作區與導覽）。

條目裡有什麼#

每個條目包含：

  • 分類：世界觀、角色、口氣、格式、受眾、策略、做法、教訓、名詞、其他。
  • 標題：80 字內。同一個專案裡，定案條目的標題不能重複。
  • 一句話摘要：200 字內，讓 Agent 先判斷要不要讀全文。
  • 內文：可以用 # 標題、- 清單、1. 編號、**粗體**、行內程式碼與 > 引用。
  • 標籤：用逗號分隔，最多 12 個，每個 30 字內。
  • 來源：這條知識從哪來，例如某個資料夾、某份文件、某篇貼文、某次審稿。網址會變成連結。最多 20 個。
  • 專案：屬於某個專案，或「不分專案（整個工作區）」。不分專案的條目是整個組織共用的。

條目頁上方會標出版本號，以及這條知識是由人寫的、Agent 提的還是匯入的。「資訊」欄列出標籤與建立、更新、裁決的時間。

條目狀態#

狀態意思
定案Agent 會讀的正式知識
待審Agent 提的草稿，等人核准
已退回被人退回的提案，Agent 會讀退回原因並修正
已退役不再使用的條目，Agent 不會再讀

知識庫首頁用分頁切換這四種狀態，預設是「定案」。

搜尋與篩選#

  • 「搜尋」：輸入框寫著「搜尋標題、摘要、內文」。
  • 「專案」：「全部專案」、某個專案，或「不分專案」。
  • 「分類」：「全部分類」或某一類。

選好後按「篩選」；按「清除篩選」回到全部。

自動定案#

頁面上方的「自動定案」開關決定 Agent 提的知識怎麼處理：

  • 開：Agent 寫進來的知識直接定案。舊版留在歷史，你可以隨時編輯或退役。
  • 關：Agent 提的知識先進「待審」，人核准才定案。

如果還有待審的草稿，打開開關時會先問你：「打開後，目前 N 份待審草稿會直接定案。確定要打開嗎？」

開關打開而且沒有待審草稿時，「待審」分頁會隱藏起來。

提示 品牌剛起步、設定還在變的時候，建議關掉自動定案，每條都自己看過再核准。

核准、退回與退役#

打開一個「待審」條目，會看到：

  • 「核准」：可以寫備註（選填）。核准後成為定案，Agent 下次讀就會用到。
  • 「退回」：一定要寫「退回原因（必填，Agent 會讀到並據此修正）」。

打開一個「定案」條目，可以按「退役」，並寫「退役原因（必填）」。退役後 Agent 就不會再讀這條。

原因最多 1000 字。條目頁會顯示「Agent 說明」（Agent 提案時附的說明）和「裁決說明」。「已退回」和「已退役」的條目不能再操作。

修改提案#

Agent 發現某條定案知識需要更新時，會提一份修改草稿，而不是直接改原條目：

  • 在原條目上方會看到「有一份修改提案等審：」，點了打開那份草稿。
  • 草稿頁上方寫著「這份草稿提議修改定案條目」，並有「和目前定案比較」，左右並排顯示「目前定案（vN）」與「提案」。標題有改時會寫出前後差別。
  • 核准修改草稿後，內容會併回原條目，成為新版本，你會被帶到原條目。

原條目已經不存在時，草稿會寫「原本要修改的條目已不存在」。

新增與編輯條目#

  1. 在知識庫首頁按「新增條目」。
  2. 選「分類」，填「標題（80 字內）」。
  3. 選「專案」。
  4. 填「一句話摘要（200 字內）」和「內文」。
  5. 需要的話填「標籤」。
  6. 在「來源」選類型，填「路徑／網址／編號」與「名稱（選填）」。要多個來源就按「加一個來源」。
  7. 按「儲存」。

人寫的條目存下就是定案，Agent 下次讀就會用到。

編輯時：

  • 編輯「定案」條目，存下後直接成為新版本，舊內容留在「歷史版本」。
  • 編輯「待審」草稿，存下後仍是草稿，要另外按「核准」才會給 Agent 讀。

歷史版本#

每個條目都有版本號，例如 v3。定案條目頁下方的「歷史版本」列出每一個被取代的舊版，以及被取代的日期。還沒改過的條目顯示「還沒有被改過。」

知識來源#

如果你的品牌資料已經放在雲端資料夾、筆記軟體或文件庫裡，可以設定「知識來源」，讓 Agent 定期去讀新的變更，煉成條目寫進知識庫。

從知識庫首頁右上的「知識來源」進入。

重要 讀取用的是 Agent 自己本來就有的連線。tennnzo 不保管任何帳號密碼，設定時也不要貼帳密或分享金鑰。

新增知識來源#

  1. 按「新增來源」。
  2. 選「類型」：Google Drive、Notion、Obsidian 或其他。
  3. 填「名稱（80 字內）」。
  4. 填「位置（500 字內）」，例如資料夾連結、頁面連結或資料夾路徑。
  5. 選「專案」。
  6. 選「負責同步的 Agent」，或交給任一 Agent。
  7. 填「同步頻率」，1 到 720 小時一次。
  8. 需要的話填「收錄範圍（選填）」，寫清楚要收哪些、不收哪些，例如「只收角色與主題系列；不收客戶個資、價格」。
  9. 確認「啟用」有勾，按「儲存」。

關掉「啟用」後，Agent 不會再同步這個來源，過去的同步紀錄與條目都留著。按「刪除來源」會一併刪掉同步紀錄，但已寫進知識庫的條目會留著。

看同步狀況#

每個來源一張卡，顯示類型、名稱、負責的 Agent、「每 N 小時」，以及「上次同步」的時間。暫停的來源會標「已暫停」，還沒同步過的寫「還沒同步過。」

「最近 N 次同步」列出每次的結果：

  • 狀態：「成功」「部分完成」或「失敗」。
  • 數量：「新增」「修改」「未變」「略過」各幾條。

同步寫進來的條目，一樣依「自動定案」的設定決定直接定案或先進待審。

Agent 端怎麼讀知識庫與提案，請看 知識庫 API。