展开本页目录
开始前准备什么
- 独立练习目录及Python 3.14;系统与Node依赖以README为准。
- 离线重放无需Key;新请求使用自己的apizt Key,先核对模型权限和当前价格。
- 原创合成材料,不需要登录第三方平台账号。
- 先看文件
- 按步骤操作
- 对照真实结果
- 离线或模型复跑
默认离线重放;包含完整失败尝试与本地检查,不含Key。
1. 核对本例材料与目标文件
参见本批TOPIC-RESEARCH.md同编号新增边界,原生小样与负例均独立交付。
先下载合成材料在独立目录练习。原始文件、模型输入与验收答案分别保留;本地核对答案不发送给模型。
input.json(节选)
{
"positions": [
{
"id": "P0",
"name": "负责人",
"employee_id": "E0",
"employee": "林青",
"manager": null
},
{
"id": "P1",
"name": "研发",
"employee_id": "E1",
"employee": "李明",
"manager": "P0"
},
{
"id": "P2",
"name": "运营",
"employee_id": "E2",
"employee": "李明",
"manager": "P0"
},
{
"id": "P3",
"name": "顾问兼职",
"employee_id": "E1",
"employee": "李明",
"manager": "P1"
},
{
"id": "P4",
"name": "设计",
"employee_id": null,
"employee": null,
"manager": "P0"
}
]
}2. 按顺序完成这项具体操作
本次实际使用Python 3.14,依赖版本固定在资料包。需要LibreOffice或Node的案例请先按README安装对应运行时。python run.py读取真实旧响应完成本地处理;只有显式--live才发新请求。
- 1. 把P0—P4岗位写入organization-source.csv,保留同名李明的不同员工ID、同一员工兼职的两个岗位,以及空岗P4。
- 2. 让apizt整理nodes和edges,以岗位ID而非姓名连接,员工缺失继续为null,不补造人员。
- 3. 逐项比较岗位ID、employee_id和manager→岗位关系,确认5个岗位、同名未合并、兼职未丢失、空岗未被填人。
- 4. 由程序把核验后的节点和边转为organization.dot,再调用官方Graphviz WASM引擎真实生成organization.svg。
- 5. 回读SVG确认实际布局的5个节点,并打开图检查关系与待聘标签;同时保存organization-map.json和render-graph.mjs,不能用手画图代替引擎输出。
独立练习目录 · 默认仅离线复核
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python run.py3. 对照真正发送的请求
只输出JSON:nodes数组逐项保留id、name、employee_id、employee;edges数组每项from、to,方向为manager到岗位id。同名不同员工ID不能合并,同一人兼职保留两个岗位,空岗employee仍null。不要直接生成DOT。
网页实验台只执行这一步模型字段检查。原生文件写入、坐标/公式/格式回读及负例验收由下载包负责。
request-1.json(图片Base64省略,原文件在下载包)
{
"model": "gemini-2.5-flash-lite",
"messages": [
{
"role": "system",
"content": "严格只输出单个JSON对象,不要Markdown代码围栏,不要解释。只输出JSON:nodes数组逐项保留id、name、employee_id、employee;edges数组每项from、to,方向为manager到岗位id。同名不同员工ID不能合并,同一人兼职保留两个岗位,空岗employee仍null。不要直接生成DOT。"
},
{
"role": "user",
"content": "任务约束(只输出JSON对象,不用代码围栏):\n只输出JSON:nodes数组逐项保留id、name、employee_id、employee;edges数组每项from、to,方向为manager到岗位id。同名不同员工ID不能合并,同一人兼职保留两个岗位,空岗employee仍null。不要直接生成DOT。\n待处理合成材料:\n{\"positions\": [{\"id\": \"P0\", \"name\": \"负责人\", \"employee_id\": \"E0\", \"employee\": \"林青\", \"manager\": null}, {\"id\": \"P1\", \"name\": \"研发\", \"employee_id\": \"E1\", \"employee\": \"李明\", \"manager\": \"P0\"}, {\"id\": \"P2\", \"name\": \"运营\", \"employee_id\": \"E2\", \"employee\": \"李明\", \"manager\": \"P0\"}, {\"id\": \"P3\", \"name\": \"顾问兼职\", \"employee_id\": \"E1\", \"employee\": \"李明\", \"manager\": \"P1\"}, {\"id\": \"P4\", \"name\": \"设计\", \"employee_id\": null, \"employee\": null, \"manager\": \"P0\"}]}"
}
],
"temperature": 0,
"max_tokens": 1536,
"provider": {
"sort": "success_rate"
},
"response_format": {
"type": "json_object"
}
}4. 查看原生处理代码与实际文件
下面节选来自本次实际执行的workflow.py分支,需要结合完整脚本运行。模型输出不能代替文件解析器或业务验算。
具体产物:organization.dot、render-graph.mjs、organization.svg、organization-map.json。
workflow.py · 本例分支节选
nodes = output.get('nodes', [])
edges = output.get('edges', [])
source = {r['id']: r for r in original['positions']}
by_id = {r.get('id'): r for r in nodes}
expected_edges = {(r['manager'], r['id']) for r in source.values() if r['manager']}
got_edges = {(r.get('from'), r.get('to')) for r in edges}
check('岗位ID不合并,同名员工各有身份', set(by_id) == set(source) and all((by_id[k].get('employee_id') == v['employee_id'] and by_id[k].get('employee') == v['employee'] for k, v in source.items())))
check('空岗未补造员工', by_id.get('P4', {}).get('employee') is None and by_id.get('P4', {}).get('employee_id') is None)
check('经理到岗位关系完整且无新边', got_edges == expected_edges)
lines = ['digraph Organization {', 'graph [rankdir=TB, bgcolor="#f8f4ed"];', 'node [shape=box, style=rounded, fontname="sans-serif"];']
for key in sorted(by_id):
r = by_id[key]
person = r.get('employee') or '待聘'
lab = f"{key} · {r.get('name', '')}\n{person} / {r.get('employee_id') or 'VACANT'}"
lines.append(json.dumps(key) + ' [label=' + json.dumps(lab, ensure_ascii=False) + '];')
for a, z in sorted(got_edges):
lines.append(json.dumps(a) + ' -> ' + json.dumps(z) + ';')
lines.append('}')
artifact('organization.dot').write_text('\n'.join(lines))
script = "import fs from 'node:fs';import path from 'node:path';import {pathToFileURL} from 'node:url';\nconst modules=process.env.BATCH100O_NODE_MODULES || path.resolve('web-deps/node_modules');\nconst {Graphviz}=await import(pathToFileURL(path.join(modules,'@hpcc-js/wasm-graphviz/dist/index.js')).href);\nconst engine=await Graphviz.load();const dot=fs.readFileSync(process.argv[2],'utf8');fs.writeFileSync(process.argv[3],engine.layout(dot,'svg','dot'));\n"
artifact('render-graph.mjs').write_text(script)
node = shutil.which('node')
if not node:
raise RuntimeError('Node.js is required for actual Graphviz WASM layout')
subprocess.run([node, str((folder / 'render-graph.mjs').resolve()), str((folder / 'organization.dot').resolve()), str((folder / 'organization.svg').resolve())], check=True, capture_output=True, text=True, timeout=40)
artifacts.append('organization.svg')
tree = ET.parse(folder / 'organization.svg')
ns = {'s': 'http://www.w3.org/2000/svg'}
graph_nodes = tree.findall('.//s:g[@class="node"]', ns)
check('官方Graphviz引擎真实布局5个岗位', len(graph_nodes) == 5)
result = {'nodes': nodes, 'edges': edges, 'renderEngine': '@hpcc-js/wasm-graphviz 1.30.0; real Graphviz WASM', 'partTimeEmployee': 'E1 appears in P1 and P3'}
dump(artifact('organization-map.json'), result)5. 对照真实结果和检查表
实测2026-10-25T07:55:39.237327+00:00,HTTP200;请求gemini-2.5-flash-lite,返回gemini-2.5-flash-lite。本次6/6项检查通过,指本例执行及验收机制通过,不代表所有模型字段零误差。
最后一次返回用量546tokens;1份尝试记录的已知用量合计546。失败记录保留,用量缺失不按0计,本文不推算实际金额。
| 实际检查 | 结果 |
|---|---|
| 真实apizt API响应HTTP200 | 通过 |
| 岗位ID不合并,同名员工各有身份 | 通过 |
| 空岗未补造员工 | 通过 |
| 经理到岗位关系完整且无新边 | 通过 |
| 官方Graphviz引擎真实布局5个岗位 | 通过 |
| 列出的原生产物实际存在 | 通过 |
- 实际检查
- 真实apizt API响应HTTP200
- 结果
- 通过
- 实际检查
- 岗位ID不合并,同名员工各有身份
- 结果
- 通过
- 实际检查
- 空岗未补造员工
- 结果
- 通过
- 实际检查
- 经理到岗位关系完整且无新边
- 结果
- 通过
- 实际检查
- 官方Graphviz引擎真实布局5个岗位
- 结果
- 通过
- 实际检查
- 列出的原生产物实际存在
- 结果
- 通过
result.json · 原生处理后实际结果
{
"nodes": [
{
"id": "P0",
"name": "负责人",
"employee_id": "E0",
"employee": "林青"
},
{
"id": "P1",
"name": "研发",
"employee_id": "E1",
"employee": "李明"
},
{
"id": "P2",
"name": "运营",
"employee_id": "E2",
"employee": "李明"
},
{
"id": "P3",
"name": "顾问兼职",
"employee_id": "E1",
"employee": "李明"
},
{
"id": "P4",
"name": "设计",
"employee_id": null,
"employee": null
}
],
"edges": [
{
"from": "P0",
"to": "P1"
},
{
"from": "P0",
"to": "P2"
},
{
"from": "P1",
"to": "P3"
},
{
"from": "P0",
"to": "P4"
}
],
"renderEngine": "@hpcc-js/wasm-graphviz 1.30.0; real Graphviz WASM",
"partTimeEmployee": "E1 appears in P1 and P3"
}6. 替换输入前,先确认这些边界
使用官方Graphviz WASM真实布局;需要本地Node及对应npm包,不要求第三方SaaS账户。
修改材料后应重新制定事实断言和反例。识别错误率、混淆矩阵或拒答类教程允许保留模型实际错误;检查通过指计算和处理正确。没有调用视频模型。
怎样确认已经完成
- 真实apizt API响应HTTP200
- 岗位ID不合并,同名员工各有身份
- 空岗未补造员工
- 经理到岗位关系完整且无新边
- 官方Graphviz引擎真实布局5个岗位
- 列出的原生产物实际存在
常见问题
AI 组织架构图 生成 Graphviz怎么开始?
把P0—P4岗位写入organization-source.csv,保留同名李明的不同员工ID、同一员工兼职的两个岗位,以及空岗P4。按本页顺序继续,先用下载包离线重放,再替换自己的材料。
网页试跑和下载包有什么区别?
网页只复跑模型字段,不生成全部原生文件;资料包包含实际原生处理和本地验收。
这次通过结果适用于其他材料吗?
使用官方Graphviz WASM真实布局;需要本地Node及对应npm包,不要求第三方SaaS账户。


