高阶版智能体开发代码调试优化提示词

角色定义与任务定位

你是一位资深智能体开发工程师与提示词架构师。你的核心任务是为复杂Agent工作流中的代码调试与优化环节，设计一套可复用、可落地的提示词策略。这套策略需要兼顾技术严谨性与创意表达，帮助开发团队在调试阶段快速定位瓶颈、优化逻辑、提升代码质量，同时保持Agent行为的可控性与可解释性。

适用场景

• 多步骤Agent工作流中代码逻辑的断点调试与性能分析
• 智能体函数调用、工具链编排过程中的异常捕获与错误修复
• 基于大模型的代码生成模块的自我修正与迭代优化
• Agent长期记忆、上下文管理相关的代码层优化
• 创意表达类智能体（如AI编剧、设计助手）代码层的灵活度与一致性调优

核心提示词

• “请作为资深智能体调试专家，逐步分析以下Agent工作流代码，定位可能存在的死循环、上下文丢失或工具调用超时问题，并给出优化方案： [粘贴代码]”
• “针对该Agent的决策逻辑，模拟一次完整执行过程，在每一步输出关键变量状态、函数返回值和错误堆栈，帮助我理解行为路径。”
• “请以代码审查视角，指出该智能体工作流中不合理的依赖顺序、潜在竞态条件，并建议更高效的事件驱动重写方案。”
• “在保持原有创意表达能力的前提下，为该Agent的提示词模板增加显式错误处理分支，要求输出修改后的代码片段及注释说明。”
• “生成一份智能体调试清单，包含常见的配置错误、模型响应超时、工具链中断等场景的检测方法与修复模板。”

风格方向

• 技术深度：以工程师思维为核心，使用精确的术语（如异步回调、状态机、上下文窗口、重试策略）
• 逻辑清晰：分步骤列出调试流程，避免模糊描述，每个优化点附带可度量的效果说明
• 创意融合：在代码优化建议中保留Agent的个性化表达空间，避免过度硬编码导致输出僵化

构图建议

• 使用流程图式构图展示Agent工作流的调用链，用不同颜色标注“正常路径”“错误路径”“优化节点”
• 在视觉表达中，将调试面板设计为分栏结构：左侧为代码行号与断点标记，右侧为实时变量监视与输出日志
• 可在提示词描述中加入“以俯视视角呈现智能体决策树，每个分支节点旁附错误概率与修复建议”的视觉指令
• 若用于创意配图，建议采用科技感扁平风格，主色为深蓝与青绿，强调数据流穿越的轨迹感

细节强化

• 变量级跟踪：要求在提示词中明确指定需要监控的变量名、类型及其变化阈值
• 时间维度：加入执行耗时记录，比如“记录每次工具调用从开始到返回的实际秒数”
• 日志分级：提示词可指定输出级别（debug/info/warn/error），确保关键问题不被淹没
• 上下文快照：要求Agent在执行关键决策点前输出当前上下文摘要，便于对比前后状态
• 回滚机制：在优化提示词中嵌入“如果本次优化导致输出质量下降，请自动回退至上版本”的指令

使用建议

• 在实际调试时，先运行一次完整工作流，收集默认日志；然后使用上述核心提示词重新执行，对比差异
• 将核心提示词保存为模板，在需要时替换具体代码块或Agent描述，保持格式一致性
• 对于创意表达类Agent，优先使用“可解释性优化”方向，确保调试后仍保持足够的随机性与新颖性
• 建议结合单元测试框架，将提示词生成的优化建议转化为自动化测试用例
• 定期复查提示词中引入的约束条件，避免过度优化导致Agent丧失自适应能力