SuperAPI AI 工具集

connect-ai-googledrive

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 Google Drive 数据提供专门指引,构建在 connect-ai-base 技能之上。使用前必须先定位并加载 connect-ai-base;若当前环境未加载、未启用或未安装,应停止任务并提示用户安装启用。本技能替代 GoogleDrive 驱动的 getInstructions,识别连接后直接进行模式发现(getTables/getColumns)。

主要能力:可用 SQL 列出文件/文件夹及元数据;读取 Google Docs 文本(GetDocumentContent);以 base64 下载任意文件(DownloadFile);通过存储过程和表写入创建、复制、移动、回收站及管理共享。无法直接通过 SQL 读取非 Google Docs 文件(CSV、Excel、PDF、图片、JSON 等)的内容,需先下载,或为结构化数据文件另建专用 CData 连接。

数据模型:Google Drive 为单模式,模式名 GoogleDrive。Files 是核心表,同时包含文件和文件夹,用 Folder 布尔值区分,约 115 列。类型视图 Folders、Docs、Sheets、Photos、Videos 为只读过滤视图。其他表包括 Permissions、Comments、Replies、Revisions、Drives。ParentIds 只读,移动需用 MoveResource。

用法要点:查询时务必加过滤条件,大型 Drive 无过滤会超时;日期用显式字面量如 '2025-01-01';布尔用 true/false,不可用 1/0。DownloadFile 省略 LocalFile/FileStream 并设 @Encoding='BASE64',结果在 FileData 列;Workspace 文件用 @FileFormat 导出。GetDocumentContent 仅适用于 Google Docs,返回 API JSON,需解析 textRun.content。UploadFile 用 base64 的 @FileData。删除用 MoveToTrash 或 DeleteResource,MCP 不支持直接 DELETE。写入被阻止时连接可能处于只读模式。SubscribeToFileChanges 等推送通知过程不适用于 MCP 会话。