HS Knowledge Vault

Google Workspace Agent 架构与能力规范（Spark 提供）

6分钟阅读

Google Workspace Agent 架构与能力规范指南 (System Specification)

来源：Gemini Spark 提供的知识库文案（2026-08-01 由用户转发） 用途：作为 Hermes Agent 完善和扩展 google-workspace skill 的架构参考与设计规范

1. 架构总览 (Architecture Overview)

一个完整的 Workspace AI Agent 采用 分层解耦 + 集中语义检索 + 并行子任务调度 的三层架构：

  1. 统一上下文检索层 (Unified Context Service)：第一级感知层，通过语义向量与自然语言检索，跨应用（邮件、文档、表格、日历、即时通讯）抓取相关上下文，避免在主线程中滥用具体应用 API。
  2. 专项产品 API 矩阵 (Specialized Domain Tools)：第二级执行层，包含针对 Gmail、Drive、Docs、Sheets、Slides、Calendar 及 Tasks 的细粒度 CRUD 与自动化操作接口。
  3. 子 Agent 调度与并行并发框架 (Sub-agent Delegation)：处理复杂的跨应用分析、多文档比对与历史时空跨度汇总，保持主上下文窗口清爽。

2. 核心功能模块设计与接口规范

模块一：统一语义检索服务 (Unified Context Service)

  • 核心职责：解决开放性、跨域查询（如”查找关于某项目的所有历史讨论与文档”）
  • 输入设计：自然语言 Query，支持指定/排除 AI 生成的产物
  • 输出规范：返回按相关度排序的片段，并必须附带元数据与原始 URL（threadUrl、webViewLink、htmlLink），供后置生成引用链接

模块二：邮件管理引擎 (Gmail Engine & Threading Protocol)

  • 线程感知 (Thread-Awareness)：查询时使用线程搜索获取完整上下文；回复时必须获取上一条消息的 ID 以保证邮件链（Thread ID）不中断
  • 搜索算子优化：支持 from:, to:, has:attachment, after:, before:, label:
  • 格式控制：默认 Plaintext 纯文本；仅在用户明确要求表格/列表/加粗时使用格式化 HTML，禁止在 Body 中混用 Markdown 语法
  • 变更确认：对发送邮件、删除邮件、标记垃圾邮件等破坏性/对外操作，需先向用户展示结构化预览草稿

模块三：云端硬盘与文档引擎 (Drive & Docs Engine)

  • 结构化文件检索：支持按 title（包含/精准）、mimeType、modifiedTime、parentId 组合过滤
  • 精准编辑协议 (Docs Agent)：
    • 增量追加 (Append)：明确标记保留现有内容，避免误删
    • 局部替换 (Replace)：针对特定章节进行精确改写
  • 引用规范：文档内引用统一采用 Markdown 行内链接 标题，不使用无来源的编号角标

模块四：电子表格自动化引擎 (Sheets Processing Engine)

  • 任务载荷结构化 (Task Payload Pattern)：采用结构化（如 XML）载荷向表格处理模块传递意图： 
    <global_user_intent>原始用户意图与全局上下文</global_user_intent>
<your_specific_mission>当前表格改动或创建的具体目标</your_specific_mission>
<gathered_data>从外部（邮件/文档/网页）抓取的原始数据，供表格解析插入</gathered_data>
<explicit_user_style_overrides>用户明确要求的样式规则（未指定则留空）</explicit_user_style_overrides>

模块五：演示文稿处理引擎 (Slides Engine)

  • 结构预读 (Read Presentation)：修改前先分析 Presentation 的全量页面结构与对象 ID
  • 空白页插入与样式继承：插入新幻灯片时仅传入位置索引，保持空白；内容填充时引入相邻 4 页（前后各 2 页）作为样式参考基准，确保版式一致性

模块六：日历与任务调度引擎 (Calendar & Tasks Engine)

  • 严格时间边界 (Bounded Window)：查询单日或特定时间段事件时，必须同时设定 start_time（如 00:00:00）与 end_time（如 23:59:59），采用 ISO 8601 格式，避免使用当前时间导致漏掉前半天事件
  • 空闲时段建议 (Suggest Free Time)：跨多人日历查询最大连续空闲块
  • 任务与提醒同步：支持创建带重复规则（RRULE）的 Task，并支持同步日历提醒时间

3. 最佳实践与自动化控制逻辑 (Best Practices)

  • 所有从 Workspace 检索到的事实与数据，在输出时必须带上原始 clickable URL（如 邮件主题 — 描述、文档名称）
  • 严禁伪造链接或仅提供无链接的文本说明

变更加工与安全确认卡片 (Confirmation Card Pattern)

  • 在对用户数据进行改动（修改表格、更新文档、删除日程）前，必须生成简明改动计划（包含文档标题的 Markdown 链接与逐项改动清单），确保改动透明可追溯

分层降级机制 (Fallback Protocol)

  • 当高级语义搜索未命中或结果不全时，自动降级至各具体应用的细粒度 API（如标准的 Drive 标题搜索或 Gmail 算子检索）进行二次兜底，避免盲目放弃

关系图谱

反向链接