AI Engineer onepage / Sourcegraph
速讀 · 設計取捨 · 實務清單 · source
Stephanie Jarmak, Sourcegraph · 約 18 分鐘

這支影片在講:Developer Relations 沒死,只是 agent 也成了使用者

當 AI agent 會搜尋工具、讀文件、呼叫 API、踩到錯誤並向人推薦產品,開發者關係的工作不再只是「被找到」;而是把 agent 的實際任務路徑變成可量測、可改善的產品體驗。

Published: 2026-08-26 · Video ID: Lrw0jqBNaw0
01 / 問題

搜尋排名看不到採用摩擦

問 agent「比較 code intelligence 工具」會提到 Sourcegraph;描述「改 shared library 會不會弄壞下游服務」卻沒有。購物語言和受傷語言之間有一段看不見的落差。

02 / 反轉

Agent 同時是使用者與推薦者

它會讀 docs、打 API、遇到錯誤並形成建議。這使 developer experience 直接進入 agent 的工具選擇與人類的採購路徑。

03 / 解法

跑任務、讀 trace、縮短距離

以數百個 lifecycle 任務 benchmark 有無工具的表現,再從 trace 找到模糊描述、陳舊內容和多餘步驟,逐一收斂。

Signals

影片中最重要的四個訊號

DISCOVERY GAP65% → 0%比較工具時被提及的比例,到了具體痛點描述卻歸零。
BENCHMARK數百項用完整 lifecycle tasks,而非單一問答,觀察 agent 是否真的完成工作。
WASTED COST1 turn一個不存在的參數名,就能因不清楚的 tool description 燒掉一輪推理。
PERSONAL ARC12,000講者從一年前零 commit,到維護開源 multi-agent orchestration framework。
Core story

把 developer relations 改成 agent experience 的三個轉向

轉向 1

從「是否被提到」改問「能否解決正在發生的痛」

泛用比較 prompt 容易出現在答案裡,卻未必能連到真實工作情境。應蒐集使用者自己的任務敘述,測試 agent 是否能把痛點、工具能力與正確的下一步接起來。

轉向 2

從成功率改看成功的 token 與延遲成本

對 agent 買家而言,「能不能用」不夠;每一次猜錯、recover 或繞路都會消耗 token 和時間。產品文件與錯誤訊息因此成為成本結構的一部分。

轉向 3

從內容行銷改成可觀測的採用路徑

把 agent trace 當成使用研究:它怎麼理解工具、在哪個參數卡住、如何從錯誤回復。每個 trace 都能指出應改善的描述、範例、registry 入口或 onboarding 摩擦。

Design choices

不要只把文件寫得更長;要讓 agent 下一步更明確

工具描述是操作介面,不是產品型錄

trace 裡 agent 假設了不存在的參數名。更清楚地說明輸入、適用時機和失敗條件,就可能省下一次呼叫與一次 recovery。

陳舊內容會累積成錯誤上下文

agent 會吸收 docs、API 回應與網路內容;過期資訊不只是舊頁面,而會持續污染它後續的建議與操作。

先在 agent 出現的地方降低摩擦

MCP registry 與可被工具讀取的入口,是 agent 的 distribution surface;讓發現、理解、試用之間少一層人工轉譯。

為一種使用者做的 curb cut,常會幫到所有人

清楚的錯誤、短的採用路徑與可驗證範例,對 agent 有用,也會讓新進開發者更快成功。

Checklist

若你的產品想被 agent 正確採用,先做這五件事

把「比較題」換成使用者真正的痛點題同時測試 agent 能否辨識情境、選對工具、走完任務,而非只看品牌是否被提到。
建立有/無工具的 lifecycle benchmark以任務成功、token、延遲和 recovery 次數比較,讓工具價值能被看見。
定期閱讀 trace,修正最常見的猜測優先修工具描述、參數命名、錯誤訊息和範例,消除可避免的一輪推理。
把文件當成可執行的產品表面移除過期內容,讓版本、限制與下一步一致,避免 agent 把錯誤知識帶入任務。
在 agent 的入口點提供低摩擦路徑確認 registry、MCP 與 API 文件能被發現、理解和安全地開始使用。
Source video

原影片與章節

0:00 背景 · 4:19 agent 是使用者與推薦者 · 5:36 有無工具的 benchmark · 7:42 65%→0% 的發現落差 · 10:29 陳舊內容會複利 · 12:12 registry 與採用摩擦 · YouTube 原始影片