AGENT SKILL

feishu-bitable-ai-agent

要把飞书多维表格接到 n8n AI Agent 当工具时使用。 Feishu Suite / Feishu Suite Base 已 usableAsTool。不要用它来配 Trigger 或首次凭据。

License 许可
MIT
最近更新
2026-10-12
Stars
★ 0
Forks
0

01 前言 Front Matter

name
feishu-bitable-ai-agent
description
要把飞书多维表格接到 n8n AI Agent 当工具时使用。 Feishu Suite / Feishu Suite Base 已 usableAsTool。不要用它来配 Trigger 或首次凭据。

03 SKILL.md 正文

多维表格当 AI Agent 工具

依据:BITABLE_RECIPES.md 配方 4、E2E_REPORT.md。e2e:usableAsTool 在 Feishu Suite 和 Feishu Suite Base 上断言通过;中文操作名存在。

步骤

  1. 凭据已按 feishu-n8n-setup Test 通过
  2. 工作流加 AI Agent
  3. Tools 里加 Feishu Suite Base(只暴露多维表格,推荐)或统一节点 Feishu Suite
  4. Agent 能看到中文操作名:新增记录、查询记录、列出字段、上传附件、解析多维表格链接等
  5. 在 Agent System 里写死下面几条(与 e2e / 配方一致,防止模型乱猜)

System 必写

  • 先 列出字段 或 解析多维表格链接,再写记录
  • 记录 JSON 的键用字段名称,不是 field_id
  • 日期可用 YYYY-MM-DD(按上海时区转毫秒)或 Unix 毫秒
  • 不要猜 app_token / table_id:让用户给多维表格链接,或用节点选择器
  • 公式(type 20)、查找引用(type 19)只读,不要写
  • 人员单元格需要真实 open_id,且应用通讯录数据范围够;不够会 40004,不是缺 bitable:app
  • 附件必须先 上传附件到多维表格 再写入 file_token,不要塞外部 URL
  • 超链接可写裸 URL;地理位置写 "经度,纬度"
  • 批量超过 500 条交给节点拆批,不要自己发明分页协议
  • 不要对真实业务群群发、不要提交审批、不要对外发邮件

不要做的事

  • 配方只写了把 Feishu Suite Base(或统一节点)挂到 Tools;PoC 不要让模型猜该调哪个模块
  • 不要让模型编造 field_id 当 JSON 键
  • 不要让模型创建查找引用字段(本租户 99992402 field validation failed)

04 同仓库更多 Skills

RandallAnjie
RandallAnjie/n8n-nodes-feishu-suite

feishu-n8n-troubleshooting

n8n 飞书节点报错时使用。覆盖已实测错误码:99991672 缺 scope、40004 无部门权限、 99992402 字段校验失败、1254290/1254291/1254607 限流与写冲突、重试行为、 日期时区 Asia/Shanghai。先对照本文再改工作流,不要编造新的错误含义。

★ 0
RandallAnjie
RandallAnjie/n8n-nodes-feishu-suite

feishu-n8n-setup

在 n8n 里第一次接飞书 / 本包凭据时使用。覆盖:创建飞书应用、申请应用身份权限、 发布版本 + 租户管理员审批坑、n8n 添加 Feishu Suite API 凭据并点 Test、 通讯录/云文档数据范围。不要用它来搭多维表格工作流(见 feishu-bitable-workflows)。

★ 0
RandallAnjie
RandallAnjie/n8n-nodes-feishu-suite

feishu-bitable-workflows

在 n8n 里搭飞书多维表格工作流时使用:从链接拿 app_token/table_id、 webhook 新增记录、定时查询通知、按业务键 upsert、批量超过 500、 各字段写入格式(日期毫秒 Asia/Shanghai、人员、关联、附件、地理位置、超链接)。 不要用它来配 Trigger 或 AI Agent(见 feishu-bitable-trigger / feishu-bitable-ai-agent)。

★ 0
RandallAnjie
RandallAnjie/n8n-nodes-feishu-suite

feishu-bitable-trigger

需要「多维表格记录变更 / 字段变更时启动 n8n 工作流」时使用。 说明:没有单独的 Bitable Trigger,要用 Feishu Suite Trigger + 订阅云文档事件。 不要用它来写记录或配凭据(见 feishu-bitable-workflows / feishu-n8n-setup)。

★ 0