SuperAPI AI 工具集

connect-ai-gmail

办公与效率

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能在 connect-ai-base 之上,提供通过 CData Connect AI 查询与操作 Gmail 数据的专门指引,替代 Gmail 驱动的 getInstructions。使用前必须先在环境中加载并启用 connect-ai-base,否则应停止任务并提示用户安装。

主要能力:Gmail 为单 schema 驱动,schema 名为 REST,采用三段式命名 [连接名].[REST].[表]。核心表包括 Messages、Draft、Sent、Threads、Labels、MessageLabels、Attachments 及账户设置表(AutoForwarding、Delegates、Filters、Vacation、SendAs 等)。每个 Gmail 标签都会呈现为一个视图,如 INBOX、UNREAD、STARRED、SENT、SPAM、TRASH 及用户自建标签。

用法要点:Messages 的 SearchQuery 伪列可传入原生 Gmail 搜索语法,服务端执行且优先于其他 WHERE 条件;LabelsFilter 用逗号分隔标签 ID 取交集;IncludeSpamTrash 控制是否含垃圾邮件与回收站;MessageFormat 可选 minimal、full、raw、metadata。附件需按 MessageId 过滤,Data 为 URL-safe base64。存储过程支持 SendMailMessage、ReplyToMailMessage、SendDraft、UpdateMessageLabels、TrashMessage、DownloadAttachments 等;也可对 Draft、Labels 等表直接 INSERT/UPDATE。

限制:无 isRead 列,已读状态即 UNREAD 标签;AttachmentIds 与 Labels 计数列仅在按 Id 单行查询时填充;has:attachment 可能误匹配无附件的投递状态通知;对大结果集使用 ORDER BY [Date] 会超时并断开 MCP 连接;SPAM 与 TRASH 默认排除;MCP 不提供删除操作,丢弃草稿需用 TrashMessage;写操作受连接权限约束,任何发信、回复、删除或改标签前应先与用户确认。