實戰範例 010：用 Exa 全網語意搜尋彙整產業週報並發佈至 LinkedIn

經營技術品牌的人幾乎都遇過同一個難題：要每週發一篇有觀點的產業週報，但光是把散落在十幾個網站的話題收集起來，就吃掉一整個早上。等你整理完、寫完、還要手動貼到 LinkedIn，常常下一週的主題又冒出來了。

這個範例把整條流程交給 AI 助理加上 Agent Reach：用 Exa 全網語意搜尋撈素材，彙整成專業週報，再透過 LinkedIn 寫入通道發佈。關鍵是善用 Agent Reach 的安全模式 (--preview)，讓你按下確認鍵之前，什麼都不會真的送出去。

情境設定

你是某個 AI 工程師社群的維護者，每週要在 LinkedIn 發一篇「本週 AI 工程值得關注的三件事」。本週主題鎖定「AI 代理的網路讀寫能力」。

素材來源：全網（透過 Exa 語意搜尋）。
彙整目標：3 個觀點，每個觀點附 1 個可信來源連結。
發佈平台：LinkedIn 個人動態。
語氣：專業但口語，繁體中文。
安全要求：發文前必須預覽，由人類確認後才真正送出。

第一步：用 Exa 語意搜尋撈素材

傳統的關鍵字搜尋會回你一大票字面相符的結果，但常常錯過用字不同、概念卻相同的文章。Exa 走的是語意比對，把「意思接近」的內容一起撈進來，特別適合這種主題式彙整。

Agent Reach 把 Exa 包成統一的語意搜尋通道。AI 助理接到需求後，會透過這個通道向 Exa 提出查詢，主要傳入四個輸入：

主題描述：用一段自然語言描述想找的方向（這次是「AI 代理的網路讀寫能力、多後端路由、瀏覽器自動化」），不用刻意塞關鍵字。
結果數量：指定取回前幾篇最相關的結果，這次設定 10 篇。
網域白名單：把這次彙整可信的網域限定進來（例如 github.com、oreilly.com、stackoverflow.blog），避免農場文混入。
搜尋後端：Agent Reach 內建的語意搜尋後端就是 Exa，這個欄位預設走 Exa。

Exa 通道回傳的結構化結果大概長這樣（節錄）：

{
  "status": "success",
  "engine": "exa",
  "results": [
    {
      "title": "Giving LLM Agents Safe Access to the Open Web",
      "url": "https://stackoverflow.blog/2026/07/agents-network-access",
      "score": 0.91,
      "publishedDate": "2026-07-22",
      "summary": "Multi-backend routing and credential vaults are becoming..."
    },
    {
      "title": "Why Headless Browser Fallback Beats Official APIs in 2026",
      "url": "https://oreilly.com/ideas/headless-fallback-2026",
      "score": 0.88,
      "publishedDate": "2026-07-19",
      "summary": "Rate limits and WAF blocks are pushing agents toward..."
    }
  ]
}

每筆結果附語意相似度分數 (score)、發佈日期與自動摘要。AI 助理可以拿分數做初步排序，再用日期過濾掉超過兩週的舊聞。

第二步：AI 助理彙整成週報草稿

拿到 10 篇素材之後，AI 助理進到下一步：閱讀摘要、找共同脈絡、萃取出三個觀點。這段不需要 Agent Reach，是純語言模型的工作。

人類：把上面這 10 篇整理成 LinkedIn 週報草稿。三個觀點，每個觀點兩到三句中文說明，並附一個原文連結。語氣要專業但口語。

AI 助理：好的。我從素材中歸納出三個本週值得關注的脈絡，草稿如下：

本週 AI 工程值得關注的三件事

1. 多後端路由正在成為標準配備 當官方 API 被速率限制或 WAF 擋下，與其寫一長串 retry 邏輯，越來越多團隊改用「首選加備選」的路由清單，讓代理在底層無感切換。参考：https://stackoverflow.blog/2026/07/agents-network-access

