想在Dify项目中,把AI的对话结果自动存档到飞书多维表格里,听上去很智能,但实现起来需要跨过几道坎:飞书开放平台的鉴权、应用权限的配置,以及最关键的——在Dify工作流里精准地调用飞书API,完成数据提交。整个过程,本质上是连接飞书自建应用的权限体系和Dify强大的HTTP请求节点能力。
简单来说,你需要先在飞书那边“配钥匙、开权限”,然后在Dify这边“写指令、发请求”。下面我们就把这个流程掰开揉碎了讲清楚。
在飞书开放平台创建自建应用并获取凭证
一切从源头开始。你得先在飞书开放平台创建一个“袋里人”,也就是自建应用。
登录平台后,点击「开发者后台」,在左上角找到「创建应用」,选择「自建应用」。给你的应用起个有意义的名字,比如“Dify数据同步器”,然后点击「创建」。
创建成功后,进入应用详情页。左侧菜单找到「凭证与基础信息」,这里躺着两个至关重要的东西:「App ID」和「App Secret」。请立刻、马上复制保存好它们,尤其是App Secret,页面一旦关闭就再也看不到了,后续Dify调用API全靠这组“身份证”。
有了身份,还得有权限。接着在左侧菜单进入「权限管理」,点击「添加权限」,搜索并找到「多维表格:编辑多维表格数据(bitable:record:write)」,勾选提交审核后,记得要点一下「同意授权」,这样你的应用才真正获得了写入表格的“牌照”。
在飞书多维表格中启用API并获取表结构信息
“袋里人”准备就绪,接下来要搞定目标表格本身,让它具备被外部访问的能力。
打开你要写入数据的那个多维表格,点击右上角的「⋯」,进入「设置」,找到「API管理」选项。把「启用API」的开关打开,然后点击「生成新Token」。这个生成的「Access Token」请妥善保管,它是每次数据写入时的“临时通行证”。
光有通行证还不行,还得知道表格的“内部构造”。点击表格顶部的「字段」栏,这里隐藏着关键信息:你需要记录下每个要写入字段的英文ID,也就是field_id。它通常长这样:`fldabc123`。这里有个常见的坑:在Dify里发送数据时,必须严格使用这个英文ID,如果填了中文字段名或你给的别名,系统会直接返回错误。
最后,确认一下你写入数据时默认所处的视图。点击「视图」标签,当前使用的视图ID(view_id)有时会在浏览器地址栏里显示,形如`view_id=viwxxxxx`。如果不确定或没有特殊需求,这个参数可以省略,系统会使用默认视图。
在Dify中配置HTTP请求节点写入飞书多维表格
前面都是铺垫,现在进入核心操作环节:在Dify里配置请求,把数据“发射”出去。
进入你的Dify项目,新建或编辑一个AI应用,切换到「编排模式」。从左侧的「工具」分类里,拖入一个「HTTP请求」节点。
接下来是配置这个节点的具体参数:
方法(Method):选择 `POST`。
URL:填入飞书多维表格的写入API地址:`https://www.php.cn/link/be1fe5a4cbad9fd763db5aaedf0ec611open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records`。这里需要注意,你得把大括号里的占位符替换成你表格的真实信息:`{app_token}` 和 `{table_id}` 都可以在你刚才打开的多维表格「API管理」页面顶部找到。
Headers:需要添加两个关键的请求头。
- `Content-Type` 设置为 `application/json`。
- `Authorization` 设置为 `Bearer `,后面紧跟你之前从多维表格里获取的那个 Access Token。
Body(请求体):选择 `raw` 格式,类型为 `JSON`。这里就是你要写入的具体数据了。一个标准的格式示例如下:
{
"fields": {
"fldabc123": "今天天气怎么样?",
"fldxyz789": 42,
"fldmno456": "2024-06-12"
}
}
重点来了:`fields` 对象里的每一个键(key),都必须是对应字段的 `field_id`;而值(value)则需要严格按照字段类型来填:单行文本就填字符串,数字字段填整数或浮点数,日期字段就用 `YYYY-MM-DD` 这种格式的字符串。
配置完成后,最关键的一步是将这个HTTP请求节点接入你的工作流。通常,你会将上游的「大模型」节点或「变量提取」节点的输出,连接到这个HTTP请求节点的「Body」输入端口。这样一来,AI生成的动态内容就能被自动注入到预设好的JSON字段中,实现数据的自动、精准录入。
