展开本页目录
开始前准备什么
- 本题公开输入为原创或虚构教学材料,不需要登录第三方平台。
- API步骤需要自己的apizt Key;在模型广场核对当前权限和费用,Key只留在本机。
- 本地处理步骤需要文中注明的Python、FFmpeg或对应工具;本地执行与云API计费分别判断。
- 确认应用权限
- 读取记录与字段
- 调用摘要
- 核对原文版本
- 人工审核回读
2026-10-24 核验材料;实际执行范围、结果与限制见下方记录。
补充:原有练习资料与下载
固定 n8n 2.42.3 节点结构,无网络、飞书凭据或回写;未做实例导入验收。
DEMO 记录 ID、文本分段与模拟摘要,不能用于真实 API。
校验纯文本字段、固定记录、版本和白名单摘要。
读取、分页、独立凭据、单条更新与回读步骤。
真实操作、成品与核验记录
原生n8n 2.16.0 HTTP节点已实际调用apizt并输出摘要;四种分支验证同版本已审核可进入本地回写演练,版本过期、已完成、未审核均阻止。飞书生产写入应另配自己的record_id和权限,本例不冒称已写入飞书云端。
· 按下列具体任务验收API或本地执行;产品原生功能、文件成功与内容质检分别说明。
已取得下列真实结果;仍有内容质量或功能范围需要按本页检查项复核。
- 运行环境
- apizt API;具体型号与参数见每个请求回执;macOS;公开报告不包含凭据
1. 配置独立HTTP节点
下载workflow-local.json(已实跑的n8n 2.16.0模板),URL为apizt chat/completions,令牌只在环境/凭据中读取,不写入下载包。
2. 实际运行摘要
n8n手动开始后调用gpt-4.1-mini,对虚构台灯售后记录输出真实中文摘要。
3. 审核版本再回写
检查approved、inputVersion=currentVersion、status=pending三条件;四分支结果与本地readback已保存。
这次实际得到什么
- 原生n8n execution.status=success,四分支中仅同版本已审核记录允许写入演练。
使用这份结果时注意
- localReadback是本地内存演练;没有飞书应用权限与云表读写,因此不能将其称为飞书线上集成验收。
2026-10-25 资料复核与操作补充
继续操作前,核对当前配置与执行范围
先下载已实跑的workflow-local.json与对应结果。另一份offline-n8n-workflow.json是历史离线字段/审核演练,使用2.42.3节点定义,未做同一实例导入验收。两者均不代表飞书生产写回完成。
原记录范围:按下列具体任务验收API或本地执行;产品原生功能、文件成功与内容质检分别说明。 下列相邻实验各有自己的日期、模型和产物,不替代本篇客户端或协议的原生验收。
应用权限与文档访问是两道检查
在飞书开放平台申请需要的多维表格读写能力、发布应用版本并按企业流程获得批准,再为应用授予目标测试文档访问权限。拿到 token 不代表它能访问每一张表;高级权限还可能限制特定记录。先验证一条只读请求,再考虑写入。
| 值 | 用途 | 常见混淆 |
|---|---|---|
| app_token | 目标多维表格的标识 | 不是认证 token |
| table_id | 该多维表格中的数据表 | 不是视图的列表序号 |
| record_id | 真实 API 返回的记录 ID | 不是业务标题或模型生成值 |
| tenant_access_token | 自建应用认证凭据 | 按实际有效期管理,不能替代文档授权 |
| apizt Key | 调用模型的独立凭据 | 不用于飞书接口 |
- 值
- app_token
- 用途
- 目标多维表格的标识
- 常见混淆
- 不是认证 token
- 值
- table_id
- 用途
- 该多维表格中的数据表
- 常见混淆
- 不是视图的列表序号
- 值
- record_id
- 用途
- 真实 API 返回的记录 ID
- 常见混淆
- 不是业务标题或模型生成值
- 值
- tenant_access_token
- 用途
- 自建应用认证凭据
- 常见混淆
- 按实际有效期管理,不能替代文档授权
- 值
- apizt Key
- 用途
- 调用模型的独立凭据
- 常见混淆
- 不用于飞书接口
HTTP 节点分别连接表格与模型
飞书完整地址以 https://open.feishu.cn 开头;国际版 Lark 的域名和应用环境需单独核对,不能直接套国内租户设置。n8n 使用 HTTP Request,凭据写入独立 Header Auth;不要在 Code 节点联网。
每个飞书返回检查 HTTP 状态和实际业务 code。列表还没读完就进入模型会漏记录;首次只处理一条,不为演示新增真实记录或启用自动批量。认证 token、app_secret 保留在自己的凭据管理,不放 workflow 或页面下载文件。
| 操作 | HTTP 路径 | 认证和检查 |
|---|---|---|
| 查询候选 | POST /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/search | 飞书凭据;按 has_more/page_token 分页 |
| 读取原记录 | GET /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id} | 更新前检查原文与版本 |
| 生成摘要 | POST https://api.apizt.com/v1/chat/completions | apizt 独立 Header Auth |
| 更新单条 | PUT /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id} | 仅在人工确认后配置白名单 fields |
- 操作
- 查询候选
- HTTP 路径
- POST /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/search
- 认证和检查
- 飞书凭据;按 has_more/page_token 分页
- 操作
- 读取原记录
- HTTP 路径
- GET /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}
- 认证和检查
- 更新前检查原文与版本
- 操作
- 生成摘要
- HTTP 路径
- POST https://api.apizt.com/v1/chat/completions
- 认证和检查
- apizt 独立 Header Auth
- 操作
- 更新单条
- HTTP 路径
- PUT /open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}
- 认证和检查
- 仅在人工确认后配置白名单 fields
文字可合并,附件和人员不能直接拼接
附件、链接、人员、日期和关联记录使用各自字段结构;原始字段对象不是可以随意写回的摘要请求体。本页只实现纯文本教学分支,其他类型需按自己的实际 Schema 转换,并保留可回查来源。
| 字段 | 本模板类型 | 检查规则 |
|---|---|---|
| 原文 | 纯文本字符串或 type=text 的分段 | 按顺序合并;遇到其他类型停止 |
| 输入版本 / 处理版本 | 正整数 | 新旧版本分别保存 |
| AI摘要 | 文本 | 不超过 100 字,人工核对语义 |
| 处理状态 | 单选 | 目标表预先建立需要的选项 |
| 人工审批 | 由你的审批流程控制 | 模型输出没有审批字段 |
- 字段
- 原文
- 本模板类型
- 纯文本字符串或 type=text 的分段
- 检查规则
- 按顺序合并;遇到其他类型停止
- 字段
- 输入版本 / 处理版本
- 本模板类型
- 正整数
- 检查规则
- 新旧版本分别保存
- 字段
- AI摘要
- 本模板类型
- 文本
- 检查规则
- 不超过 100 字,人工核对语义
- 字段
- 处理状态
- 本模板类型
- 单选
- 检查规则
- 目标表预先建立需要的选项
- 字段
- 人工审批
- 本模板类型
- 由你的审批流程控制
- 检查规则
- 模型输出没有审批字段
模型只返回摘要 · 人工模拟
{
"summary": "青禾台灯底座松动,需要售后联系确认。"
}用 DEMO 记录看版本与重复检查
离线 workflow 采用官方 n8n 2.42.3 的 Manual Trigger v1 和 Code v2,内置虚构文本与人工模拟摘要,没有真实飞书 record_id、凭据、HTTP 或回写。可先阅读并运行代码分支;真实实例导入、企业授权、联网调用仍需在你的环境验收。
- A 的纯文本分段合并后与当前原文一致,进入人工审核。
- B 的原文和输入版本已变,旧摘要拦截为 stale。
- C 同一版本已完成,跳过为 already_done。
- 所有计划 write_allowed=false;重复 ID、非文本字段和额外摘要字段会被拒绝。
只更新白名单字段,再读取同一记录
业务目标 record_id 始终来自原始读取,不接受模型生成的 ID。人工核对摘要后再读取该记录,检查原文、版本、处理状态与访问权限;仅写目标白名单字段,避免把整份原 fields 覆盖回去。
记录删除、修改、重复或版本已完成时停止写入。更新后 GET 同一 record_id,核对返回值与原文;最后读与写之间仍有竞争,正式并发需自己的锁、持久化台账和恢复逻辑。离线教学不自带自动审批或原子版本检查。
更新体结构示例 · 不可直接发送示例值
{
"fields": {
"AI摘要": "经人工核对的摘要",
"处理状态": "待审核",
"处理版本": 1
}
}权限、字段和执行未知分别处理
发送给模型的资料由你选择并授权。初次只用虚构测试表,记录请求、返回、人工确认和回读;应用成功、模型成功与写入成功是三件不同的事。
| 问题 | 定位证据 | 处理 |
|---|---|---|
| token 有效但表不能读 | 应用 API 权限、文档授权、高级权限 | 检查实际目标表与应用身份 |
| 字段更新失败 | 真实字段 Schema 与业务 code/message | 按字段类型修复,不猜统一错误码 |
| 只有部分候选 | has_more 与 page_token | 完整读取分页再核对数量 |
| AI 请求超时 | n8n 执行与平台用量 | 先标记 unknown,核对后再重试 |
| 写入超时 | 同 record_id 回读结果 | 先查真实状态,不重复生成 |
- 问题
- token 有效但表不能读
- 定位证据
- 应用 API 权限、文档授权、高级权限
- 处理
- 检查实际目标表与应用身份
- 问题
- 字段更新失败
- 定位证据
- 真实字段 Schema 与业务 code/message
- 处理
- 按字段类型修复,不猜统一错误码
- 问题
- 只有部分候选
- 定位证据
- has_more 与 page_token
- 处理
- 完整读取分页再核对数量
- 问题
- AI 请求超时
- 定位证据
- n8n 执行与平台用量
- 处理
- 先标记 unknown,核对后再重试
- 问题
- 写入超时
- 定位证据
- 同 record_id 回读结果
- 处理
- 先查真实状态,不重复生成
怎样确认已经完成
- 真实只读请求能访问目标 app_token/table_id。
- 实际 record_id 与来源快照始终一致。
- 字段类型正确,分页完整,过期与重复计划被拦截。
- 人工确认后只更新目标字段,GET 回读一致。
- 企业授权、模型请求与费用各有实际记录。
常见问题
n8n飞书AI这次真实做到了什么?
原生n8n 2.16.0 HTTP节点已实际调用apizt并输出摘要;四种分支验证同版本已审核可进入本地回写演练,版本过期、已完成、未审核均阻止。飞书生产写入应另配自己的record_id和权限,本例不冒称已写入飞书云端。
是否需要登录第三方平台?
本页主流程按上方实测中的apizt API或本地工具执行。localReadback是本地内存演练;没有飞书应用权限与云表读写,因此不能将其称为飞书线上集成验收。

