agents-flex

一个轻量级的Java AI智能体开发框架,支持RAG、MCP、技能、Text2SQL等多种能力。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:agents-flex。
它的用途是:一个轻量级的Java AI智能体开发框架,支持RAG、MCP、技能、Text2SQL等多种能力。
详细介绍见:https://321skill.com/skills/agents-flex/
请根据该页面的说明完成安装。

使用示例

“帮我用Agents-Flex框架搭建一个简单的企业知识库问答原型。” 它会引导你引入agents-flex-core、agents-flex-chat(如对接通义千问)和agents-flex-store(如使用Redis向量库)等模块,并编写文档加载、向量入库和检索问答的示例代码。

介绍

Agents-Flex 旨在解决Java开发者构建AI应用时面临的框架臃肿、依赖复杂、难以灵活组合不同AI能力的问题。它通过模块化设计,将LLM调用、工具调用、智能体、RAG、向量存储等核心功能拆分为独立模块,开发者可以像搭积木一样,仅引入项目所需的部分,无需绑定特定的运行时或应用框架。

使用上,开发者可以通过引入核心依赖和相应的模型集成模块(如agents-flex-chat),快速配置并调用多种AI模型。框架提供了统一的API抽象(如ChatModel、EmbeddingModel),以及同步与流式调用的一致体验,极大简化了开发流程。

它非常适合Java生态中的后端开发、全栈开发和智能体开发者,用于构建智能客服、企业知识库、自然语言数据分析、Agent工作流、模型网关等需要灵活集成AI能力的服务。

建议在项目初期根据具体需求规划所需模块,例如,若仅需对话和向量检索,可引入core、chat和store模块。注意,虽然框架轻量,但涉及生产部署时,仍需关注模型路由、重试、熔断等内置的生产级特性配置。

核心特点

与Spring AI等框架相比,Agents-Flex定位更轻量、模块化程度更高,不强制依赖Spring生态,核心模块兼容Java 8+,可在纯Java或任何JVM栈中运行;同时,它原生集成了MCP客户端、基于文件系统的技能加载、Text2SQL安全拦截器等特色能力,提供了更完整的AI应用开箱即用组件。

注意事项

对于非Java技术栈或追求极简脚本化开发的场景可能不是最佳选择。

常见问题

Agents-Flex和Spring AI有什么区别?

Agents-Flex更轻量、模块化,不依赖Spring,兼容Java 8+,支持MCP、技能沙箱等特色功能。

如何用Agents-Flex快速搭建一个RAG应用?

引入core、chat、embedding、store模块,配置文档加载、切分、向量化存储和检索链即可。