Бот присоединяется к видеовстречам Lark от вашего имени: мониторинг в реальном времени, выход по завершении. Укажите 9-значный номер встречи — бот подключится.

vc-agent (v1) — агент видеоконференций Lark

Скилл для «действий внутри встречи» в Feishu/Lark: позволяет боту реально войти в текущую встречу или покинуть её, а также читать события в реальном времени (вход/выход участников, речь, чат, демонстрация экрана). Используйте этот скилл, когда пользователь спрашивает о том, что происходит в идущей встрече.

Смежные скиллы

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

Бета-доступ

Функционал находится на стадии бета-тестирования и доступен лишь ограниченному кругу пользователей.
При ошибках missing required scope(s) / permission_violations — не используйте стандартный процесс запроса разрешений; сначала уточните у пользователя, подключён ли он к бета-группе, затем проверьте разрешения приложения согласно разделу ниже.
При ошибке error.code=20017 / ErrNotInGray — предложите пользователю вступить в группу раннего доступа: https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd

Разграничение зон ответственности

Данный скилл работает параллельно с lark-vc:

lark-vc — «запросы после встречи»: поиск прошедших встреч, список участников, конспекты / транскрипты / записи.
lark-vc-agent — «действия во время встречи»: вход бота / чтение событий идущей встречи / выход бота.

Намерение пользователя	Скилл
«Войди в встречу 123456789», «присоединись вместо меня», «пусть бот подключится»	Этот скилл `+meeting-join`
«Встреча идёт — кто только что вошёл?», «кто говорит?», «кто-то делится экраном?»	Этот скилл `+meeting-events`
«В какой встрече я/пользователь сейчас нахожусь?», «найди meeting_id текущей встречи»	Этот скилл `+meeting-list-active`
«Выйди из встречи», «пусть бот покинет»	Этот скилл `+meeting-leave`
«Кто был на вчерашней встрече?», «найди вчерашнюю встречу», «покажи конспект/запись»	`lark-vc`

Маршрутизация по удостоверению

Сценарий	Удостоверение	Правило
Запросить встречи текущего пользователя	`--as user`	Не передавать `--user-id`; для чтения событий продолжать использовать `--as user`
Запросить встречи целевого пользователя (бот уже в встрече)	`--as bot --user-id <user_open_id>`	`--user-id` должен быть `ou_...`; продолжать `--as bot`
Пользователь явно просит бота войти/прослушать/присутствовать	`--as bot`	Это операция записи; возвращённый `meeting.id` использовать в дальнейшем

Жёсткое правило: удостоверение, от которого получен meeting_id, используется и для всех последующих вызовов +meeting-events.

Основные сценарии

1. Вход в идущую встречу (операция записи)

Используйте +meeting-join только когда пользователь явно хочет «реального присутствия» бота.
Принимает только 9-значный номер встречи — не ссылку и не meeting_id.
meeting.id из ответа нужно сохранить немедленно — он нужен для +meeting-events / +meeting-leave.
Вход виден всем участникам — уточните номер встречи перед выполнением.

2. Чтение событий встречи (операция чтения)

Используйте +meeting-events когда нужно «что происходит сейчас» (участники, чат, транскрипция, демонстрация экрана).
Входной параметр — meeting_id (длинное числовое ID), не 9-значный номер.
По умолчанию использовать --page-all, если пользователь не просит «только одну страницу».
Предпочтительный формат: --format pretty (удобная временная шкала).
Нельзя использовать для анализа завершённых встреч — это зона ответственности lark-vc.
При наличии has_more=true или page_token в ответе — обязательно продолжить постраничную загрузку.
Всегда заново запрашивайте события при ответе на вопросы о текущем состоянии встречи — не переиспользуйте старые результаты.

3. Выход из встречи (операция записи)

Выполняйте +meeting-leave --as bot --meeting-id <длинный meeting_id> только при явном запросе пользователя.
Принимает только длинное числовое meeting_id — не 9-значный номер.
Выход виден другим участникам немедленно.

4. Получение ID идущих встреч (операция чтения)

Пользовательское удостоверение: lark-cli vc +meeting-list-active --as user --format json — встречи текущего пользователя.
Удостоверение приложения: lark-cli vc +meeting-list-active --as bot --user-id <open_id> --format json — встречи целевого пользователя, в которых бот уже находится.
При нескольких результатах — показать список по meeting_title / meeting_no и дождаться выбора пользователя.

5. Пример работы агента

# 1. Войти в встречу, сохранить meeting.id
JOIN=$(lark-cli vc +meeting-join --as bot --meeting-number 123456789 --format json)
MID=$(echo "$JOIN" | jq -r '.data.meeting.id')

# 2. Читать события (интервал ~10-30 сек)
lark-cli vc +meeting-events --as bot --meeting-id "$MID" --page-all --format pretty

# 3. После встречи — получить данные о продуктах встречи
lark-cli vc +detail --meeting-ids "$MID"

Shortcuts

Shortcut	Тип	Описание
`+meeting-join`	запись	Войти в идущую встречу по 9-значному номеру
`+meeting-list-active`	чтение	Список активных встреч и получение meeting_id
`+meeting-events`	чтение	События встречи (участники, транскрипция, чат, демонстрация экрана)
`+meeting-leave`	запись	Выйти из встречи по meeting_id

Диагностика разрешений приложения

При ошибках no permission, missing required scope(s), ErrNotInGray (код 20017) для --as bot:

Убедитесь, что нужные VC Agent-разрешения активированы в консоли разработчика.
Приложение опубликовано и установлено в текущем тенанте.
Настроена область данных «Открытая платформа».
В настройке диапазона данных выбрано условие: владелец встречи включён в доступную область приложения.
Если всё верно, но ошибка ErrNotInGray сохраняется — требуется подключение к бета-программе.

Связанные скиллы

lark-vc — поиск прошедших встреч, список участников, конспекты/транскрипты/записи
lark-minutes — продукты AI-конспекта (сводка / транскрипция / главы)
lark-im — отправка результатов в группы или личные чаты
lark-shared — аутентификация, переключение удостоверений, управление scope

lark-vc-agentбот для видеовстреч Lark

Установка