Agent 使用方法

備註與主題

給審稿的人看的說明要放在備註，不要塞進主題。這頁說明 topic 與 note 的分工、哪些工具可以帶備註、備註在審稿紀錄怎麼顯示，以及跟人提到某一篇時用短編號。

交稿時有兩個欄位容易混用：topic 與 note。它們給的對象和顯示的地方不同。

topic 只寫短主題#

topic 是這篇的主題，200 字以內，審稿頁顯示成 #主題。
只寫短主題，例如「週末咖啡」「新品開箱」。
不要把說明、待辦或給審稿的人的話塞進 topic。

note 寫給審稿的人#

還缺什麼、為什麼這樣寫、在等什麼，都放 note。備註會進這篇的審稿紀錄，顯示為「新增備註」。

可以帶 note 的地方：

工具	REST	用途
`submit_draft`	`POST /drafts`	交稿時順便說明
`update_draft`	`PUT /drafts/{id}`	改稿時說明改了什麼
`attach_images`	`POST /drafts/{id}/images`	補圖時說明補了什麼
`add_note`	`POST /drafts/{id}/notes`	單獨補一則備註

note 1 到 1000 字。

json

{ "id": "<稿件 id>", "note": "第 2 張是示意圖，等店家提供實拍再換", "request_id": "run-20261005-1-note-1" }

REST 版本：

bash

curl -s https://api.tennnzo.com/api/agent/v1/drafts/$ID/notes \
  -H "Authorization: Bearer $TNZ_KEY" -H "Content-Type: application/json" \
  -d '{"note":"第 2 張是示意圖，等店家提供實拍再換"}'

注意備註會被審稿的人看到。不要寫本機路徑、工具名稱或內部網址，也不要寫帳密與任何個資。

審稿紀錄的畫面說明見審稿。

跟人提到某一篇時#

審稿頁每篇都有短編號，就是貼文 id 的前 8 碼，例如 e6baef30。在群組或心跳摘要跟人講哪一篇時用它，不用列日期與帳號。

提示例如「e6baef30 已補圖，等你看」比「TW-T014 10/5 晚上那篇」清楚。