tennnzoAgent 與 API

個人 API

個人 API 使用方法

每個成員都能建立自己的個人金鑰，把自己的助理或工具接上 tennnzo。這頁說明建立金鑰、REST 與 MCP 網址、各角色能做的事、審稿動作、圖片連結、錯誤，以及客戶、Agency、平台管理員可以怎麼跟助理說。

個人 API 讓你把自己的助理或工具接上 tennnzo，替你看審稿佇列、審稿、看報告。

金鑰就是你本人：看得到什麼、能做什麼、審稿紀錄與稽核上記的是誰，都和你在 dashboard 上點按鈕一模一樣。Agent 用的是另一種金鑰（tnz_…）與另一套 API，兩者互不影響。

建立金鑰#

  1. 在 dashboard 左下角的使用者選單打開「個人設定」，再進「我的 API 金鑰」（/me/keys）。
  2. 建立一把金鑰。完整金鑰長這樣 tnu_<8 碼>_<43 碼>，只顯示一次，馬上存好。
  3. 把它放進你助理的設定或環境變數。
  • 每人每個組織最多 10 把有效金鑰。
  • 個人金鑰在組織層級運作，不綁工作區，也不受畫面上選的工作區影響。
  • 還沒完成首次登入設定（改密碼、填 Email）的帳號不能建立，也不能使用金鑰。
  • 弄丟了就撤銷再建一把。撤銷立即生效，不能恢復。
  • 組織管理者可以在「組織設定 › Agent 與金鑰」看到所有成員的金鑰並撤銷，但看不到金鑰本身。

畫面說明見 我的 API 金鑰。

網址#

網址
RESThttps://api.tennnzo.com/api/user/v1
REST（你的組織網域也可以）https://<組織代號>.tennnzo.com/api/user/v1
MCPhttps://api.tennnzo.com/api/mcp

所有請求都帶 Authorization: Bearer tnu_…。MCP 和 Agent 是同一個網址，系統依金鑰開頭判斷是誰。

bash
curl -s https://api.tennnzo.com/api/user/v1/me -H "Authorization: Bearer $TNU_KEY"

接上你的助理#

支援遠端 MCP 的工具，設定一個 HTTP MCP 伺服器，加上 Authorization 標頭即可。用指令新增的工具寫法類似：

bash
<your-client> mcp add --transport http tennnzo https://api.tennnzo.com/api/mcp \
  --header "Authorization: Bearer tnu_…"

完整設定見 MCP 連線。

注意 金鑰只放在你自己電腦的設定裡，不要貼進群組或對話。

角色與能做的事#

能做的事由你目前在這個組織的角色決定，每次請求都重新計算。角色被調整，下一次請求就跟著變；被移出組織，金鑰立刻失效。MCP 只會列出你的角色能用的工具。

工具REST客戶Agency平台管理員
whoami 我是誰GET /me可以可以可以
review_queue 審稿佇列GET /review只有待客戶審全部階段全部階段
get_post 看一篇GET /posts/{id}可以可以可以
review_post 審稿、排程POST /posts/{id}/transition要有審稿權可以可以
published_posts 已發布GET /posts/published可以可以可以
list_reports、get_report 報告GET /reports、GET /reports/{id}已發給客戶的全部全部
list_decisions 待裁決GET /decisions可以可以
decide_issue 已處理、不處理POST /decisions/{id}/resolve、/dismiss可以可以
choose_issue 回答選項題POST /decisions/{id}/choose可以可以
list_tasks Agent 看板GET /tasks可以可以
open_task 交辦POST /tasks可以可以
confirm_task、reopen_task 確認、退回重做POST /tasks/{id}/confirm、/reopen可以可以
today 今日摘要GET /today可以可以
metrics 成效GET /metrics可以可以
list_keys 金鑰清單GET /admin/keys可以
revoke_key 撤銷金鑰POST /admin/keys/{kind}/{id}/revoke可以

角色的完整說明見 角色與權限。

客戶看得到什麼#

和 dashboard 的客戶畫面一樣：等你審的貼文（專案有開客戶審稿才有）、這些貼文的配圖、人設基本資料、已發布的貼文、已發給客戶的報告、你和同事對貼文的決定。看不到草稿、內部意見、Agent、其他專案或其他組織。

審稿動作#

review_post（POST /posts/{id}/transition）：

json
{ "action": "request_changes", "comment": "開頭太像上一篇，換個角度" }
  • 客戶：approve 通過、request_changes 要求修改、reject 退回、request_rewrite 要求 Agent 重寫；後三者要寫 comment。只能在「待客戶審」階段、專案開著客戶審稿、你有審稿權時做。
  • Agency 與平台管理員：另外還有 submit、cancel_rewrite、schedule、reschedule、unschedule。排程要 scheduled_for，帶時區的 ISO、未來時間，例如 2026-10-06T20:00:00+08:00。
  • 規則和 dashboard 的按鈕一樣，例如客戶審稿開著時不能替客戶按通過。

圖片連結#

review_queue 與 get_post 裡的 images[] 有 thumb_url（縮圖）與 url（原圖）。

  • 這是 tennnzo 網域的簽名連結，15 分鐘內有效，不用帶金鑰就能開。
  • 過期了就重新叫一次 review_queue 或 get_post，會拿到新的。
  • 金鑰撤銷後，舊連結也立刻打不開。

跟助理怎麼說#

客戶#

  • 「tennnzo 有哪些貼文等我審？」→ review_queue
  • 「打開第二篇，給我看圖和這個帳號最近發了什麼。」→ get_post
  • 「這篇通過。」「這篇請他們把開頭改得口語一點。」→ review_post，助理會先跟你確認再送出
  • 「上週的週報重點是什麼？」→ list_reports、get_report

Agency#

  • 「今天有什麼要處理？」→ today
  • 「待內部審的稿列出來，第 3 篇通過、第 5 篇退回說太長。」→ review_queue、review_post
  • 「把 TW-T014 那篇排在明天晚上 8 點。」→ review_post（schedule）
  • 「待裁決有哪些？那件貓的，選虎斑。」→ list_decisions、choose_issue
  • 「小橘交回來的卡確認一下；那張頭像的退回，說顏色不對。」→ list_tasks、confirm_task、reopen_task
  • 「Threads 這 30 天瀏覽最高的帳號？」→ metrics

平台管理員#

Agency 能做的都可以，另外：

  • 「這個組織有哪些金鑰？最近沒在用的有哪些？」→ list_keys
  • 「撤銷 Mika 那把舊筆電的金鑰。」→ revoke_key，撤銷後不能恢復，助理會先跟你確認

錯誤#

所有錯誤都是 { "error": { "code", "message", "request_id" } }：

HTTPcode意思
400invalid_request參數格式錯，message 說哪一欄
401unauthorized沒帶金鑰、金鑰錯誤或已撤銷、還沒完成首次登入設定、已不是這個組織的成員
403forbidden你的角色不能做這件事，例如客戶看待裁決、沒有審稿權的客戶按通過
404not_found找不到，或你看不到（不會告訴你是哪一種）
413payload_too_large請求內容太大
422rejected規則不允許，例如退回沒寫意見、這篇已經不在這個階段；message 是原因
429rate_limited太快了，看 Retry-After 秒數再試；預設每把金鑰每分鐘 60 次
500internal伺服器錯誤

每次請求（含 MCP 工具呼叫）都會記一筆紀錄：誰、哪把金鑰、哪個路徑或工具、結果，不記內容。

完整端點與欄位見 個人 API 參考。