SuperAPI AI 工具集

wecom-smartsheet-data

办公与效率

查看项目

更新于 10-16 08:33

技能介绍

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

主要能力:smartsheet_get_records 查询子表全部记录;smartsheet_add_records 添加一行或多行(单次建议 500 行内);smartsheet_update_records 更新记录(单次须在 500 行内,需 record_id);smartsheet_delete_records 删除记录(单次须在 500 行内,操作不可逆,需 record_id)。

使用方式:所有操作通过调用 wecom_mcp tool 完成。前置条件:首次调用前必须按 wecom-preflight 技能执行前置条件检查,确保工具已加入白名单。调用形式为 wecom_mcp call doc <tool_name> '<json_params>',品类为 doc。添加记录前需先用 smartsheet_get_fields 了解目标表字段类型;字段值格式参见单元格值格式参考。涉及成员(USER)字段时须填写 user_id,不能直接使用姓名,需先通过 wecom-contact-lookup 的 get_userlist 按姓名查出 userid。record_id 通过 smartsheet_get_records 获取。

返回格式:接口返回 JSON,含公共字段 errcode(0 成功,非 0 失败)与 errmsg;errcode 非 0 时可重试 1 次,仍失败则将 errcode 与 errmsg 展示给用户。

适用场景:用户需要读取表格数据、写入新数据、修改或删除表格行时触发。

限制:更新时创建时间、最后编辑时间、创建人、最后编辑人字段不可更新;删除不可逆;单次操作行数有上限要求。其余信息资料未提供。