展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
参见本批TOPIC-RESEARCH.md同编号新增边界,原生小样与负例均独立交付。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"questions": [
{
"id": "Q01",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?"
},
{
"id": "Q02",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?请说明。"
},
{
"id": "Q03",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?"
},
{
"id": "Q04",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?请说明。"
},
{
"id": "Q05",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?"
},
{
"id": "Q06",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?请说明。"
},
{
"id": "Q07",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?"
},
{
"id": "Q08",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?请说明。"
},
{
"id": "Q09",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?"
},
{
"id": "Q10",
"sku": "CUP-300",
"text": "300毫升杯能保温多久?请说明。"
},
{
"id": "Q11",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?"
},
{
"id": "Q12",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?请说明。"
},
{
"id": "Q13",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?"
},
{
"id": "Q14",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?请说明。"
},
{
"id": "Q15",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?"
},
{
"id": "Q16",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?请说明。"
},
{
"id": "Q17",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?"
},
{
"id": "Q18",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?请说明。"
},
{
"id": "Q19",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?"
},
{
"id": "Q20",
"sku": "CUP-500",
"text": "500毫升杯能保温多久?请说明。"
}
]
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 将20条原创观众问题写入viewer-questions.csv,保留Q01—Q20与CUP-300、CUP-500两个不同容量SKU。
- 2. 让apizt按相同问题聚类,同时为每组保留sku、question_ids和回复草稿;输入没有保温时长,草稿应标待确认。
- 3. 把所有组的原问题ID合并回查,要求20个ID恰好出现一次,不允许漏问或重复计入。
- 4. 逐组对照原CSV的SKU,拒绝把300毫升和500毫升的问题混组,导出qa-groups.csv。
- 5. 检查回复草稿没有捏造保温小时数;确认跨SKU混组或重复ID会触发已有核对规则,不把问题重复计入分组。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只输出JSON:groups数组,每项sku、question_ids、draft。按SKU聚合相同问题,同款不同容量不可并组。问题材料未提供保温时长,draft应说明待确认。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只输出JSON:groups数组,每项sku、question_ids、draft。按SKU聚合相同问题,同款不同容量不可并组。问题材料未提供保温时长,draft应说明待确认。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只输出JSON:groups数组,每项sku、question_ids、draft。按SKU聚合相同问题,同款不同容量不可并组。问题材料未提供保温时长,draft应说明待确认。\n待处理合成材料:\n{\"questions\": [{\"id\": \"Q01\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?\"}, {\"id\": \"Q02\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?请说明。\"}, {\"id\": \"Q03\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?\"}, {\"id\": \"Q04\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?请说明。\"}, {\"id\": \"Q05\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?\"}, {\"id\": \"Q06\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?请说明。\"}, {\"id\": \"Q07\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?\"}, {\"id\": \"Q08\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?请说明。\"}, {\"id\": \"Q09\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?\"}, {\"id\": \"Q10\", \"sku\": \"CUP-300\", \"text\": \"300毫升杯能保温多久?请说明。\"}, {\"id\": \"Q11\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?\"}, {\"id\": \"Q12\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?请说明。\"}, {\"id\": \"Q13\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?\"}, {\"id\": \"Q14\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?请说明。\"}, {\"id\": \"Q15\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?\"}, {\"id\": \"Q16\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?请说明。\"}, {\"id\": \"Q17\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?\"}, {\"id\": \"Q18\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?请说明。\"}, {\"id\": \"Q19\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?\"}, {\"id\": \"Q20\", \"sku\": \"CUP-500\", \"text\": \"500毫升杯能保温多久?请说明。\"}]}"
}
],
"temperature": 0,
"max_tokens": 1536,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:qa-groups.csv。
workflow.py · 本例分支节选
groups = output.get('groups', [])
question_map = {r['id']: r for r in original['questions']}
seen = []
mix = []
rows = []
for g in groups:
ids = g.get('question_ids', [])
seen.extend(ids)
if any((x not in question_map or question_map[x]['sku'] != g.get('sku') for x in ids)):
mix.append(g)
rows.append({'sku': g.get('sku'), 'question_ids': '|'.join(ids), 'draft': g.get('draft', '')})
check('20个原问题恰好归组一次', sorted(seen) == sorted(question_map) and len(set(seen)) == 20)
check('不同容量SKU从未混组', not mix)
check('输出只有两种SKU且未知时长待确认', {g.get('sku') for g in groups} == {'CUP-300', 'CUP-500'} and all((any((x in g.get('draft', '') for x in ['确认', '未知', '未提供', '暂无'])) for g in groups)))
write_csv(artifact('qa-groups.csv'), rows)
result = {'groups': groups, 'mixedGroups': mix, 'questionCount': len(seen)}5. 对照真实结果和检查表
实测2026-10-25T07:54:06.522601+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次5/5项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量1028tokens;1份尝试记录的已知用量合计1028。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 20个原问题恰好归组一次 | 通过 |
| 不同容量SKU从未混组 | 通过 |
| 输出只有两种SKU且未知时长待确认 | 通过 |
| 列出的原生产物实际存在 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 20个原问题恰好归组一次
- 结果
- 通过
- 实际检查
- 不同容量SKU从未混组
- 结果
- 通过
- 实际检查
- 输出只有两种SKU且未知时长待确认
- 结果
- 通过
- 实际检查
- 列出的原生产物实际存在
- 结果
- 通过
result.json · 原生处理后实际结果
{
"groups": [
{
"sku": "CUP-300",
"question_ids": [
"Q01",
"Q02",
"Q03",
"Q04",
"Q05",
"Q06",
"Q07",
"Q08",
"Q09",
"Q10"
],
"draft": "关于300毫升杯的保温时长,材料中未提供具体数据,待确认。"
},
{
"sku": "CUP-500",
"question_ids": [
"Q11",
"Q12",
"Q13",
"Q14",
"Q15",
"Q16",
"Q17",
"Q18",
"Q19",
"Q20"
],
"draft": "关于500毫升杯的保温时长,材料中未提供具体数据,待确认。"
}
],
"mixedGroups": [],
"questionCount": 20
}6. 替换输入前,先确认这些边界
公开材料为原创合成小样。API模型阶段与本地处理分别验收;通过结构和来源检查不代表通用事实准确率。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 20个原问题恰好归组一次
- 不同容量SKU从未混组
- 输出只有两种SKU且未知时长待确认
- 列出的原生产物实际存在
常见问题
AI 直播 问答 整理怎么开始?
将20条原创观众问题写入viewer-questions.csv,保留Q01—Q20与CUP-300、CUP-500两个不同容量SKU。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
公开材料为原创合成小样。API模型阶段与本地处理分别验收;通过结构和来源检查不代表通用事实准确率。


