AgentNexus

<div align="center"> [简体中文](./README.md) | [English](./README.en.md) </div> <br> <div align="center"> # AgentNexus - Next-Generation Agent Development and Orchestration Hub **A fully functional, hot-swappable, production-grade enterprise Agent infrastructure** </div> <div align="center"> [](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) [](https://spring.io/projects/spring-boot) [](https://spring.io/projects/spring-ai) [](https://github.com/oiii/ai-agent-station/blob/main/LICENSE) [](https://github.com/oiii/ai-agent-station) </div> AgentNexus is not just an AI application framework; it's a fully functional Agent infrastructure designed to address the core challenges of deploying complex AI workflows in enterprise production environments. The platform is deeply built on **Spring AI 1.0.0**, with its core being the realization of **"DB-as-Config" for Agents** and **"API-triggered Hot-Reloading"**, providing developers with unprecedented flexibility and dynamism. We have abandoned hard-coded Agent logic by persisting all core components such as models, tools (MCP), RAG knowledge bases, and prompts in the database. Through an API-driven chain-of-responsibility pattern, Agents are dynamically constructed at runtime, granting the system powerful dynamic orchestration, autonomous collaboration, and full lifecycle management capabilities. --- ## ✨ Core Features 🤖 **Autonomous Multi-Agent Orchestration** > Introduces a "Brain Model" as the central coordinator, based on the *ReAct + Plan-and-Execute* pattern, to achieve dynamic planning, decomposition, and delegation of complex tasks. The system can autonomously analyze user intentions and dynamically load and assemble a temporary **Agent Team** from the database to collaboratively achieve the goal. 🌐 **Pluggable Tools** > Built-in practical tools such as **Internet Search**. Through Spring AI's `ToolCallback` mechanism, any Bean that implements `java.util.function.Function` can be automatically registered as a tool available to the Agent and associated with the specified Agent through the database. 📚 **Production-Ready RAG Engine** > Provides a complete *Retrieval-Augmented Generation (RAG)* solution. Supports uploading files via API or providing a Git repository address to load the entire Git repository, automatically performing text segmentation, vectorization, and storage to **PgVector**, providing Agents with accurate, low-latency external knowledge support. ⚡ **API-Triggered Hot-Reloading and Nacos Integration** > The platform's true highlight lies in its **dynamism**. All components of the Agent (models, tools, memory, prompts, etc.) are stored in the database and can be added, deleted, modified, and queried in real-time through business APIs or **Nacos**. The latest configuration can be assembled into a brand new, usable Agent instance in milliseconds, overwriting the old instance in memory, achieving near real-time updates **without restarting the service**. 💬 **Persistent Chat Memory** > Built-in long-term memory mechanism based on `ChatMemoryRepository`, which persists multi-turn conversation context to the database through `conversationId`, ensuring that the Agent has **cross-session, cross-model** memory capabilities. 🔗 **Workflow Agent** > Supports chaining multiple independent Agents into a **chain workflow** through simple configuration to handle continuous tasks with sequential dependencies. ⏰ **Scheduled Task Trigger** > Supports configuring scheduled tasks through Cron expressions, automatically triggering a preset Workflow Agent at a specified time, perfectly suited for automated business processes such as **report generation, data analysis, and content publishing**. --- ## 🗺️ Roadmap We are excited about the future of AgentNexus and plan to continue evolving in the following directions. Community developers are welcome to participate in the construction! - [ ] **Visual Workflow Designer** - Develop a web-based drag-and-drop interface that allows business personnel to design and orchestrate Agent workflows through graphical operations. - [ ] **Agent Observability Dashboard** - Integrate Prometheus and Grafana to provide a visual dashboard of key metrics such as Agent call performance monitoring, Token consumption, and error rates. - [ ] **Database-Triggered Hot-Reloading** - Introduce a message queue (such as Kafka/RocketMQ) to listen for change events (insert, update, delete) in core business tables, automatically triggering `AgentSyncService` to achieve true "configuration as effect". - [ ] **Expanded Toolset** - Increase support for commonly used enterprise tools, such as: database connection tools (execute SQL), email sending tools, Office document generation tools, etc. - [ ] **Broader API Support** --- ## 🛠️ Technology Stack | Category | Technology | |--------------|----------------------------------------| | **Core Framework** | `Spring Boot 3.2.6`, `Spring Cloud Alibaba` | | **AI Framework** | `Spring AI 1.0.0` | | **Database** | `MySQL 8.0+`, `PostgreSQL 15+` | | **Vector Storage** | `PgVector` (PostgreSQL Plugin) | | **Persistence Layer** | `MyBatis-Plus` | | **Configuration Center** | `Nacos` | | **API Documentation** | `SpringDoc OpenAPI` (Swagger UI) | | **Git Operation** | `JGit` | | **Document Parsing** | `Apache Tika` | --- ## 🏁 Quick Start ### **Environment Preparation** - `Java 17` or higher - `Maven 3.6+` - `MySQL 8.0+` - `PostgreSQL 15+` (requires `pgvector` extension) - `Nacos 2.2.0+` - `Docker` (optional, for quickly starting dependent services) ### **Installation and Running** 1. **Clone the Project** ```bash git clone https://github.com/wozhenbang2004/AgentNexus.git cd AgentNexus ``` 2. **Initialize the Database** In your MySQL database, execute the script in the `sql/schema.sql` file in the project root directory to create all necessary table structures. 3. **Configure Nacos** Create a new configuration in the Nacos console with **Data ID** as `agent-nexus-dev.yml` (or your custom name), **Group** as `DEFAULT_GROUP`, and configuration format as `YAML`. Paste the content of `application.yml` in the project's `resources` directory as a template, and modify the database and API keys of major model vendors according to your environment. 4. **Build and Run the Project** ```bash # Execute in the project root directory mvn clean package -DskipTests # Run the main application java -jar target/AgentNexus.jar ``` ### **API Documentation** 📚 After the project starts, you can visit the following address to view and test all APIs: [`http://localhost:8091/swagger-ui.html`](http://localhost:8091/swagger-ui.html) *(Please modify the port number according to your configuration)* --- ## 🤝 Contribution Guide We welcome contributions of any kind! Whether it's submitting an Issue, fixing a Bug, or contributing a new feature. 1. **Fork** this repository 2. Create your feature branch (`git checkout -b feature/AmazingFeature`) 3. Commit your changes (`git commit -m 'feat: Add some amazing feature'`) 4. Push your branch to the remote repository (`git push origin feature/AmazingFeature`) 5. Create a **Pull Request** --- ## 📄 License This project is open source under the **MIT License**.