展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
参见本批TOPIC-RESEARCH.md同编号新增边界,原生小样与负例均独立交付。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"query": "SKU如何填写?",
"glossary": {
"SKU": "库存单位",
"SLA": "服务响应时限"
},
"ambiguous": [
"AP"
],
"documents": [
{
"id": "G1",
"text": "库存单位应填写内部商品编码。"
},
{
"id": "G2",
"text": "服务响应时限为两个工作小时。"
},
{
"id": "G3",
"text": "应付账款需月底核对。"
}
]
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 把G1—G3资料写入本地search.sqlite,准备已确认的SKU→库存单位、SLA→服务响应时限词典,并把AP单列为歧义词。
- 2. 让apizt提出当前问题中SKU的扩展建议;人工词典只确认已出现且有明确业务含义的缩写,不自动采纳AP解释。
- 3. 在SQLite执行参数化LIKE查询,先查原词SKU,再查确认后的“库存单位”,记录扩展前后的实际命中ID。
- 4. 导出search-comparison.csv,核对扩展后只找到G1,没有混入SLA或应付账款资料;这是本地词义扩展对照,不是向量检索跑分。
- 5. 保留模型建议、人工确认词典与命中结果三部分,检查未知缩写不能被默默扩展到另一个业务含义。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只输出JSON:expansions对象,仅给出query中出现且glossary已确认的缩写扩展;ambiguous数组列出不能确定词义的缩写AP。不要自行扩展AP。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只输出JSON:expansions对象,仅给出query中出现且glossary已确认的缩写扩展;ambiguous数组列出不能确定词义的缩写AP。不要自行扩展AP。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只输出JSON:expansions对象,仅给出query中出现且glossary已确认的缩写扩展;ambiguous数组列出不能确定词义的缩写AP。不要自行扩展AP。\n待处理合成材料:\n{\"query\": \"SKU如何填写?\", \"glossary\": {\"SKU\": \"库存单位\", \"SLA\": \"服务响应时限\"}, \"ambiguous\": [\"AP\"], \"documents\": [{\"id\": \"G1\", \"text\": \"库存单位应填写内部商品编码。\"}, {\"id\": \"G2\", \"text\": \"服务响应时限为两个工作小时。\"}, {\"id\": \"G3\", \"text\": \"应付账款需月底核对。\"}]}"
}
],
"temperature": 0,
"max_tokens": 1536,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:search-comparison.csv。
workflow.py · 本例分支节选
confirmed = {k: v for k, v in original['glossary'].items() if k in original['query']}
check('只建议已确认且出现的缩写', output.get('expansions') == confirmed)
check('歧义词不自动扩展', 'AP' in output.get('ambiguous', []))
db = sqlite3.connect((folder / 'search.sqlite').resolve().as_uri() + '?mode=ro', uri=True)
before = [r[0] for r in db.execute('SELECT id FROM docs WHERE text LIKE ?', ('%SKU%',)).fetchall()]
expanded = original['query']
for key, value in confirmed.items():
expanded = expanded.replace(key, value)
after = sorted({r[0] for value in confirmed.values() for r in db.execute('SELECT id FROM docs WHERE text LIKE ?', ('%' + value + '%',)).fetchall()})
db.close()
check('指定词义扩展找到G1且不混SLA/AP', after == ['G1'])
write_csv(artifact('search-comparison.csv'), [{'stage': 'before', 'query': original['query'], 'ids': '|'.join(before)}, {'stage': 'approved expansion', 'query': expanded, 'ids': '|'.join(after)}])
result = {'modelAdvice': output, 'approved': confirmed, 'before': before, 'after': after}5. 对照真实结果和检查表
实测2026-10-25T07:53:47.359360+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次5/5项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量248tokens;1份尝试记录的已知用量合计248。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 只建议已确认且出现的缩写 | 通过 |
| 歧义词不自动扩展 | 通过 |
| 指定词义扩展找到G1且不混SLA/AP | 通过 |
| 列出的原生产物实际存在 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 只建议已确认且出现的缩写
- 结果
- 通过
- 实际检查
- 歧义词不自动扩展
- 结果
- 通过
- 实际检查
- 指定词义扩展找到G1且不混SLA/AP
- 结果
- 通过
- 实际检查
- 列出的原生产物实际存在
- 结果
- 通过
result.json · 原生处理后实际结果
{
"modelAdvice": {
"expansions": {
"SKU": "库存单位"
},
"ambiguous": [
"AP"
]
},
"approved": {
"SKU": "库存单位"
},
"before": [],
"after": [
"G1"
]
}6. 替换输入前,先确认这些边界
公开材料为原创合成小样。API模型阶段与本地处理分别验收;通过结构和来源检查不代表通用事实准确率。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 只建议已确认且出现的缩写
- 歧义词不自动扩展
- 指定词义扩展找到G1且不混SLA/AP
- 列出的原生产物实际存在
常见问题
AI 知识库 同义词 缩写怎么开始?
把G1—G3资料写入本地search.sqlite,准备已确认的SKU→库存单位、SLA→服务响应时限词典,并把AP单列为歧义词。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
公开材料为原创合成小样。API模型阶段与本地处理分别验收;通过结构和来源检查不代表通用事实准确率。


