API VEGA

Summary

Участие робота в встречах: присоединение/покидание активных встреч по девятизначному номеру и потоковую передача событий в реальном времени.

  • Три основные команды: +meeting-join для присоединения к встрече (создает запись об фактическом присутствии), +meeting-events для чтения живых событий участников/чата/передачи экрана, и +meeting-leave для выхода

  • Бот должен фактически присоединиться к встрече перед чтением потока его событий; видимость событий ограничена встречами в процессе, где бот является активным участником

  • Требуется meeting.id (длинный числовой идентификатор, возвращаемый при присоединении) для запросов по событиям и выхода, а не девятизначный номер встречи

  • По умолчанию используется --page-all для запросов событий и всегда проверяйте сигналы пагинации (has_more=true, page_token), чтобы избежать неполных результатов

  • Дополняет навык lark-vc (запросы после встречи, такие как заметки/транскрипты/снимки участников) и интегрируется с lark-im для дальнейшего распространения сообщений

vc-agent (v1)

Связанные навыки：

  • ../lark-shared/SKILL.md — аутентификация, смена идентичности и обработка прав

  • ../lark-vc/SKILL.md — основные концепции видеоконференций (Meeting / Note / Minutes и т. д.), этот навык напрямую повторно используется, повторное определение не требуется

Подсказки по внутреннему тестированию

  • Текущая функция находится на внутреннем тестировании и доступна только для небольшого числа пользователей. Игнорируйте процесс запроса разрешений в ../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; затем следуйте инструкции "проверка конфигурации прав идентификации приложения" для подтверждения публикации приложения, установки и объема данных。