2. 無頭瀏覽器從備案升級為主戰力 過去無頭瀏覽器只被當作官方 API 失效時的後備，2026 年越來越多場景直接讓它上場，特別是處理登入態與 JavaScript 重渲染的頁面。参考：https://oreilly.com/ideas/headless-fallback-2026

3. 憑證本地化成為信任底線 代理需要寫入能力的同時，社群也開始要求憑證不能離開本機。600 權限加預覽模式，逐漸變成基本款。参考：（第三個觀點的連結，來自素材第 5 篇）

草稿出來之後別急著發。下一步要靠 LinkedIn 通道的安全模式把關。

第三步：用 LinkedIn 通道搭配 `--preview` 預覽

LinkedIn 在 Agent Reach 裡屬於需要登入態的平台。首次使用要先完成登入授權（細節在主題的 harness 文件），之後 Agent Reach 會把憑證以 600 權限存到本機。

授權完成後，發文呼叫本身非常短：

agent-reach post --platform=linkedin --content="@WEEKLY_DRAFT" --preview

--preview 是這個範例的靈魂。它讓 Agent Reach 走完整個發文流程，但最後一步停在「按下送出鍵之前」，把即將貼上的內容渲染成預覽畫面交給你檢查。

預覽輸出範例：

[PREVIEW] LinkedIn post ready. Review before commit:
---------------------------------------------------------------
本週 AI 工程值得關注的三件事

1. 多後端路由正在成為標準配備
   當官方 API 被速率限制或 WAF 擋下...
   https://stackoverflow.blog/2026/07/agents-network-access

2. 無頭瀏覽器從備案升級為主戰力
   ...
---------------------------------------------------------------
[INPUT] Type 'confirm' to publish, anything else to abort:

這一層人工卡關，是 Agent Reach 在所有寫入通道都會強制的安全邊界。你可以檢查連結有沒有抓錯、語氣有沒有偏、有沒有不小心洩漏內部資訊。

第四步：確認送出，記錄路由

預覽沒問題，輸入 confirm，Agent Reach 才會真正呼叫 LinkedIn 寫入介面把貼文推上去。

[INFO] Publishing to LinkedIn via primary route...
[ OK ] Post published: https://www.linkedin.com/posts/activity-123456789
[INFO] Route used: primary (official API)

回傳訊息會標注這次走的是 primary 還是某條 fallback 路由。如果哪一週 LinkedIn 官方介面臨時不通，Agent Reach 會自動切到網頁模擬，並在這行寫清楚切換原因。把這幾行存下來，月底檢討路由健康狀態時直接看紀錄就好。

第五步：把整條流程做成排程

單次手動跑順之後，可以用 cron 觸發腳本，把第一步的 Exa 語意搜尋自動化，再把結果交給 AI 助理生成草稿，最後落地成預覽檔等你週一早上簽核。排程能代勞蒐集與起草，但步驟三的 --preview 永遠留給人類。寫入能力越強，越需要這層固定的人工卡關。

常見陷阱

Exa 回太多農場文：在網域白名單加上你信任的網站。語意搜尋的好處是廣，但白名單才能保證質。
LinkedIn 預覽看起來正常，但發出去格式跑了：LinkedIn 對 emoji 與多層縮排處理不一致。預覽時盡量用純文字與單層縮排，避免 fancy 排版。
--preview 卡住沒回應：通常是它在前一步驟等你在終端輸入 confirm。如果排程環境沒有終機，要改成把預覽寫入檔案，再由人類另開連線簽核。

關鍵學習點

Exa 語意搜尋特別適合「主題式彙整」這類任務，用一段自然語言描述加上網域白名單，就能拿到高濃度素材。
Agent Reach 把 LinkedIn 這類需要登入態的平台，包成與公開網頁一致的 post 介面，差別只在首度要完成本機授權。
--preview 是所有寫入通道共享的安全邊界。自動化流程可以跑到生成草稿，但 confirm 這一步永遠建議留給人類。
每次發文回傳的 Route used 欄位是路由健康監控的第一手資料，長期收集下來可以判斷哪些平台首選路由退化、需要調整後端清單。