Update README.md
Browse files
README.md
CHANGED
|
@@ -12,94 +12,6 @@
|
|
| 12 |
- **结果保存**:自动将分析结果保存为JSON文件,便于归档和对比分析
|
| 13 |
- **错误处理**:完善的错误提示和处理机制,帮助用户快速定位和解决问题
|
| 14 |
|
| 15 |
-
## 环境要求
|
| 16 |
-
|
| 17 |
-
- Python 3.8+
|
| 18 |
-
- openai 库
|
| 19 |
-
|
| 20 |
-
## 安装步骤
|
| 21 |
-
|
| 22 |
-
1. 克隆或下载项目代码到本地
|
| 23 |
-
2. 安装依赖库:
|
| 24 |
-
```bash
|
| 25 |
-
pip install openai
|
| 26 |
-
```
|
| 27 |
-
|
| 28 |
-
## 百度API密钥获取
|
| 29 |
-
|
| 30 |
-
1. 访问百度智能云API密钥管理页面:https://console.bce.baidu.com/iam/#/iam/apikey/list
|
| 31 |
-
2. 登录百度账号(未注册用户需先完成注册和实名认证)
|
| 32 |
-
3. 点击"创建Access Key"生成API密钥
|
| 33 |
-
4. 确保已开通千帆大模型服务(新用户可领取免费调用额度)
|
| 34 |
-
|
| 35 |
-
## 使用指南
|
| 36 |
-
|
| 37 |
-
1. 准备一张智能体网页的截图,保存为PNG或JPG格式
|
| 38 |
-
2. 打开`ernie_analysis_with_parsing.py`文件,修改配置参数:
|
| 39 |
-
```python
|
| 40 |
-
API_KEY = "您的百度智能云Access Key" # 替换为实际API密钥
|
| 41 |
-
IMAGE_PATH = "demo.png" # 替换为您的截图路径
|
| 42 |
-
OUTPUT_FILE = "analysis_result.json" # 结果保存文件名
|
| 43 |
-
```
|
| 44 |
-
3. 运行脚本:
|
| 45 |
-
```bash
|
| 46 |
-
python ernie_analysis_with_parsing.py
|
| 47 |
-
```
|
| 48 |
-
4. 查看结果:
|
| 49 |
-
- 控制台将显示原始JSON数据和解析后的结构化结果
|
| 50 |
-
- 分析结果同时会保存到指定的JSON文件中
|
| 51 |
-
|
| 52 |
-
## 输出结果说明
|
| 53 |
-
|
| 54 |
-
### 控制台输出
|
| 55 |
-
|
| 56 |
-
1. **原始JSON结果**:完整展示模型返回的结构化数据,包含页面评分和智能体能力拆解的全部信息
|
| 57 |
-
2. **解析后的结果**:格式化展示分析结果,包括:
|
| 58 |
-
- 页面评分:各维度得分及评论
|
| 59 |
-
- 智能体能力拆解:核心功能、优势、劣势、潜在用途、改进方向和详细分析
|
| 60 |
-
|
| 61 |
-
### JSON文件输出
|
| 62 |
-
|
| 63 |
-
分析结果会保存到指定的JSON文件中,可用于:
|
| 64 |
-
- 结果归档和版本对比
|
| 65 |
-
- 导入其他工具进行进一步分析
|
| 66 |
-
- 集成到报告生成系统
|
| 67 |
-
|
| 68 |
-
## 常见问题
|
| 69 |
-
|
| 70 |
-
### API密钥相关问题
|
| 71 |
-
|
| 72 |
-
- **Q: 提示"API密钥验证失败"怎么办?**
|
| 73 |
-
A: 检查API_KEY是否正确填写,确保没有多余空格;确认百度智能云账号已完成实名认证并开通千帆大模型服务;检查账号是否有可用的调用额度。
|
| 74 |
-
|
| 75 |
-
### 图像相关问题
|
| 76 |
-
|
| 77 |
-
- **Q: 提示"未找到图像文件"如何解决?**
|
| 78 |
-
A: 检查IMAGE_PATH是否正确,确保路径中包含正确的文件名和扩展名;如果使用相对路径,确认图像文件与脚本在同一目录下。
|
| 79 |
-
|
| 80 |
-
### 结果解析问题
|
| 81 |
-
|
| 82 |
-
- **Q: 模型返回结果格式异常怎么办?**
|
| 83 |
-
A: 系统已内置格式清理功能,会自动处理常见的格式问题。如果仍解析失败,可尝试重新运行脚本。
|
| 84 |
-
|
| 85 |
-
## 自定义扩展
|
| 86 |
-
|
| 87 |
-
### 调整评分维度
|
| 88 |
-
|
| 89 |
-
如需增加或修改评分维度,可修改脚本中messages里的文本内容,例如:
|
| 90 |
-
"text": "请分析这张智能体网页的截图,并完成以下任务:\n\
|
| 91 |
-
1. 页面评分(每项1-10分,并给出简短评论):\n\
|
| 92 |
-
- 整体评价(overall)\n\
|
| 93 |
-
- 设计美感(design)\n\
|
| 94 |
-
- 易用性(usability)\n\
|
| 95 |
-
- 功能完整性(functionality)\n\
|
| 96 |
-
- 响应式设计(responsiveness)\n\
|
| 97 |
-
- 安全性(security)\n # 新增维度\
|
| 98 |
-
..."
|
| 99 |
-
### 修改输出文件路径
|
| 100 |
-
|
| 101 |
-
如需将结果保存到指定路径,可修改OUTPUT_FILE参数:
|
| 102 |
-
OUTPUT_FILE = "D:/reports/agent_analysis_202409.json" # 绝对路径
|
| 103 |
## 注意事项
|
| 104 |
|
| 105 |
- 使用前请确保已阅读并遵守百度智能云的服务协议
|
|
|
|
| 12 |
- **结果保存**:自动将分析结果保存为JSON文件,便于归档和对比分析
|
| 13 |
- **错误处理**:完善的错误提示和处理机制,帮助用户快速定位和解决问题
|
| 14 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 15 |
## 注意事项
|
| 16 |
|
| 17 |
- 使用前请确保已阅读并遵守百度智能云的服务协议
|