站在技术视角，分析 AI Agent 脚手架项目，这样一个产品功能需求的背景、诉求和目的。
首先，脚手架本质上是一种工程化模板体系，可视为标准化的项目骨架。通过少量参数化配置，即可自动完成 IntelliJ IDEA 项目的初始化搭建，并预置常用的基础组件与通用能力，避免在每次新项目启动时重复进行工程结构、依赖管理与基础服务的手动构建。
那么，为什么强调“技术视角”？
在互联网企业中，项目来源通常可以划分为两种类型：其一是围绕具体业务场景展开的产品型需求，其二是由研发体系主导的技术建设类项目（或由基础架构团队牵头打造的技术平台型产品）。后者的核心目标在于提升整体研发效能，减少在支持业务过程中产生的重复性工程工作，并通过统一规范与抽象能力沉淀，推动研发流程的标准化与体系化。
从 AgentWorkflowNode 出发，流程将进入 LoopAgent、ParallelAgent 或 SequentialAgent 等不同类型的节点。这几类节点在流转机制上具有相似性，因此可以采用统一的处理思路进行设计与实现。
接下来，我们将围绕这些节点的共性逻辑进行梳理与处理，以便形成一致的流转规则。
如图，智能体装配中，LoopAgentNode、ParallelAgentNode、SequentialAgentNode 部分；
将构建完成的智能体实例注入到 InMemoryRunner 中，并同步注册到 Spring 容器内。这样一来，后续即可直接从 Spring 上下文中获取对应对象，用于发起 AI Agent 的对话与调用。
在当前实现中，仅将最终生成的 SequentialAgent 写入 InMemoryRunner。后续会进一步优化为动态机制，使任意配置的智能体都能够按需注入，从而提升整体的灵活性与扩展能力。
如图，智能体构建完成后，则填充到 InMemoryRunner 中；
在应用启动阶段，加载智能体的 YAML 配置文件，完成整体装配过程。同时编写相应的测试用例，用于验证智能体加载与运行是否符合预期。
这部分内容将作为后续对话服务开发的基础，帮助明确对话执行的核心流程，包括会话的创建以及消息请求的处理方式。
如图，智能体全部节点构建完成后，在程序启动的时候进行加载；
调整整体架构设计，进一步强化 AgentWorkflowNode 的流程调度能力。将原本由 LoopAgentNode、ParallelAgentNode、SequentialAgentNode 分别承担的流转判断逻辑统一收敛到 AgentWorkflowNode 中处理。
这样一来，各类型节点只专注于自身任务执行，在流程完成后统一返回 AgentWorkflowNode，由其负责后续节点的路由与编排决策。通过这种方式，不仅能够降低节点之间的耦合度，还可以让整个智能体工作流具备更灵活、更复杂的组合编排能力。
采用新的设计思路，提升 AgentWorkflowNode 的流转管理能力，使 LoopAgentNode、ParallelAgentNode 与 SequentialAgentNode 不再承担流转判断的职责。每个节点在完成自身处理后，都会返回 AgentWorkflowNode，由它统一进行流转决策。这种方式能够支持更灵活、复杂的智能体编排和组合，实现多样化的流程控制。
用户在使用 AI Agent 脚手架 时，通常会有扩展自定义 MCP 服务 的需求。比如在智能体客服、企业内部系统巡检等场景中，往往没有现成统一的 MCP 服务可直接使用，因此需要开发者根据自身业务实现本地 MCP 能力，并将其装配到整个智能体流程中。
同时，随着 MCP 接入方式的增加，系统中不仅需要支持 SSE、STDIO 等类型，还要兼容本地自定义实现的 MCP 服务。因此在装配阶段，需要引入相应的策略处理机制，根据不同的 MCP 类型选择对应的创建与加载方式，使整体扩展更加灵活，也便于后续维护。
为 InMemoryRunner 运行器扩展 Plugin 插件机制，使用户能够在智能体执行流程的不同阶段获取运行上下文，并根据实际需求实现监控、干预、治理等扩展能力。
借助插件机制，可以在关键节点进行拦截处理、日志记录、结果输出、性能监控等操作，从而增强系统的可观测性和可扩展性。同时，这种设计模式也广泛应用于各类框架和中间件之中，本质上都是通过扩展点与回调机制实现能力解耦。
如图，增强运行体插件配置，可以在各个节点埋入钩子；
为接入 Google ADK 的 Spring AI 扩展图片识别等多模态能力，使智能体在处理文本对话的同时，也能够接收并理解图片内容。
通过这一能力，用户可以将图片作为输入传递给模型，由模型完成图像内容识别、信息提取、场景理解等操作，从而进一步丰富智能体的交互方式和业务应用场景。
在 ai-agent-scaffold-lite-app项目中，resources 目录下新增文件，测试工程多模态能力。
当智能体装配完成后，下一步需要对外提供统一的会话服务能力，作为智能体运行与交互的基础入口。服务内容主要涵盖已注册智能体列表查询（agentId）、会话实例创建，以及消息处理能力，包括同步响应和异步响应两种交互模式。
如图，会话接口服务所在分层；
