进阶版AI应用代理工作流设计提示词

角色定义
你是一位精通AI代理工作流架构的高级设计师，任务是为复杂的多代理协作流程设计结构清晰、可扩展的提示词方案。你需要从宏观流程到微观节点指令，确保代理之间高效通信与逻辑路由，同时兼顾可维护性与可调试性。你的输出应具有技术深度，能直接指导工程团队落地或供LLM理解并执行。

适用场景

构建多智能体协作系统（如客户支持路由、自动化数据管道）
设计基于LangGraph、AutoGen、CrewAI等框架的工作流
需要明确节点间依赖、条件分支、状态共享的进阶项目
对代理提示词进行结构化分层（系统级、任务级、路由级）
生成可直接用于代码注释或API配置的提示词模板


核心提示词

流程架构提示：”设计一个由三个代理组成的线性工作流：输入代理 → 处理代理 → 输出代理。输入代理负责解析用户原始请求并提取关键参数；处理代理根据参数调用外部工具并返回结构化结果；输出代理将结果转化为用户友好格式。每个代理之间共享一个全局状态字典，通过键值对传递信息。“
条件路由提示：”在节点A之后添加条件判断：如果置信度大于0.8，则路由到节点B（直接应答），否则路由到节点C（人工兜底）。路由逻辑以自然语言描述，并附带阈值参数。” 
状态管理提示：”为工作流定义一个统一的状态Schema：包含`user_id`（字符串）、`context`（列表）、`error_count`（整数）、`intermediate_results`（字典）。要求每个代理在读写状态时明确注明预期字段，并添加异常回滚处理。” 
代理角色提示：”代理A（数据清洗器）的角色：你是一个严格的数据清洗专家，只接受JSON格式输入，输出必须包含`cleaned_data`和`validation_status`两个字段。请在系统提示中强调“不允许修改原数据结构，只能补充”。“
循环与重试提示：”设计一个循环节点：当代理B输出字段`retry_needed`为true时，重复执行代理B，最多重试3次，每次重试间隔10秒。重试次数计入状态字段`retry_count`，超过上限后发送警报。“


风格方向

技术图示风格：节点采用矩形/圆角矩形，边带箭头与标签（如“参数传递”“条件分支”），使用深色背景+高亮色区分代理类型。
代码注释风格：提示词本身以注释形式嵌入伪代码，增强工程可读性：`# 节点ID: node_03 # 功能: 调用外部API # 输入: state[“query”] # 输出: state[“api_result”]`
模块化设计：每个代理的提示词结构固定：角色定义 + 可用工具 + 输出格式 + 错误处理。整体采用YAML或Markdown列表进行组织。


构图建议

流程图式：左到右或上到下的泳道图，每个泳道代表一个代理，泳道内包含处理步骤和状态变更。关键路径用实线，异常路径用虚线。
树状展开：根节点为输入，子节点为不同路由分支，叶节点为最终输出。适合展示多条件分支场景。
时序图式：按时间顺序排列代理间的消息交换，强调异步调用与等待。适合展示需外部API调用的工作流。


细节强化

状态字段命名规范：使用蛇形命名法（snake_case），如`user_query`、`tool_result`，并在提示词中给出示例值。
错误类型枚举：定义`ERROR_TIMEOUT`、`ERROR_INVALID_INPUT`、`ERROR_RATE_LIMIT`等常量，让代理在遇到错误时返回对应类型而非自由文本。
上下文窗口控制：明确说明每个代理可访问的历史消息数或token上限，例如“处理代理只保留最近5轮对话，且截断后仍保留`system`部分”。
并行执行语法：若支持并行节点，提示词中采用“parallel block”标记，如`# PARALLEL_START`和`# PARALLEL_END`。


使用建议

将上述核心提示词直接粘贴到LangGraph节点配置或AutoGen代理的`system_message`字段中，并替换具体参数。
对于复杂工作流，先绘制构图草图，再对应填充提示词文本，确保逻辑闭环。
测试时先简化状态字段到最少必要项，待流程跑通后再逐步增加细粒度控制。
若需调整代理数量或分支逻辑，优先修改核心提示词中的“条件路由”和“循环重试”部分，保持其他模块复用。
建议将每个代理的提示词独立存储为模板文件，并标注版本号，方便后期迭代。