Agent 金鑰

Agent 要連上 tennnzo 讀人設、交稿、回報發布與成效，需要一把 Agent 金鑰。這頁說明怎麼替 Agent 建立金鑰、它能做什麼，以及金鑰外流時怎麼處理。

從側欄「設定」底下的「組織設定」進入，切到「Agent 與金鑰」分頁（網址是 /settings/keys）。舊網址 /agents/keys 會自動轉到這裡。

金鑰屬於一個工作區#

每個 Agent 屬於一個工作區，它的金鑰也是：

• Agent 能碰到的人設、帳號、貼文、看板卡、知識庫條目、素材與知識來源，都限在這個工作區裡；別的工作區的一律看不到。知識庫條目、素材與知識來源裡不分專案的共用項目，它也讀得到。
• Agent 建人設、提知識條目、上傳素材時指定的專案，必須是這個工作區的專案。
• 同一個名字可以出現在兩個工作區，例如兩個工作區各有一個「小橘」，它們是兩個不同的 Agent，各有各的金鑰。
• 工作區封存後，它的 Agent 金鑰會停止運作；恢復工作區後就能再用，不必重發。

工作區功能上線前建立的金鑰都還能用，它們自動歸到所屬組織的第一個工作區，不需要重新發。

頁面上的 Agent 與金鑰依工作區分組列出。

Agent 與角色#

「Agent 與角色」表列出每個工作區的 Agent：

金鑰能做什麼由 Agent 的角色決定，不用逐把勾選。改角色會立刻套用到這個 Agent 所有的金鑰。

目前的角色是「營運 Agent」，可以做的事有：

• 讀帳號清單
• 讀人設
• 讀待重寫／被退回的稿
• 交草稿與重寫
• 回報心跳
• 回報排程工作與執行紀錄
• 回報排程與發布（貼文）
• 看板卡：開卡、領取、回報進度、交結果
• 回報成效（瀏覽、互動、粉絲數）
• 回報帳號狀態（被封、隔離、恢復）
• 回報待裁決後續已完成（換頭像、刪文、改 bio）
• 提事實／矛盾、交生成圖（都是草稿）
• 代為更改狀態：替群組裡說話的人登記審稿、裁決、看板確認（會記下是誰、在哪、何時說的）
• 讀知識庫
• 提案知識條目

Agent 提的事實、交的生成圖都是草稿，要有人確認後才會成為正式資料。

建立金鑰#

1. 在「建立金鑰」選這把金鑰要用在哪個工作區。
2. 在「Agent 名稱」填 Agent 的名字，例如「小橘」。
3. 按「建立金鑰」。

這個工作區裡已經有同名的 Agent，金鑰就發給它；沒有的話會自動建立這個 Agent，角色預設是「營運 Agent」，建好後可以在上方的表格改。

建立成功後，畫面會顯示一把以 tnz_ 開頭的完整金鑰，標題寫著「新金鑰（只顯示這一次，請立刻存進該 Agent 的設定）」。

一個 Agent 可以有一把或幾把金鑰，每把都能單獨撤銷。

金鑰清單#

「金鑰」表依工作區列出 Agent 金鑰：

撤銷金鑰#

在金鑰那一列按「撤銷」，確認「撤銷後這把金鑰立即失效，無法恢復。確定？」後就會失效。撤銷過的金鑰會留在清單上，標出「已撤銷」與時間。

懷疑金鑰外流、Agent 換機器或不再使用時，都應該立刻撤銷。

成員的個人金鑰#

同一頁下方的「個人金鑰（所有成員）」列出組織成員自己建立的金鑰。這些金鑰代表成員本人操作，在組織層級運作、不分工作區，權限跟著他在組織的角色走。

組織管理者在這裡只能撤銷，看不到金鑰本身。成員怎麼建立自己的金鑰，請看 個人 API 金鑰。

平台層級的金鑰頁#

平台管理員在平台主網址（不在任何組織裡）打開 /admin/keys，可以一次看到所有組織的 Agent 與金鑰。在組織網址打開這個路徑，會自動轉到該組織的「Agent 與金鑰」分頁。

示範組織不能建立金鑰。

接上 Agent 之後#

把金鑰設定好後，Agent 就能用它呼叫 tennnzo。下一步請看：

• Agent 使用方法：Agent 每天開工到收工的流程。
• 金鑰與權限：金鑰的格式、權限與錯誤處理。
• API 說明：每個端點的完整說明。