knowledge-agent/offline/README.md

飞书表格评估程序

这个程序用于从飞书表格读取数据，进行一致性评估和打分，然后将结果写回飞书表格。

功能特点

1. 从飞书表格读取C列(关键词)和G列(结构化结果)数据
2. 使用OpenRouter API进行一致性评估，结果写入H列(一致性结论)和I列(原因)
3. 使用OpenRouter API进行打分评估，结果写入J列(打分结果)和K列(原因)
4. 支持并发处理，提高效率
5. 完善的日志记录和错误处理
6. 自动跳过已处理的行，支持断点续传

环境要求

• Python 3.7+
• 必要的Python包：aiohttp, pandas, python-dotenv

配置说明

在项目根目录的.env文件中配置以下环境变量：

# 飞书API配置
FEISHU_APP_ID=your_feishu_app_id
FEISHU_APP_SECRET=your_feishu_app_secret

# OpenRouter API配置
OPENROUTER_API_TOKEN=your_openrouter_api_token
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

使用方法

1. 确保已安装所有依赖包：

pip install -r requirements.txt

1. 配置环境变量

2. 运行程序：

python feishu_evaluation.py

程序流程

1. 程序启动后，首先获取飞书访问令牌
2. 读取飞书表格数据
3. 对每一行数据进行处理：
   • 检查H列和J列是否已有数据，如果有则跳过相应的评估
   • 进行一致性评估并更新H列和I列
   • 进行打分评估并更新J列和K列
4. 所有数据处理完成后，程序结束

日志

程序运行日志保存在feishu_evaluation.log文件中，同时也会在控制台输出。

注意事项

• 程序默认并发数为10，可以通过修改MAX_CONCURRENCY变量调整
• 如果API调用失败，程序会记录错误并继续处理下一行数据
• 程序支持断点续传，已处理的行不会重复处理