展开本页目录
开始前准备什么
- 已运行的 n8n;本次核验版本为 2.16.0。
- 自己的 apizt Key,以及可用的 gpt-4o-mini 模型权限。
- 使用本页合成样例首次验收。更换业务资料后,需要同步修改提示词和校验断言。
- 导入中文模板
- 选择私密凭据
- 执行合成样例
- 校验并导出
- 人工确认
先下载样例,再完成自己的首次调用
示例不含密钥。API 按实际用量计费;下载和点击不代表调用成功。
不含 Key、凭据 ID 或预填执行结果。
包括样例范围、字段检查和费用控制。
1. 导入工作流,先核对任务范围
在 n8n 右上角更多操作中选择 Import from File,导入本页的 workflow.json。画布应依次显示“手动开始 → 准备中文样例 → apizt 文字请求 → 校验字段与结果 → 导出待确认 CSV”。
输入已整理的会议文字,只运行文字模型。输出行动清单后人工确认,不录音、不转写,也不调用外部审批工具。
模板默认关闭,不含凭据和固定执行结果。先保留样例;不要直接接入生产触发器或批量业务资料。
2. 单独保存 Key,限制单次输出
双击“apizt 文字请求”,Authentication 选择 Generic Credential Type,Generic Auth Type 选择 Header Auth。新建或选择自己的凭据,Name 填 Authorization,Value 填 Bearer、一个空格和自己的 Key。
请求地址为 https://api.apizt.com/v1/chat/completions。Key 只保存在 n8n 凭据中,不填进 JSON 请求体、便签或公开导出文件。
“准备中文样例”内指定 gpt-4o-mini,max_tokens=600、stream=false,关闭自动重试。每次有效执行一次文字请求;模板免费,API 使用量另计费。
3. 运行合成输入,核对发给模型的内容
校验负责人为小林、行动项包含测试报告、截止时间为 null;依据必须能在原文找到。
首轮曾只引用“会议决定”。修订后,依据必须是包含负责人和行动项的原文连续片段;本页最终回执已通过这项检查,仍需业务负责人确认上下文。
“上线还需评审”不能变成已批准任务。本次仅完成文字提取并标记待人工确认,不运行 Human Review 工具分支。
sample-input.json
[
{
"id": "M01",
"text": "会议决定:小林负责整理测试报告,截止时间尚未确定。上线时间还需评审,不能把上线列为已批准任务。"
}
]4. 查看本次原生结果
实测时间:2026-11-02T13:58:08.765472+00:00。请求模型:gpt-4o-mini;返回模型:gpt-4o-mini;HTTP 200;finish_reason=stop;输入 150、输出 36、合计 186 tokens。
在成功执行记录中双击“校验字段与结果”,右侧 Output 应能看到实际字段。下方 JSON 是本次真实导出结果,便于与截图放大对照;不是预填的期望答案。
actual-result.json
[
{
"id": "M01",
"行动项": "整理测试报告",
"负责人": "小林",
"截止时间": "待确认",
"依据": "小林负责整理测试报告",
"需人工确认": "是"
}
]5. 下载 CSV,人工确认后再使用
在“导出待确认 CSV”的 Binary 输出中下载文件,核对 id、中文字段和“需人工确认”列。CSV 对以 =、+、@、- 开头的文本添加转义。
模型生成的摘要、建议或草稿仍可能有误。更换输入后,固定样例断言可能让工作流停止,这是保护行为;应先按新业务定义验收标准,再小批量测试。
失败时先检查状态,不连续重跑
401 检查 Header Auth 是否选中、Bearer 格式和 Key;429 核对账户额度、模型权限与路由,不能直接判断为模型不存在。DNS 或 TLS 错误先检查主机与容器网络。
HTTP 200 之后仍需检查完整文本和 JSON。若内容为空、夹带 Markdown 或字段不合约定,校验节点会停止,不生成伪成功结果。
首轮曾遇到 Gemini 非流式响应被拆成多个相同索引 choice 的异常;本组最终模板统一使用 gpt-4o-mini。异常调用另有用量记录,不能因为校验失败就当作零消费。
怎样确认已经完成
- 中文节点连线完整,凭据留在 n8n 凭据库中。
- HTTP 请求成功,记录数量、id 与业务校验均通过。
- 能够下载真实 CSV;人工核对模型输出,没有自动对外发送。
- 更换资料前重新审查脱敏范围、字段定义和断言。
常见问题
模板是中文的吗?
工作流名称、节点、便签、提示词、业务字段和说明优先中文。n8n 自身的界面标签及 API 字段保留原名,便于逐项配置。
可以直接处理我的真实资料吗?
先检查数据授权与脱敏范围,再修改输入和校验规则。本页验证的是公开的合成样例,不代表所有业务数据均能正确处理。
是否会发布 Issue 或发送通知?
不会。模板只有一次文字请求及本地校验、导出节点,结果需人工确认。



