SuperAPI AI 工具集

wecom-smartsheet-data

数据与分析

查看项目

更新于 10-16 08:44

技能介绍

用途:管理企业微信智能表格中的记录(行数据),提供查询、添加、更新、删除四类操作,支持通过 docid 或文档 URL 二选一定位文档。

主要能力:smartsheet_get_records 查询子表全部记录;smartsheet_add_records 添加一行或多行(单次建议 500 行内);smartsheet_update_records 更新记录,需提供 record_id,可用 key_type 指定 values 的 key 为字段标题或字段 ID;smartsheet_delete_records 删除记录(单次必须在 500 行内,操作不可逆)。

使用方式:所有操作通过 wecom_mcp tool 调用,品类为 doc,例如 wecom_mcp call doc smartsheet_get_records '{"docid": "DOCID", "sheet_id": "SHEETID"}'。首次调用前必须按 wecom-preflight 技能执行前置条件检查,确保工具已加入白名单。写入或更新前应先通过 smartsheet_get_fields 了解字段类型,并参考单元格值格式。成员(USER)字段需先经 wecom-contact-lookup 的 get_userlist 按姓名查到 userid。

限制与注意:接口返回 JSON,含 errcode(0 成功)与 errmsg,失败可重试 1 次,仍失败则向用户展示错误码与信息。创建时间、最后编辑时间、创建人、最后编辑人字段不可更新。图片(IMAGE)/文件(ATTACHMENT)字段必须且只能直接在 cell value 中传入本地路径(image_path / file_path),严禁调用上传接口或 base64 编码,出错时直接告知用户错误码与信息。若返回 errcode 851003 或 errmsg 含 no authority(通常为企业可见范围超 10 人的规模限制),切换到 Webhook 兜底方案;Webhook 只能更新通过 Webhook 写入的记录,人工创建的记录无法更新。其余细节暂未提供。