# AI 智能体

**Repository Path**: DDF-c/ai-intelligent-agent

## Basic Information

- **Project Name**: AI 智能体
- **Description**: SpringAI + RAG + MCP + Agent 开发 AI 恋爱大师应用 + 拥有自主规划能力的超级智能体
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-10-31
- **Last Updated**: 2026-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Yu AI Agent

A smart agent system based on Spring Boot, providing multiple AI functionalities including chat, tool invocation, search, and file operations.

## Project Structure

- `YuAiAgentApplication.java`: The Spring Boot main class and entry point.
- `agent/`: Contains core logic for AI agents, such as `BaseAgent`, `ReActAgent`, and `ToolCallAgent`.
- `app/LoveApp.java`: Main application logic offering chat, report generation, tool invocation, and other features.
- `controller/`: Provides REST API endpoints, such as `AiController` and `HealthController`.
- `tools/`: Various utility classes including file operations, PDF generation, web search, and terminal command execution.
- `rag/`: Implementation of Retrieval-Augmented Generation (RAG) based on vector storage.
- `advisor/`: Aspect classes for logging and request interception.
- `config/`: Configuration classes, such as CORS settings and tool registration.
- `demo/`: Demonstrations of how to invoke AI models.
- `test/`: Unit test classes.

## Features

- **AI Chat**: Supports synchronous and streaming chat (SSE).
- **Tool Invocation**: Supports multiple tools such as file read/write, PDF generation, web search, and terminal command execution.
- **RAG Retrieval**: Retrieval-Augmented Generation based on vector storage.
- **Logging**: Logs request and response information via aspect classes.
- **Health Check**: Provides a `/health` endpoint for health monitoring.

## Quick Start

### Prerequisites

- Java 17+
- Maven 3.8+
- Spring Boot 3.x

### Installation Steps

1. Clone the project:

   ```bash
   git clone https://gitee.com/DDF-c/ai-intelligent-agent.git
   ```

2. Navigate to the project directory:

   ```bash
   cd ai-intelligent-agent
   ```

3. Build the project:

   ```bash
   mvn clean install
   ```

4. Start the project:

   ```bash
   mvn spring-boot:run
   ```

### Usage Examples

#### Synchronous Chat

```bash
GET /ai/love_app/chat/sync?message=Hello&chatId=123
```

#### Streaming Chat (SSE)

```bash
GET /ai/love_app/chat/sse1?message=Hello&chatId=123
```

#### Tool Invocation

```bash
GET /ai/manus/chat?message=Write file
```

#### Health Check

```bash
GET /health
```

## Contribution Guidelines

Contributions are welcome! Please follow these steps:

1. Fork the project.
2. Create a new branch.
3. Commit your changes.
4. Submit a Pull Request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.