Composio Google Meet 工具包实战指南鉴权作用域、工具 slug 选择与会议转录提取【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本指南围绕 Composio 知识库中 Google Meet 排障与使用文档 展开系统讲解 Google Meet 工具包的使用要点如何区分GOOGLEMEET_*与GOOGLESUPER_*工具 slug、如何配置 OAuth 作用域并启用 Google Meet API、如何按会议记录 → 转录 → 转录条目的链路提取会议内容以及录制/转录缺失与 403 权限错误的排查思路。读完本文你将能够正确完成 Google Meet 工具包的鉴权配置并搭建一条可复用的会议转录提取工作流。一、认识 Composio 的 Google Meet 工具包Google Meet 是 Composio 中一个独立的工具包toolkit其元数据收录在 docs/public/data/toolkits.json 中约第 46470 行起。从该清单可以看出鉴权方式OAUTH2并且同时支持 Composio 托管鉴权composioManagedAuthSchemes: [OAUTH2]意味着既可以用自己的 OAuth 应用也可以使用平台托管的凭据流程工具数量共 15 个工具覆盖会议空间创建/更新、会议记录查询、参与者与参与者会话、录制、转录五个能力域工具版本当前清单中版本号为20260811_00实际以你所拉取仓库的版本为准分类属于 video conferencing 类别CLI 侧注册该工具包 sluggooglemeet也登记在 ts/packages/cli/src/generated/toolkit-slugs.ts可通过 Composio CLI 的composio add googlemeet类命令或 SDK 的get_tools直接接入。15 个工具 slug 一览能力域工具 slug用途空间管理GOOGLEMEET_CREATE_MEET创建新的 Meet 空间支持访问控制、主持、录制、转录等配置空间管理GOOGLEMEET_UPDATE_SPACE更新既有空间的设置需要 organizer/host 权限空间管理GOOGLEMEET_GET_MEET按唯一标识查询 Meet 空间详情会议结束GOOGLEMEET_END_ACTIVE_CONFERENCE结束指定空间中的进行中会议会立刻断开所有参与者会议记录GOOGLEMEET_LIST_CONFERENCE_RECORDS按会议码、空间名、时间范围等条件列出历史会议记录会议记录GOOGLEMEET_GET_CONFERENCE_RECORD_BY_NAME按资源名获取单个会议记录参与者GOOGLEMEET_LIST_PARTICIPANTS列出会议记录中的参与者可筛选在线参与者参与者GOOGLEMEET_LIST_PARTICIPANT_SESSIONS列出某参与者的全部加入/离开会话参与者GOOGLEMEET_GET_PARTICIPANT_SESSION获取单个参与者会话详情录制GOOGLEMEET_LIST_RECORDINGS列出会议记录下的录制资源保存为 Google Drive MP4录制GOOGLEMEET_GET_RECORDINGS_BY_CONFERENCE_RECORD_ID按会议记录 ID 获取录制转录GOOGLEMEET_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID按会议记录 ID 获取全部转录资源转录GOOGLEMEET_GET_TRANSCRIPT按资源名获取单个转录详情STARTED/ENDED/FILE_GENERATED 状态转录GOOGLEMEET_LIST_TRANSCRIPT_ENTRIES列出转录的结构化条目说话人/时间/文本片段转录GOOGLEMEET_GET_TRANSCRIPT_ENTRY按资源名获取单条转录条目提示GOOGLEMEET_CREATE_MEET只创建会议空间不会挂接日历事件如需关联日历需要在工具链中额外调用日历类工具。创建后应立即捕获响应中的meetingUri、meetingCode与space.name供后续查询使用。二、区分GOOGLEMEET_*与GOOGLESUPER_*按连接账户选择正确的工具 slug原文档首先强调了一个极易踩坑的选错 slug 问题Google Super 是一个独立的工具包拥有自己的一套工具 slug。如果某个连接账户connected account是为Google Super创建的那么你应该运行对应的GOOGLESUPER_*工具例如GOOGLESUPER_CREATE_MEET而不是GOOGLEMEET_*前缀的 slug反过来当工作流有意使用 Google Super 时不需要再为 Google Meet 单独创建一份 auth config 或连接账户。在 docs/public/data/toolkits.json 中确实可以同时找到两套工具Google Meet 工具包下有GOOGLEMEET_CREATE_MEETGoogle Super 工具包下也定义了同名的GOOGLESUPER_CREATE_MEET约第 63947 行两者的功能描述一致均创建 Google Meet 空间、均要求meetings.space.created作用域。因此先确认连接账户属于哪个工具包在 Composio 连接账户列表或初始化响应中查看所属 auth config / toolkit再选择与之一致的前缀GOOGLEMEET_*或GOOGLESUPER_*混用前缀通常会导致工具在账户上不可用或鉴权上下文不匹配的问题。三、配置 Meet 作用域并启用 Google Meet API创建会议空间的前置条件原文档指出在通过 Google Super 创建/修改 Meet 空间之前必须先把 Meet 作用域加进 auth config并重新发起一次连接让新作用域被授权同时还要在承载 OAuth 应用的 Google Cloud Console 项目中启用 Google Meet API。3.1 需要的作用域需要在 auth config 的 scopes 中包含https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.settings这一要求与工具包元数据完全一致在 docs/public/data/toolkits.json 的authConfigDetails中Google Meet 的 OAuth 配置把 scopes 设为可选字段且默认值正是这两个作用域以逗号分隔拼接{ auth_config_creation: { required: [ { name: client_id, displayName: Client id, type: string, required: true }, { name: client_secret, displayName: Client secret, type: string, required: true } ], optional: [ { name: oauth_redirect_uri, displayName: Redirect URI, type: string, default: https://backend.composio.dev/api/v1/auth-apps/add }, { name: scopes, displayName: Scopes, type: string, description: Scopes to request from the user, comma separated, default: https://www.googleapis.com/auth/meetings.space.created,https://www.googleapis.com/auth/meetings.space.settings } ] }, connected_account_initiation: { required: [], optional: [] } }也就是说必填项只有client_id与client_secret自建 OAuth 应用场景oauth_redirect_uri有平台默认值如果使用自建应用需要把这个 Redirect URL 加入你应用的 OAuth 允许列表allow list否则授权回调会被 Google 拒绝scopes以逗号分隔传入默认即包含创建与修改会议空间所需的最小作用域连接账户初始化阶段connected_account_initiation没有额外必填字段作用域在创建 auth config 时一次性声明。3.2 修改作用域后必须重新建立连接作用域只在授权时生效。如果某个连接账户创建时没有申请 Meet 作用域之后才在 auth config 中补上那么必须发起一次新的连接重新走 OAuth 授权新作用域才会被授予。直接复用旧连接继续调用空间相关工具仍会遇到权限不足的问题。3.3 在 Google Cloud Console 启用 API除了作用域还要确认承载 OAuth 应用的 Google Cloud 项目已启用Google Meet API在 Google Cloud Console 的 APIs Services 中搜索并启用。作用域与 API 启用是两条独立的检查项作用域决定授权范围API 启用决定后端是否有权访问该服务两者缺一不可。四、提取会议转录的标准三步流程原文档给出了从会议到逐条转录文本的调用链这也是把 Meet 会议内容转化为结构化数据如纪要、知识库、总结的核心路径GOOGLEMEET_LIST_CONFERENCE_RECORDS │ 按 meeting code / space name / 时间范围筛选拿到 conference record ID ▼ GOOGLEMEET_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID │ 得到 transcript 资源含 resource name 与状态 ▼ GOOGLEMEET_LIST_TRANSCRIPT_ENTRIES 传入 transcript 资源名返回带说话人、时间戳的逐条文本片段结合 docs/public/data/toolkits.json 中各工具的描述可以补充以下实操细节GOOGLEMEET_LIST_CONFERENCE_RECORDS用于检索历史会议支持按会议码meeting code、空间名space name、时间范围等条件过滤。拿到结果中的conference_record_id资源名格式类似conferenceRecords/{id}后进入下一步。如果你已经知道某个会议记录的资源名也可以直接用GOOGLEMEET_GET_CONFERENCE_RECORD_BY_NAME跳过列表检索。GOOGLEMEET_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID按会议记录 ID 拉取该会议的全部转录资源。注意两点转录资源只有在会议期间开启了转录、且组织者域策略允许时才会生成空结果可能意味着从未生成转录会议结束后转录需要处理时间空结果可能是暂时性的建议延迟后重试再下结论。GOOGLEMEET_LIST_TRANSCRIPT_ENTRIES传入上一步得到的 transcript 资源名返回结构化转录条目每个片段包含说话人、起止时间与文本。逐条处理这些片段即可得到完整的会议文字记录。需要精确取某一条时可再用GOOGLEMEET_GET_TRANSCRIPT_ENTRY按conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}格式的资源名读取。已知限制API 返回的转录条目可能与 Google Docs 中最终生成的转录不完全一致说话人交错或生成后被修改所致因此以 API 条目为准做程序化处理时不要假设与 Docs 版本逐字相同。五、403 权限错误先确认资源可访问性而不是盲目换 token原文档针对 Google Meet API 的常见报错给出了明确诊断方向报错形如Permission denied on resource Conference (or it might not exist)时大概率是会议资源不可访问或不存在而不是凭据格式问题。排查顺序建议如下确认连接账户的访问权限当前登录的连接账户signed-in connected account是否对该会议/工件conference/artifact有访问权限例如会议是否由该账户发起、是否在共享范围内、账户是否仍属于该 Workspace 组织确认会议记录确实存在用GOOGLEMEET_GET_CONFERENCE_RECORD_BY_NAME或GOOGLEMEET_LIST_CONFERENCE_RECORDS复核该记录是否存在、ID 是否拼写正确用最小权限的工具或 Proxy Execute 对比 provider 原始响应原文档特别提醒——provider 的 token 会从连接账户响应中做脱敏redacted不应把响应里出现的 token 复制到支持工单或工作流中。正确的做法是通过一个最小权限的 Composio 工具或 Proxy Execute 调用去比较 provider 返回的原始错误从而区分账户权限不足与资源不存在两类根因。这条原则同样适用于其他工件录制/转录读取出现 403 时先验证工件是否存在、账户是否有权再考虑作用域是否遗漏。六、录制与转录缺失Workspace 版本与功能的双重前提遇到会议结束了却没有录制/转录时原文档提醒不要想当然地归结为工具问题因为 Google 侧本身就存在版本与功能门槛需要符合条件的 Google Workspace 版本支持录制与转录的并非只有 Enterprise 版多个符合条件的 Workspace 版本均可用具体范围以 Google 官方的 Meet 功能矩阵为准主持方必须有该功能会议主持人host自身的账号需具备录制/转录能力组织管理员必须允许组织域策略需要放开录制与转录开关会议期间必须实际启动过录制或转录即使一切配置就绪若会议中没有开启录制/转录事后自然没有对应工件免费个人账号不提供同样的工件可用性个人 Gmail 账号下通常无法获得录制与转录工件。因此一个合规的排障流程是先对照 Google 官方的 Meet 功能矩阵与转录要求原文档已给出对应官方支持页面确认版本与功能满足前提再确认会议过程中确实启动了录制/转录最后才回到 API 侧检查GOOGLEMEET_LIST_RECORDINGS/GOOGLEMEET_GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID的返回注意处理处理中导致的临时空结果适当重试。七、排障速查表现象首要检查项对应章节调用GOOGLEMEET_*报工具不可用连接账户是否属于 Google Super 工具包应改用GOOGLESUPER_*二创建/更新空间报权限不足auth config 是否包含两个 Meet 作用域、是否重新建立连接、Cloud 项目是否启用 Meet API三转录为空会议期间是否开启转录、是否还在处理中延迟重试、Workspace 版本是否合格四、六403 Permission denied on resource Conference连接账户对资源是否有访问权、会议记录是否存在、通过最小权限工具对比原始响应五无录制/转录工件Workspace 版本、主持方功能、组织管理员策略、会议中是否启动过录制/转录六本文所有工具 slug、鉴权字段与默认作用域均可在 docs/public/data/toolkits.jsongooglemeet 条目与 ts/packages/cli/src/generated/toolkit-slugs.ts 中核对知识库原文见 docs/kb/articles/toolkits-googlemeet.md其来源文件为 docs/kb/source/toolkits/googlemeet/public.md对应的站点版指南为 docs/content/kb/guide/toolkits-googlemeet.mdx。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考