169 lines
4.2 KiB
Markdown
169 lines
4.2 KiB
Markdown
# 智能客服节点日志查看器 - 使用说明
|
||
|
||
## 使用指南
|
||
|
||
### 1. 首次配置
|
||
|
||
#### 步骤1：获取API凭证
|
||
|
||
1. 登录Udesk控制台：https://agent.udesk.cn
|
||
2. 打开浏览器开发者工具（F12），切换到"网络"标签页
|
||
3. 执行一个API请求（如刷新页面）
|
||
4. 找到带有`authorization: Bearer xxx`的请求
|
||
5. 需要先切换到网络试图，然后找到刚刚的请求命令
|
||
|
||
|
||
|
||
1. 复制完整的curl命令
|
||
|
||
|
||
|
||
#### 步骤2：配置程序
|
||
|
||
1. 点击"配置"按钮
|
||
2. 在"Curl命令"文本框粘贴curl命令
|
||
3. 点击"解析Curl"按钮
|
||
4. 系统自动填充App ID、API Token和Cookies
|
||
5. （可选）在"关键节点"标签页编辑需要监控的节点
|
||
6. 点击"应用"保存配置
|
||
7. 
|
||
|
||
### 2. 获取数据
|
||
|
||
1. 选择开始日期和结束日期
|
||
2. 点击"获取数据"按钮
|
||
3. 等待数据加载完成
|
||
4. 在"审核记录"标签页查看关键对话
|
||
|
||
### 3. 人工审核（直接excel表格操作即可）
|
||
|
||
1. 在"审核记录"表格中找到需要审核的记录
|
||
2. 双击"大模型审核"或"二次生成审核"单元格
|
||
3. 选择审核结果（正确/错误/需改进）
|
||
4. 审核结果自动保存到audit_cache.json
|
||
|
||
### 4. 大模型自动评审
|
||
|
||
#### 准备测试用例
|
||
|
||
1. 创建Excel文件，包含以下列：
|
||
- 提问问题：用户问题内容
|
||
- 答案：标准答案
|
||
2. 保存为.xlsx格式
|
||
|
||
#### 执行评审
|
||
|
||
1. 点击"大模型评审"按钮
|
||
2. 选择测试用例Excel文件
|
||
3. 勾选需要评审的节点（可多选）
|
||
4. 点击"开始评审"
|
||
5. 等待评审完成
|
||
|
||
### 5. 导出Excel
|
||
|
||
1. 点击"导出Excel"按钮
|
||
2. 选择保存位置
|
||
3. 导出文件包含三个Sheet：
|
||
- 关键节点审核：人工审核结果
|
||
- 完整流程日志：所有节点执行记录
|
||
- 大模型评审结果：AI评审报告（如有）
|
||
|
||
### 6.切换app，默认6.4
|
||
|
||
6.4 a46947ea-c1bf-4884-b6ba-9d7be32e18c4
|
||
|
||
6.3.1 29d32bb5-994d-452a-8828-9d94b9eaea9d
|
||
|
||
## 五、配置说明
|
||
|
||
### 配置文件结构
|
||
|
||
config.json包含以下配置项：
|
||
|
||
```json
|
||
{
|
||
"app_id": "应用ID",
|
||
"api_token": "API访问令牌",
|
||
"cookies": {
|
||
"cookie名": "cookie值"
|
||
},
|
||
"key_node_titles": ["节点1", "节点2"],
|
||
"window": {
|
||
"width": 1400,
|
||
"height": 800
|
||
},
|
||
"default_date_range": {
|
||
"days_before": 1
|
||
},
|
||
"columns": {
|
||
"index": 50,
|
||
"chat_id": 120
|
||
}
|
||
}
|
||
```
|
||
|
||
### 关键配置项
|
||
|
||
| 配置项 | 说明 | 默认值 |
|
||
| ------------------------------ | ---------- | ------------------------ |
|
||
| app_id | Udesk应用ID | 必填 |
|
||
| api_token | Bearer令牌 | 必填 |
|
||
| key_node_titles | 需要监控的关键节点 | ["大模型","单次反思","大模型二次生成"] |
|
||
| default_date_range.days_before | 默认查询几天前的数据 | 1 |
|
||
|
||
## 六、常见问题
|
||
|
||
### Q1: 提示401 - Invalid token
|
||
|
||
**解决方案**：
|
||
|
||
- 重新获取最新的curl命令
|
||
- 在配置对话框重新解析并保存
|
||
- 确保token在有效期内
|
||
|
||
### Q2: 程序无法启动
|
||
|
||
**解决方案**：
|
||
|
||
- 检查是否有杀毒软件拦截
|
||
- 右键选择"以管理员身份运行"
|
||
- 使用源码运行方式排查问题
|
||
|
||
### Q3: Excel导出失败
|
||
|
||
**解决方案**：
|
||
|
||
- 检查保存位置是否有权限
|
||
- 确保目标文件未被其他程序占用
|
||
- 尝试保存到其他目录
|
||
|
||
### Q4: 大模型评审无结果
|
||
|
||
**解决方案**：
|
||
|
||
- 确认测试用例格式正确
|
||
- 检查用户问题匹配度
|
||
- 查看状态栏提示信息
|
||
|
||
## 七、技术支持
|
||
|
||
如有问题，请检查：
|
||
|
||
1. 程序同目录的log文件（如有）
|
||
2. config.json配置是否正确
|
||
3. 网络连接是否正常
|
||
|
||
## 八、版本历史
|
||
|
||
### v1.0.0
|
||
|
||
- 初始版本发布
|
||
- 支持日志查看、人工审核
|
||
- 支持大模型自动评审
|
||
- 支持Excel导出
|
||
- 支持配置管理---**注意事项**：
|
||
1. 请妥善保管API Token，不要泄露
|
||
2. 建议定期备份audit_cache.json
|
||
3. API Token有有效期，过期后需要重新获取
|
||
4. 首次使用建议先用少量数据测试
|