Как да поискам от Padlet MCP данни за анализи за администратори (бета)?

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

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

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

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

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

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

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

• Анализ на акаунт за училище (Padlet for Schools и Classroom)
• Анализ на акаунт за Екип

Използвайте таблото, когато искате бърза визуална справка. Използвайте 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 от ваше име.

Ето пример:

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

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

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

Достъп до пилотната програма

Примерни заявки

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

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

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

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

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

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

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

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

ЧЗВ

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

• Padlet MCP Server
• Анализ на акаунт за училище
• Анализ на акаунт за Екип
• Public API
• Преглед на аналитичните данни на организацията (документация за разработчици)