Как да поискам от Padlet MCP аналитични данни за администратори?
由 Carla Sese 於 преди 4 дни 更新Не намирате нужните числа в таблото за администратори на училището или Екипа? Свържете Padlet MCP с AI асистент и задавайте въпроси на обикновен език за анализи на училище, учебна стая или Екип, или извикайте сами API за анализи на организацията.
За кого е предназначено
Тази статия е предназначена за:
- Собственици и администратори на акаунти Padlet for Schools или Team
- Собственици и учители на акаунти Classroom
Не е нужно да пишете код, за да използвате MCP. Пътят с API е незадължителен за напреднали потребители, които вече работят с Public API.
Какво вече имате
В страницата Анализи на организацията ви в „Настройки“ вече има подбрани раздели за текущия период на таксуване. За училищата и учебните стаи са налични „Общ преглед“, „Използване“, „Въздействие“, „Безопасност“, „Топ потребители“ и „Всички потребители“. За Екипите са налични „Общи“, „Padlet“ и „Потребители“ или „Общ преглед“, „Използване“, „Въздействие“, „Топ потребители“ и „Всички потребители“, ако вашият Екип разполага с новата страница „Анализи“ (бета).
- Анализи за училищни акаунти (Padlet for Schools и Classroom)
- Анализи за акаунти Team
Използвайте таблото, когато искате бърз визуален преглед. Използвайте MCP или API, когато имате нужда от персонализирана разбивка, на която разделите не дават ясен отговор.
Какво предлагат MCP и API
Таблото съдържа подбрани раздели. С MCP и API можете да поискате точно желаната разбивка:
- Въпроси на обикновен език във вашия AI клиент („Кои учители бяха неактивни през миналия период на таксуване?“)
- Персонализирани съчетания от показатели за ангажираност, членство и безопасност на съдържанието
- Месечни поредици за избран период
- Разбивки по роли (учители спрямо ученици, създатели спрямо сътрудници)
- Най-популярните padlet-и, потребители и медийни файлове, класирани по зададен от вас начин
- Отговори, които можете да копирате в презентация за тримесечен преглед на бизнеса (QBR) или подновяване
Бърз старт с Padlet MCP
- Свържете Padlet MCP във вашия AI клиент. Използвайте URL адреса на сървъра
https://mcp.padlet.com. Пълните инструкции за настройка ще намерите в Сървър Padlet MCP. - Влезте в профила си и се оторизирайте като администратор на организацията, за която искате да изпратите заявка. В Classroom учител също може да извлича анализи.
- Задавайте въпроси на обикновен език. Не е нужно да посочвате вътрешните инструменти. Кажете на AI асистента какво искате да знаете за вашето училище, учебна стая или Екип и той ще използва Padlet MCP от ваше име.
Ето пример:

По избор: API за анализи на организацията
Предпочитате сами да създадете скрипт? Използвайте Public API с API ключ за администратор (или ключ на учител в Classroom).
- Създайте или копирайте API ключ от страницата „Developer“ в „Настройки“. Подробностите ще намерите в статията за Public API.
- Намерете идентификатора на организацията си с
GET /me?include=organizations. Нужен ви е идентификатор с префиксwksp_. Организациитеorg_на padlet.org все още не се поддържат от тази крайна точка. - Изпратете
POSTзаявка до/organizations/{org_id}/analyticsс желаните показатели. - Ако отговорът е
202илиmeta.pendingне е празно, изчакайте указаното време вRetry-Afterи изпратете отново идентичната заявка. Анализите се изчисляват във фонов режим, затова чакащият показател липсва в отговора. Никога не го приемайте за нула.
Кой може да го използва
Засега се поддържат само организации с идентификатор
wksp_.Примерни заявки
Ето няколко начални примера, които можете да поставите във вашия MCP клиент. Променете формулировката така, че да съответства на вашето училище, учебна стая или Екип, и сверете числата със страницата „Анализи“, когато подготвяте презентация за клиенти.
- „За нашето училище през този период на таксуване колко са активните учители спрямо броя на лицензите и през кои месеци има спад?“
- „Кои padlet-и на нашата организация имат най-много преглеждания? Покажи първите 3 табла/sandbox.“
- „Кои членове с роля на учител не са използвали Padlet през последните 12 месеца?“
- „Колко членове нямат имейл адрес от домейна <ouremaildomain.edu>?“
Какво все още прави таблото по-добре
Използвайте страницата „Анализи“ в „Настройки“, когато искате:
- Визуалния банер „Общ преглед“, акцентите „Най-добри възможности“ и заявка за професионално развитие с едно кликване
- Таблицата „Всички потребители“ / „Потребители“ с търсене, филтри по роля и изтегляне на CSV файл с едно кликване
- Списъци за изтегляне на активни и неактивни учители за избрания период от раздела „Общ преглед“ (училища и учебни стаи)
MCP и API са особено полезни, когато подбраните раздели не дават точния отговор, от който се нуждаете за демонстрация или разговор за подновяване.
Ограничения:
- Ограничение на честотата: 60 заявки на час за всеки API ключ и организация, включително повторните проверки след
202 - Период: най-много 24 месеца в една заявка
- Безопасност на съдържанието: само за училища и учебни стаи. За тези показатели Екипите получават отговор
400 - Брой членове: отразява текущия списък, а не историческа снимка на това кои са били членове в дадения момент
- В изчакване ≠ нула: показател, който все още се изчислява, липсва в отговора; не го приемайте за нула
- Тип организация: засега се поддържа само
wksp_
Често задавани въпроси
Защо получавам 404, когато поискам анализи?
Всички откази изглеждат еднакво: за непозната организация или липса на достъп се връща 404. Уверете се, че сте влезли като администратор (или като учител в Classroom) на тази организация и че тя е от тип wksp_. Все още имате проблем? Свържете се с екипа за поддръжка.
Трябва ли да пиша код?
Не. Свържете Padlet MCP, влезте като администратор и задавайте въпроси на обикновен език. Пътят с API е незадължителен за разработчици и напреднали потребители, които вече използват Public API.
Това същото ли е като Public API?
Свързани са, но не са един и същ продукт. Public API е предназначен за разработчици, които използват API ключ. Padlet MCP е за AI асистенти, които оторизирате чрез влизане в профила си. И двата инструмента имат достъп до анализите на организацията и можете да използвате единия или и двата.
Могат ли ученици или потребители, които не са администратори, да виждат така анализите на организацията?
Не. За достъп до анализите е необходим администратор на организацията или учител в Classroom. Асистентът има точно същия достъп като акаунта, с който сте влезли, и нищо повече.
Моят MCP клиент сякаш не разпознава анализите. Какво да опитам?
При някои клиенти обновяването на списъка с инструменти се забавя. Опитайте да свържете отново Padlet MCP, да преминете към друг съвместим с MCP клиент или да използвате директно API за анализи на организацията. Ако все още имате проблем, свържете се с нас.
Свързани статии
- Сървър Padlet MCP
- Анализи за училищни акаунти
- Анализи за акаунти Team
- Public API
- Прочетете за анализите на организацията (документация за разработчици)
