内容摘录
<p align="center">
<img src="./docs/assets/images/banner.png"/>
</p>
<p align="center">
<strong>An Elegant Java Framework for LLM Application Development | Truly Open Source · Easy Integration · Production Ready</strong>
</p>
🚀 Core Features
Agents-Flex is designed for Java engineers and architects, delivering a **lightweight, modular, and extensible** AI agent development experience to help enterprises rapidly build production-grade LLM applications.
✨ New Core Capabilities (v2.0+)
| Feature | Description | Use Cases |
|---------|-------------|-----------|
| **MCP Support** | Native integration with Model Context Protocol for standardized connection to external data sources and tools | Cross-system context sharing, tool orchestration |
| **AI Skills** | Encapsulate business capabilities into reusable, composable Skill units | Rapid domain Agent construction, skill marketplace |
| **Text2SQL / Smart Data Query** | Built-in Text2SQL and natural language data analysis capabilities | Zero-code querying for business users, data insights |
🔧 Core Capabilities Matrix
💡 **Design Principles**: Zero-Intrusion Integration · Interface-Driven Extension · Configuration Over Code · Production-Friendly
⚡ Quick Start
1️⃣ Add Dependencies (Maven)
2️⃣ Hello World
**Console Output Example**:
📝 The [Agents-Flex] log prefix can be customized or disabled via application.properties. For production environments, SLF4J integration is recommended.
📦 Module Overview
✅ **Production-Ready Recommendations**:
Use agents-flex-spring-boot-starter with a configuration center for API key management in production
Inject sensitive information (API Keys / DB passwords) via @Value("${xxx}") + encrypted configuration
Enable management.endpoints.web.exposure.include=metrics,trace for monitoring integration
For RAG scenarios, combine: data + embedding + store + rerank modules
📚 Documentation & Resources
| Type | Link | Description |
|------|------|-------------|
| 📘 Chinese Docs | https://agentsflex.com | Complete API guide + best practices |
| 🧪 Sample Projects | /demos | MCP integration / Skills orchestration / Text2SQL demos |
| 📋 Changelog | /changes.md | Version history and migration guide |
| 🐛 Issue Tracker | GitHub Issues | Bug reports / feature requests |
| 💬 Community | Join Discussion | Q&A, ideas, and community support |
🤝 Contributing
We follow the Apache Way and Contributor Covenant guidelines:
Fork the repo → Create a feature branch (feature/xxx)
Code style: Run mvn spotless:apply for auto-formatting (Google Java Style)
Add unit tests: Aim for ≥ 80% coverage on core modules
Submit a PR linked to an issue, describing the motivation and impact of changes
🌟 Especially welcome: Java 8/11/17 compatibility tests, enterprise use cases, and documentation translations
---
📜 License
Agents-Flex is released under the **Apache License 2.0**. You are free to:
✅ Use commercially in your projects
✅ Modify and deploy privately
✅ Contribute code to grow the ecosystem
Please retain the original copyright notice and indicate modifications when distributing. See LICENSE for details.