Agent Skills
返回列表
钉钉 AI 表格写入

钉钉 AI 表格写入

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5e4c54ff/dingtalkaisheetyxlv1 到你的 AI 助手。

技能介绍

解决什么问题

在把本地数据或任务结果同步到钉钉 AI 表格（Notable）时，手工调用开放平台接口容易卡在凭证、Token、baseId、sheetIdOrName、records 格式和列名匹配上。这个技能把写入流程封装成固定动作：只要给出目标表格和记录，就能批量写入并返回文档链接。

工作流与边界

  • 凭证：内置默认 appKey、appSecret、operatorId，也可通过 --app-key、--app-secret、--operator-id 覆盖。
  • 必填参数：baseId、sheetIdOrName、records。records 是 JSON 数组，每条记录的 key 必须与钉钉表格列名完全一致。
  • 关键步骤：先调用 accessToken 接口获取 Token，再调用 Notable 记录写入接口，最后返回 https://alidocs.dingtalk.com/i/nodes/{baseId} 形式的文档链接。
  • 注意：列名不存在、字段类型不匹配、operatorId 无权限或网络异常都会影响结果；技能对 Token 过期和网络错误有重试或自动获取逻辑，但不会替代权限配置。

使用场景

  • 任务结束后，把生成的 JSON 记录按钉钉列名批量写入指定 Notable 表格。
  • 运营汇总完多份本地数据后，用一次调用把记录写入共享钉钉表格的固定工作表。
  • 排查同步失败时，依据列名缺失、类型错误或权限不足等返回信息定位写入问题。
  • 需要文档链接时，在写入完成后直接取回对应钉钉 AI 表格的节点 URL。

适合人员

  • 要维护业务台账的运营：把多次产出的指标和备注写入同一张钉钉 AI 表格。
  • 负责数据同步的工程：用脚本把任务结果批量写入 Notable 并保留可追踪文档链接。
  • 排查集成故障的技术支持：根据列名、类型或权限错误信息定位写入问题。
  • 管理共享表格的 PM：将审批或巡检结果记录到指定工作表。