之前在做 AI 應(yīng)用落地時我經(jīng)常遇到一個很典型的問題單智能體在簡單問答場景表現(xiàn)很好但一旦把“收集資料、拆解大綱、寫初稿、審校潤色”這些任務(wù)全部交給同一個 Agent它就開始顧此失彼——上下文一長早期內(nèi)容被遺忘既要搜索又要寫作角色指令互相干擾輸出格式也經(jīng)常不穩(wěn)定。后來把所有任務(wù)拆分到多個子 Agent交給 Coze 工作流統(tǒng)一調(diào)度整個鏈路才真正穩(wěn)定下來。這篇文章會圍繞 Coze 平臺的多 Agent 協(xié)作展開從核心設(shè)計模式講起再用一個“技術(shù)文章創(chuàng)作團(tuán)隊”的完整案例帶你走通項目空間配置、子 Agent 創(chuàng)建、工作流編排、調(diào)試發(fā)布的全流程。文中會重點拆解“主從調(diào)度”思想以及為什么把子 Agent 當(dāng)作“另類工具”來調(diào)用是當(dāng)前多 Agent 設(shè)計里最實用的思路。如果你已經(jīng)熟悉 Coze 基礎(chǔ)操作想進(jìn)一步把智能體做成真正的“AI 團(tuán)隊”這篇文章正好適合你。1. 背景為什么需要多 Agent 協(xié)作1.1 單智能體的能力邊界先看一個最常見的場景用戶要求“寫一篇關(guān)于 Spring Security 的技術(shù)文章”并且給出關(guān)鍵詞和字?jǐn)?shù)。如果用一個 Agent 完成這件事會出現(xiàn)幾個問題。第一是上下文壓力。一次完整的寫作鏈路至少包含選題、資料補(bǔ)充、正文撰寫、格式調(diào)整四步。單 Agent 在同一個會話里反復(fù)切換任務(wù)早期輸入的信息會被后續(xù)內(nèi)容稀釋尤其當(dāng)用戶要求“參考第一輪討論的結(jié)論”時Agent 很可能已經(jīng)記不清楚。第二是角色沖突。同一個提示詞里既要讓 Agent 扮演“嚴(yán)謹(jǐn)?shù)馁Y料搜集員”又要讓它扮演“有文采的寫作教練”這兩個角色天然有張力。結(jié)果往往是資料部分不夠扎實正文部分又顯得生硬。第三是工具調(diào)用混亂。單 Agent 同時綁定了搜索插件、知識庫、代碼解釋器等工具后Agent 容易在錯誤的時機(jī)調(diào)用錯誤的工具。比如寫技術(shù)文章時頻繁調(diào)用搜索卻忘了先根據(jù)知識庫中的寫作規(guī)范來約束輸出。第四是可維護(hù)性差。所有邏輯都堆在一個巨型提示詞里改一句角色描述可能影響整個輸出風(fēng)格。項目一旦需要多人協(xié)作或復(fù)用這種“超級 Agent”很難維護(hù)。1.2 多 Agent 協(xié)作的核心價值多 Agent 協(xié)作的本質(zhì)是把一個復(fù)雜任務(wù)拆解成多個邊界清晰的子任務(wù)每個子任務(wù)交給獨(dú)立的 Agent 完成再由上層調(diào)度邏輯統(tǒng)一組合結(jié)果。這樣做有三個直接收益。一是職責(zé)聚焦。每個 Agent 只需要專注一件事提示詞可以寫得非常具體不需要在“角色切換”上消耗模型能力。二是上下文隔離。子 Agent 只接收自己需要的最小輸入集不會把無關(guān)信息帶進(jìn)上下文這也從根源上減少了信息污染。三是可編排與可復(fù)用。任務(wù)流程可以用工作流固定下來某個子 Agent 調(diào)優(yōu)后其他環(huán)節(jié)不受影響。而且同一個子 Agent比如“審校優(yōu)化 Agent”可以復(fù)用到文章寫作、PPT 生成、測試用例審核等不同項目里。1.3 適合多 Agent 的場景并不是所有任務(wù)都需要多 Agent。適合用多 Agent 的場景通常有三個特征鏈路長、步驟之間可以拆分、不同步驟對角色能力要求不同。典型場景包括內(nèi)容生產(chǎn)流水線選題策劃、資料檢索、正文撰寫、審校潤色。復(fù)雜報告生成數(shù)據(jù)采集、指標(biāo)分析、可視化建議、報告撰寫。AI 軟件測試工作臺測試用例設(shè)計、測試執(zhí)行、缺陷分析、測試報告生成。客服工單處理用戶意圖識別、知識庫匹配、答案生成、合規(guī)復(fù)核。學(xué)習(xí)輔導(dǎo)助手知識點講解、出題練習(xí)、作業(yè)批改、學(xué)習(xí)計劃制定。以內(nèi)容生產(chǎn)為例單 Agent 也能寫但寫出來的文章往往結(jié)構(gòu)松散、事實性信息缺乏支撐。多 Agent 后每個環(huán)節(jié)由更專業(yè)的角色完成產(chǎn)出質(zhì)量會明顯提升。1.4 Coze 平臺的多 Agent 能力概覽Coze 是一站式智能體開發(fā)平臺核心資源包括項目空間、Agent、工作流、知識庫、插件、變量和發(fā)布渠道。在 Coze 上落地多 Agent通常有兩條路徑在工作流中直接編排多個 Agent 節(jié)點讓不同的子 Agent 按順序或并行執(zhí)行。用主 Agent 作為調(diào)度入口主 Agent 負(fù)責(zé)拆解用戶需求把子 Agent 當(dāng)作能力模塊來調(diào)用。兩條路徑并不互斥實際項目中往往組合使用。這篇文章的實戰(zhàn)案例會以“主工作流 多個子 Agent”的方式演示。需要提醒的是Coze 的界面入口和功能名稱迭代比較快你看到的按鈕位置可能和我描述的有差異但核心概念和設(shè)計思路是通用的。2. 多 Agent 協(xié)作的核心模式2.1 串行流水線模式串行模式是最直觀的協(xié)作方式Agent A 的輸出作為 Agent B 的輸入依次傳遞。例如用戶輸入標(biāo)題 ↓ 選題策劃 Agent 生成大綱 ↓ 內(nèi)容撰寫 Agent 根據(jù)大綱生成初稿 ↓ 審校優(yōu)化 Agent 輸出終稿這種模式的優(yōu)點是邏輯清晰、容易調(diào)試。缺點是鏈路耗時較長而且前面節(jié)點如果輸出質(zhì)量差會直接影響后面所有節(jié)點。串行模式適合步驟之間存在強(qiáng)依賴關(guān)系的場景。比如“先有大綱才能寫正文”兩個步驟無法并行。2.2 并行分發(fā)模式在很多任務(wù)里子任務(wù)之間并不存在依賴關(guān)系。比如收集資料和設(shè)計大綱可以同時進(jìn)行。并行分發(fā)模式由一個分發(fā)節(jié)點把任務(wù)拆開多個子 Agent 并行運(yùn)行最后再匯總結(jié)果。用戶輸入標(biāo)題 ↓ 分發(fā)節(jié)點同時調(diào)用 ├── 選題策劃 Agent ├── 資料檢索 Agent └── 素材整理 Agent ↓ 匯總節(jié)點合并所有輸出這種模式可以顯著縮短整體耗時但要注意子 Agent 數(shù)量不要太多否則會產(chǎn)生較高的并發(fā)調(diào)用成本也容易讓匯總節(jié)點處理不過來。2.3 主從調(diào)度模式主從調(diào)度模式是當(dāng)前多 Agent 設(shè)計里很主流的一種做法。主 Agent 類似于“項目負(fù)責(zé)人”它負(fù)責(zé)理解用戶需求、拆解任務(wù)、選擇合適的子 Agent、驗證中間結(jié)果最后匯總輸出。從調(diào)用關(guān)系上看主 Agent 是調(diào)用方子 Agent 是被調(diào)用方。主 Agent 不關(guān)心子 Agent 內(nèi)部具體怎么推理只關(guān)心輸入輸出是否符合約定。這種模式在實際應(yīng)用中更靈活。用戶直接和主 Agent 對話不需要感知背后有幾個子 Agent。主 Agent 可以根據(jù)不同問題動態(tài)決定調(diào)用哪些能力而不是把整個流程寫死。2.4 將子 Agent 視為“另類工具”很多人在設(shè)計多 Agent 時容易把子 Agent 想象成“團(tuán)隊成員”給每個 Agent 特別擬人化的設(shè)定結(jié)果反而忽略了接口設(shè)計。在最新的多 Agent 設(shè)計中有一個非常實用的視角把子 Agent 當(dāng)作另類的 Tool 進(jìn)行調(diào)用。傳統(tǒng)插件工具是確定性的 API 調(diào)用輸入固定參數(shù)返回固定結(jié)構(gòu)。子 Agent 表面上是一個“智能體”但站在上層調(diào)度邏輯的角度它同樣是一個封裝好的能力函數(shù)只是內(nèi)部由大模型驅(qū)動可以處理更復(fù)雜的非結(jié)構(gòu)化輸入。用這個視角設(shè)計系統(tǒng)你會更關(guān)注三件事子 Agent 的輸入輸出契約是否清晰。子 Agent 的調(diào)用成本是否可控。子 Agent 的失敗模式是什么上層如何兜底。這種“工具化”思維能讓多 Agent 系統(tǒng)更穩(wěn)定、更容易工程化落地。3. 實戰(zhàn)案例技術(shù)文章創(chuàng)作團(tuán)隊3.1 為什么選“技術(shù)文章創(chuàng)作團(tuán)隊”選這個案例有三個原因。第一寫技術(shù)文章是很多開發(fā)者熟悉的場景理解成本低。第二寫作鏈路足夠長能體現(xiàn)多 Agent 分工的價值。第三案例可以復(fù)用到其他內(nèi)容類應(yīng)用比如生成 PPT 大綱、生成測試報告、生成產(chǎn)品方案。這個案例的目標(biāo)是用戶輸入一個技術(shù)主題和關(guān)鍵詞系統(tǒng)自動輸出一篇結(jié)構(gòu)清晰、有事實支撐、格式規(guī)范的技術(shù)文章。3.2 整體協(xié)作流程案例整體流程采用“并行 串行”混合編排用戶輸入標(biāo)題、關(guān)鍵詞、目標(biāo)讀者 ↓ 主調(diào)度入口 ↓ 并行執(zhí)行 ├── 選題策劃 Agent輸出標(biāo)題候選和大綱 └── 資料檢索 Agent輸出事實清單和示例 ↓ 內(nèi)容撰寫 Agent根據(jù)大綱和資料生成初稿 ↓ 審校優(yōu)化 Agent檢查質(zhì)量、優(yōu)化表達(dá)、輸出終稿你可以在 Coze 中把它實現(xiàn)為一條主工作流前面兩個分支并行后面兩個節(jié)點串行。3.3 子 Agent 的職責(zé)與輸入輸出契約在開始創(chuàng)建 Agent 之前先把每個角色的職責(zé)和輸入輸出約定清楚。這一步非常重要工作流編排是否順暢完全取決于契約設(shè)計是否清晰。子 Agent職責(zé)輸入字段輸出字段選題策劃 Agent拆解用戶主題生成大綱title, keywords, audiencetitle_list, outline, word_count_plan資料檢索 Agent補(bǔ)充事實性信息outline, keywords, search_scopefacts, examples, source_notes內(nèi)容撰寫 Agent根據(jù)大綱和資料生成初稿outline, facts, examples, styledraft審校優(yōu)化 Agent檢查質(zhì)量并潤色draft, review_rulesfinal_article, issues我建議在 Coze 的提示詞里直接用字段名描述輸入輸出例如“輸出格式必須包含 draft 字段”這樣后續(xù)工作流映射字段時不會混亂。3.4 協(xié)作流程中的并行與串行選題策劃和資料檢索之間沒有依賴關(guān)系適合并行執(zhí)行。但內(nèi)容撰寫必須等前兩者都結(jié)束才能開始審校優(yōu)化必須等初稿完成才能執(zhí)行。從性能角度考慮并行可以讓第一個版本的整體耗時降低約三分之一。從穩(wěn)定角度考慮串行環(huán)節(jié)越少出錯時越容易定位。所以這個案例是一個比較平衡的設(shè)計。4. 環(huán)境準(zhǔn)備與項目空間配置4.1 注冊賬號與新增項目空間在開始創(chuàng)建 Agent 前需要先注冊 Coze 賬號并完成登錄。登錄后第一步不是直接創(chuàng)建 Agent而是先規(guī)劃項目空間。項目空間是管理智能體、工作流、知識庫、插件、變量等資源的地方。推薦按“團(tuán)隊 項目”的維度來劃分空間。例如你可以創(chuàng)建一個名為“AI 內(nèi)容創(chuàng)作中臺”的項目空間專門承載所有內(nèi)容類智能體。創(chuàng)建項目空間時通常只需要填寫空間名稱、簡介和成員權(quán)限。如果你只是個人練習(xí)可以先用單成員空間重點是理解空間的資源組織邏輯。4.2 項目空間內(nèi)的資源規(guī)劃進(jìn)入項目空間后建議先規(guī)劃好要創(chuàng)建哪些資源而不是想到什么創(chuàng)建什么。以本文案例為例規(guī)劃如下Agent1 個主調(diào)度 Agent4 個子 Agent。工作流1 條主工作流承載整個協(xié)作流程。知識庫1 個“技術(shù)寫作規(guī)范庫”存放文章結(jié)構(gòu)模板和表達(dá)規(guī)范。插件搜索插件供資料檢索 Agent 使用。變量寫作風(fēng)格偏好、目標(biāo)讀者默認(rèn)值。如果把所有 Agent 都放在同一個空間調(diào)試時找資源會方便很多。但如果項目進(jìn)入生產(chǎn)階段建議把開發(fā)環(huán)境和正式環(huán)境拆成不同的空間。4.3 成員權(quán)限與環(huán)境隔離Coze 的項目空間支持配置成員權(quán)限。即使你是個人練習(xí)也應(yīng)該養(yǎng)成最小權(quán)限的習(xí)慣每個成員只分配完成工作所需的最小權(quán)限組合。涉及外部系統(tǒng)調(diào)用時API Token 等敏感信息建議通過變量管理不要在提示詞或代碼節(jié)點中硬編碼。版本方面Coze 迭代頻繁發(fā)布功能變化較快。生產(chǎn)環(huán)境變更前建議在獨(dú)立測試空間中驗證再通過發(fā)布流程同步到正式環(huán)境避免直接修改線上可用的智能體。5. 創(chuàng)建子 Agent 與角色分工5.1 子 Agent 的通用創(chuàng)建步驟在 Coze 中創(chuàng)建子 Agent 的常見路徑是在項目空間的 Agent 管理頁面點擊創(chuàng)建填寫名稱和描述再配置提示詞、模型、知識庫、插件等。子 Agent 雖然可以被工作流調(diào)用但它本身也可以獨(dú)立對話。為了讓其適合被調(diào)度創(chuàng)建時應(yīng)重點配置兩件事清晰的人設(shè)、嚴(yán)格的輸出格式。下面我會給出四個子 Agent 的提示詞配置示例你可以在實際創(chuàng)建時根據(jù)自己的業(yè)務(wù)調(diào)整。示例中用到的字段名需要與工作流中的變量名保持一致。5.2 選題策劃 Agent 配置示例這個 Agent 負(fù)責(zé)把用戶模糊的主題變成可執(zhí)行的文章大綱。你是「選題策劃 Agent」負(fù)責(zé)把用戶給出的技術(shù)主題拆解成結(jié)構(gòu)清晰的文章大綱。 輸入字段 - title用戶輸入的主題 - keywords相關(guān)關(guān)鍵詞列表 - audience目標(biāo)讀者 處理要求 1. 根據(jù)受眾判斷文章的深度和側(cè)重點。 2. 輸出 3 個候選標(biāo)題要求具體、有信息量。 3. 設(shè)計一級和二級大綱每個部分給出目標(biāo)字?jǐn)?shù)。 輸出格式嚴(yán)格 JSON { title_list: [標(biāo)題1, 標(biāo)題2, 標(biāo)題3], outline: [ {section: 一級標(biāo)題, subsections: [二級標(biāo)題1, 二級標(biāo)題2], word_count: 800} ], word_count_plan: 全文目標(biāo)字?jǐn)?shù)與各部分分配說明 } 注意不要編寫正文不要編造引用來源。5.3 資料檢索 Agent 配置示例資料檢索 Agent 的核心職責(zé)是給后續(xù)寫作提供事實性素材。它需要綁定搜索插件也可以掛載你自己的知識庫。你是「資料檢索 Agent」負(fù)責(zé)根據(jù)文章大綱和關(guān)鍵詞補(bǔ)充可靠的事實性信息。 輸入字段 - outline文章大綱 - keywords關(guān)鍵詞列表 - search_scope檢索范圍說明例如“僅使用本文檔庫”或“使用互聯(lián)網(wǎng)搜索” 處理要求 1. 每個大綱小節(jié)至少補(bǔ)充 2 條相關(guān)信息。 2. 每條信息必須注明來源無法確認(rèn)的信息標(biāo)為“待確認(rèn)”。 3. 禁止編造統(tǒng)計數(shù)據(jù)和引用。 輸出格式嚴(yán)格 JSON { facts: [ {section: 對應(yīng)大綱小節(jié), fact: 事實內(nèi)容, source: 來源說明, confidence: high/medium/low} ], examples: [可直接使用的示例片段], source_notes: 檢索過程中的補(bǔ)充說明 }5.4 內(nèi)容撰寫 Agent 配置示例內(nèi)容撰寫 Agent 是整個流程中最核心的角色。它負(fù)責(zé)把大綱和事實清單轉(zhuǎn)化成一篇可讀性高的技術(shù)文章初稿。你是「內(nèi)容撰寫 Agent」負(fù)責(zé)根據(jù)大綱和資料清單生成結(jié)構(gòu)化技術(shù)文章初稿。 輸入字段 - outline文章大綱 - facts事實清單 - style寫作風(fēng)格偏好例如“教程式”“筆記式”“工程復(fù)盤式” 處理要求 1. 嚴(yán)格按照 outline 組織章節(jié)結(jié)構(gòu)。 2. 正文中使用 facts 中的事實不要自行編造。 3. 每個章節(jié)至少包含一個可運(yùn)行示例或配置片段。 4. 代碼塊使用 Markdown 格式并標(biāo)注語言。 輸出格式嚴(yán)格 JSON { draft: 完整的 Markdown 格式文章初稿, used_facts: [正文中實際使用的事實條目ID] }5.5 審校優(yōu)化 Agent 配置示例審校優(yōu)化 Agent 負(fù)責(zé)最后一道質(zhì)量關(guān)口主要包括結(jié)構(gòu)檢查、事實核對、表達(dá)潤色、格式規(guī)范。你是「審校優(yōu)化 Agent」負(fù)責(zé)對技術(shù)文章初稿進(jìn)行質(zhì)量檢查和表達(dá)優(yōu)化。 輸入字段 - draft待審校的文章初稿 - review_rules審校規(guī)則列表例如“標(biāo)題層級正確”“代碼塊完整”“無重復(fù)段落” 處理要求 1. 先輸出問題清單再輸出優(yōu)化后的全文。 2. 修改時必須保留原意不改變技術(shù)結(jié)論。 3. 如果初稿引用了“待確認(rèn)”信息必須在問題清單中突出提醒。 輸出格式嚴(yán)格 JSON { issues: [ {type: 結(jié)構(gòu)/事實/表達(dá)/格式, description: 問題描述, suggestion: 修改建議} ], final_article: 優(yōu)化后的完整 Markdown 文章 }5.6 約定子 Agent 的輸入輸出契約四個子 Agent 創(chuàng)建完成后建議用一個統(tǒng)一契約文檔記錄字段定義。即使是個人項目這個文檔也能幫你減少調(diào)試時“字段對不上”的問題。契約文檔可以用 Markdown 表格維護(hù)放在項目空間的知識庫或本地代碼倉庫里。后續(xù)新增子 Agent 時先補(bǔ)充契約再寫提示詞和節(jié)點編排。6. 工作流編排將子 Agent 當(dāng)作工具調(diào)度6.1 創(chuàng)建主工作流創(chuàng)建主工作流后你會看到一個畫布左側(cè)是可以拖拽的節(jié)點類型。本案例需要用到以下節(jié)點開始節(jié)點接收用戶輸入。Agent 節(jié)點調(diào)用已創(chuàng)建的子 Agent。并行節(jié)點讓多個 Agent 節(jié)點同時執(zhí)行。結(jié)束節(jié)點返回最終文章。開始節(jié)點一般需要三個輸入字段title、keywords、audience。字段類型可以設(shè)置為文本類型并為 audience 設(shè)置一個默認(rèn)值方便調(diào)試。6.2 字段映射與節(jié)點連接拖入“選題策劃 Agent”節(jié)點后需要把開始節(jié)點的字段映射到該 Agent 的輸入。這里的映射規(guī)則是開始節(jié)點.title → 選題策劃Agent 輸入 title 開始節(jié)點.keywords → 選題策劃Agent 輸入 keywords 開始節(jié)點.audience → 選題策劃Agent 輸入 audience同樣地拖入“資料檢索 Agent”節(jié)點時需要把開始節(jié)點的 keywords以及選題 Agent 輸出的 outline 作為它的一部分輸入。這里的關(guān)鍵點是字段名必須和子 Agent 提示詞中約定的字段名一致。如果子 Agent 提示詞里寫的是 outline而工作流節(jié)點里傳的是 article_outline就會導(dǎo)致子 Agent 收到空值。6.3 并行節(jié)點讓兩個子 Agent 同時干活在開始節(jié)點之后拖入一個并行節(jié)點把“選題策劃 Agent”和“資料檢索 Agent”都放進(jìn)并行分支里。需要注意的是資料檢索 Agent 依賴 outline而 outline 是選題策劃 Agent 的輸出。如果嚴(yán)格串行執(zhí)行資料檢索只能等選題完成后才能開始。但在實際項目中你可以先讓資料檢索 Agent 根據(jù)關(guān)鍵詞做第一輪泛檢索等大綱出來后再補(bǔ)充一次定向檢索。如果暫時不想做兩輪檢索也可以讓兩者完全并行資料檢索 Agent 只根據(jù)關(guān)鍵詞檢索不依賴大綱。這樣實現(xiàn)更簡單適合案例演示。等流程跑通后你再優(yōu)化為兩輪檢索。6.4 用編程思維理解主從調(diào)度如果用偽代碼描述這個主工作流會更接近“將子 Agent 當(dāng)作工具”的編程思維main(input) { // 并行執(zhí)行兩個子Agent類似并發(fā)調(diào)用兩個工具函數(shù) const outlineResult specAgent.call(input) const searchResult searchAgent.call(input) // 串行執(zhí)行內(nèi)容撰寫 const draft writeAgent.call({ outline: outlineResult.outline, facts: searchResult.facts }) // 串行執(zhí)行審校 const final reviewAgent.call({ draft: draft.draft }) return final }這段偽代碼不是 Coze 里的實際配置但思維模型完全一致每個子 Agent 就是一個可調(diào)用的函數(shù)輸入輸出由契約約束上層只負(fù)責(zé)調(diào)度和匯總。6.5 設(shè)置最終輸出主工作流的結(jié)束節(jié)點需要組合多個來源的結(jié)果。推薦把審校 Agent 的 final_article 作為返回主體的內(nèi)容同時把 issues 列表也返回給調(diào)用方方便你判斷是否需要人工介入。如果需要在輸出里追加其他信息可以用一個代碼節(jié)點做拼接。代碼節(jié)點的用法會在下一節(jié)詳細(xì)說明。7. 代碼節(jié)點與外部系統(tǒng)集成示例7.1 JavaScript合并多 Agent 結(jié)果當(dāng)并行節(jié)點返回多個子 Agent 的結(jié)果時你可能會想把這些結(jié)果整理成一份摘要方便后面節(jié)點統(tǒng)一處理。這時可以插入一個 JavaScript 代碼節(jié)點。以下代碼是一個典型的“合并 格式化”示例// 文件路徑工作流代碼節(jié)點 // 輸入parallel_result 并行結(jié)果對象 function main({ parallel_result }) { const spec parallel_result.spec_agent || {}; const search parallel_result.search_agent || {}; const merged { titles: spec.title_list || [], outline: spec.outline || [], facts: search.facts || [], examples: search.examples || [], }; return { output: JSON.stringify(merged), summary: 已合并選題結(jié)果 ${merged.titles.length} 條資料結(jié)果 ${merged.facts.length} 條, }; }在代碼節(jié)點中main函數(shù)的入?yún)⑹巧嫌喂?jié)點傳入的字段集合返回值會作為后續(xù)節(jié)點的輸入。建議在調(diào)試時先打印summary快速確認(rèn)合并結(jié)果是否符合預(yù)期。7.2 Python校驗輸出完整性內(nèi)容撰寫 Agent 輸出 draft 后可以在進(jìn)入審校節(jié)點前增加一個校驗節(jié)點避免空文章或字段缺失進(jìn)入下一步。# 文件路徑工作流代碼節(jié)點 # 輸入draft_result 由內(nèi)容撰寫Agent返回 def main(draft_result: dict) - dict: draft draft_result.get(draft, ) required_sections [背景, 環(huán)境準(zhǔn)備, 總結(jié)] missing_sections [] for section in required_sections: if section not in draft: missing_sections.append(section) is_valid len(missing_sections) 0 and len(draft) 100 return { is_valid: is_valid, missing_sections: missing_sections, draft_length: len(draft), }這種節(jié)點不直接生成內(nèi)容但能顯著提升工作流的穩(wěn)定性。遇到輸出異常時你能快速定位是生成環(huán)節(jié)的問題還是契約字段的問題。7.3 調(diào)用外部 API 與敏感信息管理Coze 工作流支持通過 HTTP 請求節(jié)點調(diào)用外部 API。常見的場景包括把生成的文章同步到自己的 CMS、調(diào)用內(nèi)部服務(wù)生成圖片、發(fā)送到飛書群通知等。調(diào)用外部 API 時建議遵循以下規(guī)范API 地址和請求參數(shù)使用變量管理不要寫死在節(jié)點配置里。密鑰 Token 使用 Coze 的變量或密鑰管理能力不要在提示詞、代碼和日志中明文展示。外部接口調(diào)用失敗時增加錯誤分支或重試機(jī)制而不是讓工作流直接失敗。請求第三方服務(wù)前確認(rèn)對方接口的授權(quán)范圍和調(diào)用限制避免觸發(fā)越權(quán)或濫用風(fēng)險。由于 Coze 的開放 API 地址在不同地域和版本中存在差異具體請求地址、鑒權(quán)方式和參數(shù)格式請以當(dāng)前 Coze 平臺的接口文檔為準(zhǔn)示例只是通用思路。7.4 擴(kuò)展Markdown 轉(zhuǎn) Word 或 PPT很多技術(shù)博主會希望把生成的文章直接導(dǎo)出成 Word 或 PPT。在 Coze 中實現(xiàn)這類轉(zhuǎn)換一般走兩種思路用代碼節(jié)點實現(xiàn)轉(zhuǎn)換但要先確認(rèn)代碼節(jié)點的運(yùn)行環(huán)境是否包含對應(yīng)的轉(zhuǎn)換庫。不同迭代版本中運(yùn)行環(huán)境支持情況不一樣需要以實際環(huán)境為準(zhǔn)。將 Agent 輸出格式統(tǒng)一為規(guī)范 Markdown再通過外部轉(zhuǎn)換服務(wù)或插件把 Markdown 轉(zhuǎn)成 docx、pptx。更推薦第二種思路。因為 Agent 負(fù)責(zé)生成內(nèi)容轉(zhuǎn)換任務(wù)交給更穩(wěn)定的確定性服務(wù)職責(zé)邊界更清晰。如果以后要接入文章發(fā)布平臺這種設(shè)計也能復(fù)用同一套內(nèi)容流。8. 調(diào)試、測試與發(fā)布8.1 在調(diào)試面板中逐節(jié)點驗證工作流創(chuàng)建完成后先在調(diào)試面板中運(yùn)行一次。建議用真實輸入測試?yán)鐦?biāo)題Spring Boot 整合 Apollo 配置中心實戰(zhàn) 關(guān)鍵詞Spring Boot, Apollo, 配置中心 目標(biāo)讀者有 Spring Boot 基礎(chǔ)的后端開發(fā)者運(yùn)行后逐個點擊節(jié)點查看輸入輸出。你可以發(fā)現(xiàn)哪些節(jié)點輸出異常是提示詞問題還是字段映射問題。需要注意Coze 工作流的調(diào)試面板通常會記錄每個節(jié)點的詳細(xì)運(yùn)行日志你應(yīng)養(yǎng)成“先看日志、再改配置”的習(xí)慣。日志里的報錯信息遠(yuǎn)比表面現(xiàn)象更有排查價值。8.2 避免輸出格式漂移的調(diào)試技巧大模型輸出的格式不穩(wěn)定是多 Agent 工作流最常見的問題。即使提示詞里寫了“嚴(yán)格 JSON”偶爾還會出現(xiàn)多余的解釋文本。解決思路有三個在提示詞中給出一個“最小示例”模型會更容易模仿。在代碼節(jié)點中增加解析容錯邏輯比如用正則提取 JSON 片段后解析。把“格式校驗”作為一個獨(dú)立節(jié)點校驗不通過時走分支重新生成。不要指望提示詞一次寫完美多輪調(diào)試是正常的。建議把調(diào)試過程中調(diào)整過的提示詞版本記錄下來方便對比效果。8.3 發(fā)布到 WebApp 或 API流程調(diào)通后可以發(fā)布到 WebApp得到一個可分享的網(wǎng)頁鏈接適合內(nèi)部測試或給非技術(shù)人員體驗。如果希望外部系統(tǒng)調(diào)用這條多 Agent 流程需要了解平臺提供的開放接口能力。發(fā)布后通常需要配置 API Token并在請求中攜帶 Bot ID 或工作流 ID。調(diào)用方身份、請求頻率、數(shù)據(jù)范圍都需要在平臺側(cè)做好限制。發(fā)布到生產(chǎn)環(huán)境前建議再檢查一遍是否測試過異常輸入密鑰是否已經(jīng)替換為生產(chǎn)變量知識庫版本是否最新這些檢查項看起來基礎(chǔ)卻能避免線上事故。9. 常見問題與排查9.1 高頻問題速查表問題現(xiàn)象常見原因解決思路子 Agent 節(jié)點長時間無響應(yīng)子 Agent 內(nèi)部工作流復(fù)雜或模型響應(yīng)慢精簡提示詞、更換更快模型、降低并行 Agent 數(shù)量輸出 JSON 格式不穩(wěn)定提示詞約束不夠或沒有提供示例補(bǔ)充輸出示例增加格式校驗節(jié)點工作流返回字段為空字段映射錯誤或子 Agent 輸出字段名不一致檢查提示詞中的字段名與節(jié)點映射是否一致資料檢索內(nèi)容偏少搜索關(guān)鍵詞太少或知識庫未正確配置增加同義詞關(guān)鍵詞檢查知識庫分段方式文章風(fēng)格不符合預(yù)期寫作風(fēng)格字段傳空或默認(rèn)值不合理在變量中配置默認(rèn)風(fēng)格并在子 Agent 提示詞中強(qiáng)化風(fēng)格要求9.2 典型問題詳細(xì)排查如果你遇到“內(nèi)容撰寫 Agent 生成的文章引用來源是編造的”需要重點排查資料檢索 Agent 的輸出。事實核查通常不能只靠“審校優(yōu)化 Agent”自己判斷因為審校 Agent 也無法知道哪些信息是真實的。更穩(wěn)妥的方案是在資料檢索 Agent 中強(qiáng)制輸出 source 和 confidence 字段在內(nèi)容撰寫 Agent 中提示“只允許使用 facts 中 confidence 為 high 的信息”。這樣可以在源頭控制風(fēng)險而不是等到最后再糾錯。如果遇到“工作流運(yùn)行失敗但日志顯示每個節(jié)點都成功”則問題大概率出在節(jié)點間的返回值傳遞上。你可以在代碼節(jié)點中增加 try-catch把異常信息轉(zhuǎn)為工作流輸出避免失敗原因被吞掉。10. 最佳實踐與工程建議10.1 從單 Agent 到多 Agent 的遷移路徑不建議新項目直接堆五個子 Agent。即使你理解了多 Agent 的好處也應(yīng)該控制復(fù)雜度。推薦路徑是先用一個 Agent 跑通主流程。找到最容易出問題的環(huán)節(jié)把它拆成獨(dú)立子 Agent。驗證拆分后效果確實提升再繼續(xù)拆分下一個環(huán)節(jié)。多 Agent 不是越多越好。每個子 Agent 都意味著一次額外的大模型調(diào)用成本和一次出錯風(fēng)險。只有當(dāng)一個環(huán)節(jié)因為“角色負(fù)擔(dān)過重”而明顯影響質(zhì)量時才值得單獨(dú)拆出來。10.2 子 Agent 契約與提示詞管理把提示詞當(dāng)成代碼來管理。為每個 Agent 維護(hù)獨(dú)立的版本記錄修改時間和修改原因。子 Agent 的輸入輸出契約要像接口文檔一樣明確。尤其是項目進(jìn)入多人協(xié)作階段后契約不清晰會造成大量返工。一個人約定了 camelCase另一個人用了 snake_case兩個 Agent 對接時自然失敗。10.3 成本、性能與模型選型多 Agent 工作流的成本由兩部分組成模型調(diào)用次數(shù)和單次調(diào)用 token 量?？刂瞥杀镜某Ｓ檬侄伟懿⑿械娜蝿?wù)盡量并行減少等待時間。簡單任務(wù)使用更快、更便宜的模型復(fù)雜推理任務(wù)才使用更強(qiáng)模型。盡量向子 Agent 傳遞最小化文本避免把整篇長文重復(fù)傳給每個子 Agent。緩存重復(fù)查詢的結(jié)果比如知識庫檢索結(jié)果避免多次調(diào)用大模型。在 Coze 中不同模型的上下文長度和計費(fèi)方式有差異。你要根據(jù)任務(wù)復(fù)雜度選擇合適的模型而不是所有 Agent 都默認(rèn)用最強(qiáng)的模型。10.4 安全、權(quán)限與發(fā)布規(guī)范多 Agent 系統(tǒng)涉及多個子 Agent 和外部資源安全邊界需要格外注意。操作規(guī)范如下敏感 Token 不進(jìn)入提示詞、代碼節(jié)點或日志。子 Agent 不需要的知識庫和插件不要綁定給它遵循最小權(quán)限原則。發(fā)布到公開 WebApp 前先確認(rèn)是否有信息泄露風(fēng)險。涉及外部 API 寫入操作時先在小范圍測試環(huán)境中驗證確認(rèn)無誤后再開放生產(chǎn)權(quán)限。如果工作流涉及用戶上傳的文檔或數(shù)據(jù)要確保數(shù)據(jù)使用范圍符合平臺規(guī)則和你的合規(guī)要求。10.5 版本管理與灰度發(fā)布Coze 平臺迭代很快智能體發(fā)布和版本管理能力會逐步增強(qiáng)。即使當(dāng)前用的是簡單流程也應(yīng)該保持“先測試、再發(fā)布”的習(xí)慣。建議按照“開發(fā)空間 → 測試空間 → 生產(chǎn)空間”的思路來組織項目空間。開發(fā)階段可以隨意調(diào)試測試空間驗證完整流程生產(chǎn)空間只承載穩(wěn)定版本。當(dāng)你調(diào)整了某個子 Agent 的提示詞后先在測試空間跑一遍典型用例觀察是否會影響到其他環(huán)節(jié)的輸出。不要為了節(jié)省時間而跳過回歸測試。11. 總結(jié)與學(xué)習(xí)路線這篇文章從單智能體的能力瓶頸出發(fā)介紹了多 Agent 協(xié)作的三種核心模式重點講解了“將子 Agent 當(dāng)作另類工具”的主從調(diào)度思想。接著用一個技術(shù)文章創(chuàng)作團(tuán)隊案例帶你走通了項目空間配置、四個子 Agent 的創(chuàng)建、主工作流編排、代碼節(jié)點調(diào)試、發(fā)布以及常見問題排查。下一步你可以嘗試把這個方案復(fù)用到自己的場景里。比如構(gòu)建一個“AI 軟件測試工作臺”拆解出測試設(shè)計 Agent、測試執(zhí)行 Agent、缺陷分析 Agent 和報告生成 Agent整體設(shè)計邏輯和本文案例幾乎一致。也可以做“PPT 生成工作流”讓選題 Agent 負(fù)責(zé)拆大綱內(nèi)容 Agent 負(fù)責(zé)輸出每頁要點再由外部插件渲染成 PPT 文件。建議你先從兩個子 Agent 的小實驗開始調(diào)通之后再逐步增加角色。過程中重點觀察兩件事子 Agent 的輸出質(zhì)量是否真的因為分工而提升以及整體耗時和成本是否處于可接受范圍。多 Agent 協(xié)作不是銀彈但它確實是突破單智能體能力局限的一條有效路徑。如果你在 Coze 上折騰多 Agent 時卡在某個環(huán)節(jié)歡迎留言交流。