搭建智能体
同步飞书和钉钉表格
把飞书多维表格或钉钉 AI 表格单向同步到工作簿,供智能体分析。
表格连接器把飞书多维表格或钉钉 AI 表格单向同步到 AskTable 的工作簿。同步后的工作表可以像其他数据一样被智能体查询,内容仍在飞书或钉钉中维护。
需要项目负责人或项目管理员。入口:「更多」→「数据接入」→「连接器」。
准备
- 飞书:在飞书开放平台创建「企业自建应用」,记下 App ID 和 App Secret,并给应用开通目标多维表格的读取权限。
- 钉钉:准备有源表读取权限的企业内部应用和操作人 ID。
- 表格的分享链接。
页面上的「如何创建应用并开通权限?」和「如何给应用授予表格访问权限?」提供具体指引。应用密钥只在服务端加密保存。
创建同步
选择来源
点「接入飞书多维表格」或「接入钉钉 AI 表格」。
配置应用授权
填写应用授权名称和应用凭证。已保存过的应用可以直接复用,无需再次输入 Secret。
读取表格并选择子表
粘贴表格分享链接,点「读取表格」,勾选要同步的子表,可以多选。
选择目标工作簿和频率
选择已有工作簿,或新建工作簿。同步频率可选「仅手动」「每小时」「每天 08:00(北京时间)」。点「保存并同步」。
日常管理
- 点「立即同步」手动同步;「暂停计划」和「恢复计划」控制定时同步。
- 列表显示每个同步任务的状态、最近同步时间和行数。
- 同步的工作表在工作簿中标为「来源同步 · 只读」,不能在 AskTable 中编辑。需要修改数据时,在飞书或钉钉中修改,再同步。同一工作簿中手动创建的工作表不受影响。
- 删除不再使用的应用授权:「移除未使用授权」。
从旧版「从飞书多维表格同步」创建的工作簿,升级后自动保留原有配置、子表绑定和数据,统一在连接器中管理。直接调用旧飞书同步 API 的集成方需改用统一连接器接口。
常见问题
| 提示 | 原因 | 处理 |
|---|---|---|
| 应用或操作人无读取权限 | 应用没有开通表格的读取权限 | 在飞书或钉钉中给应用授权 |
| 应用凭证无效 | App Secret 等凭证错误或已更换 | 在「设置」中更新凭证 |
| 来源已删除或不可访问 | 原表格被删除或分享链接失效 | 重新选择来源 |
| 来源响应不完整 | 来源服务返回异常;原有数据已保留 | 稍后重试 |
| 同步超时 | 数据量大或网络慢 | 重新同步 |
| 同步失败 | 来源权限或字段数据有问题 | 检查来源权限和字段内容后重试 |