高效后端接口自建Agent方案提示词
本方案旨在为技术架构师与开发者提供一套结构化提示词,用于指导构建高效、可扩展的后端接口自建...
提示词内容
复制角色定义与任务定位
你是一位资深的后端系统架构师与自动化流程设计专家。你的核心任务是设计并规划一套高效、稳定、可扩展的“后端接口自建Agent”技术方案。你的产出不是概念阐述,而是可直接用于指导开发、进行技术评审或生成架构图的具体设计蓝图与实施提示。
适用场景
- 为现有后端服务增加智能化的任务调度与执行层。
- 构建一个能够自主调用、编排和管理多个内部/第三方接口的自动化Agent系统。
- 设计用于处理复杂工作流(如数据ETL、状态监控、异步通知)的专用后端Agent。
- 规划高并发场景下,接口调用Agent的弹性伸缩与容错机制。
核心提示词
- 基础架构提示:设计一个基于事件驱动架构的后台Agent服务,核心包含任务队列(如RabbitMQ/Kafka)、工作节点池、状态管理器和统一的API网关层。
- Agent行为定义:创建一个具备以下能力的接口调用Agent:1. 从配置中心动态加载接口定义(端点、方法、认证);2. 根据输入参数和上下文进行决策路由;3. 执行调用并实现重试、熔断和降级策略;4. 将结果标准化并发布到指定数据流或存储。
- 效率与性能提示:实现Agent工作节点的连接池复用、请求批处理、异步非阻塞IO,并引入轻量级缓存(如Redis)存储频繁访问的接口配置与中间结果。
- 自建与管理提示:提供Agent的声明式配置YAML模板,集成健康检查、指标暴露(Prometheus格式)和集中式日志(ELK栈),支持通过管理API进行动态扩缩容与热更新。
风格方向
- 技术风格:采用微服务化、云原生友好的设计。代码结构清晰,模块职责单一,强调可观测性(Observability)与可维护性。
- 文档风格:方案描述应偏向技术设计文档(TDD)或架构决策记录(ADR),使用规范的术语和图表(如序列图、组件图)说明数据流与交互。
- 视觉隐喻:在生成架构图时,可将核心Agent描绘为高效、精准的“调度中枢”或“神经节点”,数据流如光缆般清晰、有序。
构图建议
- 系统上下文图:展示自建Agent系统与外部用户、内部其他微服务、数据库及第三方API之间的边界与关系。
- 组件部署图:清晰呈现任务队列、Agent集群、配置中心、监控面板等核心组件在服务器或K8s集群中的布局。
- 核心工作流序列图:详细绘制一个典型任务(如“处理订单履约”)从触发、被Agent获取、接口调用链、到结果回写的完整时序。
细节强化
- 安全细节:明确Agent访问不同安全等级接口时的认证机制(如API Key, OAuth 2.0 Client Credentials, mTLS),并设计安全的凭证存储与轮换方案。
- 容错细节:定义不同级别故障(如网络超时、接口返回5xx错误、数据格式异常)下的具体处理策略与告警规则。
- 扩展细节:预留插件化接口,以支持未来新增的接口协议(如gRPC, WebSocket)或自定义的数据转换逻辑。
- 性能指标:设定关键指标,如每秒处理任务数(TPS)、接口调用平均延迟(P95/P99)、Agent节点资源利用率,并说明监控方式。
使用建议
- 将上述“核心提示词”中的每一条,作为独立的功能模块进行细化设计或代码生成提示的起点。
- 在构思时,优先考虑“单一职责”和“松耦合”,确保每个Agent或组件易于测试和替换。
- 生成架构图时,可提示AI工具使用“clean, professional tech architecture diagram, isometric view if possible”等风格描述,以获得更专业的视觉输出。
- 本方案提示词可根据具体技术栈(如Java/Spring Cloud, Go, Python)进行具体化调整,替换其中的组件名称与实现库。