Как да поискам Admin Analytics (Beta) от Padlet MCP?

Carla Seses profilbildUppdaterad преди 13 часа av Carla Sese

Нужните ви числа не са представени по желания от вас начин в таблото за администратори на училището или Екипа? Свържете Padlet MCP с AI асистент и поискайте анализи за училище, учебна стая или Екип на разбираем език — или извикайте сами API за анализи на организацията.

За пълната справка за REST API (каталог на показателите, формати на заявките и кодове за грешки) вижте Read organization analytics на docs.padlet.dev.

За кого е предназначено

Тази статия е за:

  • Собственици и администратори на акаунти Padlet for Schools или Екип
  • Собственици и учители на акаунти Classroom

Не е необходимо да пишете код, за да използвате MCP. Използването на API е незадължително за напреднали потребители, които вече работят с Public API.

Какво вече имате

Страницата Анализи на организацията ви в „Настройки“ вече показва подбрани раздели за текущия период на таксуване. Училищата и учебните стаи имат разделите „Общ преглед“, „Използване“, „Въздействие“, „Безопасност“, „Най-активни потребители“ и „Всички потребители“. Екипите имат разделите „Общи“, „Padlet-и“ и „Потребители“.

Използвайте таблото, когато искате бърз визуален преглед. Използвайте MCP или API, когато ви е необходима персонализирана разбивка, на която разделите не дават ясен отговор.

Какво ви дават MCP / API

Таблото предлага подбрани раздели. MCP и API ви позволяват да зададете точно желаната разбивка:

  • Въпроси на разбираем език във вашия AI клиент („Кои учители бяха неактивни през предишния период на таксуване?“)
  • Персонализирани комбинации от показатели за ангажираност, членство и безопасност на съдържанието
  • Месечни поредици за избран период от дати
  • Разбивки по роли (учители спрямо ученици, създатели спрямо сътрудници)
  • Най-популярни padlet-и, потребители и медийни материали, подредени по зададен от вас начин
  • Отговори, които можете да поставите в презентация за QBR или подновяване
Показателите за безопасност на съдържанието (сканирани елементи, маркирани елементи, процент на откриване) са достъпни само за училища и учебни стаи. Ако ги поискате за организация от тип Екип, ще получите грешка, а не нулева стойност.

Бърз старт с Padlet MCP

  1. Свържете Padlet MCP във вашия AI клиент. Използвайте URL адреса на сървъра https://mcp.padlet.com. Пълните инструкции за настройка ще намерите в статията Padlet MCP Server.
  2. Влезте и дайте разрешение като администратор на организацията, за която искате да правите справки. В Classroom учителите също могат да извличат анализи.
  3. Задавайте въпроси на разбираем език. Не е нужно да назовавате вътрешните инструменти. Кажете на AI асистента какво искате да знаете за вашето училище, учебна стая или Екип и той ще използва Padlet MCP от ваше име.

Ето пример:

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

По избор: API за анализи на организацията

Предпочитате сами да автоматизирате това със скрипт? Използвайте Public API с API ключ на администратор (или ключ на учител в Classroom).

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

Достъп в пилотен режим

Анализите на организацията чрез MCP и API са достъпни с включване по заявка по време на пилотния период. Padlet включва собственика на организацията — само ролята на администратор не е достатъчна. Докато организацията ви не бъде включена, всяко извикване ще връща 404 (същия отговор като за неизвестна организация).

Засега се поддържат само организации от вида wksp_.

Свържете се с екипа за поддръжка и поискайте да включат собственика на организацията ви за администраторски анализи.

Примерни подкани

Ето няколко отправни точки, които можете да поставите във вашия MCP клиент. Променете формулировките според нуждите на училището, учебната стая или Екипа си — и сверете числата със страницата „Анализи“, когато подготвяте презентация за клиенти.

  • „За нашето училище през този период на таксуване — колко са активните учители спрямо броя на лицензите и през кои месеци имаше спад?“
  • „Кои padlet-и в организацията имат най-много преглеждания? Покажи ми първите 3 дъски/sandbox-а.“
  • „Кои членове с роля на учител не са използвали Padlet през последните 12 месеца?“
  • „Колко членове нямат имейл домейна <ouremaildomain.edu>?“
Поискайте нужната ви разбивка: месечна поредица, филтър по роля, най-популярни padlet-и по публикации или посетители или общи показатели за безопасност на съдържанието за училище или учебна стая. Асистентът ще свърже въпроса ви с наличните показатели.

В какво таблото все още е по-добро

Използвайте страницата „Анализи“ в „Настройки“, когато искате:

  • Визуалния банер „Общ преглед“, препоръки за най-добри възможности и заявка за професионално развитие с едно щракване
  • Таблицата „Всички потребители“ / „Потребители“ с търсене, филтри по роли и изтегляне на CSV файл с едно щракване
  • Списъци за изтегляне на активни и неактивни учители за избрания период от раздела „Общ преглед“ (за училища и учебни стаи)
  • Изглед, за който не е нужно включване в пилотния режим — страницата „Настройки“ е достъпна за отговарящите на условията роли и без включване на API

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

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

  • Ограничение на честотата: 60 заявки на час за API ключ и организация, включително повторните заявки след отговор 202
  • Период от дати: максимум 24 месеца в една заявка
  • Безопасност на съдържанието: само за училища и учебни стаи — за тези показатели Екипите получават отговор 400
  • Брой членове: отразява текущия списък, а не историческия състав към определен момент
  • В процес на обработка ≠ нула: показател, чието изчисление още продължава, липсва в отговора; не приемайте, че стойността му е нула
  • Тип организация: засега се поддържа само wksp_

Често задавани въпроси

Защо получавам отговор 404, когато поискам анализи?

Докато крайната точка е в пилотен режим, всички откази изглеждат еднакво: невключена организация, неизвестна организация или липса на достъп — всички връщат 404. Уверете се, че сте влезли като администратор (или учител в Classroom), че организацията ви е от вида wksp_ и че Padlet е включил собственика на организацията. Свържете се с екипа за поддръжка, за да поискате включване.

Трябва ли да пиша код?

Не. Свържете Padlet MCP, влезте като администратор и задавайте въпроси на разбираем език. Използването на API е незадължително за разработчици и напреднали потребители, които вече използват Public API.

Това същото ли е като Public API?

Свързани са, но са различни начини за достъп. Public API е предназначен за разработчици, които използват API ключ. Padlet MCP е предназначен за AI асистенти, на които давате разрешение чрез влизане в акаунта си. И двата инструмента имат достъп до анализите на организацията, след като тя бъде включена; можете да използвате единия или и двата.

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

Не. За анализите е необходим администратор на организацията или учител в Classroom. Асистентът има точно същия достъп като акаунта, с който сте влезли — нито повече, нито по-малко.

MCP клиентът ми сякаш не разпознава анализите. Какво да опитам?

При някои клиенти списъкът с инструменти се актуализира със закъснение. Опитайте да свържете отново Padlet MCP, да преминете към друг MCP-съвместим клиент или да използвате директно API за анализи на организацията. Ако проблемът продължава и след включването, свържете се с нас.

Свързани статии

Var den här artikeln till hjälp?

Relaterade artiklar