Как да поискам от Padlet MCP аналитични данни за администратори?

Carla Sese 的個人檔案照片由 Carla Sese 於 преди 4 дни 更新

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

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

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

Тази статия е предназначена за:

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

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

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

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

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

Какво предлагат MCP и API

Таблото съдържа подбрани раздели. С MCP и API можете да поискате точно желаната разбивка:

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

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

  1. Свържете Padlet MCP във вашия AI клиент. Използвайте URL адреса на сървъра https://mcp.padlet.com. Пълните инструкции за настройка ще намерите в Сървър Padlet MCP.
  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 и изпратете отново идентичната заявка. Анализите се изчисляват във фонов режим, затова чакащият показател липсва в отговора. Никога не го приемайте за нула.
Пълните формати на заявките, каталогът с показатели и готовите примери са в Прочетете за анализите на организацията.

Кой може да го използва

Анализите на организацията чрез Padlet MCP и API са достъпни за собствениците и администраторите на акаунти Padlet for Schools и Team, както и за собствениците и учителите в акаунти Classroom. Не е нужно да молите Padlet да активира тази функция.

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

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

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

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

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

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

  • Визуалния банер „Общ преглед“, акцентите „Най-добри възможности“ и заявка за професионално развитие с едно кликване
  • Таблицата „Всички потребители“ / „Потребители“ с търсене, филтри по роля и изтегляне на 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 за анализи на организацията. Ако все още имате проблем, свържете се с нас.

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

這篇文章有幫助嗎?

相關文章