Jak poprosić Padlet MCP o analitykę administratora?

Carla Sese’in profil fotoğrafıCarla Sese tarafından 4 dni temu güncellendi

Potrzebujesz liczb, których nie da się uzyskać w odpowiednim przekroju w panelu administratora szkoły lub zespołu? Połącz Padlet MCP z asystentem AI i zadawaj prostym językiem pytania o analitykę szkoły, klasy lub zespołu albo samodzielnie wywołuj API analityki organizacji.

Pełny opis REST (katalog wskaźników, formaty żądań i kody błędów) znajdziesz w artykule Odczytywanie danych analitycznych organizacji na stronie docs.padlet.dev.

Dla kogo jest ten artykuł

Ten artykuł jest przeznaczony dla:

  • właścicieli i administratorów kont Padlet for Schools lub Team
  • właścicieli i nauczycieli kont Classroom

Do korzystania z MCP nie musisz pisać kodu. Korzystanie z API jest opcjonalne i przeznaczone dla zaawansowanych użytkowników, którzy już korzystają z Public API.

Co już masz

Na stronie Analityka organizacji w Ustawieniach znajdziesz gotowe karty z danymi za bieżący okres rozliczeniowy. W szkołach i klasach dostępne są karty Przegląd, Użycie, Wpływ, Bezpieczeństwo, Najaktywniejsi użytkownicy i Wszyscy użytkownicy. Zespoły mają karty Ogólne, Padlety i Użytkownicy albo Przegląd, Użycie, Wpływ, Najaktywniejsi użytkownicy i Wszyscy użytkownicy, jeśli Twój zespół korzysta z nowej strony Analityka (beta).

Skorzystaj z panelu, jeśli chcesz szybko uzyskać wizualny podgląd danych. Użyj MCP lub API, jeśli potrzebujesz przekroju, którego nie da się łatwo uzyskać na kartach.

Co oferują MCP i API

Panel zawiera gotowe karty. MCP i API pozwalają uzyskać dokładnie taki przekrój, jakiego potrzebujesz:

  • Pytania zadawane prostym językiem w kliencie AI („którzy nauczyciele byli nieaktywni w poprzednim okresie rozliczeniowym?”)
  • Niestandardowe zestawienia wskaźników zaangażowania, członkostwa i bezpieczeństwa treści
  • Miesięczne zestawienia z wybranego zakresu dat
  • Zestawienia według ról (nauczyciele i uczniowie, twórcy i współtwórcy)
  • Najpopularniejsze padlety, użytkownicy i materiały uporządkowane według wskazanych kryteriów
  • Odpowiedzi, które możesz wkleić do prezentacji na QBR lub dotyczącej odnowienia umowy
Wskaźniki bezpieczeństwa treści (skanowane elementy, oflagowane elementy, współczynnik wykrywalności) są dostępne tylko w szkołach i klasach. Prośba o nie dla organizacji typu Team zwróci błąd, a nie zero.

Szybki start z Padlet MCP

  1. Połącz Padlet MCP ze swoim klientem AI. Użyj adresu URL serwera https://mcp.padlet.com. Pełną instrukcję konfiguracji znajdziesz w artykule Serwer Padlet MCP.
  2. Zaloguj się i autoryzuj jako administrator organizacji, której dane chcesz sprawdzić. W Classroom analitykę może też pobierać nauczyciel.
  3. Zadawaj pytania prostym językiem. Nie musisz podawać nazw narzędzi wewnętrznych. Powiedz asystentowi AI, czego chcesz się dowiedzieć o swojej szkole, klasie lub zespole, a on użyje Padlet MCP w Twoim imieniu.

Oto przykład:

Jeśli wybrany klient MCP nie wyświetla jeszcze odpowiedzi dotyczących analityki, spróbuj użyć innego klienta zgodnego z MCP lub skorzystaj z API analityki organizacji. Obsługa nowych funkcji w klientach może być opóźniona względem serwera.
Asystent działa w Twoim imieniu. Może pobierać tylko te dane analityczne, do których wglądu uprawnia Cię zalogowane konto.

Opcjonalnie: API analityki organizacji

Wolisz samodzielnie napisać skrypt? Skorzystaj z Public API, używając klucza API administratora (lub klucza nauczyciela w Classroom).

  1. Utwórz lub skopiuj klucz API ze strony Developer w Ustawieniach. Szczegóły znajdziesz w artykule Public API.
  2. Znajdź identyfikator organizacji za pomocą GET /me?include=organizations. Szukaj identyfikatora wksp_. Organizacje org_ w domenie padlet.org nie są jeszcze obsługiwane w przypadku tego punktu końcowego.
  3. Wyślij żądanie POST do /organizations/{org_id}/analytics, podając interesujące Cię wskaźniki.
  4. Jeśli odpowiedź ma kod 202 lub pole meta.pending nie jest puste, poczekaj przez czas określony w nagłówku Retry-After i ponownie wyślij identyczne żądanie. Dane analityczne są obliczane w tle, więc oczekującego wskaźnika nie będzie w odpowiedzi. Nigdy nie traktuj go jako zera.
