AI智能体基础平台

ai-agnet-base/
├── blank/                          # 后端服务
│   ├── agent/                      # AI智能体模块
│   │   ├── conversation_agent.py   # 对话智能体
│   │   ├── research_topic_agent.py # 科研方案智能体
│   │   ├── keyword_expansion_agent.py # 关键词扩展智能体
│   │   ├── translation_agent.py    # 翻译智能体
│   │   └── deep_search_agent.py   # 深度搜索智能体
│   ├── api/                        # API路由模块
│   │   ├── auth_routes.py         # 认证路由
│   │   ├── conversation_routes.py # 对话路由
│   │   ├── user_routes.py         # 用户管理路由
│   │   └── ...                    # 其他路由
│   ├── models/                     # 数据模型
│   ├── schemas/                    # 数据模式
│   ├── services/                   # 业务服务
│   ├── config.py                   # 配置文件
│   ├── main.py                     # 主应用入口
│   └── requirements.txt            # Python依赖
├── frontend/                       # 前端应用
│   ├── src/                        # 源代码
│   │   ├── components/             # Vue组件
│   │   ├── views/                  # 页面视图
│   │   ├── stores/                 # 状态管理
│   │   ├── services/               # API服务
│   │   └── router/                 # 路由配置
│   ├── package.json                # Node.js依赖
│   └── vite.config.ts              # Vite配置
└── start_all.sh                    # 一键启动脚本

git clone <repository-url>
cd ai-agnet-base

cd blank

# 创建虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate  # Linux/Mac
# 或
.venv\Scripts\activate     # Windows

# 安装依赖
pip install -r requirements.txt

cd frontend

# 安装依赖
npm install
# 或
pnpm install
# 或
yarn install

cd blank
cp env.example .env

# 数据库配置
DATABASE_URL=mysql+aiomysql://username:password@localhost:3306/ai_agent_db

# Redis配置
REDIS_URL=redis://localhost:6379

# Elasticsearch配置 (可选)
ES_HOST=localhost
ES_PORT=9200

# AI模型配置
QWEN3_API_KEY=your_api_key_here
OPENAI_API_KEY=your_openai_key_here

# 应用配置
HOST=0.0.0.0
PORT=8000
DEBUG=true

cd blank

# 创建数据库
mysql -u root -p -e "CREATE DATABASE ai_agent_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 运行数据库迁移
alembic upgrade head

# 初始化管理员账号
python3 scripts/init_admin.py

# 在项目根目录
chmod +x start_all.sh
./start_all.sh

cd blank
source .venv/bin/activate
python3 main.py

cd frontend
npm run dev
# 或
pnpm dev
# 或
yarn dev

cd blank
python3 scripts/init_admin.py

// 前端调用示例
import { postJSON } from '@/services/api';

const response = await postJSON('/conversation/chat', {
  message: '你好，请介绍一下人工智能',
  model: 'qwen3',
  temperature: 0.7
});

const response = await postJSON('/research/topic', {
  research_direction: '机器学习',
  requirements: '需要包含算法原理和实现方案',
  model: 'qwen3'
});

const response = await postJSON('/keyword-expansion/expand', {
  base_keywords: ['机器学习', '深度学习'],
  domain: '计算机科学',
  model: 'qwen3'
});

const response = await postJSON('/translation/translate', {
  text: 'Hello, how are you?',
  source_lang: 'en',
  target_lang: 'zh',
  model: 'qwen3'
});

const response = await postJSON('/deep-search/search', {
  query: '机器学习最新进展',
  filters: {
    year: '2024',
    domain: 'AI'
  },
  model: 'qwen3'
});

# 使用一键启动脚本
./start_all.sh

# docker-compose.yml
version: '3.8'
services:
  backend:
    build: ./blank
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=mysql://user:pass@mysql:3306/ai_agent_db
      - REDIS_URL=redis://redis:6379
    depends_on:
      - mysql
      - redis
  
  frontend:
    build: ./frontend
    ports:
      - "80:80"
    depends_on:
      - backend
  
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: ai_agent_db
    volumes:
      - mysql_data:/var/lib/mysql
  
  redis:
    image: redis:6-alpine
    volumes:
      - redis_data:/data

volumes:
  mysql_data:
  redis_data:

server {
    listen 80;
    server_name your-domain.com;
    
    # 前端静态文件
    location / {
        root /var/www/frontend;
        try_files $uri $uri/ /index.html;
    }
    
    # API代理
    location /ai-api/ {
        proxy_pass http://backend:8000/ai-api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

# 测试API文档
curl http://localhost:8000/ai-api/docs

# 测试认证接口
curl http://localhost:8000/ai-api/auth/me

# 测试对话接口
curl -X POST http://localhost:8000/ai-api/conversation/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello", "model": "qwen3"}'

# 检查MySQL服务状态
sudo systemctl status mysql

# 检查数据库连接
mysql -u username -p -h localhost -P 3306

# 检查Redis服务状态
sudo systemctl status redis

# 测试Redis连接
redis-cli ping

# 后端日志
tail -f backend.log

# 前端日志
tail -f frontend.log

# 系统日志
sudo journalctl -u your-service -f