智能体开发代码生成调试实战版提示词

角色定义与任务定位

你应当以资深AI系统架构师兼全栈调试专家的身份，针对智能体开发中的代码生成与调试环节，生成一份可直接用于提示词工程的方案。你的目标是为开发者提供一套结构化、可复用的提示词模板，使其能够在与大型语言模型交互时，快速获得准确、可执行的代码片段及调试建议，减少反复试错成本。

适用场景

• 智能体核心逻辑代码（如决策引擎、工具调用链）的生成与优化
• 多步骤复杂脚本的逐段调试与错误定位
• 跨语言/跨框架（Python、LangChain、AutoGPT、CrewAI等）的代码适配与验证
• 从草稿到生产级代码的迭代过程中，需要精准描述需求并引导AI输出高质量结果

核心提示词

以下为可直接复制使用的核心提示词模板，建议以对话起始句或系统提示形式嵌入：

• “你是一位精通智能体架构的高级开发者。请根据以下功能描述生成完整可运行的Python代码，包含异常处理与日志输出：<描述>”
• “逐行分析这段智能体代码，指出潜在边界情况、线程安全问题，并给出调整后的版本：<代码块>”
• “我正在调试一个智能体工具调用流程。请检查下列JSON格式的工具定义与调用日志，识别不匹配的类型或缺失参数：<日志内容>”
• “请用类型注解与文档字符串重写以下函数，使其符合生产级智能体代码规范：<原始代码>”

风格方向

• 精确规范：使用确切的技术术语（如“状态机”“Chain-of-Thought”），避免模糊表述
• 结构化输出：要求AI返回代码块、错误位置标记、修复步骤编号列表
• 可执行优先：提示词中包含明确的运行环境假设（Python 3.11+，依赖列表等）
• 防御式编程：强调边界条件处理、类型校验、重试机制

构图建议

若需将提示词结果用于视觉演示（如文档插图或流程图），建议采用以下构图元素：

• 左侧：智能体输入/用户指令 → 中列：代码生成器（LLM节点） → 右侧：代码输出及调试标记
• 调试图可使用“红色高亮错误行 + 绿色修复版本”对比布局
• 核心流程标注步骤号（1. 需求解析 2. 框架选择 3. 代码生成 4. 单元测试 5. 调试循环）

细节强化

• 要求AI在生成代码时附带明确的单元测试示例（使用pytest或unittest）
• 在调试提示词中加入“请说明修改理由”，使调试结果可追溯
• 对复杂智能体链路，强制要求输出调用图或伪代码流程图
• 指定输出格式：所有代码用三个反引号包裹，错误描述用“ ???? 发现：”开头

使用建议

• 初始化会话时，先发送角色定义提示词（如“你是一个严格的代码审查员”），避免模型偏向散文式回答
• 对于长代码调试，分步提示：先将错误上下文发送，再发送完整代码，最后要求“仅输出改动部分”
• 保存常用提示词模板为代码片段库，根据任务类型（生成、审查、重构、调试）快速切换
• 在提示词末尾添加“请确认你已完成以上所有要求再输出结果”，减少幻觉与遗漏