Как запросить Admin Analytics в Padlet MCP?

Photo de profil de Carla SeseMis à jour 4 дня назад par Carla Sese

Не хватает данных в панели администратора школы или Команды? Подключите Padlet MCP к ИИ-ассистенту и задавайте вопросы об аналитике школы, класса или команды обычным языком либо самостоятельно вызывайте API аналитики организации.

Полное описание REST API (каталог метрик, форматы запросов и коды ошибок) см. в разделе Чтение аналитики организации на docs.padlet.dev.

Для кого эта статья

Эта статья предназначена для:

  • Владельцев и администраторов аккаунтов Padlet для школ или Команд
  • Владельцев и учителей аккаунтов классов

Для работы через MCP не нужно писать код. API — дополнительный вариант для опытных пользователей, которые уже работают с публичным API.

Что у вас уже есть

На странице «Аналитика» вашей организации в настройках уже есть тематические вкладки за текущий расчетный период. Для школ и классов доступны вкладки «Обзор», «Использование», «Влияние», «Безопасность», «Самые активные пользователи» и «Все пользователи». Для Команд доступны вкладки «Общие сведения», «Padlet» и «Пользователи» либо «Обзор», «Использование», «Влияние», «Самые активные пользователи» и «Все пользователи», если в вашей Команде доступна новая страница «Аналитика» (бета-версия).

Если вам нужен быстрый визуальный обзор, воспользуйтесь панелью. Если нужны данные в разрезе, которого нет на вкладках, используйте MCP или API.

Что дают MCP и API

На панели собраны тематические вкладки. MCP и API позволяют запросить именно нужные вам данные:

  • Задавайте вопросы обычным языком в своем ИИ-клиенте («Какие учителя не проявляли активность в прошлом расчетном периоде?»)
  • Сочетайте метрики вовлеченности, состава участников и безопасности контента
  • Получайте помесячные данные за выбранный период
  • Фильтруйте по ролям (учителя и ученики, авторы и участники)
  • Составляйте рейтинги популярных padlet, пользователей и медиа по заданным критериям
  • Получайте ответы, которые можно вставить в презентацию для ежеквартального обзора бизнеса или продления подписки
Метрики безопасности контента (проверенные материалы, помеченные материалы, доля обнаружения) доступны только для школ и классов. Если запросить их для организации типа «Команда», API вернет ошибку, а не нулевое значение.

Быстрый старт с Padlet MCP

  1. Подключите Padlet MCP в своем ИИ-клиенте. URL сервера: https://mcp.padlet.com. Полные инструкции по настройке см. в статье Сервер Padlet MCP.
  2. Войдите в систему и предоставьте разрешение как администратор организации, данные которой хотите запросить. В классе аналитику также может получать учитель.
  3. Задавайте вопросы обычным языком. Называть внутренние инструменты не нужно. Скажите ИИ-ассистенту, что хотите узнать о своей школе, классе или команде, и он выполнит запрос через Padlet MCP.

Например:

Если ваш MCP-клиент пока не показывает ответы по аналитике, попробуйте другой клиент с поддержкой MCP или воспользуйтесь API аналитики организации. Поддержка со стороны клиентов может появляться с задержкой.
Ассистент действует от вашего имени и может получать только те данные аналитики, которые доступны вашей учетной записи.

Дополнительно: API аналитики организации

Предпочитаете написать собственный скрипт? Используйте публичный API с ключом API администратора (или ключом учителя для класса).

  1. Создайте или скопируйте ключ API на странице для разработчиков в настройках. Подробности — в статье Публичный API.
  2. Найдите идентификатор организации с помощью GET /me?include=organizations. Вам нужен идентификатор wksp_. Организации org_ на padlet.org пока не поддерживаются этой конечной точкой.
  3. Отправьте запрос POST на /organizations/{org_id}/analytics с нужными метриками.
  4. Если ответ содержит код 202 или поле meta.pending не пустое, дождитесь значения Retry-After и повторно отправьте точно такой же запрос. Аналитика рассчитывается в фоновом режиме, поэтому ожидающая метрика отсутствует в ответе. Никогда не считайте ее нулевой.
