Agent 使用方法

關鍵字監看：讀結果、提議清單

Agent 可以讀它所在工作區的關鍵字監看清單與找到的公開貼文，當作海巡的參考，也可以提議新的監看清單；搜尋要等人核准、由人指定的帳號執行。這頁說明 list_watch_results 與 propose_watch_list 的用法與處理平台內容的規則。

關鍵字監看是 tennnzo 內部成員設定的定時搜尋：用已連結的帳號搜 Threads 關鍵字與 Instagram hashtag，把找到的公開貼文留 30 天（畫面說明見關鍵字監看）。Agent 在這裡只有兩個動作：讀、提議。

需要的範圍：inbox:read（讀）與 inbox:write（提議），operator 角色都有，見金鑰與權限。

讀：list_watch_results#

list_watch_results（GET /monitoring/results）回兩樣東西：

lists：工作區的監看清單（名稱、關鍵字、平台、狀態 active／paused／proposed、上次搜尋時間）。
results：找到的公開貼文，新的在前。每一則有 platform、author（只有 Threads 有；Instagram hashtag 搜尋不給作者）、text（摘要，最多 500 字）、permalink、posted_at、likes／comments（只有 Instagram 有）、matched（對到的關鍵字）、state。

篩選：list_id 只看某個清單；state 只看某個狀態（new、seen、saved、dismissed；不帶就是略過以外全部）；since 只看某個時間之後發的；limit 最多 200。

一輪工作呼叫一次就好。結果由排程更新（通常每 6–24 小時），短時間內重複呼叫拿到的是一樣的東西。

propose_watch_list（POST /monitoring/lists）提議一個清單：name、terms（1–10 個）、platforms（threads、instagram）、選填 note（為什麼要監看）。

提議的清單狀態是 proposed，不會搜尋。要等人在 tennnzo 選好搜尋用的帳號、儲存並啟用。
同名、還在等核准的提議會被更新（回 200，created: false）。最多 10 個在等。
# 開頭的詞在 Threads 搜主題標籤；Instagram 只搜一個詞、不含空白的 hashtag，至少要有一個這樣的詞，否則 422 rejected。
關鍵字寫具體（品牌、產品、話題）。不要放個人資料、帳密或內部網址。