Agenxia SDK：声明式智能体运行时与A2A协议的创新实践

Agenxia SDK提出声明式智能体构建范式，通过workflow.json配置工作流，暴露单一A2A端点（JSON-RPC的start方法），支持SSE事件流推送执行事件，采用增量执行与智能缓存优化性能，实现A2A协议互操作性，降低智能体开发门槛同时保持灵活性。

Agenxia SDK的核心理念是"声明式智能体"，区别于传统编程式智能体，开发者只需编写workflow.json描述工作流图即可。其核心洞察为：智能体本质是通用工作流执行器，对话交互、工具调用、UI组件联动均可统一建模为工作流执行问题，从而用简洁API支持多样化场景。

架构遵循"少即是多"原则，仅暴露JSON-RPC的start方法作为唯一入口，所有交互统一通过start处理。执行模型高效：首次调用无缓存时按需执行所有节点；后续调用仅重新执行start节点及其后代，其他节点复用缓存。例如日历组件交互时，仅相关节点重新执行，避免重复昂贵请求。

工作流模型引入端口（Handle）概念，通过sourceHandle和targetHandle精确控制数据流转发（如connector-ics的events字段转发到widget-calendar的events端口）。冲突解决规则简单：多条边指向同一targetHandle时，最后定义的边生效，鼓励显式设计数据流。

模块执行器位于modules//execute.js（CommonJS规范），接收inputs、params、context参数返回输出。context.llm可选，SDK仅在配置LLM_API_URL和KEY时创建客户端（优先节点配置，后备环境变量）。无execute.js的模块默认透传输入，适合纯展示UI组件。

提供/a2a/stream端点返回SSE事件流（node_start、node_complete等事件），事件范围限于重新执行的子图，便于前端高效更新。典型场景包括：1.对话式智能体（发送用户消息路由到agent-core节点）；2.交互式组件（如日历选择触发相关节点执行）；3.程序化工作流（初始化引擎并利用缓存）。

Agenxia实现Google的A2A协议，支持智能体互操作性，带来生态优势（无缝集成、工具以智能体形式暴露、灵活编排）。开发者体验友好：零配置启动（自动加载相关文件）、模块化扩展（文件约定）、多层配置（CLI/环境变量/.agent.env）、清晰JSON-RPC错误信息。

Agenxia SDK代表智能体开发范式转变（命令式→声明式、复杂API→单一入口、全量→增量执行），是轻量级且功能完整的解决方案，适合快速构建需交互式组件和复杂工作流的AI应用。其声明式理念与A2A协议支持，为智能体生态系统奠定基础，未来或成主流模式。