Активности с помощью MCP
Агент может подготовить черновик активности, изменить его и запросить запуск. Для работы с черновиками нужен боевой ключ на Pro или Enterprise с правами activities:read и activities:draft. Для запроса запуска нужен боевой ключ Enterprise с правом activities:control. Подключение даёт те же права.
Запуск и остановку подтверждаете вы в приложении. Агент вернёт ссылку на запрос; перед подтверждением проверьте настройки активности. Если запрос недоступен, проверьте тариф и права ключа или управляйте активностью в кабинете.
Три примера запросов#
Фразы можно адаптировать под свою задачу. Для работы с черновиками агенту нужны activities:read и activities:draft.
- Создать активность. «Подготовь черновик конкурса для моего канала [название]: название — [название], запуск — [дата и время], окончание — [дата и время], часовой пояс — [пояс]. Условия участия: [условия], призы: [призы]. Если каких-то данных не хватает, спроси меня. Покажи итог для проверки». Агент создаёт черновик, а не запускает его.
- Изменить черновик. «Найди мой черновик [название или ID], покажи текущие условия и призы, затем измени [что именно]. Покажи результат и сообщи, если нужное изменение недоступно». Инструменты изменения работают с черновиками.
- Подготовить запуск и анонс. «Проверь черновик [название или ID] и покажи его настройки. Если доступен запрос запуска, отправь его мне на подтверждение. Также подготовь в контент-плане [название] черновик анонса на [дата и время] с условиями и ссылкой [ссылка]». Для запроса запуска нужен боевой ключ Enterprise с правом
activities:controlили подключение с тем же правом; для поста нужныcontent:readиcontent:draft. Проверьте и подтвердите запуск в приложении, а пост согласуйте по правилам контент-плана.
Для тех, кто пишет интеграцию#
activities_list и activities_get читают активности; инструменты activities_draft_* создают и изменяют черновики. При записи нужен уникальный operation_id, а при изменении — актуальный expected_revision. Инструменты activities_request_launch и activities_request_stop создают запрос подтверждения, а activities_get_action_request показывает его состояние. Если у активности есть условие «комментарий», activities_get добавляет telegramCommentSetupWarnings с кодами tg_no_discussion_group и tg_bot_not_discussion_admin, когда проверка Telegram подтвердила проблему. Пустой список значит, что явной проблемы нет. Новое условие «комментарий» при tg_no_discussion_group не сохраняется: сначала привяжите группу обсуждений. Код tg_bot_not_discussion_admin условие не отклоняет, это предупреждение.