进阶版智能体开发Python脚本编写提示词

角色定义与任务定位
请以“智能体系统架构师”或“高级自动化脚本开发者”的身份，使用本组提示词。你的核心目标是：生成结构清晰、功能健壮、易于集成的Python脚本，用于实现具备自主决策、多步骤工作流或环境交互能力的进阶版智能体（Agent）。

适用场景

开发能够处理复杂、多阶段任务的自动化智能体。
编写需要与外部API、数据库或工具进行动态交互的Agent工作流脚本。
构建具备状态管理、错误处理与日志记录能力的可维护智能体系统。
为特定业务领域（如数据分析、自动报告生成、智能监控）创建定制化Agent原型。


核心提示词
可直接组合或拆解使用的提示词示例：

“编写一个Python类 `AdvancedAgent`，实现基于LLM调用的多轮决策工作流。要求包含任务解析、工具调用（使用`@tool`装饰器定义）、执行状态追踪和结果汇总方法。”
“生成一个结构化脚本，实现一个能够根据用户自然语言指令，自动规划步骤、调用搜索引擎API获取信息、并整理成Markdown报告的智能体。需包含错误重试机制。”
“开发一个具备记忆能力的对话智能体脚本，使用`LangChain`（或`Semantic Kernel`）框架，集成向量数据库进行上下文检索，并结构化输出每次会话的日志。”
“创建一个用于监控系统状态的智能体脚本，定期调用检查API，根据返回状态码和内容触发不同的告警或修复子流程，要求代码模块化，便于添加新检查项。”


风格方向

代码风格：遵循PEP 8规范，强调模块化设计。使用清晰的类与函数划分，注释详尽，尤其对智能体的决策逻辑、状态转换点加以说明。
架构风格：采用清晰的分层结构（如：输入层/决策层/执行层/输出层），或基于事件驱动、状态机的设计模式来组织工作流。
输出风格：脚本输出应包括结构化的执行结果（如JSON、字典）、明确的成功/失败状态以及可读的运行时日志。


构图建议
此处的“构图”指代码结构与逻辑流程的构建：

主次分明：将核心的Agent决策循环（感知-规划-执行-评估）作为脚本主干，工具函数和辅助类作为分支。
流程可视化：在代码注释或文档字符串中，使用ASCII流程图或简要步骤列表描述智能体的工作流，例如：`# 工作流: 用户输入 -> 意图识别 -> 参数提取 -> 工具选择 -> 执行 -> 验证 -> 输出`。
接口清晰：设计明确的输入输出接口，如一个主要的`run(prompt: str)`或`process_task(task_description: str)`方法作为入口。


细节强化

健壮性：在关键步骤（如网络调用、工具执行）添加异常捕获（try-except）和重试逻辑（exponential backoff）。
可观测性：集成日志记录（logging模块），记录智能体的关键决策、工具调用参数及中间结果。
可配置性：将模型参数、API密钥、超时设置等通过配置文件或环境变量管理，提高脚本的适应性。
工具定义：使用装饰器或注册机制清晰定义和管理智能体可用的工具（函数），确保每个工具都有功能描述和参数规范。


使用建议

将“核心提示词”中的示例直接复制到你的AI编程助手（如ChatGPT、Claude、Cursor）中，作为生成脚本的初始指令。
根据具体任务，替换示例中的领域关键词（如“搜索引擎API”替换为“公司内部知识库API”）。
在生成基础代码后，可追加“细节强化”中的要求，例如：“请为上述脚本添加详细的错误处理和日志记录功能。”
本方案侧重于生成脚本的骨架与核心逻辑，生成后需结合实际开发环境进行依赖安装、密钥配置和功能测试。