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 上断言通过;中文操作名存在。
步骤
- 凭据已按 feishu-n8n-setup Test 通过
- 工作流加 AI Agent
- Tools 里加
Feishu Suite Base(只暴露多维表格,推荐)或统一节点Feishu Suite - Agent 能看到中文操作名:新增记录、查询记录、列出字段、上传附件、解析多维表格链接等
- 在 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
feishu-n8n-troubleshooting
n8n 飞书节点报错时使用。覆盖已实测错误码:99991672 缺 scope、40004 无部门权限、 99992402 字段校验失败、1254290/1254291/1254607 限流与写冲突、重试行为、 日期时区 Asia/Shanghai。先对照本文再改工作流,不要编造新的错误含义。
feishu-n8n-setup
在 n8n 里第一次接飞书 / 本包凭据时使用。覆盖:创建飞书应用、申请应用身份权限、 发布版本 + 租户管理员审批坑、n8n 添加 Feishu Suite API 凭据并点 Test、 通讯录/云文档数据范围。不要用它来搭多维表格工作流(见 feishu-bitable-workflows)。
feishu-bitable-workflows
在 n8n 里搭飞书多维表格工作流时使用:从链接拿 app_token/table_id、 webhook 新增记录、定时查询通知、按业务键 upsert、批量超过 500、 各字段写入格式(日期毫秒 Asia/Shanghai、人员、关联、附件、地理位置、超链接)。 不要用它来配 Trigger 或 AI Agent(见 feishu-bitable-trigger / feishu-bitable-ai-agent)。
feishu-bitable-trigger
需要「多维表格记录变更 / 字段变更时启动 n8n 工作流」时使用。 说明:没有单独的 Bitable Trigger,要用 Feishu Suite Trigger + 订阅云文档事件。 不要用它来写记录或配凭据(见 feishu-bitable-workflows / feishu-n8n-setup)。