# agent_management

**Repository Path**: taomac/agent_management

## Basic Information

- **Project Name**: agent_management
- **Description**: agent_management
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI智能体应用管理系统

一个基于Python Flask和PostgreSQL的AI智能体管理平台，提供智能体的创建、配置、管理和监控功能。

## 功能特性

- 🤖 **智能体管理**: 支持AI智能体的增删改查操作
- 🔧 **配置管理**: 提供API配置、密钥管理等
- 💬 **提示词管理**: 支持多种用途的提示词配置
- 📱 **响应式设计**: 完美适配桌面端、平板端和移动端
- 🎨 **现代化UI**: 采用渐变色彩和精美动画效果
- ⚡ **实时交互**: 流畅的用户体验和表单验证
- 📊 **智能布局**: 自适应网格布局，支持多屏幕尺寸

## 技术栈

- **后端**: Python 3.8+, Flask 2.3.3
- **数据库**: PostgreSQL (也支持SQLite作为开发环境)
- **前端**: HTML5, CSS3, JavaScript (Tailwind CSS)
- **ORM**: SQLAlchemy
- **其他**: Flask-CORS, python-dotenv

## 项目结构

```
ai-agent-manager/
├── app.py                    # Flask应用主文件
├── models.py                 # 数据库模型定义
├── config.py                 # 配置文件
├── requirements.txt          # Python依赖
├── .env.example             # 环境变量示例
├── README.md               # 项目说明
├── API_DOCUMENTATION.md     # 详细API文档
├── openapi.yaml            # OpenAPI规范文件
├── api_test_tool.py        # API测试工具
├── test_edit_fix.py        # 编辑功能测试
├── test_prompt_fix.py      # 提示词功能测试
├── diagnose_edit.py        # 系统诊断工具
├── preview_layout.py       # 布局预览工具
├── init_database.py        # 数据库初始化脚本
├── run.sh                 # 启动脚本
└── templates/              # HTML模板
    └── index.html          # 主页面
```

## 快速开始

### 1. 环境准备

```bash
# 克隆项目
git clone <repository-url>
cd ai-agent-manager

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate  # Windows

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

### 2. 配置环境变量

```bash
# 复制环境变量模板
cp .env.example .env

# 编辑.env文件，配置数据库连接等信息
# DATABASE_URL=postgresql://username:password@localhost/ai_agents_db
```

### 3. 数据库设置

**使用PostgreSQL (推荐):**

```bash
# 创建数据库
createdb ai_agents_db

# 初始化数据库
python -c "from app import app, db; app.app_context().push(); db.create_all()"
```

**使用SQLite (开发环境):**

```bash
# 默认会自动创建sqlite:///ai_agents.db
python -c "from app import app, db; app.app_context().push(); db.create_all()"
```

### 4. 启动应用

```bash
python app.py
```

访问 http://localhost:5000 即可使用系统。

### 5. 布局测试（可选）

```bash
python preview_layout.py
```

生成测试数据用于验证响应式布局效果。

## ⚠️ 常见问题

### Chrome DevTools 404错误

如果看到以下错误信息：
```
"GET /.well-known/appspecific/com.chrome.devtools.json HTTP/1.1" 404 -
```

这是Chrome开发者工具的正常行为，**不会影响系统功能**。系统已经做了以下处理：

1. ✅ 创建了DevTools配置文件
2. ✅ 添加了路由处理404请求
3. ✅ 返回空JSON响应避免错误

**解决方案**：
- 完全忽略此错误（推荐）
- 或者在浏览器中禁用开发者工具扩展

### 编辑功能无法获取智能体信息

如果点击编辑按钮时显示"获取智能体信息失败"，请按以下步骤排查：

1. **检查Flask应用**：
   ```bash
   python diagnose_edit.py
   ```

2. **重启应用**：
   ```bash
   python app.py
   # 或
   ./run.sh
   ```

3. **重新初始化数据库**：
   ```bash
   python init_database.py
   ```

4. **生成测试数据**：
   ```bash
   python preview_layout.py
   ```

5. **浏览器检查**：
   - 打开开发者工具 (F12)
   - 查看Console标签的错误信息
   - 查看Network标签的API请求状态

**常见原因**：
- Flask应用未启动
- 数据库连接问题
- 浏览器缓存问题
- API端点缺失（已修复）

### 数据库连接问题

如果遇到数据库连接错误：

```bash
# 检查PostgreSQL服务状态
sudo systemctl status postgresql

