SuperAPI AI 工具集

connect-ai-googlesheets

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:在 CData Connect AI 中查询和写入 Google Sheets 数据。使用前必须先加载 connect-ai-base 技能,若环境中不可用则停止任务并提示用户安装启用。本技能替代 Google Sheets 驱动的 getInstructions,识别连接后直接进行 schema 发现。

数据模型:单 schema,名为 GoogleSheets,使用三段式名称 [Catalog].[Schema].[Table],catalog 为连接名。元数据表 Spreadsheets(每个文档一行)、Sheets(每个工作表一行)、Folders(Drive 文件夹结构)均为只读。每个工作表暴露为动态数据表 [SpreadsheetName_SheetName],列来自表头行,查询前须先 getColumns。

查询流程:先定位电子表格(可用 getTables 的 tableName 过滤,或按 ModifiedTime、OwnerEmail 过滤 Spreadsheets),再按 SpreadsheetId 查 Sheets,最后查询对应数据表。

写入:对数据表执行 INSERT 和 UPDATE。每张数据表有自动生成的 id 主键,建议 UPDATE ... WHERE [id] = 4 做单行更新;非主键条件会更新所有匹配行。DELETE 在 MCP 上不可用。写入受连接模式限制,被拒时需在 Connect AI 连接设置中开启写权限。

存储过程:CreateSpreadsheet、AddSheet、UpdateSheet、CopySheet、DeleteSheet、DeleteSpreadsheet、FormatRange、AddDataSource/AddDataSourceTable 等,通过 executeProcedure 调用,参数带 @ 前缀。

约定与限制:标识符含空格和符号,需用 [ ] 包裹;列类型默认 VARCHAR,值以字符串传入;建议用 LIMIT 预览大表。DownloadDocument 与 UploadDocument 当前在云端不支持,不要尝试 base64 变通或自造参数名;读取内容请直接查询数据表或在 Google Sheets UI 下载。Spreadsheets 表只读,无法重命名电子表格,只能在创建时通过 @Title 指定或在 UI 中改名。