戰(zhàn)指南:從安裝配置到 Skill 開發(fā)與避坑全解析)
1. 先搞清楚 WorkBuddy 到底是個(gè)什么東西很多人第一次聽到 WorkBuddy 這個(gè)名字會(huì)下意識(shí)把它歸類成又一個(gè)套殼聊天窗口。我一開始也這么想直到真正把它接進(jìn)日常工作流跑了兩周才發(fā)現(xiàn)它和普通對(duì)話式 AI 的定位完全不是一回事。WorkBuddy 是騰訊推出的 AI 工作臺(tái)核心形態(tài)是AI Agent 中臺(tái)——它不是一個(gè)讓你問問題、它答問題的工具而是一個(gè)能掛載技能、調(diào)用工具、按規(guī)則自主完成任務(wù)的執(zhí)行體。你給它一個(gè)目標(biāo)它自己拆步驟、自己調(diào)技能、自己交付結(jié)果。這個(gè)區(qū)別非常關(guān)鍵。普通 AI 是你問我答WorkBuddy 是你派活它干活。舉個(gè)我實(shí)際用過的場(chǎng)景我讓它把這份會(huì)議紀(jì)要整理成周報(bào)按項(xiàng)目分組輸出 Markdown 并生成一個(gè)可訪問的網(wǎng)頁。它會(huì)先解析紀(jì)要內(nèi)容再按項(xiàng)目維度歸類然后調(diào)用文檔處理技能生成結(jié)構(gòu)化文本最后調(diào)用網(wǎng)頁生成技能把結(jié)果發(fā)布出去。整個(gè)過程我只說了一句話中間沒有來回確認(rèn)。這就是 Agent 和 Chatbot 的本質(zhì)分水嶺。那它適合誰用我梳理了三類人。第一類是日常有大量重復(fù)性文檔、表格、信息整理工作的人比如運(yùn)營、行政、項(xiàng)目助理WorkBuddy 能把這類活兒壓縮到原來的零頭。第二類是想入門 AI Agent 但不知道從哪下手的技術(shù)愛好者WorkBuddy 的 Skill 機(jī)制是一個(gè)非常好的練手載體比從零搭框架友好太多。第三類是需要把 AI 能力嵌進(jìn)團(tuán)隊(duì)流程的小團(tuán)隊(duì)負(fù)責(zé)人它的規(guī)則系統(tǒng)和技能復(fù)用機(jī)制天然適合做標(biāo)準(zhǔn)化。關(guān)鍵詞里反復(fù)出現(xiàn)的Skill、models.json、AI Agent其實(shí)就是理解 WorkBuddy 的三把鑰匙。Skill 是它的能力單元models.json 是它的模型配置入口AI Agent 是它的整體形態(tài)。把這三個(gè)概念吃透后面所有的安裝、配置、避坑都會(huì)順理成章。接下來我按真實(shí)上手順序從安裝一路講到那些官方文檔不會(huì)告訴你的坑。2. 安裝這件事坑比你想的多2.1 版本選擇國內(nèi)版和國際版不是簡(jiǎn)單換個(gè)語言WorkBuddy 有國內(nèi)版和國際版兩條線熱詞里workbuddy 國際版被搜了很多次說明不少人在糾結(jié)選哪個(gè)。我的建議很直接如果你的主要工作內(nèi)容、協(xié)作對(duì)象、數(shù)據(jù)來源都在國內(nèi)生態(tài)里就用國內(nèi)版。國際版在模型接入、技能市場(chǎng)上和國內(nèi)版有差異不是簡(jiǎn)單的界面語言切換。我見過有人圖新鮮裝了國際版結(jié)果發(fā)現(xiàn)自己常用的幾個(gè)技能在那邊找不到對(duì)應(yīng)實(shí)現(xiàn)又折騰回來重裝。選版本之前先想清楚三件事你的數(shù)據(jù)主要在哪、你要用的技能在哪個(gè)版本更全、你的團(tuán)隊(duì)協(xié)作在哪個(gè)版本更順。這三個(gè)問題想明白了版本選擇就是水到渠成的事不用反復(fù)橫跳。2.2 安裝路徑與緩存目錄C 盤爆了別怪我沒提醒這是被問得最多的問題之一——workbuddy 系統(tǒng)緩存目錄能改到 D 盤嗎。答案是能但要在首次啟動(dòng)之前改裝完再改會(huì)麻煩很多。WorkBuddy 運(yùn)行過程中會(huì)產(chǎn)生大量緩存包括技能執(zhí)行日志、模型調(diào)用記錄、臨時(shí)文件。如果你默認(rèn)裝在 C 盤用不了多久就會(huì)發(fā)現(xiàn)系統(tǒng)盤告急。我的做法是安裝時(shí)就把主程序和緩存目錄都指到非系統(tǒng)盤。具體操作上安裝向?qū)Ю锿ǔS凶远x路徑的選項(xiàng)別一路點(diǎn)下一步。如果安裝向?qū)]給緩存目錄的選項(xiàng)那就裝完后第一時(shí)間去配置文件里改趁緩存還沒堆起來。這里有個(gè)經(jīng)驗(yàn)緩存目錄的路徑里不要有中文和空格我踩過這個(gè)坑某些技能在讀取路徑時(shí)會(huì)對(duì)特殊字符處理不當(dāng)導(dǎo)致執(zhí)行失敗但報(bào)錯(cuò)信息很含糊排查半天才發(fā)現(xiàn)是路徑問題。2.3 首次啟動(dòng)的初始化別急著跳過首次啟動(dòng)會(huì)有一個(gè)初始化過程包括環(huán)境檢測(cè)、依賴?yán)?、默認(rèn)技能加載。這個(gè)過程可能比較慢尤其是網(wǎng)絡(luò)狀況一般的時(shí)候。我的建議是讓它跑完不要中途關(guān)掉。我見過有人嫌慢直接強(qiáng)退結(jié)果技能庫加載了一半后面調(diào)用技能時(shí)各種莫名其妙的報(bào)錯(cuò)最后只能卸載重裝。初始化完成后先別急著上任務(wù)。花五分鐘做一件事打開設(shè)置確認(rèn)模型配置、緩存路徑、默認(rèn)工作目錄這三項(xiàng)。模型配置決定了你后面能用哪些能力緩存路徑?jīng)Q定了你的磁盤會(huì)不會(huì)爆默認(rèn)工作目錄決定了你生成的文件會(huì)落在哪里。這三項(xiàng)確認(rèn)好后面能省掉大量返工。3. models.json整個(gè)工作臺(tái)的命門所在3.1 這個(gè)文件為什么這么重要熱詞里models.json單獨(dú)被列出來說明它是很多人的痛點(diǎn)。簡(jiǎn)單說models.json 是 WorkBuddy 的模型配置文件它決定了工作臺(tái)能調(diào)用哪些模型、每個(gè)模型怎么連、參數(shù)怎么設(shè)。你可以把它理解成工作臺(tái)的通訊錄——里面記著它能找誰干活、怎么找到、找的時(shí)候說什么。這個(gè)文件出問題表現(xiàn)往往很迷惑。比如技能明明裝了卻調(diào)不動(dòng)、任務(wù)跑到一半卡住、返回結(jié)果格式不對(duì)很多時(shí)候根子都在 models.json 上。我遇到過最典型的一次某個(gè)技能一直報(bào)模型不可用我以為是技能本身的問題重裝了三遍最后發(fā)現(xiàn)是 models.json 里那個(gè)模型的配置項(xiàng)少了一個(gè)字段。3.2 配置時(shí)的幾個(gè)關(guān)鍵點(diǎn)配置 models.json 有幾個(gè)地方必須注意。第一是字段完整性不同模型需要的字段不完全一樣缺一個(gè)就可能導(dǎo)致整個(gè)條目失效。第二是參數(shù)格式比如溫度值、最大 token 數(shù)這類寫錯(cuò)類型該寫數(shù)字寫成字符串不會(huì)立刻報(bào)錯(cuò)但會(huì)在實(shí)際調(diào)用時(shí)出問題。第三是條目順序有些版本會(huì)按順序嘗試模型把常用的放前面能減少等待。我自己的習(xí)慣是改 models.json 之前先備份一份改完用一個(gè)最簡(jiǎn)單的任務(wù)測(cè)一下確認(rèn)沒問題再繼續(xù)。這個(gè)習(xí)慣幫我省過好幾次事。因?yàn)?models.json 一旦改壞可能整個(gè)工作臺(tái)都用不了有個(gè)備份能讓你快速回滾。提示models.json 的修改建議在 WorkBuddy 完全退出后進(jìn)行改完再啟動(dòng)。運(yùn)行中改文件有些版本不會(huì)熱加載你以為改了其實(shí)沒生效白折騰。3.3 多模型配置的取舍邏輯如果你要配多個(gè)模型得想清楚分工。我的經(jīng)驗(yàn)是按任務(wù)類型分需要強(qiáng)推理的復(fù)雜任務(wù)配一個(gè)能力強(qiáng)的模型日常輕量任務(wù)配一個(gè)響應(yīng)快的模型需要處理長文檔的配一個(gè)上下文窗口大的模型。這樣配置的好處是技能在調(diào)用時(shí)可以根據(jù)任務(wù)性質(zhì)選合適的模型既保證效果又控制成本。別貪多。我見過有人一口氣配了七八個(gè)模型結(jié)果自己都記不清哪個(gè)是干嘛的技能調(diào)用時(shí)經(jīng)常選錯(cuò)。兩到三個(gè)精心配置的模型比一堆隨便加的模型有用得多。配置完在 models.json 里給每個(gè)模型寫個(gè)注釋如果格式支持的話或者自己?jiǎn)为?dú)記一份說明后面維護(hù)會(huì)輕松很多。4. Skill 機(jī)制WorkBuddy 真正的戰(zhàn)斗力來源4.1 Skill 到底是什么和插件有什么區(qū)別熱詞里skill、skill 插件、skill 腳本、agent skill出現(xiàn)頻率極高但很多人對(duì) Skill 的理解是模糊的。我的定義是Skill 是封裝好的、可被 Agent 調(diào)用的能力單元。它和普通插件的區(qū)別在于插件通常是給人點(diǎn)的按鈕Skill 是給 Agent 調(diào)的函數(shù)。你裝一個(gè) Skill等于給工作臺(tái)加了一項(xiàng)它能自主使用的能力。這個(gè)區(qū)別決定了 Skill 的設(shè)計(jì)思路。一個(gè)好的 Skill 不是功能越多越好而是邊界清晰、輸入輸出明確、能被 Agent 準(zhǔn)確理解什么時(shí)候該用它。我見過一些 Skill 功能堆得很全但 Agent 根本不知道該在什么場(chǎng)景調(diào)用它最后成了擺設(shè)。4.2 從 book to skill 看 Skill 的典型形態(tài)熱詞里有個(gè)很有意思的詞叫book to skill這其實(shí)揭示了 Skill 的一種典型用法把一份文檔、一套流程、一類知識(shí)封裝成一個(gè)可調(diào)用的技能。比如你把公司的報(bào)銷規(guī)范整理成 Skill以后 Agent 處理報(bào)銷相關(guān)任務(wù)時(shí)就能自動(dòng)按規(guī)范來。這種知識(shí)固化是 Skill 最有價(jià)值的應(yīng)用之一。我實(shí)際做過一個(gè)類似的把我們團(tuán)隊(duì)的周報(bào)模板和寫作規(guī)范做成 Skill。以前每次讓 AI 寫周報(bào)都要把規(guī)范貼一遍現(xiàn)在直接調(diào)用 SkillAgent 自己就知道格式要求、語氣要求、必填字段。這個(gè) Skill 我用了大半年省下的重復(fù)溝通時(shí)間非??捎^。4.3 Skill 開發(fā)的基本思路如果你想自己寫 Skill熱詞里的skill 開發(fā)指南、skill 編碼可以參考但我更想講思路而不是語法。寫 Skill 的第一步不是寫代碼是想清楚這個(gè)能力的輸入是什么、輸出是什么、什么情況下該被觸發(fā)。這三個(gè)問題答不清楚代碼寫得再漂亮也沒用。第二步是把邊界劃死。Skill 最怕的是什么都能干一點(diǎn)因?yàn)?Agent 判斷是否調(diào)用它時(shí)會(huì)猶豫。一個(gè)只干一件事、干得很好的 Skill比一個(gè)什么都能干的 Skill 有用得多。第三步是寫好描述Skill 的描述是給 Agent 看的不是給人看的要寫清楚什么時(shí)候用我而不是我有多厲害。注意Skill 的命名和描述直接影響 Agent 的調(diào)用準(zhǔn)確率。我踩過的坑是描述寫得太抽象結(jié)果 Agent 該調(diào)用的時(shí)候不調(diào)用不該調(diào)用的時(shí)候亂調(diào)用。后來把描述改成具體的場(chǎng)景化語言準(zhǔn)確率明顯提升。4.4 Skill 的復(fù)用與管理Skill 裝多了會(huì)亂這是必然的。我的管理方法是按使用頻率分層高頻 Skill 放在顯眼位置低頻的歸檔一次性的用完就刪。另外同類 Skill 盡量只留一個(gè)別裝三個(gè)功能重疊的否則 Agent 調(diào)用時(shí)會(huì)隨機(jī)選結(jié)果不穩(wěn)定。還有一點(diǎn)定期清理失效 Skill。有些 Skill 依賴的外部服務(wù)變了、接口改了會(huì)靜默失效。失效的 Skill 留在那里Agent 偶爾調(diào)用到會(huì)報(bào)錯(cuò)影響體驗(yàn)。我一般每個(gè)月過一遍 Skill 列表把不用的、失效的清掉。5. 給 WorkBuddy 定規(guī)則讓 Agent 真正聽話5.1 規(guī)則系統(tǒng)解決的是什么問題熱詞里有一條很具體給 workbuddy 定幾條規(guī)則后續(xù)對(duì)所有任務(wù)都生效。這戳中了很多人的需求——不想每次都重復(fù)交代同樣的要求。規(guī)則系統(tǒng)就是干這個(gè)的你把長期有效的要求寫進(jìn)規(guī)則Agent 在執(zhí)行任何任務(wù)時(shí)都會(huì)遵守。這個(gè)功能的價(jià)值在于一致性。沒有規(guī)則的時(shí)候你每次派活都要把偏好說一遍說漏了 Agent 就按默認(rèn)來結(jié)果時(shí)好時(shí)壞。有了規(guī)則相當(dāng)于給 Agent 裝了一套工作習(xí)慣它每次都會(huì)按這個(gè)習(xí)慣來輸出質(zhì)量就穩(wěn)定了。5.2 什么樣的規(guī)則值得寫不是所有要求都值得寫成規(guī)則。我的判斷標(biāo)準(zhǔn)是這條要求是不是跨任務(wù)、長期、穩(wěn)定有效的。如果是寫進(jìn)規(guī)則如果只針對(duì)某一次任務(wù)當(dāng)場(chǎng)說就行。我自己的規(guī)則清單里有這么幾條輸出默認(rèn)用 Markdown、涉及數(shù)據(jù)必須標(biāo)注來源、生成文件默認(rèn)放在指定目錄、不確定的信息必須明確標(biāo)注而不是編造。這幾條覆蓋了我日常大部分任務(wù)寫進(jìn)去之后我派活時(shí)基本不用再重復(fù)這些要求。5.3 規(guī)則的寫法與常見誤區(qū)規(guī)則要寫得具體、可執(zhí)行、無歧義。輸出要專業(yè)這種規(guī)則等于沒寫因?yàn)?Agent 不知道什么叫專業(yè)。輸出使用 Markdown 格式標(biāo)題用二級(jí)標(biāo)題代碼塊標(biāo)注語言類型——這才叫可執(zhí)行的規(guī)則。常見誤區(qū)有三個(gè)。一是規(guī)則太多太雜幾十條規(guī)則堆在一起Agent 反而抓不住重點(diǎn)還可能互相沖突。二是規(guī)則太抽象說了等于沒說。三是規(guī)則和技能描述打架比如規(guī)則說輸出簡(jiǎn)潔某個(gè)技能描述說輸出詳盡Agent 就懵了。寫規(guī)則的時(shí)候要通盤考慮別只顧著加。提示規(guī)則改完之后用一個(gè)典型任務(wù)驗(yàn)證一下效果。規(guī)則的影響是全局的改壞了影響面很大驗(yàn)證這一步不能省。6. 實(shí)戰(zhàn)從零跑通一個(gè)完整任務(wù)6.1 任務(wù)拆解的正確姿勢(shì)前面講的都是零件這一節(jié)講怎么組裝。我拿一個(gè)真實(shí)任務(wù)舉例把一批散亂的客戶反饋整理成分析報(bào)告并生成一個(gè)可分享的網(wǎng)頁。這個(gè)任務(wù)涉及信息整理、分析、文檔生成、網(wǎng)頁發(fā)布四個(gè)環(huán)節(jié)正好能體現(xiàn) WorkBuddy 的完整能力。派活的時(shí)候我不會(huì)把四個(gè)環(huán)節(jié)都寫死。我只會(huì)說清楚目標(biāo)和交付物中間的步驟讓 Agent 自己拆。這是用 Agent 和用普通工具最大的思維差異——你要學(xué)會(huì)給目標(biāo)不給步驟。當(dāng)然如果某個(gè)環(huán)節(jié)有特殊要求比如報(bào)告必須包含某個(gè)維度那就在目標(biāo)里點(diǎn)明。6.2 技能調(diào)用的觀察與干預(yù)任務(wù)跑起來之后我會(huì)觀察它調(diào)用了哪些技能、順序?qū)Σ粚?duì)。如果發(fā)現(xiàn)它用了不合適的技能或者順序有問題我會(huì)中途干預(yù)。但干預(yù)要克制不要每一步都插手否則就失去了用 Agent 的意義。我的原則是只要大方向?qū)χ虚g的小偏差讓它自己調(diào)整。這里有個(gè)經(jīng)驗(yàn)第一次跑新類型任務(wù)時(shí)全程盯著。因?yàn)樾氯蝿?wù)可能觸發(fā)你沒想到的技能組合出問題的概率高。跑順了之后同類任務(wù)就可以放手讓它自己跑。我現(xiàn)在大部分常規(guī)任務(wù)都是派完就不管過一會(huì)兒看結(jié)果。6.3 結(jié)果驗(yàn)收與迭代結(jié)果出來之后別急著用。先檢查幾個(gè)點(diǎn)格式對(duì)不對(duì)、數(shù)據(jù)準(zhǔn)不準(zhǔn)、有沒有編造的內(nèi)容。Agent 有時(shí)候會(huì)為了完成任務(wù)而編造信息這是必須防的。我一般會(huì)抽查關(guān)鍵數(shù)據(jù)確認(rèn)來源可靠。如果結(jié)果不理想不要直接重跑而是分析問題出在哪。是規(guī)則沒覆蓋到是技能選錯(cuò)了還是任務(wù)描述有歧義找到原因針對(duì)性調(diào)整比盲目重跑有效得多。我見過有人結(jié)果不好就反復(fù)重跑跑了十遍還是那樣因?yàn)楦驔]解決。7. 那些官方不會(huì)告訴你的坑7.1 緩存與性能的隱形關(guān)系WorkBuddy 用久了會(huì)變慢很多人以為是電腦問題其實(shí)是緩存堆積。緩存目錄里的文件會(huì)越來越多影響讀寫效率。我的做法是定期清理緩存頻率大概兩周一次。清理前確認(rèn)沒有正在跑的任務(wù)清理后第一次啟動(dòng)會(huì)慢一點(diǎn)之后就恢復(fù)正常。另外緩存目錄和程序目錄最好分開。放一起的話清理緩存時(shí)容易誤刪程序文件。這個(gè)坑我踩過一次清理完發(fā)現(xiàn)程序起不來了只能重裝。7.2 技能沖突與靜默失敗裝了兩個(gè)功能重疊的技能可能出現(xiàn)靜默失敗——任務(wù)看起來跑完了但結(jié)果是錯(cuò)的而且沒有任何報(bào)錯(cuò)。這種問題最難排查因?yàn)楸砻嫔弦磺姓?。我的?yīng)對(duì)方法是同類技能只留一個(gè)從源頭上避免沖突。如果確實(shí)需要多個(gè)就在規(guī)則里明確指定用哪個(gè)。還有一種靜默失敗是技能依賴的外部服務(wù)不可用。技能本身沒壞但它依賴的東西壞了結(jié)果就是任務(wù)跑不通。這種情況要看日志日志里通常有線索。養(yǎng)成看日志的習(xí)慣能幫你快速定位大部分問題。7.3 模型配置與任務(wù)失敗的關(guān)聯(lián)前面講過 models.json這里補(bǔ)充一個(gè)實(shí)戰(zhàn)經(jīng)驗(yàn)任務(wù)失敗時(shí)先懷疑模型配置。我遇到過好幾次任務(wù)跑到一半失敗排查半天發(fā)現(xiàn)是某個(gè)模型的配置有問題導(dǎo)致調(diào)用超時(shí)。把模型配置檢查一遍往往能解決大部分莫名其妙的失敗。具體檢查什么模型是否可用、參數(shù)是否正確、是否有多個(gè)模型配置沖突。如果實(shí)在找不到原因把 models.json 恢復(fù)到一個(gè)已知可用的版本再逐個(gè)加回配置用排除法定位問題。7.4 規(guī)則與技能的優(yōu)先級(jí)陷阱規(guī)則和技能都可能對(duì)輸出有要求當(dāng)兩者沖突時(shí)誰優(yōu)先這個(gè)問題的答案在不同版本里可能不一樣而且官方文檔往往不寫。我的經(jīng)驗(yàn)是不要制造沖突。寫規(guī)則的時(shí)候避開技能已經(jīng)定義好的部分只補(bǔ)充技能沒覆蓋的。這樣就不會(huì)有優(yōu)先級(jí)問題。如果實(shí)在需要覆蓋技能的默認(rèn)行為就在任務(wù)描述里明確說而不是靠規(guī)則去壓。任務(wù)描述的優(yōu)先級(jí)通常高于規(guī)則這是更可靠的做法。8. 進(jìn)階把 WorkBuddy 用出中臺(tái)的感覺8.1 從個(gè)人工具到團(tuán)隊(duì)能力WorkBuddy 一個(gè)人用是工具一個(gè)團(tuán)隊(duì)用就是中臺(tái)。區(qū)別在于能力是否被沉淀和復(fù)用。個(gè)人用的時(shí)候技能和規(guī)則都是自己攢的團(tuán)隊(duì)用的時(shí)候需要把這些沉淀成共享資產(chǎn)。我的做法是把團(tuán)隊(duì)通用的規(guī)則和技能整理成一套標(biāo)準(zhǔn)配置新成員進(jìn)來直接導(dǎo)入省去從零摸索的時(shí)間。這個(gè)過程中文檔化很關(guān)鍵。每個(gè)技能是干什么的、每條規(guī)則為什么這么定都要寫清楚。不然新人看到一堆技能和規(guī)則根本不知道從哪下手。我們團(tuán)隊(duì)有一份內(nèi)部說明記錄了我們沉淀的所有技能和規(guī)則這份說明的價(jià)值隨著時(shí)間越來越高。8.2 和其他工具的配合WorkBuddy 不是孤島它需要和其他工具配合。熱詞里提到的codebuddy、cursor這些都是可以配合的對(duì)象。我的用法是WorkBuddy 負(fù)責(zé)流程編排和任務(wù)執(zhí)行專業(yè)工具負(fù)責(zé)專業(yè)環(huán)節(jié)。比如代碼相關(guān)的任務(wù)WorkBuddy 負(fù)責(zé)拆解和調(diào)度具體編碼交給更專業(yè)的工具。這種配合的關(guān)鍵是接口清晰。WorkBuddy 要知道什么時(shí)候該把任務(wù)交給外部工具外部工具的結(jié)果要能順暢回到 WorkBuddy。這需要在技能層面做好封裝把外部工具包裝成 WorkBuddy 能調(diào)用的技能。8.3 持續(xù)迭代的心態(tài)AI Agent 這個(gè)領(lǐng)域變化很快今天好用的配置明天可能就有更好的方案。我的心態(tài)是保持迭代但不盲目追新。新功能出來先小范圍試確認(rèn)有價(jià)值再全面鋪開。不要因?yàn)槌隽诵聳|西就把現(xiàn)有的穩(wěn)定配置全推翻那樣只會(huì)讓自己一直在折騰。我自己的節(jié)奏是每個(gè)月花一點(diǎn)時(shí)間看看有沒有值得升級(jí)的地方有就小步試沒有就繼續(xù)用現(xiàn)有的。這樣既不會(huì)落后也不會(huì)被新東西牽著走。用 Agent 的最終目的是省事如果為了追新反而更累那就本末倒置了。9. 我踩過的幾個(gè)具體坑和修復(fù)過程9.1 技能裝了但調(diào)不動(dòng)第一次遇到這個(gè)問題時(shí)我以為是技能本身有 bug重裝了三次都沒用。后來靜下心來看日志發(fā)現(xiàn)是技能依賴的一個(gè)模型在 models.json 里配置不完整。補(bǔ)上缺失的字段后技能立刻就能用了。這個(gè)坑教會(huì)我技能調(diào)不動(dòng)先查模型配置再查技能本身。9.2 任務(wù)跑一半卡住有一次任務(wù)跑到一半就不動(dòng)了等了很久也沒反應(yīng)。排查發(fā)現(xiàn)是某個(gè)技能在等一個(gè)永遠(yuǎn)不會(huì)返回的外部調(diào)用。這種情況沒有好的自動(dòng)恢復(fù)機(jī)制只能手動(dòng)終止任務(wù)然后檢查那個(gè)技能依賴的外部服務(wù)。我的應(yīng)對(duì)是給關(guān)鍵技能設(shè)置超時(shí)避免無限等待。9.3 輸出格式總是不對(duì)有段時(shí)間 Agent 輸出的格式總是不符合要求我以為是規(guī)則沒寫清楚反復(fù)改規(guī)則都沒用。最后發(fā)現(xiàn)是某個(gè)技能的默認(rèn)輸出格式覆蓋了我的規(guī)則。解決辦法是在任務(wù)描述里明確指定格式而不是靠規(guī)則。這個(gè)坑讓我明白規(guī)則不是萬能的關(guān)鍵要求要在任務(wù)描述里說。9.4 緩存目錄遷移失敗想把緩存目錄從 C 盤遷到 D 盤直接改了配置結(jié)果工作臺(tái)起不來。原因是舊緩存還在原位置新配置指向了空目錄程序找不到需要的文件。正確做法是先停程序遷移緩存文件再改配置。順序錯(cuò)了就會(huì)出問題。10. 關(guān)于學(xué)習(xí)路徑的一點(diǎn)個(gè)人建議熱詞里有workbuddy 從入門到精通 pdf 下載、workbuddy 教程這類搜索說明很多人想要一份系統(tǒng)的學(xué)習(xí)材料。我的建議是別指望一份文檔就能精通這東西必須上手。看十篇教程不如自己跑通一個(gè)任務(wù)。我的學(xué)習(xí)路徑是先跑通最簡(jiǎn)單的任務(wù)建立信心然后逐步加復(fù)雜度遇到問題就查、就問、就試最后嘗試自己寫技能、定規(guī)則把工作臺(tái)改造成適合自己的樣子。這個(gè)過程里記錄很重要。我有個(gè)習(xí)慣每次踩坑和解決都記一筆時(shí)間長了就攢出一份自己的避坑清單。這份清單比任何通用教程都有用因?yàn)樗轻槍?duì)我的使用場(chǎng)景的。你也可以這么做用著用著你就成了別人眼里的WorkBuddy 老手。最后分享一個(gè)我自己的體會(huì)WorkBuddy 這類工具的價(jià)值不在于它有多強(qiáng)而在于你愿不愿意花時(shí)間把它調(diào)教成適合你的樣子。默認(rèn)配置能用但用不出彩。真正拉開差距的是那些愿意花時(shí)間定規(guī)則、寫技能、調(diào)配置的人。這個(gè)投入是值得的因?yàn)橐坏┱{(diào)好它每天幫你省下的時(shí)間會(huì)持續(xù)累積。