# 使用初始化脚本重新创建数据库
python init_database.py
```

## 📊 API接口

### 📖 完整文档

- **[API文档 (Markdown)](API_DOCUMENTATION.md)** - 详细的API使用说明
- **[OpenAPI规范](openapi.yaml)** - 标准化的API规范文件

### 🔗 快速参考

#### 智能体管理
- `GET /api/agents` - 获取所有智能体
- `GET /api/agents/<id>` - 获取单个智能体（含提示词）
- `POST /api/agents` - 创建新智能体
- `PUT /api/agents/<id>` - 更新智能体
- `DELETE /api/agents/<id>` - 删除智能体

#### 提示词管理
- `GET /api/agents/<id>/prompts` - 获取智能体的提示词
- `POST /api/agents/<id>/prompts` - 为智能体添加提示词

#### 辅助接口
- `GET /.well-known/appspecific/com.chrome.devtools.json` - Chrome DevTools配置

### 🛠️ API测试工具

```bash
# 测试API功能
python test_edit_fix.py      # 测试编辑功能
python test_prompt_fix.py    # 测试提示词功能
python diagnose_edit.py      # 系统诊断
```

## 配置说明

### 智能体配置字段

- **智能体名称**: 必填，智能体的显示名称
- **描述**: 可选，智能体功能描述
- **API URL**: 可选，AI服务的API地址
- **API Key**: 可选，API认证密钥

### 提示词配置字段

- **提示词名称**: 提示词的标识名称
- **用途**: 下拉选择，支持聊天、写作、分析、翻译、编程、其他
- **提示词内容**: 大文本域，输入具体的提示词内容

## 部署指南

### 生产环境部署

1. **环境配置**:
   ```bash
   export FLASK_ENV=production
   export DATABASE_URL=postgresql://user:pass@host/dbname
   ```

2. **使用Gunicorn**:
   ```bash
   pip install gunicorn
   gunicorn -w 4 -b 0.0.0.0:5000 app:app
   ```

3. **使用Nginx反向代理**:
   ```nginx
   location / {
       proxy_pass http://127.0.0.1:5000;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
   }
   ```

## 功能演示

### 测试用例

以下是一些测试用的输入示例：

**测试用例1: 创建GPT智能体**
```
智能体名称: GPT-4 Assistant
描述: 基于OpenAI GPT-4的通用对话助手
API URL: https://api.openai.com/v1
API Key: sk-xxxxx
```

**测试用例2: 创建本地智能体**
```
智能体名称: 本地LLM
描述: 基于本地部署的开源大语言模型
API URL: http://localhost:8080/api
API Key: local-key
```

**测试用例3: 提示词配置**
```
提示词名称: 代码审查
用途: 编程
提示词内容: 请帮我审查以下代码，检查代码质量、性能问题和潜在的bug。
```

## 预期结果

系统应该能够：

1. **成功创建智能体**: 表单验证通过后，智能体被保存到数据库
2. **显示智能体列表**: 主页面显示所有已创建的智能体卡片
3. **编辑智能体**: 点击编辑按钮，弹出表单并加载现有数据
4. **删除智能体**: 确认后删除智能体及其关联的提示词
5. **响应式适配**: 在不同设备尺寸下都能正常显示和操作

## 故障排除

### 常见问题

1. **数据库连接失败**:
   - 检查DATABASE_URL配置是否正确
   - 确认PostgreSQL服务是否启动
   - 验证数据库用户权限

2. **静态资源加载失败**:
   - 检查网络连接是否正常
   - 确认CDN资源是否可访问

3. **表单提交失败**:
   - 检查必填字段是否完整
   - 查看浏览器控制台错误信息

## 贡献指南

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 联系方式

如有问题或建议，请提交 Issue 或联系项目维护者。