用 Cradl AI 把 Gmail 里的发票 PDF 读进 Google Sheets

用 Cradl AI 把 Gmail 里的发票 PDF 读进 Google Sheets

一个 n8n 工作流，它在 Gmail 里盯着发票邮件，把每个 PDF 附件发给 Cradl AI 智能体。它会等智能体给出结果，其中可以包含有人对智能体没把握的值所做的审核。然后为每个发票行在 Google Sheets 里加一行数据。

包里有什么

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

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

• Extract invoice details with AI 里的智能体原来是原作者自己的。现在是 <YOUR_CRADL_AGENT_ID>，你要从列表里选你的智能体。
• 这个节点默认显示的两个设置，也就是操作和 Wait for Results，现在写进了文件。
• Add invoice line to Google Sheets 原来没有电子表格，现在里面是 <YOUR_SPREADSHEET_ID>。
• Split out each invoice line 把每一行放在叫 line 的字段下。以前它用的是名字里带点的字段，映射起来很别扭。
• Code 节点 Filter PDF attachments 原来用了没声明的循环变量，还假设每封邮件都有附件。它也没告诉 n8n 每个 PDF 来自哪封邮件，而 Mark a message as read 需要这一点。现在这三点都做对了。
• 便签不再链接到厂商的注册页和视频页，并且说明了每一步需要什么。
• 别的都没改。Gmail 的筛选条件和每分钟一次的轮询都和原来一样。

开始之前

• 装了 Cradl AI 社区节点的 n8n。它不是 n8n 自带的节点，它在 npm 注册表上 2026 年 11 月 12 日的最新版本是 1.0.9。你的 n8n 还必须能从互联网访问到，因为这个节点会为每次运行把一个恢复地址交给 Cradl AI。
• 一个 Cradl AI 账户，和一个至少有一份测试文档、用来读发票的智能体。Cradl AI 的页面介绍了智能体、审核界面和 n8n 的设置。
• 一个 Gmail 账户和一个 Google 账户，各自用自己的凭据连到 n8n。
• 一个存放这些行的 Google 电子表格。空表格也可以。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 在 Cradl AI 里打开你的智能体，添加一个触发器并选 n8n。从那个面板复制 Client ID 和 Client Secret。
3. 打开 Extract invoice details with AI，点 Set up credential。粘贴这两个值，然后在 Agent Name or ID 下选你的智能体。
4. 打开 Gmail Trigger，连上你的 Gmail 账户，检查搜索筛选条件。它对未读邮件写的是 has:attachment subject:invoice。对于共用邮箱，你可以加上 to:<YOUR_INVOICE_ADDRESS>。
5. 打开 Add invoice line to Google Sheets。连上你的 Google 账户，选好电子表格和工作表，并映射每一列。值来自 {{ $json.line.<field id>.value }}。
6. 用一封测试邮件运行一次 Gmail 触发器，然后打开 Cradl AI 节点的输出。明细行位于 body.output.<group id> 下。如果你的分组不叫 invoice_lines，就把它的 ID 填到 Split out each invoice line 的字段里。
7. 保存，点画布顶部的 Publish（或按 Shift+P）。

一次运行的过程

1. Gmail Trigger 每分钟检查一次是否有符合筛选条件的未读邮件，并下载附件。
2. Filter PDF attachments 为每个 PDF 生成一项，带上它的文件名。
3. Mark a message as read 把邮件标为已读。这是立即发生的，与下一步并行。
4. Extract invoice details with AI 把 PDF 上传给你的智能体并暂停运行。智能体完成后，且任何审核结束后，Cradl AI 会调用这次运行的恢复地址。然后这个节点输出 body，里面有 output 和 context，以及作为二进制数据的文档。
5. Split out each invoice line 为 body.output.invoice_lines 里的每个条目生成一项，保留其他字段，并把这一行放在 line 下。
6. Add invoice line to Google Sheets 把每个明细行作为一行追加。

改变样子

• 读取哪些邮件：Gmail Trigger 里的搜索筛选条件。
• 保留哪些文件：Filter PDF attachments。把 "pdf" 改掉就能保留别的类型。
• 读取哪些字段、哪些值要审核：你在 Cradl AI 账户里的智能体。
• 行数据去哪里：Add invoice line to Google Sheets。你可以把它换成把这些行发到会计工具或数据库的节点。

值得知道的

• 未运行：Mindket 没有调用过 Cradl AI、Gmail 或 Google。它在 2026 年 11 月 12 日读了 Cradl AI 的页面、1.0.9 版 Cradl AI 节点的代码和 n8n 自己的节点代码，并在自己的机器上用示例数据运行了 Filter PDF attachments。
• Google Sheets 节点没有列映射，所以在你于 n8n 编辑器里映射好列之前，它会报错停下。
• Cradl AI 的 webhook 页面把每个字段显示为一个对象，带有 value、rawValue、confidence、page 和 name，按 ID 分组。.value 是规范化后的文字，.rawValue 是原文。
• 邮件在 Cradl AI 给出结果之前就被标为已读。如果某次运行失败，这封邮件不会被重试，所以请在 Executions 里检查失败的运行。
• 等待结果的运行会停在 Waiting，直到 Cradl AI 回调，所以较长的审核会让这次运行在那段时间里一直开着。
• Cradl AI 的页面说，智能体会从每次人工纠正中学习来改进模型。这个工作流不做这件事，因为它发生在 Cradl AI 内部。
• 没有核对 Cradl AI 的价格和套餐限额，所以在用到整个邮箱之前，请先看你的套餐。
• 你的数据：每个 PDF 都会发到 Cradl AI 的服务器，行数据会发到 Google。发票里可能有姓名、地址和银行信息。
• 凭据：JSON 里没有任何凭据。Gmail、Google Sheets 和 Cradl AI 各自需要一个 n8n 凭据。