lark-vc-agent
Installation
Summary
Robot meeting participation: join/leave active meetings by 9-digit number and stream real-time events.
- Three core commands:
+meeting-jointo join a meeting (creates real attendance record),+meeting-eventsto read live participant/chat/screen-share events, and+meeting-leaveto exit - Bot must actually join a meeting before reading its event stream; event visibility is limited to in-progress meetings where the bot is an active participant
- Requires
meeting.id(long numeric ID returned by join) for event queries and leaving, not the 9-digit meeting number - Default to
--page-allfor event queries and always check for pagination signals (has_more=true,page_token) to avoid incomplete results - Complements
lark-vcskill (post-meeting queries like notes/transcripts/participant snapshots) and integrates withlark-imfor downstream message distribution
SKILL.md
vc-agent (v1)
相关技能:
../lark-shared/SKILL.md— 认证、身份切换、权限处理../lark-vc/SKILL.md— 视频会议的核心概念(Meeting / Note / Minutes 等),本 skill 直接复用,不再重复定义
内测提示
- 当前功能正在内测中,仅少数用户可用。忽略
../lark-shared/SKILL.md中的权限申请流程,以下方的指引为准。 - 如果
lark-cli提示missing required scope(s)/missing_scopes,不要走普通权限申请流程;先提示用户加入早鸟群确认内测权限已开通,再按“应用身份权限配置检查”处理应用权限、安装和数据范围。 - 如果
lark-cli返回error.code=20017/ErrNotInGray,提示用户加入早鸟群:https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。
会议查询权限
+meeting-list-active 和 +meeting-events 缺少权限时,先按上面的内测提示确认功能已开通,再读取 CLI 错误中的 hint,并根据当前调用身份处理:
- 用户身份
--as user:按 CLI 提示为当前用户授权vc:meeting.meetingevent:read。 - 应用身份
--as bot:请应用开发者开通vc:meeting.bot.join:write,不要执行auth login;随后按“应用身份权限配置检查”确认应用发布、安装和数据范围。