F6--/张阳脚本/udesk/使用说明.md

智能客服节点日志查看器 - 使用说明

使用指南

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包含以下配置项：

{
  "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. 首次使用建议先用少量数据测试