基于 SpringAi 的模块化设计 Agent 框架,像搭积木一样搭建 Agent。 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
如果想在 V2EX 获得更好的推广效果,欢迎了解 PRO 会员机制:
pro/about
cKnight

基于 SpringAi 的模块化设计 Agent 框架,像搭积木一样搭建 Agent。

  •  1
     
  •   cKnight 2025 年 7 月 31 日 2034 次点击
    这是一个创建于 263 天前的主题,其中的信息可能已经有所发展或是发生改变。

    写在前面

     项目的起因是,在使用 SpringAi 1.0 的时候想要使用 Qwen 作为 ChatModel ,但发现 SpringAi 没有写对应的依赖,而且要用某一个 LLM 还要引用对应的依赖。后面就想自己抽象一层,能让 LLM 无缝接入,就开始看源码和 debug ,这样就有了初版。 后面看来几篇博文,表达的意思大概是现有的几款框架( LangChain 等)能够解决 80%的问题,但是剩下 20%是无法逾越的鸿沟,最终还是要深入底层修改 Prompt 等。所以要使用“搭积木”的方式搭建属于企业自身业务的框架。受此启发在 SpingAi 的基础上,搞了这么个项目。 

    地址:AgentBrick

    核心亮点

    1. LLM 的通用适配能力
      • 基于 Spring AI 的 OpenAI 核心代码进行二次抽象,使得框架能够轻松适配不同厂商的 LLM (如 Qwen 、Kimi 、MiniMax 、ZhiPu 等)。
      • 提供统一的 ChatModel 接口,屏蔽底层实现差异,降低开发复杂度。
        @Bean(ChatModelConstants.KIMI_K2_CHAT_MODEL) public KimiChatModel kimiK2ChatModel(@Qualifier("kimiApi") AiCommonApi kimiApi){ return (KimiChatModel) LLMEnum.KIMI.genChatModel( KimiOptions.builder() .model(ChatModelEnum.KIMI_K2) .temperature(0.7) .maxTokens(8048) .build(), kimiApi ); } 
    2. 积木式 Agent 构建
      • 支持模块化搭建 Agent ,用户可以自由组合 Prompt 、Context 和 Tools 。
      • 各个环节灵活搭配
        • 上下层分离。项目中使用 Dify 的知识库检索,作为底层 RAG 检索能力。上层编写符合业务的 RAG 策略。各个层次可随时更换搭配。
        • LLM 分离。可根据不同的 Agent 搭配不同的 LLM ,若出现更加符合 Agent 能力的 LLM 可随时更换,不影响业务代码。
        • Prompt 分离。测试不同 Prompt 以寻找最符合 Agent 要求的 Prompt 。
      • 编写符合业务逻辑的 Agent 架构
        • 项目中使用开源项目OWL为例,使用 Agent 快速搭建。
       @Bean(AgentConstants.RAG_AGENT) public RagAgent ragAgent(@Qualifier(ChatModelConstants.QWEN_3_PLUS_CHAT_MODEL) QwenChatModel qwenChatModel, RagTools ragTools){ return RagAgent.builder() .chatModel(qwenChatModel) .prompt(AgentPromptConstants.RAG_AGEMNT_SYSTEM_PROMPT) .tools(ragTools) .build(); } 
    3. 高效的数据查询与处理
      • 基于 MyBatis-Plus 进行二次封装,提供更简洁、高效的数据库查询接口。
      @Override public Map<Long,ChatRecordMsgJsonDto> queryMsg(List<Long> ids) { if (CollectionUtils.isEmpty(ids)){ return Map.of(); } return where(aiChatRecordMsgMapper) .in(BaseDO::getId, ids) .hasMap( BaseDO::getId, v-> JSONObject.parseObject(v.getMsgDetail().toString(),ChatRecordMsgJsonDto.class) ); } 

    技术架构

    JDK21+Spring Ai 1.0+Spring Boot 3.4+PostgreSql+Redis7.x

    4 条回复    2025-08-01 11:23:20 +08:00
    snow0
        1
    snow0  
       2025 年 8 月 1 日
    Agent 有类似 LangChain 里面的高阶功能 loop 、策略配置吗
    我看上面代码构建的 Agent 只循环一次
    cKnight
        2
    cKnight  
    OP
       2025 年 8 月 1 日
    @snow0 可以看下项目里面使用 Agent 快速搭建 OWL 的那个例子,在这个 OwlAgentStrategy 类中。项目主要是想要快速构建单个 Agent ,然后如何搭配使用要看自己具体的需求。未来会对 Prompt 进行优化,更加系统化和规范化。
    cKnight
        3
    cKnight  
    OP
       2025 年 8 月 1 日
    @snow0 单个 Agent 的话,可以看下 RagAgent 这个是在单个 Agent 中增加逻辑,不是简单的调用 LLM 。
    snow0
        4
    snow0  
       2025 年 8 月 1 日
    @serverKnignt #2 我学习下
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     6009 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 142ms UTC 02:58 PVG 10:58 LAX 19:58 JFK 22:58
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86