Pełne formaty żądań, katalog wskaźników i przykłady znajdziesz w artykule Odczytywanie danych analitycznych organizacji.

Kto może korzystać z tej funkcji

Dane analityczne organizacji dostępne przez Padlet MCP i API mogą pobierać właściciele i administratorzy kont Padlet for Schools i Team oraz właściciele i nauczyciele kont Classroom. Nie musisz prosić Padlet o włączenie tej funkcji.

Na razie obsługiwane są tylko organizacje z identyfikatorem wksp_.

Przykładowe polecenia

Możesz skopiować te przykładowe polecenia do klienta MCP. Dostosuj ich treść do swojej szkoły, klasy lub zespołu, a przygotowując prezentację dla klienta, porównaj liczby ze stroną Analityka.

  • „Ilu nauczycieli w naszej szkole było aktywnych w tym okresie rozliczeniowym w porównaniu z liczbą licencji i w których miesiącach nastąpił spadek?”
  • „Które padlety w naszej organizacji mają najwięcej wyświetleń? Podaj 3 najpopularniejsze tablice/sandboxy.”
  • „Którzy członkowie z rolą nauczyciela nie korzystali z Padlet w ciągu ostatnich 12 miesięcy?”
  • „Ilu członków nie ma adresu e-mail w domenie <ouremaildomain.edu>?”
Poproś o potrzebny przekrój: zestawienie miesięczne, filtr według roli, najpopularniejsze padlety według liczby wpisów lub odwiedzających albo łączne dane dotyczące bezpieczeństwa treści dla szkoły lub klasy. Asystent dopasuje Twoje pytanie do dostępnych wskaźników.

Co nadal lepiej sprawdza się w panelu

Korzystaj ze strony Analityka w Ustawieniach, jeśli potrzebujesz:

  • Wizualnego banera Przegląd, informacji o największych szansach i możliwości wysłania prośby o PD jednym kliknięciem
  • Tabeli Wszyscy użytkownicy / Użytkownicy z wyszukiwaniem, filtrami ról i możliwością pobrania pliku CSV jednym kliknięciem
  • List aktywnych i nieaktywnych nauczycieli za wybrany okres do pobrania z karty Przegląd (szkoły i klasy)

MCP i API sprawdzają się najlepiej, gdy gotowe karty nie odpowiadają dokładnie na pytanie potrzebne do prezentacji lub rozmowy o odnowieniu umowy.

Ograniczenia:

  • Limit liczby żądań: 60 żądań na godzinę dla jednego klucza API i organizacji, wliczając ponowne sprawdzenia po odpowiedzi 202
  • Zakres dat: maksymalnie 24 miesiące w jednym żądaniu
  • Bezpieczeństwo treści: tylko szkoły i klasy. W przypadku zespołów te wskaźniki zwrócą błąd 400
  • Liczba członków: odzwierciedla aktualny skład, a nie historyczny stan członkostwa w danym okresie
  • Oczekujące ≠ zero: wskaźnik, którego obliczanie wciąż trwa, nie pojawi się w odpowiedzi; nie traktuj go jako zera
  • Typ organizacji: na razie tylko wksp_

Najczęściej zadawane pytania

Dlaczego podczas próby pobrania danych analitycznych pojawia się błąd 404?

Wszystkie odmowy wyglądają tak samo: nieznana organizacja i brak dostępu zwracają kod 404. Sprawdź, czy logujesz się jako administrator tej organizacji (lub nauczyciel w Classroom) oraz czy jej identyfikator zaczyna się od wksp_. Nadal masz problem? Skontaktuj się z pomocą techniczną.

Czy muszę pisać kod?

Nie. Połącz Padlet MCP, zaloguj się jako administrator i zadawaj pytania prostym językiem. Korzystanie z API jest opcjonalne i przeznaczone dla programistów oraz zaawansowanych użytkowników, którzy już korzystają z Public API.

Czy to to samo co Public API?

Te rozwiązania są powiązane, ale nie są tym samym. Public API jest przeznaczone dla programistów korzystających z klucza API. Padlet MCP jest przeznaczone dla asystentów AI, którym udzielasz dostępu po zalogowaniu. Oba rozwiązania umożliwiają pobieranie danych analitycznych organizacji, więc możesz korzystać z jednego lub obu.

Czy uczniowie lub osoby niebędące administratorami mogą w ten sposób zobaczyć dane analityczne organizacji?

Nie. Do uzyskania dostępu do danych analitycznych wymagane są uprawnienia administratora organizacji lub nauczyciela w Classroom. Asystent ma dokładnie taki sam dostęp jak konto, na które się logujesz — nic więcej.

Klient MCP nie rozpoznaje analityki. Co mogę zrobić?

Niektóre klienty aktualizują listę narzędzi z opóźnieniem. Spróbuj ponownie połączyć Padlet MCP, przełączyć się na innego klienta zgodnego z MCP lub bezpośrednio skorzystać z API analityki organizacji. Jeśli problem nadal występuje, skontaktuj się z nami.

Powiązane artykuły

Bu makale faydalı oldu mu?

İlgili makaleler