SuperAPI AI 工具集

google-drive-comments

办公与效率

查看项目

更新于 10-16 03:05

技能介绍

用途:在 Google Drive 统一插件中处理评论工作流,支持为 Docs、Sheets、Slides 及普通 Drive 文件新增顶层评论、回复已有评论和标记解决。由于 API 创建的评论可能在 Google 编辑器界面中显示为未锚定,每个新建顶层评论都必须携带足够的跨界面证据,便于读者找到目标位置。

主要能力与用法:先定位目标文件。若用户未提供确切 URL 或 ID,通过搜索 Drive、列出最近文件、列出文件夹或读取元数据,直到目标唯一确定;随后判断文件属于 Docs、Sheets、Slides 还是普通 Drive 文件。再读取将要评论的界面:Docs 或文本类文件读取目标附近文本;Sheets 先读电子表格元数据,再读具体工作表和范围;Slides 先读演示大纲或文本,必要时读具体幻灯片或缩略图。不得凭记忆或搜索片段猜测目标引文、幻灯片编号、工作表名或单元格范围。起草全部评论后,优先用一次 bulk_update_file_comments 批量完成同一请求中的所有创建、回复与解决,控制在工具暴露的动作上限内;超出时先询问再拆批。回复和解决须使用实时评论线程数据中的已有评论 ID。

证据要求:Docs 或文本类文件需包含 quoted_text(确切句子、短语、标题或附近文本),评论正文也引用同一文本;Sheets 需包含 sheet_cell_range(如 Budget!C12 或 Pipeline!A2:D10),正文中同时写明工作表和范围,必要时附 quoted_text;Slides 需包含 slide_number,正文中写明该编号,评论标题、项目符号、标签、图表文字时附 quoted_text;普通 Drive 文件若无结构化界面,评论内容须明确写出文件级、页面级、时间戳级或章节级证据。避免仅写“这句话”“这一段”“这张幻灯片”“这个单元格”等含糊表述且无对应证据字段。若无法确定确切证据目标,应改为明确标注的文件级总结评论,或省略并说明目标不够具体。

验证与限制:写入后总结创建、回复、解决的数量,并说明高风险评论(尤其是有意不针对具体引文、幻灯片或单元格的文件级评论)所用证据。除非连接器明确记录该界面受支持的锚定形状,否则不要依赖 Drive 评论锚点数据;Drive API 创建的评论在 Google 编辑器中仍可能显示为未锚定。