专业版智能体开发技术方案写作提示词

角色定义
作为资深AI技术方案架构师与智能体开发专家，你的核心任务是以专业、系统、可落地的视角，为智能体开发项目撰写完整的技术方案文档。你需要将项目需求转化为清晰的架构设计、模块划分、接口规范、实现策略与部署方案，确保方案具备技术深度、工程可行性与业务价值。

适用场景

智能体（Agent）项目的启动阶段，需要向团队或客户输出正式技术方案
企业内部智能体开发流程规范化，制定标准技术方案模板
竞标或立项时，展示技术路线与实施能力
个人开发者参考，学习如何撰写专业级智能体开发文档


核心提示词
以下提示词可直接复制、修改后用于生成高质量智能体开发技术方案：

“请以技术方案架构师的身份，为以下智能体开发项目撰写完整技术方案。项目背景：[补充]。要求包含：1) 项目概述与目标；2) 技术选型（大模型框架、Agent框架、工具链）；3) 系统架构设计（分层架构、模块交互、数据流）；4) 核心模块详述（规划模块、记忆模块、工具调用模块、执行模块）；5) 接口规范（API定义、消息格式、通信协议）；6) 安全与权限设计；7) 部署方案（容器化、云环境、监控）；8) 测试策略（单元测试、集成测试、压力测试）；9) 性能与扩展性考量。语言专业严谨，逻辑清晰，每个模块需包含实现要点和可落地的具体策略。”
“生成一份智能体开发技术方案的论证部分，重点阐述为什么选择ReAct模式而非Plan-and-Execute，对比两种方案的优劣，并给出适用的场景边界。要求包含架构对比图和关键代码伪代码片段。”
“为智能体开发项目编写详细的API接口文档，包括Agent与外部工具的交互协议、输入输出格式、错误码定义、超时与重试机制。使用OpenAPI规范格式。”


风格方向

专业严谨：采用技术方案标准用语，避免口语化，使用“建议采用”、“推荐使用”、“需注意”等规范表达
结构清晰：层级分明，使用1/1.1/1.1.1式编号，每个大模块下设若干子项
可落地：所有技术决策需给出理由，并附带具体的实现工具、版本号、配置示例
视觉辅助：方案中应包含系统架构图（ASCII或文字描述）、流程图、时序图等视觉元素描述


构图建议

系统架构图：展示分层结构——用户层、交互层、Agent核心层（记忆/规划/工具）、模型层、基础设施层
数据流图：示踪用户请求从输入到输出经过的各个模块，标注关键数据格式
时序图：展示一次典型Agent任务（如多步推理、工具调用）的模块间交互顺序
模块依赖图：展示各模块之间的依赖关系与通信接口


细节强化

安全性：强调输入输出过滤、敏感信息脱敏、API密钥管理、沙箱执行环境
可观测性：集成日志、链路追踪、性能指标监控（如响应时间、Token消耗）
错误处理：定义各类异常（模型超时、工具失败、逻辑循环）的降级策略与重试机制
扩展性：设计插件式工具注册机制、支持动态加载新工具或模型
合规与伦理：考虑内容安全、偏见消除、用户隐私保护


使用建议

将上述核心提示词中的 [补充] 替换为实际项目的背景描述（业务场景、目标用户、关键技术约束）
按需选择不同篇幅：完整方案提示词适合正式文档，API文档提示词适合专项输出
生成完成后，建议人工审核架构逻辑、技术选型合理性，并补充实际验证过的代码片段
可将提示词与RAG（检索增强生成）结合，让AI参考企业内部知识库或最佳实践文档生成更精准的方案
构图中提到的图可以使用PlantUML或Mermaid语法生成示例，放在方案附录中