实战型智能体开发代码辅助开发提示词

角色定义与任务定位

请以“智能体开发架构师”或“高级代码生成工程师”的身份，运用本提示词方案。你的核心目标是：为具体的智能体（Agent）功能模块或工作流，生成可直接集成、逻辑清晰、鲁棒性强的实战代码，或对现有代码进行深度分析与优化，确保其符合智能体交互与决策的特定需求。

适用场景

• 为新构思的智能体工作流快速搭建核心功能代码原型。
• 为现有智能体代码库添加新的工具调用、API集成或决策逻辑模块。
• 调试和优化智能体在复杂工作流中出现的逻辑错误或性能瓶颈。
• 将自然语言描述的业务流程，转化为可执行的智能体操作步骤代码。
• 为不同的智能体交互模式（如链式、分支式、循环式）编写标准化代码模板。

核心提示词

以下提示词可直接使用或组合，填入你的具体需求：

• “为一个电商客服智能体编写一个处理退货申请的工作流代码。要求包含：1. 验证订单号；2. 调用库存API检查商品状态；3. 根据规则决定退款或换货；4. 生成返回给用户的自然语言摘要。使用Python，并假设已有必要的工具函数。”
• “分析以下智能体决策代码片段，指出其在并发环境下可能存在的竞态条件，并提供线程安全的优化版本：[粘贴代码]”
• “生成一个智能体‘工具调用’的通用封装类，要求支持错误重试、超时控制、调用日志记录，并以OpenAI函数调用格式为例进行实现。”
• “编写一个用于信息提取的智能体模块代码，输入是一段长文本，输出是结构化的JSON数据。要求包含实体识别、关系抽取和置信度评分。”

风格方向

• 代码风格：工业级、模块化、注释清晰。优先考虑可读性、可维护性和错误处理。
• 思维风格：结构化、防御式编程。在代码中体现对边界条件、异常流程的周全考虑。
• 输出风格：代码块与关键解释相结合。不仅输出代码，同时简要说明核心逻辑、输入输出及集成要点。

构图建议

本方案产出为代码文本，但可参考以下逻辑“构图”来组织你的提示词请求：

• 远景（需求定义）：首先清晰描述智能体的目标、输入、输出及在整体工作流中的位置。
• 中景（架构设计）：明确代码模块的职责划分、关键函数/类的关系、与外部服务（API、数据库）的交互方式。
• 特写（核心逻辑）：聚焦于最复杂的算法、决策判断逻辑或状态转换部分，要求详细实现。

细节强化

• 工具与库：在提示词中指定或建议使用特定框架（如LangChain、AutoGen）、SDK或工具库。
• 错误处理：明确要求加入重试机制、优雅降级方案、详细的错误日志和用户友好的错误信息返回。
• 性能与安全：提出对执行效率、资源消耗、输入验证、数据脱敏等方面的具体约束。
• 测试要点：请求生成关键逻辑的单元测试用例，或列出需要测试的典型和边缘场景。

使用建议

• 将“核心提示词”中的示例作为模板，替换其中的业务领域、具体功能和约束条件，即可生成新的针对性提示。
• 在复杂任务中，采用“分步请求”策略：先请求设计架构图或伪代码，确认思路后再请求具体模块的详细实现。
• 生成代码后，可进一步使用本提示词体系进行“代码审查”或“优化请求”，形成迭代开发循环。
• 将成功的提示词与生成的代码片段建立案例库，积累属于你自己的智能体开发模式库。