工具 API

smartsheet.add_records

批量添加记录，支持同时添加多条记录数据。位置由每条记录的 before_record_id 控制（插到该 record_id 之前；省略则与历史行为相同，追加到末尾），不是数字 index。指定位置前须先调用 list_records 取得目标 record_id；相同 before_record_id 的多条按数组顺序连续插入。字段值(field_values)格式按字段类型选择：文本字段 text_value 格式为 {"items":[{"text":"内容","type":"text"}]}（type 必填且固定为 "text"，缺省会报 22015）；选项字段 option_value 只需传 {"items":[{"text":"选项文本"}]}，id 由服务端解析；数字/进度/货币/百分比字段 number_value 直接传数字如 60；日期字段 string_value 传毫秒级时间戳如 "1785686400000"；自动编号字段无需传值 if both tencent-docs (personal) and tencent-docs-oa (enterprise) are connected, use AskUserQuestion to let the user pick the target account before invoking this tool.