AI作业批改系统

本项目通过调用Dify Workflow API，实现自动化AI作业批改功能。系统包含两个核心脚本：

1. grade_assignments.py - 主批改程序
2. check_ymls.py - YML配置文件验证工具

核心功能

• 读取Excel作业提交记录（使用openpyxl）
• 验证YML配置文件的完整性和格式
• 调用Dify API进行作业批改
• 自动保存批改结果
• 提供详细的错误报告

系统要求

pip install -r requirements.txt

文件结构

ai_homework_correction/
├── ai作业/               # 作业相关文件
│   ├── AI考试作业.xlsx   # 学生作业提交Excel
│   └── 作业/            # 学生YML作业文件
├── results/             # 批改结果输出
├── docs/                # 文档
├── source/
│   ├── grade_assignments.py  # 主批改程序
│   ├── check_ymls.py         # YML验证工具
│   └── test_script.py        # 测试脚本

使用指南

1. 验证YML文件

python source/check_ymls.py

功能：

• 检查每个学生是否有对应的YML文件
• 验证YML文件格式有效性
• 生成详细检查报告

2. 执行批改

python source/grade_assignments.py

流程：

1. 读取Excel学生名单
2. 匹配对应的YML作业文件
3. 调用Dify API批改
4. 保存结果到results/

配置说明

1. 在source/grade_assignments.py中配置：

API_KEY = "your-api-key"          # Dify API密钥
WORKFLOW_ID = "your-workflow-id"  # 工作流ID
API_BASE_URL = "http://your-dify-server/v1"  # API地址

2. Excel文件要求：

• 必须包含列：填写人、工作流程描述、Dify工作流解决方案设计
• 文件路径：ai作业/AI考试作业.xlsx

3. YML文件要求：

• 存放在ai作业/作业/目录下
• 文件名格式：学生姓名.yml

API文档

详细规范参考：docs/workflow_api.md

注意事项

1. 确保：

• 网络可访问Dify服务器
• 文件大小符合API限制
• YML文件格式正确

2. 建议：

• 先运行check_ymls.py验证文件
• 定期清理results/目录