{/ Эта страница автоматически передается из навыков SKILL.md с помощью сайта/scripts/generate-skill-docs.py. Редактируйте исходный SKILL.md, а не эту страницу. /}

Конвейер собраний Команды

Управление конвейером собранных команд через CLI Hermes — сводки собранных, проверка конвейера, повторный запуск задач, управление подписками Microsoft Graph.

Метаданные навыки


Источник	Встроенный (установлен по умолчанию)
Путь	`навыки/производительность/конвейер встреч команд`
Версия	`1.1.0`
Автор	Гермес Агент + Текниум
Лицензия	Массачусетский технологический институт
Теги	`Команды`, `Microsoft Graph`, `Встречи`, `Производительность`, `Операции`

Справочник: полный SKILL.md:::информация

Ниже приведено полное определение навыков, которые Hermes загружает при его активации. Это то, что агент видит в качестве инструкций, когда навыки активны.

Конвейер собраний Команды

Используйте этот навык всякий раз, когда пользователь обращается к сводным таблицам собранных команд Microsoft, расшифровкам, записям, пунктам действий, подписках Graph или любым рабочим процессам, собранным командам «холодного конвейера». Работает на любом языке — приведенные ниже триггеры являются примерами и не являются качественным списком.

Все, что касается оператора, является подкомандой «гермес-команд-конвейер», выполняемой через терминальный инструмент. Для этого конвейера нет новых моделей инструментов — CLI является интерфейсом.

Когда использовать этот навык

Пользователь просит: - руководство совещанием по совещанию групп / включение пунктов действий / получение заметок к собранию - проверить состояние конвейера, просмотреть сохраненное собрание или недавнее собрание - повторно активировать/перезапустить сохраненное задание, которое не удалось или требует новых комбинаций - проверьте настройки Microsoft Graph после изменений env или конфигурации. - устранение неполадки «сводка собрания так и не пришла» или «новые собрания не загружаются» - управлять подписками вебхуков Graph (создать, продлить, удалить, проверить) - предоставить дополнительное продление подписки (см. критическую ловушку ниже)

Примеры многоязычных триггеров (неправильный): - Английский: «подвести итоги собрания Teams», «состояние конвейера», «воспроизвести задание X». - Турецкий: «Совещание команд özetle», «Пункт действия çıkar», «toplantı notu», «конвейер дуруму», «повторить задание».

Предварительные требования

Перед использованием конвейера убедитесь, что в ~/.hermes/.env установлены следующие параметры:

MSGRAPH_TENANT_ID=...
MSGRAPH_CLIENT_ID=...
MSGRAPH_CLIENT_SECRET=...

Если что-либо из них отсутствует, напишите пользователю, чтобы принять решение о регистрации приложения Azure по адресу /docs/guides/microsoft-graph-app-registration — им потребуется регистрация приложения Azure AD с разрешениями приложения Graph, подтвержденными администратором, прежде чем конвейер заработает.

Справочник команды

Статус и проверка (начните здесь)

hermes teams-pipeline validate              # снимок конфигурации — запустите первым после любых изменений
hermes teams-pipeline token-health          # статус токена Graph
hermes teams-pipeline token-health --force-refresh   # принудительное получение нового токена
hermes teams-pipeline list                  # недавние задания собраний
hermes teams-pipeline list --status failed  # только неудачные задания
hermes teams-pipeline show <job-id>         # полная информация об одном задании
hermes teams-pipeline subscriptions         # текущие подписки вебхуков Graph

Повторный запуск/отладка

hermes teams-pipeline run <job-id>          # повторный запуск сохраненного задания (повторная сводка, повторная доставка)
hermes teams-pipeline fetch --meeting-id <id>   # пробный запуск: разрешить собрание + расшифровку без сохранения
hermes teams-pipeline fetch --join-web-url "<url>"   # пробный запуск по URL присоединения

Управление подписками