Полные форматы запросов, каталог метрик и примеры доступны в разделе Чтение аналитики организации.

Кто может пользоваться

Аналитика организации через Padlet MCP и API доступна владельцам и администраторам аккаунтов Padlet для школ и Команд, а также владельцам и учителям классов. Обращаться в Padlet, чтобы включить эту функцию, не нужно.

Пока поддерживаются только организации с идентификатором wksp_.

Примеры запросов

Вот несколько примеров запросов, которые можно скопировать в MCP-клиент. Измените формулировки с учетом своей школы, класса или команды и сверяйте цифры со страницей «Аналитика», когда готовите презентацию для клиентов.

  • «Сколько учителей проявляли активность в нашей школе в этом расчетном периоде по сравнению с количеством лицензий и в какие месяцы показатели снижались?»
  • «У каких padlet организации больше всего просмотров? Покажи три самые популярные доски или пространства sandbox».
  • «Кто из участников с ролью учителя не пользовался Padlet последние 12 месяцев?»
  • «У скольких участников адрес электронной почты не относится к домену <ouremaildomain.edu>?»
Запрашивайте нужные данные: помесячную статистику, фильтр по ролям, рейтинг padlet по количеству постов или посетителей либо сводные показатели безопасности контента для школы или класса. Ассистент сопоставит ваш вопрос с доступными метриками.

В чем панель по-прежнему удобнее

Воспользуйтесь страницей «Аналитика» в настройках, если вам нужны:

  • Визуальный баннер «Обзор», подсказки о лучших возможностях и отправка запроса на повышение квалификации одним нажатием
  • Таблица «Все пользователи» / «Пользователи» с поиском, фильтрами по ролям и скачиванием CSV одним нажатием
  • Списки активных и неактивных учителей за выбранный период, которые можно скачать на вкладке «Обзор» (для школ и классов)

MCP и API особенно полезны, когда тематические вкладки не дают точного ответа, необходимого для демонстрации или обсуждения продления подписки.

Ограничения:

  • Ограничение частоты запросов: 60 запросов в час на ключ API и организацию, включая повторные запросы после ответа 202
  • Диапазон дат: не более 24 месяцев в одном запросе
  • Безопасность контента: только для школ и классов. Для Команд при запросе этих метрик возвращается ошибка 400
  • Количество участников: отражает текущий состав, а не исторический снимок участников на определенную дату
  • Ожидание ≠ ноль: метрика, которая еще рассчитывается, отсутствует в ответе; не считайте ее нулевой
  • Тип организации: пока поддерживается только wksp_

Часто задаваемые вопросы

Почему при запросе аналитики я получаю ошибку 404?

Во всех случаях отказ выглядит одинаково: для неизвестной организации и при отсутствии доступа возвращается код 404. Убедитесь, что вы вошли как администратор этой организации (или как учитель в классе) и что у нее идентификатор wksp_. Не помогло? Обратитесь в службу поддержки.

Нужно ли писать код?

Нет. Подключите Padlet MCP, войдите как администратор и задавайте вопросы обычным языком. API — дополнительный вариант для разработчиков и опытных пользователей, которые уже используют публичный API.

Это то же самое, что публичный API?

Эти продукты связаны, но это не одно и то же. Публичный API предназначен для разработчиков, использующих ключ API. Padlet MCP предназначен для ИИ-ассистентов, которым вы предоставляете доступ после входа в систему. Оба способа позволяют получать аналитику организации, и вы можете использовать любой из них или оба.

Могут ли ученики или пользователи без прав администратора просматривать таким способом аналитику организации?

Нет. Для доступа к аналитике требуется быть администратором организации или учителем в классе. Ассистент имеет ровно те же права доступа, что и учетная запись, с которой вы вошли в систему, и не более того.

Кажется, мой MCP-клиент не знает об аналитике. Что попробовать?

Некоторым клиентам требуется время, чтобы обновить список инструментов. Попробуйте переподключить Padlet MCP, переключиться на другой клиент с поддержкой MCP или напрямую воспользоваться API аналитики организации. Если проблема не решилась, свяжитесь с нами.

Связанные материалы

Cet article vous a-t-il été utile ?

Articles connexes