用银行 CSV 和本地工作簿核对租金

用银行 CSV 和本地工作簿核对租金

一个 n8n 工作流，监视文件夹里的银行流水 CSV 文件。一个 AI Agent 把每份流水和本地 Excel 工作簿里的租户与房产核对。它标出漏交或交错的租金、快到期的租约和未付的退租费用，并把提醒写到同一个工作簿的一张工作表里。它需要自己托管的 n8n。

包里有什么

• workflow.json：n8n 导出的工作流，十七个节点：十一个会运行的和六张便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• OpenAI Chat Model 上的凭据关联删掉了。请选你自己的。
• 模型原来是 gpt-4o。OpenAI 的弃用页面（2026 年 11 月 12 日查阅）给出 gpt-4o 快照的停用日期是 2027 年 1 月 14 日，并点名了 gpt-6-luna。OpenAI 关于那个模型的页面写明，Chat Completions 只有在推理强度设为 none 时才支持函数调用，而这个 Agent 要调用工具，所以节点现在用 gpt-5.6-terra。
• Agent 的指示原来要一个叫 action required（中间有空格）的字段。输出解析器和最后一个 Code 节点用的是 action_required，所以指示现在写的就是它。
• 工作簿的名字原来拼成 reconcilation-workbook.xlsx，现在是 reconciliation-workbook.xlsx。
• 便签改写成了对每一步的简短说明。
• 别的都没改。

开始之前

• 一个自己托管的 n8n。触发器和工作簿代码用的是运行 n8n 的那台机器上的文件。
• 启用 Local File Trigger 节点。n8n 2.0 的破坏性变更（2026 年 11 月 12 日查阅）把它列为默认禁用，把它从 NODES_EXCLUDE 里去掉就能恢复。
• 让代码能用 xlsx 模块。Code 节点和两个代码工具都调用 require('xlsx')。n8n 的文档说，外部模块需要 NODE_FUNCTION_ALLOW_EXTERNAL，用任务运行器的话，这个变量要放在任务运行器上。
• 一个 n8n 够得到的文件夹。文件里用的是 /home/node/host_mount/reconciliation_project，这是 Docker 设置里的路径。
• 那个文件夹里有一个叫 reconciliation-workbook.xlsx 的工作簿，有三张工作表。
• tenants 需要 Tenant ID 和 Tenant Name 两列，再加上你想让 Agent 看到的条款、租金和备注。
• properties 需要 Property ID，再加上地址、邮编和类型。
• alerts 需要一行表头，工作流会往它下面追加。
• 第一行有 date、reference、money_in 和 money_out 列的银行流水 CSV 文件。
• 一个 OpenAI API 密钥。
• 工作簿的一份备份。工作流会改写它。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 添加一个 OpenAI 凭据，在 OpenAI Chat Model 里选中它。
3. 在 Watch For Bank Statements 里，设置文件夹在 n8n 看来的路径。
4. 在 Set Variables 里，设置工作簿的路径。
5. 保存，然后点 Publish。
6. 把一份流水 CSV 放进文件夹，等运行结束。

一次运行的过程

1. Watch For Bank Statements 在有文件加入时触发。它的忽略规则 !**/*.csv 是想跳过所有不是 CSV 的东西。
2. Set Variables 保存工作簿的路径。
3. Get Bank Statement File 读取 CSV，Get CSV Data 把每一行变成一个条目。
4. Reconcile Rental Payments 是一个 AI Agent。它拿到表格形式的流水，可以调用 Get Tenant Details 和 Get Property Details，这是两个读工作簿的代码工具。
5. Agent 用一个提醒列表回答，Structured Output Parser 把它固定成一种格式。
6. Alert Actions To List 为每条提醒做一个条目，Append To Spreadsheet 给 alerts 工作表各加一行。

改变风格

• 什么算问题：Reconcile Rental Payments 的系统消息。
• 模型：OpenAI Chat Model。
• 被监视的文件夹：Watch For Bank Statements。
• Agent 能看到一位租户或一处房产的哪些列：工作表本身，因为这些工具返回整行。

注意事项

• 这个工作流会改你的工作簿。Append To Spreadsheet 先存一个副本，放在工作簿旁边，名字加上 .bak.xlsx。每次用的是同一个名字，所以副本里只是最近一次运行之前的状态。
• 触发器不会等文件写完，因为它的这个选项默认是关的。较大的 CSV 可能在写了一半时就被读取。
• 由 Agent 决定什么不对。在你据此行动之前，先检查它的提醒。
• 较长的流水会整个放进提示词，可能超过模型的限制。
• 流水行，以及 Agent 要的租户和房产记录，都会发给 OpenAI。
• JSON 里没有任何凭据。