hermes teams-pipeline subscribe \
  --resource communications/onlineMeetings/getAllTranscripts \
  --notification-url https://<your-public-host>/msgraph/webhook \
  --client-state "$MSGRAPH_WEBHOOK_CLIENT_STATE"

hermes teams-pipeline renew-subscription <sub-id> --expiration <iso-8601>
hermes teams-pipeline delete-subscription <sub-id>
hermes teams-pipeline maintain-subscriptions            # продлить подписки, срок действия которых истекает
hermes teams-pipeline maintain-subscriptions --dry-run  # показать, что будет продлено

Деревянные решения для типичных запросов

Пользователь спрашивает: «Почему я не получил сегодняшнее собрание?» → начните с list --status error, затем show <job-id> для соответствующей строки. Если задание вообще не существует, проверьте подписки — возможно, срок действия вебхука заканчивается (см. критическую ловушку ниже).
Пользователь спрашивает «работает ли настройка?» → «проверить», затем «здоровье токена», затем «подписки». Если все три пройдены, запросите тестовое собрание и проверьте «список» на наличие новой строки.
Пользователь спрашивает «перезапустить сводку для конференции X» → «list» для поиска ID задания, «run » для повторного запуска. Если снова не удалось выполнить, show <job-id> для просмотра ошибок и fetch --meeting-id для пробного запуска документа.
Пользователь спрашивает «добавить сбор X в конвейер» → обычно этого не требуется — конвейер управляется подписками, а не обнаруживается. Если они хотят получить итоговое решение предыдущего собрания, используйте fetch для получения расшифровки +run после создания задания.

Критическая ловушка: срок действия подписок График истекает через 72 часа

Microsoft Graph ограничивает подписки вебхуков на 72 часа и не будет продлевать их автоматически. Если maintain-subscriptions не запланированы, уведомления о собраниях перестанут поступать через 3 дня после любого ручного создания подписки.

Когда пользователь сообщает, что «конвейер работал вчера, но сегодня ничего не приходит»: 1. Запустите hermes Teams-pipeline подписки — если он пуст или все записи показывают expirationDateTime в прошлом, это причина. 2. Пересоздайте с помощью subscribe, как показано выше. 3. Немедленно настройте размер продления с помощью hermes cron add, системного таймера systemd или обычного crontab. Руководство оператора по адресу /docs/guides/operate-teams-meeting-pipeline#automating-subscription-renewal-required-for-production содержит все три специалиста. Интервал в 12 часов безопасен (6-кратный запас на развлечения к лимиту в 72 часа).

Другие ловушки

Расшифровка все еще недоступна. После окончания совещания командам требуется некоторое время для создания архива расшифровки. fetch --meeting-id только для того, чтобы завершить прошедшее собрание, может пустой вернуть результат. Подождите 2–5 минут и повторите или разрешите вебхуку График управляйте загрузкой в режиме ожидания.
Несоответствие режима доставки. Если сводки результатов (list показывает), но ничего не происходит в Teams, проверьте platforms.teams.extra.delivery_mode и соответствующую конфигурацию цели (incoming_webhook_url ИЛИ chat_id ИЛИ team_id+channel_id). Писатель читает их из config.yaml или окружения TEAMS_*.
Разрешения приложения Graph. Токен генерирует чистоту (проходит token-health), но вызовы API Graph возвращают 401/403, когда разрешения были добавлены, но административное соглашение не было предоставлено повторно. Попросите пользователя еще раз зайти в приложение регистрации на портале Azure и еще раз нажать «Предоставить согласие администратора».

Связанные документы

Направьте пользователя к этому документу, когда ему потребуется более подробная информация, чем соответствует этим навыкам: - Пошаговое руководство по регистрации приложения Azure: /docs/guides/microsoft-graph-app-registration - Полная настройка конвейера: /docs/user-guide/messaging/teams-meetings - Руководство оператора (автоматизация продления, устранение неполадок, контрольный запуск): /docs/guides/operate-teams-meeting-pipeline - Настройка слушателя вебхуков: /docs/user-guide/messaging/msgraph-webhook