建簡歷篩選智能體實(shí)戰(zhàn)指南)
在實(shí)際 AI 應(yīng)用開發(fā)中將大模型能力與具體業(yè)務(wù)流程結(jié)合是提升效率和自動(dòng)化水平的關(guān)鍵。Coze扣子平臺(tái)提供的工作流Workflow功能允許開發(fā)者通過可視化編排的方式將多個(gè) AI 模型、代碼節(jié)點(diǎn)、條件判斷和外部工具連接起來構(gòu)建復(fù)雜的智能體Agent。對(duì)于許多開發(fā)者而言從零開始設(shè)計(jì)一個(gè)高效、穩(wěn)定且能處理復(fù)雜邏輯的工作流并非易事常?？ㄔ诹鞒淘O(shè)計(jì)、節(jié)點(diǎn)選擇和調(diào)試上。本文將以一個(gè)實(shí)際場景為例帶你從零開始在 Coze 平臺(tái)上搭建一個(gè)具備完整邏輯的工作流智能體。我們將聚焦于“簡歷篩選”這一常見需求構(gòu)建一個(gè)能自動(dòng)解析簡歷、評(píng)估匹配度并生成結(jié)構(gòu)化報(bào)告的智能體。整個(gè)過程無需編寫復(fù)雜代碼但會(huì)深入解釋每個(gè)節(jié)點(diǎn)的作用、參數(shù)配置的邏輯以及排錯(cuò)的關(guān)鍵點(diǎn)確保你能理解其工作機(jī)制并能舉一反三應(yīng)用到其他場景中。1. 理解 Coze 工作流與智能體的核心概念在動(dòng)手搭建之前需要厘清幾個(gè)核心概念及其關(guān)系這是設(shè)計(jì)出合理工作流的基礎(chǔ)。1.1 什么是智能體Agent與工作流Workflow在 Coze 平臺(tái)中智能體是一個(gè)具備特定目標(biāo)和能力的 AI 實(shí)體。你可以把它理解為一個(gè)虛擬助手它能夠理解用戶意圖、調(diào)用工具、處理信息并給出反饋。一個(gè)智能體的核心能力由三部分構(gòu)成預(yù)設(shè)指令Prompt、知識(shí)庫和插件/工作流。工作流則是實(shí)現(xiàn)智能體復(fù)雜能力的引擎。當(dāng)智能體需要執(zhí)行一系列有順序、有條件分支或需要混合多種能力如調(diào)用大模型、執(zhí)行代碼、訪問數(shù)據(jù)庫的任務(wù)時(shí)單純依靠一個(gè)對(duì)話大模型是不夠的。工作流通過可視化的“節(jié)點(diǎn)”和“邊”來定義這個(gè)執(zhí)行流程。每個(gè)節(jié)點(diǎn)代表一個(gè)處理步驟例如調(diào)用模型、運(yùn)行 Python 代碼、判斷條件節(jié)點(diǎn)之間的連線定義了數(shù)據(jù)流動(dòng)的方向和邏輯順序。簡單來說智能體定義了“做什么”和“對(duì)外交互的界面”而工作流定義了“具體怎么做”的詳細(xì)步驟。一個(gè)智能體可以包含多個(gè)工作流用于處理不同類型的用戶請(qǐng)求。1.2 工作流中的關(guān)鍵節(jié)點(diǎn)類型Coze 工作流編輯器提供了多種節(jié)點(diǎn)理解其用途是設(shè)計(jì)流程的關(guān)鍵開始節(jié)點(diǎn)工作流的唯一入口接收來自智能體對(duì)話或外部觸發(fā)的輸入?yún)?shù)。大語言模型節(jié)點(diǎn)核心節(jié)點(diǎn)用于調(diào)用云端大模型如 GPT-4、DeepSeek 等進(jìn)行文本理解、生成或分析。你需要配置具體的模型、溫度Temperature、最大輸出長度等參數(shù)。代碼節(jié)點(diǎn)支持 Python 和 JavaScript。用于執(zhí)行模型無法直接完成的邏輯計(jì)算、數(shù)據(jù)處理、調(diào)用第三方 API需注意網(wǎng)絡(luò)策略等。這是連接 AI 與傳統(tǒng)編程的關(guān)鍵。條件判斷節(jié)點(diǎn)根據(jù)上游節(jié)點(diǎn)的輸出結(jié)果通常是某個(gè)變量的值決定流程下一步走向哪個(gè)分支。這是實(shí)現(xiàn)邏輯智能的核心。變量節(jié)點(diǎn)用于定義、賦值或修改變量。工作流中的變量可以存儲(chǔ)中間結(jié)果并在不同節(jié)點(diǎn)間傳遞。知識(shí)庫節(jié)點(diǎn)從你上傳到 Coze 的知識(shí)庫文件中檢索相關(guān)信息為模型提供上下文。插件節(jié)點(diǎn)調(diào)用預(yù)置或自定義的插件例如搜索網(wǎng)頁、生成圖片、查詢天氣等。1.3 設(shè)計(jì)工作流的通用思路一個(gè)健壯的工作流設(shè)計(jì)通常遵循以下步驟明確輸入與輸出首先確定工作流需要用戶提供什么如一份簡歷文本、一個(gè)崗位描述最終要輸出什么如匹配度分?jǐn)?shù)、評(píng)估報(bào)告。拆解處理步驟將任務(wù)分解為多個(gè)原子步驟。例如解析簡歷文本 - 提取關(guān)鍵信息 - 與崗位要求對(duì)比 - 計(jì)算匹配度 - 格式化報(bào)告。選擇節(jié)點(diǎn)實(shí)現(xiàn)為每個(gè)步驟分配合適的節(jié)點(diǎn)。文本解析和對(duì)比可以用大模型節(jié)點(diǎn)計(jì)算分?jǐn)?shù)可以用代碼節(jié)點(diǎn)根據(jù)分?jǐn)?shù)高低生成不同評(píng)語可以用條件判斷節(jié)點(diǎn)。定義數(shù)據(jù)流規(guī)劃每個(gè)步驟產(chǎn)生的數(shù)據(jù)如何傳遞給下一個(gè)步驟。這決定了節(jié)點(diǎn)之間如何連線以及變量如何命名。設(shè)置異常處理考慮可能出錯(cuò)的地方如簡歷格式無法解析、API調(diào)用失敗并通過條件判斷或默認(rèn)值提供降級(jí)方案。2. 環(huán)境準(zhǔn)備與 Coze 平臺(tái)配置開始搭建前你需要完成賬號(hào)和基礎(chǔ)的平臺(tái)配置。2.1 注冊(cè)與訪問訪問 Coze 官網(wǎng)并注冊(cè)賬號(hào)。目前平臺(tái)提供免費(fèi)額度足以完成本教程的學(xué)習(xí)和測試。登錄后進(jìn)入主控臺(tái)你會(huì)看到“創(chuàng)建 Bot”的入口。2.2 創(chuàng)建智能體Bot點(diǎn)擊“創(chuàng)建 Bot”為你的智能體起一個(gè)名字例如“簡歷篩選助手”。預(yù)設(shè)指令這是智能體的“人格”和核心任務(wù)描述。輸入清晰指令至關(guān)重要。注意預(yù)設(shè)指令是引導(dǎo)智能體理解何時(shí)該調(diào)用工作流的關(guān)鍵。例如你可以寫“你是一個(gè)專業(yè)的招聘助手專門幫助 HR 快速篩選簡歷。當(dāng)用戶提供簡歷文本和崗位描述時(shí)你需要調(diào)用內(nèi)置的‘簡歷評(píng)估工作流’來生成詳細(xì)的匹配度報(bào)告。如果用戶只是普通聊天請(qǐng)友好回應(yīng)?！蹦Ｐ瓦x擇在 Bot 設(shè)置中選擇一個(gè)適合的大模型。對(duì)于需要復(fù)雜理解和文本生成的任務(wù)建議選擇能力較強(qiáng)的模型如 GPT-4 系列或 DeepSeek 最新版本。模型的選擇會(huì)直接影響工作流中“大語言模型節(jié)點(diǎn)”的默認(rèn)選項(xiàng)和效果。2.3 理解工作流編輯器界面在智能體編輯頁面找到并點(diǎn)擊“工作流”標(biāo)簽頁然后點(diǎn)擊“創(chuàng)建工作流”。你將進(jìn)入一個(gè)畫布式的編輯器界面主要區(qū)域包括節(jié)點(diǎn)面板左側(cè)列出了所有可用的節(jié)點(diǎn)類型。畫布中間區(qū)域用于拖拽和連接節(jié)點(diǎn)。配置面板右側(cè)區(qū)域當(dāng)選中某個(gè)節(jié)點(diǎn)時(shí)這里會(huì)顯示該節(jié)點(diǎn)的詳細(xì)配置項(xiàng)。運(yùn)行與調(diào)試區(qū)底部區(qū)域可以輸入測試參數(shù)、運(yùn)行工作流并查看每一步的輸出和最終結(jié)果。3. 實(shí)戰(zhàn)搭建“簡歷篩選評(píng)估”工作流現(xiàn)在我們開始構(gòu)建一個(gè)完整的簡歷篩選工作流。該工作流的目標(biāo)是輸入一段簡歷文本和崗位描述JD輸出一份包含匹配度評(píng)分、技能分析、經(jīng)驗(yàn)評(píng)估和綜合建議的報(bào)告。3.1 定義輸入與輸出首先從“節(jié)點(diǎn)面板”拖拽一個(gè)“開始”節(jié)點(diǎn)到畫布。這個(gè)節(jié)點(diǎn)代表工作流的起點(diǎn)。選中開始節(jié)點(diǎn)在右側(cè)配置面板點(diǎn)擊“添加輸入?yún)?shù)”。添加兩個(gè)參數(shù)resume_text(類型字符串)代表簡歷文本。job_description(類型字符串)代表崗位描述。 這些參數(shù)將在測試或從智能體對(duì)話調(diào)用工作流時(shí)傳入。接下來拖拽一個(gè)“變量”節(jié)點(diǎn)將其重命名為“初始化輸出”。我們?cè)谶@里定義最終輸出的結(jié)構(gòu)。在變量節(jié)點(diǎn)的配置中定義一個(gè)名為final_report的變量。將其初始值設(shè)為一個(gè)空的 JSON 對(duì)象例如{ match_score: 0, skill_analysis: , experience_evaluation: , recommendation: }這個(gè)變量將隨著流程推進(jìn)被各個(gè)節(jié)點(diǎn)填充內(nèi)容。3.2 解析簡歷信息拖拽一個(gè)“大語言模型”節(jié)點(diǎn)到畫布命名為“解析簡歷”。連接將“開始”節(jié)點(diǎn)的輸出連線到該節(jié)點(diǎn)。配置模型選擇一個(gè)你擅長的模型。系統(tǒng)提示詞這是指導(dǎo)模型行為的關(guān)鍵。輸入如下內(nèi)容你是一個(gè)專業(yè)的簡歷解析器。請(qǐng)從用戶提供的簡歷文本中提取出結(jié)構(gòu)化的信息。只輸出一個(gè)JSON對(duì)象包含以下字段 - name: 姓名 - years_of_experience: 工作年限數(shù)字 - skills: 技能列表數(shù)組 - education: 最高學(xué)歷 - key_experiences: 關(guān)鍵工作經(jīng)歷簡述字符串100字內(nèi) 簡歷文本{{resume_text}}用戶消息可以留空或簡單寫“請(qǐng)解析這份簡歷”。關(guān)鍵解釋系統(tǒng)提示詞中使用了{(lán){resume_text}}這是一個(gè)變量插值語法。工作流運(yùn)行時(shí)它會(huì)自動(dòng)被替換為從“開始”節(jié)點(diǎn)傳入的resume_text參數(shù)值。這實(shí)現(xiàn)了數(shù)據(jù)在不同節(jié)點(diǎn)間的傳遞。3.3 評(píng)估技能匹配度再拖拽一個(gè)“大語言模型”節(jié)點(diǎn)命名為“評(píng)估技能”。連接將“解析簡歷”節(jié)點(diǎn)的輸出連線到本節(jié)點(diǎn)。配置系統(tǒng)提示詞你是一個(gè)技能匹配專家。請(qǐng)對(duì)比候選人的技能列表和崗位描述評(píng)估匹配度。 候選人技能{{解析簡歷.skills}} 這是一個(gè)數(shù)組 崗位描述{{job_description}} 請(qǐng)輸出一個(gè)JSON對(duì)象 { matched_skills: [列出與JD明確匹配的技能], missing_skills: [列出JD要求但候選人缺乏的技能], skill_match_score: 一個(gè)0-100的整數(shù)分?jǐn)?shù) }用戶消息留空。關(guān)鍵解釋這里使用了{(lán){解析簡歷.skills}}來引用上一個(gè)“解析簡歷”節(jié)點(diǎn)的輸出結(jié)果中的skills字段。這種{{節(jié)點(diǎn)名.輸出字段名}}的語法是工作流中傳遞數(shù)據(jù)的核心方式。3.4 計(jì)算綜合匹配分?jǐn)?shù)并生成報(bào)告現(xiàn)在我們需要綜合技能匹配度和其他因素如年限、經(jīng)驗(yàn)相關(guān)性生成最終報(bào)告。這里引入“代碼節(jié)點(diǎn)”進(jìn)行邏輯計(jì)算。拖拽一個(gè)“代碼節(jié)點(diǎn)”選擇 Python到畫布命名為“計(jì)算綜合分”。連接將“解析簡歷”和“評(píng)估技能”兩個(gè)節(jié)點(diǎn)的輸出都連線到本節(jié)點(diǎn)。這樣代碼節(jié)點(diǎn)就能接收到兩者的數(shù)據(jù)。配置代碼在代碼編輯器中編寫 Python 邏輯。# 輸入?yún)?shù)會(huì)自動(dòng)注入到 input_data 變量中它是一個(gè)字典 parsed_resume input_data[解析簡歷] # 獲取“解析簡歷”節(jié)點(diǎn)的輸出 skill_assessment input_data[評(píng)估技能] # 獲取“評(píng)估技能”節(jié)點(diǎn)的輸出 job_desc input_data[job_description] # 獲取開始節(jié)點(diǎn)的參數(shù) # 從解析結(jié)果中提取工作年限 years_exp parsed_resume.get(years_of_experience, 0) # 從技能評(píng)估中提取技能分?jǐn)?shù) skill_score skill_assessment.get(skill_match_score, 0) # 一個(gè)簡單的綜合分?jǐn)?shù)計(jì)算邏輯示例可根據(jù)業(yè)務(wù)調(diào)整 # 假設(shè)技能分權(quán)重70%年限分權(quán)重30%年限每多一年加5分上限30分 exp_score min(years_exp * 5, 30) final_score int(skill_score * 0.7 exp_score * 0.3) # 準(zhǔn)備報(bào)告文本 skill_analysis f匹配技能{skill_assessment.get(matched_skills, [])}。缺乏技能{skill_assessment.get(missing_skills, [])}。 exp_eval f候選人擁有{years_exp}年經(jīng)驗(yàn)關(guān)鍵經(jīng)歷{parsed_resume.get(key_experiences, )} recommendation 建議面試 if final_score 70 else 建議儲(chǔ)備 if final_score 50 else 暫不匹配 # 輸出結(jié)果后續(xù)節(jié)點(diǎn)可以引用 output { final_score: final_score, skill_analysis: skill_analysis, experience_evaluation: exp_eval, recommendation: recommendation }設(shè)置輸出在代碼節(jié)點(diǎn)的“輸出變量”配置部分將上面代碼中output字典的各個(gè)鍵映射為輸出變量。例如添加一個(gè)輸出變量computed_result其值路徑設(shè)置為output。3.5 組裝最終報(bào)告并結(jié)束流程再拖拽一個(gè)“變量”節(jié)點(diǎn)命名為“組裝報(bào)告”。連接將“計(jì)算綜合分”節(jié)點(diǎn)的輸出連線到本節(jié)點(diǎn)。配置在這個(gè)變量節(jié)點(diǎn)中我們要更新之前定義的final_report變量。選擇“修改變量”操作變量名為final_report。在值表達(dá)式中使用類似 JSON 合并的語法具體取決于平臺(tái)支持可能是函數(shù)或模板{{final_report}} // 先獲取原變量 .match_score {{計(jì)算綜合分.computed_result.final_score}} .skill_analysis {{計(jì)算綜合分.computed_result.skill_analysis}} .experience_evaluation {{計(jì)算綜合分.computed_result.experience_evaluation}} .recommendation {{計(jì)算綜合分.computed_result.recommendation}}或者如果平臺(tái)支持直接賦值{ match_score: {{計(jì)算綜合分.computed_result.final_score}}, skill_analysis: {{計(jì)算綜合分.computed_result.skill_analysis}}, experience_evaluation: {{計(jì)算綜合分.computed_result.experience_evaluation}}, recommendation: {{計(jì)算綜合分.computed_result.recommendation}} }最后拖拽一個(gè)“結(jié)束”節(jié)點(diǎn)到畫布。連接將“組裝報(bào)告”節(jié)點(diǎn)連線到“結(jié)束”節(jié)點(diǎn)。配置結(jié)束節(jié)點(diǎn)在結(jié)束節(jié)點(diǎn)的輸出參數(shù)中添加一個(gè)參數(shù)例如report并將其值設(shè)置為{{final_report}}。這樣當(dāng)工作流完成時(shí)就會(huì)輸出這個(gè)完整的報(bào)告對(duì)象。至此一個(gè)線性的簡歷篩選工作流就搭建完成了。流程為開始 - 解析簡歷 - 評(píng)估技能 - 計(jì)算綜合分 - 組裝報(bào)告 - 結(jié)束。3.6 增加條件判斷分支進(jìn)階為了讓智能體更靈活我們可以增加一個(gè)分支如果簡歷文本明顯過短或無效則直接返回錯(cuò)誤提示不進(jìn)行后續(xù)分析。在“開始”節(jié)點(diǎn)和“解析簡歷”節(jié)點(diǎn)之間插入一個(gè)“條件判斷”節(jié)點(diǎn)。配置條件判斷resume_text的長度是否小于 50 個(gè)字符示例閾值。條件表達(dá)式可能類似len({{resume_text}}) 50創(chuàng)建分支是True分支連線到一個(gè)新的“變量”節(jié)點(diǎn)可命名為“設(shè)置錯(cuò)誤信息”在這里將final_report的recommendation字段修改為“簡歷文本過短無法分析”。然后直接連線到“結(jié)束”節(jié)點(diǎn)。否False分支連線到原來的“解析簡歷”節(jié)點(diǎn)。同時(shí)需要在“結(jié)束”節(jié)點(diǎn)中配置使其能接收來自不同分支的final_report變量。4. 運(yùn)行、調(diào)試與集成到智能體4.1 在工作流編輯器中測試點(diǎn)擊編輯器底部的“運(yùn)行”區(qū)域。在輸入框中為resume_text和job_description提供示例內(nèi)容。{ resume_text: 張三5年Java開發(fā)經(jīng)驗(yàn)精通Spring Boot, MySQL, Redis。本科學(xué)歷。曾負(fù)責(zé)某電商系統(tǒng)后端架構(gòu)設(shè)計(jì)。, job_description: 招聘高級(jí)Java工程師要求3年以上經(jīng)驗(yàn)熟練掌握Spring Cloud, MySQL有高并發(fā)系統(tǒng)設(shè)計(jì)經(jīng)驗(yàn)者優(yōu)先。 }點(diǎn)擊“運(yùn)行”。編輯器會(huì)高亮顯示執(zhí)行路徑并在每個(gè)節(jié)點(diǎn)下方顯示其輸出結(jié)果。仔細(xì)檢查每個(gè)節(jié)點(diǎn)的輸出是否符合預(yù)期。特別是“解析簡歷”節(jié)點(diǎn)是否輸出了正確的 JSON 結(jié)構(gòu)“評(píng)估技能”節(jié)點(diǎn)是否正確識(shí)別了匹配和缺失的技能“計(jì)算綜合分”節(jié)點(diǎn)的 Python 代碼是否有語法錯(cuò)誤計(jì)算結(jié)果是否合理最終“結(jié)束”節(jié)點(diǎn)的輸出是否是一個(gè)完整的報(bào)告 JSON4.2 將工作流發(fā)布并集成到智能體測試無誤后保存工作流并點(diǎn)擊“發(fā)布”。回到智能體Bot的編輯頁面。在“技能”或“工作流”配置部分添加你剛剛創(chuàng)建并發(fā)布的工作流。關(guān)鍵步驟修改智能體的“預(yù)設(shè)指令”明確告知智能體在什么情況下調(diào)用此工作流。例如 “當(dāng)用戶想要評(píng)估簡歷時(shí)他們會(huì)提供簡歷文本和崗位描述。你需要調(diào)用‘簡歷篩選評(píng)估工作流’并將用戶提供的兩部分內(nèi)容分別作為resume_text和job_description參數(shù)傳入。然后將工作流返回的結(jié)構(gòu)化報(bào)告用友好、易讀的格式總結(jié)給用戶?！北４娌l(fā)布智能體。4.3 在智能體對(duì)話界面驗(yàn)證進(jìn)入智能體的對(duì)話界面嘗試發(fā)送如下消息 “請(qǐng)幫我評(píng)估一下這份簡歷[粘貼簡歷文本]崗位要求是[粘貼崗位描述]?！?觀察智能體是否會(huì)正確調(diào)用工作流并返回一份結(jié)構(gòu)化的評(píng)估報(bào)告。5. 常見問題排查與優(yōu)化實(shí)踐即使流程設(shè)計(jì)正確在實(shí)際運(yùn)行中也可能遇到問題。以下是基于此場景的常見排查點(diǎn)。5.1 工作流運(yùn)行失敗排查表問題現(xiàn)象可能原因檢查與解決步驟工作流啟動(dòng)失敗開始節(jié)點(diǎn)的輸入?yún)?shù)未提供或格式錯(cuò)誤。1. 檢查測試時(shí)輸入的 JSON 格式是否正確鍵名是否匹配。2. 檢查從智能體調(diào)用時(shí)參數(shù)傳遞邏輯是否正確。大模型節(jié)點(diǎn)報(bào)錯(cuò)或輸出格式不符1. 提示詞指令不清晰。2. 模型上下文長度超限。3. 輸入變量插值失敗值為空或格式錯(cuò)誤。1. 簡化并明確系統(tǒng)提示詞強(qiáng)調(diào)輸出格式如“只輸出 JSON”。2. 檢查輸入的文本是否過長嘗試截?cái)唷?. 在節(jié)點(diǎn)配置中檢查變量引用{{xxx}}的拼寫是否正確上游節(jié)點(diǎn)是否有對(duì)應(yīng)輸出。代碼節(jié)點(diǎn)執(zhí)行錯(cuò)誤1. Python 語法錯(cuò)誤。2. 引用了不存在的輸入變量。3. 第三方庫未安裝Coze 代碼節(jié)點(diǎn)有預(yù)裝環(huán)境但非標(biāo)準(zhǔn)庫可能缺失。1. 仔細(xì)閱讀代碼節(jié)點(diǎn)的錯(cuò)誤信息定位行號(hào)。2. 使用print(input_data)調(diào)試輸入數(shù)據(jù)結(jié)構(gòu)。3. 確認(rèn)代碼中使用的庫在 Coze 沙箱環(huán)境中可用。條件判斷未按預(yù)期分支條件表達(dá)式邏輯錯(cuò)誤或變量值類型不符。1. 在條件節(jié)點(diǎn)前添加一個(gè)“變量”節(jié)點(diǎn)打印出要判斷的變量值。2. 檢查表達(dá)式語法例如字符串比較是否用了數(shù)字比較是否用了。最終輸出為空或部分缺失變量賦值錯(cuò)誤或未正確傳遞到結(jié)束節(jié)點(diǎn)。1. 檢查“組裝報(bào)告”變量節(jié)點(diǎn)是否正確修改了目標(biāo)變量。2. 檢查“結(jié)束”節(jié)點(diǎn)配置的輸出參數(shù)是否引用了正確的變量名{{final_report}}。3. 確保所有可能的分支路徑最終都匯聚到“結(jié)束”節(jié)點(diǎn)并設(shè)置了輸出。從智能體無法觸發(fā)工作流1. 工作流未發(fā)布。2. 智能體預(yù)設(shè)指令未明確調(diào)用條件。3. 用戶提問方式不符合預(yù)設(shè)指令中的模式。1. 確認(rèn)工作流已發(fā)布最新版本。2. 優(yōu)化智能體預(yù)設(shè)指令使用更明確的觸發(fā)關(guān)鍵詞。3. 在智能體配置中檢查工作流是否已被成功添加。5.2 性能與穩(wěn)定性優(yōu)化建議提示詞工程大模型節(jié)點(diǎn)的效果極度依賴提示詞。務(wù)必清晰、具體并給出輸出格式示例。將復(fù)雜的任務(wù)拆解到多個(gè)提示詞清晰的節(jié)點(diǎn)中比用一個(gè)復(fù)雜提示詞效果更好、更穩(wěn)定。錯(cuò)誤處理與降級(jí)在關(guān)鍵節(jié)點(diǎn)后加入“條件判斷”檢查輸出是否有效。例如在“解析簡歷”節(jié)點(diǎn)后判斷輸出是否為合法 JSON如果不是則跳轉(zhuǎn)到錯(cuò)誤處理分支而不是讓流程崩潰。變量管理與命名使用有意義的變量名和節(jié)點(diǎn)名如parse_resume,calc_score避免使用a,b,node1等這在調(diào)試復(fù)雜工作流時(shí)至關(guān)重要。復(fù)雜度控制單個(gè)工作流不宜過于龐大。如果邏輯過于復(fù)雜考慮拆分成多個(gè)子工作流通過“工作流調(diào)用”節(jié)點(diǎn)進(jìn)行組合。這有助于維護(hù)和調(diào)試。成本與延遲考慮每個(gè)大模型節(jié)點(diǎn)都會(huì)產(chǎn)生 Token 消耗并增加延遲。評(píng)估是否每個(gè)節(jié)點(diǎn)都必要能否合并一些步驟。對(duì)于簡單的計(jì)算和判斷優(yōu)先使用代碼節(jié)點(diǎn)而非大模型節(jié)點(diǎn)。6. 擴(kuò)展方向與生產(chǎn)環(huán)境考量掌握了基礎(chǔ)工作流搭建后你可以向更深入、更實(shí)用的方向擴(kuò)展。6.1 功能擴(kuò)展接入知識(shí)庫在“評(píng)估技能”節(jié)點(diǎn)前加入“知識(shí)庫檢索”節(jié)點(diǎn)上傳公司技術(shù)棧文檔、崗位職級(jí)說明書等讓評(píng)估依據(jù)更精準(zhǔn)。多輪交互工作流可以設(shè)計(jì)為交互式。例如先輸出初步評(píng)估然后根據(jù)用戶的進(jìn)一步提問“為什么這項(xiàng)技能不匹配”再觸發(fā)另一個(gè)分支進(jìn)行詳細(xì)解釋。連接外部 API在“代碼節(jié)點(diǎn)”中使用requests庫調(diào)用外部系統(tǒng)。例如解析簡歷后自動(dòng)在內(nèi)部人才庫中查詢是否存在重復(fù)記錄或調(diào)用郵件服務(wù)發(fā)送評(píng)估報(bào)告。注意調(diào)用外部 API 需確保網(wǎng)絡(luò)可達(dá)并妥善處理鑒權(quán)如使用環(huán)境變量存儲(chǔ)密鑰和超時(shí)異常。復(fù)雜決策樹利用多個(gè)“條件判斷”節(jié)點(diǎn)構(gòu)建基于多項(xiàng)指標(biāo)經(jīng)驗(yàn)、技能、學(xué)歷、薪資期望的復(fù)雜決策樹實(shí)現(xiàn)更精細(xì)化的分類。6.2 生產(chǎn)環(huán)境部署要點(diǎn)將此類智能體用于實(shí)際業(yè)務(wù)前需考慮以下方面輸入驗(yàn)證與清洗在“開始”節(jié)點(diǎn)后立即添加“代碼節(jié)點(diǎn)”對(duì)輸入的resume_text和job_description進(jìn)行清洗去除特殊字符、截?cái)嚅L度、驗(yàn)證是否非空防止惡意輸入或無效數(shù)據(jù)導(dǎo)致后續(xù)節(jié)點(diǎn)失敗。敏感信息處理如果處理真實(shí)簡歷需注意隱私保護(hù)。不要在提示詞中明文傳遞個(gè)人信息考慮在本地或安全環(huán)境中進(jìn)行匿名化處理后再傳入工作流。日志與監(jiān)控充分利用 Coze 平臺(tái)提供的運(yùn)行日志監(jiān)控工作流的觸發(fā)頻率、成功率和各節(jié)點(diǎn)耗時(shí)。對(duì)于關(guān)鍵業(yè)務(wù)可以在代碼節(jié)點(diǎn)中加入日志記錄將關(guān)鍵結(jié)果和錯(cuò)誤信息輸出到外部監(jiān)控系統(tǒng)。版本管理Coze 平臺(tái)支持工作流版本。每次重大修改前先保存一個(gè)版本。生產(chǎn)環(huán)境使用穩(wěn)定的已發(fā)布版本在新版本測試充分后再進(jìn)行切換。成本控制估算每個(gè)工作流運(yùn)行一次消耗的 Token 數(shù)量尤其是大模型節(jié)點(diǎn)并設(shè)置預(yù)算或使用量告警。優(yōu)化提示詞減少不必要的上下文長度。工作流的價(jià)值在于將確定性的流程自動(dòng)化而將需要智能判斷的部分交給大模型。通過本教程的“簡歷篩選”案例你應(yīng)該已經(jīng)掌握了從需求分析、節(jié)點(diǎn)選型、流程設(shè)計(jì)、調(diào)試排錯(cuò)到集成的完整路徑。接下來最好的學(xué)習(xí)方式就是選擇一個(gè)你日常工作中的重復(fù)性高、有明確規(guī)則但又需要一些靈活判斷的任務(wù)嘗試用工作流將其自動(dòng)化。從簡單流程開始逐步增加復(fù)雜度你會(huì)逐漸體會(huì)到用可視化方式編排 AI 能力的強(qiáng)大與便捷。 從零搭建Coze工作流：構(gòu)建簡歷篩選智能體實(shí)戰(zhàn)指南
在實(shí)際 AI 應(yīng)用開發(fā)中將大模型能力與具體業(yè)務(wù)流程結(jié)合是提升效率和自動(dòng)化水平的關(guān)鍵。Coze扣子平臺(tái)提供的工作流Workflow功能允許開發(fā)者通過可視化編排的方式將多個(gè) AI 模型、代碼節(jié)點(diǎn)、條件判斷和外部工具連接起來構(gòu)建復(fù)雜的智能體Agent。對(duì)于許多開發(fā)者而言從零開始設(shè)計(jì)一個(gè)高效、穩(wěn)定且能處理復(fù)雜邏輯的工作流并非易事常?？ㄔ诹鞒淘O(shè)計(jì)、節(jié)點(diǎn)選擇和調(diào)試上。本文將以一個(gè)實(shí)際場景為例帶你從零開始在 Coze 平臺(tái)上搭建一個(gè)具備完整邏輯的工作流智能體。我們將聚焦于“簡歷篩選”這一常見需求構(gòu)建一個(gè)能自動(dòng)解析簡歷、評(píng)估匹配度并生成結(jié)構(gòu)化報(bào)告的智能體。整個(gè)過程無需編寫復(fù)雜代碼但會(huì)深入解釋每個(gè)節(jié)點(diǎn)的作用、參數(shù)配置的邏輯以及排錯(cuò)的關(guān)鍵點(diǎn)確保你能理解其工作機(jī)制并能舉一反三應(yīng)用到其他場景中。1. 理解 Coze 工作流與智能體的核心概念在動(dòng)手搭建之前需要厘清幾個(gè)核心概念及其關(guān)系這是設(shè)計(jì)出合理工作流的基礎(chǔ)。1.1 什么是智能體Agent與工作流Workflow在 Coze 平臺(tái)中智能體是一個(gè)具備特定目標(biāo)和能力的 AI 實(shí)體。你可以把它理解為一個(gè)虛擬助手它能夠理解用戶意圖、調(diào)用工具、處理信息并給出反饋。一個(gè)智能體的核心能力由三部分構(gòu)成預(yù)設(shè)指令Prompt、知識(shí)庫和插件/工作流。工作流則是實(shí)現(xiàn)智能體復(fù)雜能力的引擎。當(dāng)智能體需要執(zhí)行一系列有順序、有條件分支或需要混合多種能力如調(diào)用大模型、執(zhí)行代碼、訪問數(shù)據(jù)庫的任務(wù)時(shí)單純依靠一個(gè)對(duì)話大模型是不夠的。工作流通過可視化的“節(jié)點(diǎn)”和“邊”來定義這個(gè)執(zhí)行流程。每個(gè)節(jié)點(diǎn)代表一個(gè)處理步驟例如調(diào)用模型、運(yùn)行 Python 代碼、判斷條件節(jié)點(diǎn)之間的連線定義了數(shù)據(jù)流動(dòng)的方向和邏輯順序。簡單來說智能體定義了“做什么”和“對(duì)外交互的界面”而工作流定義了“具體怎么做”的詳細(xì)步驟。一個(gè)智能體可以包含多個(gè)工作流用于處理不同類型的用戶請(qǐng)求。1.2 工作流中的關(guān)鍵節(jié)點(diǎn)類型Coze 工作流編輯器提供了多種節(jié)點(diǎn)理解其用途是設(shè)計(jì)流程的關(guān)鍵開始節(jié)點(diǎn)工作流的唯一入口接收來自智能體對(duì)話或外部觸發(fā)的輸入?yún)?shù)。大語言模型節(jié)點(diǎn)核心節(jié)點(diǎn)用于調(diào)用云端大模型如 GPT-4、DeepSeek 等進(jìn)行文本理解、生成或分析。你需要配置具體的模型、溫度Temperature、最大輸出長度等參數(shù)。代碼節(jié)點(diǎn)支持 Python 和 JavaScript。用于執(zhí)行模型無法直接完成的邏輯計(jì)算、數(shù)據(jù)處理、調(diào)用第三方 API需注意網(wǎng)絡(luò)策略等。這是連接 AI 與傳統(tǒng)編程的關(guān)鍵。條件判斷節(jié)點(diǎn)根據(jù)上游節(jié)點(diǎn)的輸出結(jié)果通常是某個(gè)變量的值決定流程下一步走向哪個(gè)分支。這是實(shí)現(xiàn)邏輯智能的核心。變量節(jié)點(diǎn)用于定義、賦值或修改變量。工作流中的變量可以存儲(chǔ)中間結(jié)果并在不同節(jié)點(diǎn)間傳遞。知識(shí)庫節(jié)點(diǎn)從你上傳到 Coze 的知識(shí)庫文件中檢索相關(guān)信息為模型提供上下文。插件節(jié)點(diǎn)調(diào)用預(yù)置或自定義的插件例如搜索網(wǎng)頁、生成圖片、查詢天氣等。1.3 設(shè)計(jì)工作流的通用思路一個(gè)健壯的工作流設(shè)計(jì)通常遵循以下步驟明確輸入與輸出首先確定工作流需要用戶提供什么如一份簡歷文本、一個(gè)崗位描述最終要輸出什么如匹配度分?jǐn)?shù)、評(píng)估報(bào)告。拆解處理步驟將任務(wù)分解為多個(gè)原子步驟。例如解析簡歷文本 - 提取關(guān)鍵信息 - 與崗位要求對(duì)比 - 計(jì)算匹配度 - 格式化報(bào)告。選擇節(jié)點(diǎn)實(shí)現(xiàn)為每個(gè)步驟分配合適的節(jié)點(diǎn)。文本解析和對(duì)比可以用大模型節(jié)點(diǎn)計(jì)算分?jǐn)?shù)可以用代碼節(jié)點(diǎn)根據(jù)分?jǐn)?shù)高低生成不同評(píng)語可以用條件判斷節(jié)點(diǎn)。定義數(shù)據(jù)流規(guī)劃每個(gè)步驟產(chǎn)生的數(shù)據(jù)如何傳遞給下一個(gè)步驟。這決定了節(jié)點(diǎn)之間如何連線以及變量如何命名。設(shè)置異常處理考慮可能出錯(cuò)的地方如簡歷格式無法解析、API調(diào)用失敗并通過條件判斷或默認(rèn)值提供降級(jí)方案。2. 環(huán)境準(zhǔn)備與 Coze 平臺(tái)配置開始搭建前你需要完成賬號(hào)和基礎(chǔ)的平臺(tái)配置。2.1 注冊(cè)與訪問訪問 Coze 官網(wǎng)并注冊(cè)賬號(hào)。目前平臺(tái)提供免費(fèi)額度足以完成本教程的學(xué)習(xí)和測試。登錄后進(jìn)入主控臺(tái)你會(huì)看到“創(chuàng)建 Bot”的入口。2.2 創(chuàng)建智能體Bot點(diǎn)擊“創(chuàng)建 Bot”為你的智能體起一個(gè)名字例如“簡歷篩選助手”。預(yù)設(shè)指令這是智能體的“人格”和核心任務(wù)描述。輸入清晰指令至關(guān)重要。注意預(yù)設(shè)指令是引導(dǎo)智能體理解何時(shí)該調(diào)用工作流的關(guān)鍵。例如你可以寫“你是一個(gè)專業(yè)的招聘助手專門幫助 HR 快速篩選簡歷。當(dāng)用戶提供簡歷文本和崗位描述時(shí)你需要調(diào)用內(nèi)置的‘簡歷評(píng)估工作流’來生成詳細(xì)的匹配度報(bào)告。如果用戶只是普通聊天請(qǐng)友好回應(yīng)?！蹦Ｐ瓦x擇在 Bot 設(shè)置中選擇一個(gè)適合的大模型。對(duì)于需要復(fù)雜理解和文本生成的任務(wù)建議選擇能力較強(qiáng)的模型如 GPT-4 系列或 DeepSeek 最新版本。模型的選擇會(huì)直接影響工作流中“大語言模型節(jié)點(diǎn)”的默認(rèn)選項(xiàng)和效果。2.3 理解工作流編輯器界面在智能體編輯頁面找到并點(diǎn)擊“工作流”標(biāo)簽頁然后點(diǎn)擊“創(chuàng)建工作流”。你將進(jìn)入一個(gè)畫布式的編輯器界面主要區(qū)域包括節(jié)點(diǎn)面板左側(cè)列出了所有可用的節(jié)點(diǎn)類型。畫布中間區(qū)域用于拖拽和連接節(jié)點(diǎn)。配置面板右側(cè)區(qū)域當(dāng)選中某個(gè)節(jié)點(diǎn)時(shí)這里會(huì)顯示該節(jié)點(diǎn)的詳細(xì)配置項(xiàng)。運(yùn)行與調(diào)試區(qū)底部區(qū)域可以輸入測試參數(shù)、運(yùn)行工作流并查看每一步的輸出和最終結(jié)果。3. 實(shí)戰(zhàn)搭建“簡歷篩選評(píng)估”工作流現(xiàn)在我們開始構(gòu)建一個(gè)完整的簡歷篩選工作流。該工作流的目標(biāo)是輸入一段簡歷文本和崗位描述JD輸出一份包含匹配度評(píng)分、技能分析、經(jīng)驗(yàn)評(píng)估和綜合建議的報(bào)告。3.1 定義輸入與輸出首先從“節(jié)點(diǎn)面板”拖拽一個(gè)“開始”節(jié)點(diǎn)到畫布。這個(gè)節(jié)點(diǎn)代表工作流的起點(diǎn)。選中開始節(jié)點(diǎn)在右側(cè)配置面板點(diǎn)擊“添加輸入?yún)?shù)”。添加兩個(gè)參數(shù)resume_text(類型字符串)代表簡歷文本。job_description(類型字符串)代表崗位描述。 這些參數(shù)將在測試或從智能體對(duì)話調(diào)用工作流時(shí)傳入。接下來拖拽一個(gè)“變量”節(jié)點(diǎn)將其重命名為“初始化輸出”。我們?cè)谶@里定義最終輸出的結(jié)構(gòu)。在變量節(jié)點(diǎn)的配置中定義一個(gè)名為final_report的變量。將其初始值設(shè)為一個(gè)空的 JSON 對(duì)象例如{ match_score: 0, skill_analysis: , experience_evaluation: , recommendation: }這個(gè)變量將隨著流程推進(jìn)被各個(gè)節(jié)點(diǎn)填充內(nèi)容。3.2 解析簡歷信息拖拽一個(gè)“大語言模型”節(jié)點(diǎn)到畫布命名為“解析簡歷”。連接將“開始”節(jié)點(diǎn)的輸出連線到該節(jié)點(diǎn)。配置模型選擇一個(gè)你擅長的模型。系統(tǒng)提示詞這是指導(dǎo)模型行為的關(guān)鍵。輸入如下內(nèi)容你是一個(gè)專業(yè)的簡歷解析器。請(qǐng)從用戶提供的簡歷文本中提取出結(jié)構(gòu)化的信息。只輸出一個(gè)JSON對(duì)象包含以下字段 - name: 姓名 - years_of_experience: 工作年限數(shù)字 - skills: 技能列表數(shù)組 - education: 最高學(xué)歷 - key_experiences: 關(guān)鍵工作經(jīng)歷簡述字符串100字內(nèi) 簡歷文本{{resume_text}}用戶消息可以留空或簡單寫“請(qǐng)解析這份簡歷”。關(guān)鍵解釋系統(tǒng)提示詞中使用了{(lán){resume_text}}這是一個(gè)變量插值語法。工作流運(yùn)行時(shí)它會(huì)自動(dòng)被替換為從“開始”節(jié)點(diǎn)傳入的resume_text參數(shù)值。這實(shí)現(xiàn)了數(shù)據(jù)在不同節(jié)點(diǎn)間的傳遞。3.3 評(píng)估技能匹配度再拖拽一個(gè)“大語言模型”節(jié)點(diǎn)命名為“評(píng)估技能”。連接將“解析簡歷”節(jié)點(diǎn)的輸出連線到本節(jié)點(diǎn)。配置系統(tǒng)提示詞你是一個(gè)技能匹配專家。請(qǐng)對(duì)比候選人的技能列表和崗位描述評(píng)估匹配度。 候選人技能{{解析簡歷.skills}} 這是一個(gè)數(shù)組 崗位描述{{job_description}} 請(qǐng)輸出一個(gè)JSON對(duì)象 { matched_skills: [列出與JD明確匹配的技能], missing_skills: [列出JD要求但候選人缺乏的技能], skill_match_score: 一個(gè)0-100的整數(shù)分?jǐn)?shù) }用戶消息留空。關(guān)鍵解釋這里使用了{(lán){解析簡歷.skills}}來引用上一個(gè)“解析簡歷”節(jié)點(diǎn)的輸出結(jié)果中的skills字段。這種{{節(jié)點(diǎn)名.輸出字段名}}的語法是工作流中傳遞數(shù)據(jù)的核心方式。3.4 計(jì)算綜合匹配分?jǐn)?shù)并生成報(bào)告現(xiàn)在我們需要綜合技能匹配度和其他因素如年限、經(jīng)驗(yàn)相關(guān)性生成最終報(bào)告。這里引入“代碼節(jié)點(diǎn)”進(jìn)行邏輯計(jì)算。拖拽一個(gè)“代碼節(jié)點(diǎn)”選擇 Python到畫布命名為“計(jì)算綜合分”。連接將“解析簡歷”和“評(píng)估技能”兩個(gè)節(jié)點(diǎn)的輸出都連線到本節(jié)點(diǎn)。這樣代碼節(jié)點(diǎn)就能接收到兩者的數(shù)據(jù)。配置代碼在代碼編輯器中編寫 Python 邏輯。# 輸入?yún)?shù)會(huì)自動(dòng)注入到 input_data 變量中它是一個(gè)字典 parsed_resume input_data[解析簡歷] # 獲取“解析簡歷”節(jié)點(diǎn)的輸出 skill_assessment input_data[評(píng)估技能] # 獲取“評(píng)估技能”節(jié)點(diǎn)的輸出 job_desc input_data[job_description] # 獲取開始節(jié)點(diǎn)的參數(shù) # 從解析結(jié)果中提取工作年限 years_exp parsed_resume.get(years_of_experience, 0) # 從技能評(píng)估中提取技能分?jǐn)?shù) skill_score skill_assessment.get(skill_match_score, 0) # 一個(gè)簡單的綜合分?jǐn)?shù)計(jì)算邏輯示例可根據(jù)業(yè)務(wù)調(diào)整 # 假設(shè)技能分權(quán)重70%年限分權(quán)重30%年限每多一年加5分上限30分 exp_score min(years_exp * 5, 30) final_score int(skill_score * 0.7 exp_score * 0.3) # 準(zhǔn)備報(bào)告文本 skill_analysis f匹配技能{skill_assessment.get(matched_skills, [])}。缺乏技能{skill_assessment.get(missing_skills, [])}。 exp_eval f候選人擁有{years_exp}年經(jīng)驗(yàn)關(guān)鍵經(jīng)歷{parsed_resume.get(key_experiences, )} recommendation 建議面試 if final_score 70 else 建議儲(chǔ)備 if final_score 50 else 暫不匹配 # 輸出結(jié)果后續(xù)節(jié)點(diǎn)可以引用 output { final_score: final_score, skill_analysis: skill_analysis, experience_evaluation: exp_eval, recommendation: recommendation }設(shè)置輸出在代碼節(jié)點(diǎn)的“輸出變量”配置部分將上面代碼中output字典的各個(gè)鍵映射為輸出變量。例如添加一個(gè)輸出變量computed_result其值路徑設(shè)置為output。3.5 組裝最終報(bào)告并結(jié)束流程再拖拽一個(gè)“變量”節(jié)點(diǎn)命名為“組裝報(bào)告”。連接將“計(jì)算綜合分”節(jié)點(diǎn)的輸出連線到本節(jié)點(diǎn)。配置在這個(gè)變量節(jié)點(diǎn)中我們要更新之前定義的final_report變量。選擇“修改變量”操作變量名為final_report。在值表達(dá)式中使用類似 JSON 合并的語法具體取決于平臺(tái)支持可能是函數(shù)或模板{{final_report}} // 先獲取原變量 .match_score {{計(jì)算綜合分.computed_result.final_score}} .skill_analysis {{計(jì)算綜合分.computed_result.skill_analysis}} .experience_evaluation {{計(jì)算綜合分.computed_result.experience_evaluation}} .recommendation {{計(jì)算綜合分.computed_result.recommendation}}或者如果平臺(tái)支持直接賦值{ match_score: {{計(jì)算綜合分.computed_result.final_score}}, skill_analysis: {{計(jì)算綜合分.computed_result.skill_analysis}}, experience_evaluation: {{計(jì)算綜合分.computed_result.experience_evaluation}}, recommendation: {{計(jì)算綜合分.computed_result.recommendation}} }最后拖拽一個(gè)“結(jié)束”節(jié)點(diǎn)到畫布。連接將“組裝報(bào)告”節(jié)點(diǎn)連線到“結(jié)束”節(jié)點(diǎn)。配置結(jié)束節(jié)點(diǎn)在結(jié)束節(jié)點(diǎn)的輸出參數(shù)中添加一個(gè)參數(shù)例如report并將其值設(shè)置為{{final_report}}。這樣當(dāng)工作流完成時(shí)就會(huì)輸出這個(gè)完整的報(bào)告對(duì)象。至此一個(gè)線性的簡歷篩選工作流就搭建完成了。流程為開始 - 解析簡歷 - 評(píng)估技能 - 計(jì)算綜合分 - 組裝報(bào)告 - 結(jié)束。3.6 增加條件判斷分支進(jìn)階為了讓智能體更靈活我們可以增加一個(gè)分支如果簡歷文本明顯過短或無效則直接返回錯(cuò)誤提示不進(jìn)行后續(xù)分析。在“開始”節(jié)點(diǎn)和“解析簡歷”節(jié)點(diǎn)之間插入一個(gè)“條件判斷”節(jié)點(diǎn)。配置條件判斷resume_text的長度是否小于 50 個(gè)字符示例閾值。條件表達(dá)式可能類似len({{resume_text}}) 50創(chuàng)建分支是True分支連線到一個(gè)新的“變量”節(jié)點(diǎn)可命名為“設(shè)置錯(cuò)誤信息”在這里將final_report的recommendation字段修改為“簡歷文本過短無法分析”。然后直接連線到“結(jié)束”節(jié)點(diǎn)。否False分支連線到原來的“解析簡歷”節(jié)點(diǎn)。同時(shí)需要在“結(jié)束”節(jié)點(diǎn)中配置使其能接收來自不同分支的final_report變量。4. 運(yùn)行、調(diào)試與集成到智能體4.1 在工作流編輯器中測試點(diǎn)擊編輯器底部的“運(yùn)行”區(qū)域。在輸入框中為resume_text和job_description提供示例內(nèi)容。{ resume_text: 張三5年Java開發(fā)經(jīng)驗(yàn)精通Spring Boot, MySQL, Redis。本科學(xué)歷。曾負(fù)責(zé)某電商系統(tǒng)后端架構(gòu)設(shè)計(jì)。, job_description: 招聘高級(jí)Java工程師要求3年以上經(jīng)驗(yàn)熟練掌握Spring Cloud, MySQL有高并發(fā)系統(tǒng)設(shè)計(jì)經(jīng)驗(yàn)者優(yōu)先。 }點(diǎn)擊“運(yùn)行”。編輯器會(huì)高亮顯示執(zhí)行路徑并在每個(gè)節(jié)點(diǎn)下方顯示其輸出結(jié)果。仔細(xì)檢查每個(gè)節(jié)點(diǎn)的輸出是否符合預(yù)期。特別是“解析簡歷”節(jié)點(diǎn)是否輸出了正確的 JSON 結(jié)構(gòu)“評(píng)估技能”節(jié)點(diǎn)是否正確識(shí)別了匹配和缺失的技能“計(jì)算綜合分”節(jié)點(diǎn)的 Python 代碼是否有語法錯(cuò)誤計(jì)算結(jié)果是否合理最終“結(jié)束”節(jié)點(diǎn)的輸出是否是一個(gè)完整的報(bào)告 JSON4.2 將工作流發(fā)布并集成到智能體測試無誤后保存工作流并點(diǎn)擊“發(fā)布”。回到智能體Bot的編輯頁面。在“技能”或“工作流”配置部分添加你剛剛創(chuàng)建并發(fā)布的工作流。關(guān)鍵步驟修改智能體的“預(yù)設(shè)指令”明確告知智能體在什么情況下調(diào)用此工作流。例如 “當(dāng)用戶想要評(píng)估簡歷時(shí)他們會(huì)提供簡歷文本和崗位描述。你需要調(diào)用‘簡歷篩選評(píng)估工作流’并將用戶提供的兩部分內(nèi)容分別作為resume_text和job_description參數(shù)傳入。然后將工作流返回的結(jié)構(gòu)化報(bào)告用友好、易讀的格式總結(jié)給用戶?！北４娌l(fā)布智能體。4.3 在智能體對(duì)話界面驗(yàn)證進(jìn)入智能體的對(duì)話界面嘗試發(fā)送如下消息 “請(qǐng)幫我評(píng)估一下這份簡歷[粘貼簡歷文本]崗位要求是[粘貼崗位描述]?！?觀察智能體是否會(huì)正確調(diào)用工作流并返回一份結(jié)構(gòu)化的評(píng)估報(bào)告。5. 常見問題排查與優(yōu)化實(shí)踐即使流程設(shè)計(jì)正確在實(shí)際運(yùn)行中也可能遇到問題。以下是基于此場景的常見排查點(diǎn)。5.1 工作流運(yùn)行失敗排查表問題現(xiàn)象可能原因檢查與解決步驟工作流啟動(dòng)失敗開始節(jié)點(diǎn)的輸入?yún)?shù)未提供或格式錯(cuò)誤。1. 檢查測試時(shí)輸入的 JSON 格式是否正確鍵名是否匹配。2. 檢查從智能體調(diào)用時(shí)參數(shù)傳遞邏輯是否正確。大模型節(jié)點(diǎn)報(bào)錯(cuò)或輸出格式不符1. 提示詞指令不清晰。2. 模型上下文長度超限。3. 輸入變量插值失敗值為空或格式錯(cuò)誤。1. 簡化并明確系統(tǒng)提示詞強(qiáng)調(diào)輸出格式如“只輸出 JSON”。2. 檢查輸入的文本是否過長嘗試截?cái)唷?. 在節(jié)點(diǎn)配置中檢查變量引用{{xxx}}的拼寫是否正確上游節(jié)點(diǎn)是否有對(duì)應(yīng)輸出。代碼節(jié)點(diǎn)執(zhí)行錯(cuò)誤1. Python 語法錯(cuò)誤。2. 引用了不存在的輸入變量。3. 第三方庫未安裝Coze 代碼節(jié)點(diǎn)有預(yù)裝環(huán)境但非標(biāo)準(zhǔn)庫可能缺失。1. 仔細(xì)閱讀代碼節(jié)點(diǎn)的錯(cuò)誤信息定位行號(hào)。2. 使用print(input_data)調(diào)試輸入數(shù)據(jù)結(jié)構(gòu)。3. 確認(rèn)代碼中使用的庫在 Coze 沙箱環(huán)境中可用。條件判斷未按預(yù)期分支條件表達(dá)式邏輯錯(cuò)誤或變量值類型不符。1. 在條件節(jié)點(diǎn)前添加一個(gè)“變量”節(jié)點(diǎn)打印出要判斷的變量值。2. 檢查表達(dá)式語法例如字符串比較是否用了數(shù)字比較是否用了。最終輸出為空或部分缺失變量賦值錯(cuò)誤或未正確傳遞到結(jié)束節(jié)點(diǎn)。1. 檢查“組裝報(bào)告”變量節(jié)點(diǎn)是否正確修改了目標(biāo)變量。2. 檢查“結(jié)束”節(jié)點(diǎn)配置的輸出參數(shù)是否引用了正確的變量名{{final_report}}。3. 確保所有可能的分支路徑最終都匯聚到“結(jié)束”節(jié)點(diǎn)并設(shè)置了輸出。從智能體無法觸發(fā)工作流1. 工作流未發(fā)布。2. 智能體預(yù)設(shè)指令未明確調(diào)用條件。3. 用戶提問方式不符合預(yù)設(shè)指令中的模式。1. 確認(rèn)工作流已發(fā)布最新版本。2. 優(yōu)化智能體預(yù)設(shè)指令使用更明確的觸發(fā)關(guān)鍵詞。3. 在智能體配置中檢查工作流是否已被成功添加。5.2 性能與穩(wěn)定性優(yōu)化建議提示詞工程大模型節(jié)點(diǎn)的效果極度依賴提示詞。務(wù)必清晰、具體并給出輸出格式示例。將復(fù)雜的任務(wù)拆解到多個(gè)提示詞清晰的節(jié)點(diǎn)中比用一個(gè)復(fù)雜提示詞效果更好、更穩(wěn)定。錯(cuò)誤處理與降級(jí)在關(guān)鍵節(jié)點(diǎn)后加入“條件判斷”檢查輸出是否有效。例如在“解析簡歷”節(jié)點(diǎn)后判斷輸出是否為合法 JSON如果不是則跳轉(zhuǎn)到錯(cuò)誤處理分支而不是讓流程崩潰。變量管理與命名使用有意義的變量名和節(jié)點(diǎn)名如parse_resume,calc_score避免使用a,b,node1等這在調(diào)試復(fù)雜工作流時(shí)至關(guān)重要。復(fù)雜度控制單個(gè)工作流不宜過于龐大。如果邏輯過于復(fù)雜考慮拆分成多個(gè)子工作流通過“工作流調(diào)用”節(jié)點(diǎn)進(jìn)行組合。這有助于維護(hù)和調(diào)試。成本與延遲考慮每個(gè)大模型節(jié)點(diǎn)都會(huì)產(chǎn)生 Token 消耗并增加延遲。評(píng)估是否每個(gè)節(jié)點(diǎn)都必要能否合并一些步驟。對(duì)于簡單的計(jì)算和判斷優(yōu)先使用代碼節(jié)點(diǎn)而非大模型節(jié)點(diǎn)。6. 擴(kuò)展方向與生產(chǎn)環(huán)境考量掌握了基礎(chǔ)工作流搭建后你可以向更深入、更實(shí)用的方向擴(kuò)展。6.1 功能擴(kuò)展接入知識(shí)庫在“評(píng)估技能”節(jié)點(diǎn)前加入“知識(shí)庫檢索”節(jié)點(diǎn)上傳公司技術(shù)棧文檔、崗位職級(jí)說明書等讓評(píng)估依據(jù)更精準(zhǔn)。多輪交互工作流可以設(shè)計(jì)為交互式。例如先輸出初步評(píng)估然后根據(jù)用戶的進(jìn)一步提問“為什么這項(xiàng)技能不匹配”再觸發(fā)另一個(gè)分支進(jìn)行詳細(xì)解釋。連接外部 API在“代碼節(jié)點(diǎn)”中使用requests庫調(diào)用外部系統(tǒng)。例如解析簡歷后自動(dòng)在內(nèi)部人才庫中查詢是否存在重復(fù)記錄或調(diào)用郵件服務(wù)發(fā)送評(píng)估報(bào)告。注意調(diào)用外部 API 需確保網(wǎng)絡(luò)可達(dá)并妥善處理鑒權(quán)如使用環(huán)境變量存儲(chǔ)密鑰和超時(shí)異常。復(fù)雜決策樹利用多個(gè)“條件判斷”節(jié)點(diǎn)構(gòu)建基于多項(xiàng)指標(biāo)經(jīng)驗(yàn)、技能、學(xué)歷、薪資期望的復(fù)雜決策樹實(shí)現(xiàn)更精細(xì)化的分類。6.2 生產(chǎn)環(huán)境部署要點(diǎn)將此類智能體用于實(shí)際業(yè)務(wù)前需考慮以下方面輸入驗(yàn)證與清洗在“開始”節(jié)點(diǎn)后立即添加“代碼節(jié)點(diǎn)”對(duì)輸入的resume_text和job_description進(jìn)行清洗去除特殊字符、截?cái)嚅L度、驗(yàn)證是否非空防止惡意輸入或無效數(shù)據(jù)導(dǎo)致后續(xù)節(jié)點(diǎn)失敗。敏感信息處理如果處理真實(shí)簡歷需注意隱私保護(hù)。不要在提示詞中明文傳遞個(gè)人信息考慮在本地或安全環(huán)境中進(jìn)行匿名化處理后再傳入工作流。日志與監(jiān)控充分利用 Coze 平臺(tái)提供的運(yùn)行日志監(jiān)控工作流的觸發(fā)頻率、成功率和各節(jié)點(diǎn)耗時(shí)。對(duì)于關(guān)鍵業(yè)務(wù)可以在代碼節(jié)點(diǎn)中加入日志記錄將關(guān)鍵結(jié)果和錯(cuò)誤信息輸出到外部監(jiān)控系統(tǒng)。版本管理Coze 平臺(tái)支持工作流版本。每次重大修改前先保存一個(gè)版本。生產(chǎn)環(huán)境使用穩(wěn)定的已發(fā)布版本在新版本測試充分后再進(jìn)行切換。成本控制估算每個(gè)工作流運(yùn)行一次消耗的 Token 數(shù)量尤其是大模型節(jié)點(diǎn)并設(shè)置預(yù)算或使用量告警。優(yōu)化提示詞減少不必要的上下文長度。工作流的價(jià)值在于將確定性的流程自動(dòng)化而將需要智能判斷的部分交給大模型。通過本教程的“簡歷篩選”案例你應(yīng)該已經(jīng)掌握了從需求分析、節(jié)點(diǎn)選型、流程設(shè)計(jì)、調(diào)試排錯(cuò)到集成的完整路徑。接下來最好的學(xué)習(xí)方式就是選擇一個(gè)你日常工作中的重復(fù)性高、有明確規(guī)則但又需要一些靈活判斷的任務(wù)嘗試用工作流將其自動(dòng)化。從簡單流程開始逐步增加復(fù)雜度你會(huì)逐漸體會(huì)到用可視化方式編排 AI 能力的強(qiáng)大與便捷。