zenflow：声明式多智能体编排引擎的设计与实现

zenflow是基于Go语言的生产级多智能体工作流引擎，通过声明式YAML配置、中心协调器架构和可靠的邮箱投递机制，实现多智能体协作编排能力。它旨在平衡简洁性与功能性，解决多智能体系统中的工作流定义、消息可靠传递、并发处理等工程挑战。

随着LLM能力提升，多智能体协作系统面临诸多挑战：如何定义复杂工作流？如何保证消息可靠传递？如何处理并发竞态条件？如何避免失败时数据丢失？现有方案要么过于简单（仅线性执行），要么过于复杂（依赖重量级基础设施），zenflow试图填补这一空白。

zenflow采用中心辐射式（hub-and-spoke）架构，所有智能体通信通过中心协调器转发，避免直接耦合，简化依赖管理与故障隔离。协调器负责消息路由、进度叙述、事件转发及运行最终化；每个智能体拥有独立邮箱，实现显式投递确认与失败追踪。

zenflow用YAML定义工作流，支持步骤、依赖、并行扇出、CEL条件分支、循环、子工作流等原语。声明式设计便于版本控制与协作，运行前会进行严格验证（循环检测、依赖完整性、CEL表达式验证），确保问题提前发现。

zenflow通过Race-safe邮箱投递保证消息不丢失、不乱序、无goroutine泄漏；内置故障恢复机制，基于持久化状态恢复执行，确保已完成步骤不重复，未完成步骤断点续行，实现零数据丢失。

zenflow提供三种执行模式：

1. flow模式：运行确定性YAML DAG，适用于计划明确的场景；
2. goal模式：根据用户输入动态规划工作流，适应自适应调整场景；
3. agent模式：单智能体对话，复用生命周期钩子与提供商路由。此外支持Go库嵌入集成。

zenflow兼容Google Gemini、AWS Bedrock、Azure等主流LLM提供商（支持goai库的均可使用）；提供沙箱模式限制危险工具（如bash），适合自动化场景。部署以单一静态Go二进制发布，支持一键安装、Homebrew、Docker、Go install等多种方式。

zenflow代表多智能体编排工具向生产级演进的趋势，通过声明式配置降低门槛，中心架构简化设计，严格验证提升可靠性。对构建复杂智能体工作流的开发者而言，是值得考虑的工程方案。