Jak poprosić Padlet MCP o analitykę administratora (beta)?

Carla Sese의 프로필 사진Carla Sese님이 13 godzin temu에 업데이트함

Potrzebujesz danych, których panel administracyjny szkoły lub zespołu nie przedstawia w pożądany sposób? Połącz Padlet MCP z asystentem AI i poproś o analizy dotyczące szkoły, klasy lub zespołu, używając prostego języka — lub samodzielnie wywołaj API analiz organizacyjnych.

Pełna dokumentacja REST (katalog wskaźników, formaty żądań i kody błędów) znajduje się w sekcji „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 korzystających z kont Classroom

Aby korzystać ze ścieżki MCP, nie trzeba pisać kodu. Ścieżka API jest opcjonalna dla zaawansowanych użytkowników, którzy już korzystają z publicznego API.

Co już masz

Strona „Analizy” Twojej organizacji w sekcji „Ustawienia” zawiera już wyselekcjonowane zakładki dotyczące bieżącego okresu rozliczeniowego. Szkoły i klasy mają dostęp do zakładek: „Przegląd”, „Wykorzystanie”, „Wpływ”, „Bezpieczeństwo”, „Najaktywniejsi użytkownicy” oraz „Wszyscy użytkownicy”. Zespoły mają dostęp do zakładek: „Ogólne”, „Padlety” i „Użytkownicy”.

Skorzystaj z pulpitu nawigacyjnego, gdy potrzebujesz szybkiego, wizualnego podsumowania. Skorzystaj z MCP lub API, gdy potrzebujesz niestandardowego zestawienia, na które zakładki nie dają jednoznacznej odpowiedzi.

Co oferuje MCP / API

Pulpit nawigacyjny składa się z wyselekcjonowanych zakładek. MCP i API pozwalają uzyskać dokładnie te dane, których potrzebujesz:

  • Pytania sformułowane prostym językiem w kliencie AI („którzy nauczyciele byli nieaktywni w ostatnim okresie rozliczeniowym?”)
  • Niestandardowe kombinacje wskaźników zaangażowania, członkostwa i bezpieczeństwa treści
  • Miesięczne serie w wybranym przedziale czasowym
  • Wycinki według ról (nauczyciele vs uczniowie, twórcy vs współpracownicy)
  • Najpopularniejsze padlety, najaktywniejsi użytkownicy i najpopularniejsze multimedia uszeregowane zgodnie z Twoim zapytaniem
  • Odpowiedzi, które można wkleić do raportu QBR lub prezentacji dotyczącej przedłużenia umowy
Wskaźniki bezpieczeństwa treści (przeskanowane elementy, zgłoszone elementy, wskaźnik wykrywalności) są dostępne wyłącznie dla szkół i klas. Żądanie tych danych w organizacji typu „Team” zwraca błąd, a nie wartość zerową.

Szybki start z Padlet MCP

  1. Połącz Padlet MCP ze swoim klientem AI. Użyj adresu URL serwera https://mcp.padlet.com. Pełna instrukcja konfiguracji znajduje się w sekcji „Padlet MCP Server”.
  2. Zaloguj się i autoryzuj się jako administrator organizacji, o którą chcesz zapytać. W klasie nauczyciel również może pobrać dane analityczne.
  3. Zadawaj pytania prostym językiem. Nie musisz wymieniać nazw narzędzi wewnętrznych. Powiedz asystentowi AI, co chcesz wiedzieć o swojej szkole, klasie lub zespole, a on skorzysta z Padlet MCP w Twoim imieniu.

Oto przykład:

Jeśli konkretny klient MCP nie wyświetla jeszcze wyników analitycznych, spróbuj użyć innego klienta zgodnego z MCP lub skorzystaj z API analityki organizacji. Obsługa klienta może pozostawać w tyle za serwerem.
Twój asystent działa w Twoim imieniu. Może pobierać wyłącznie dane analityczne, do których dostęp ma Twoje zalogowane konto.

Opcjonalnie: API analityki organizacji

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

  1. Utwórz lub skopiuj klucz API ze strony „Dla programistów” w sekcji „Ustawienia”. Szczegóły znajdziesz w artykule poświęconym publicznemu API.
  2. Znajdź identyfikator swojej organizacji za pomocą GET /me?include=organizations. Potrzebujesz identyfikatora wksp_ identyfikator — org_ organizacje na padlet.org nie są jeszcze obsługiwane przez ten punkt końcowy.
  3. Wyślij POST do /organizations/{org_id}/analytics z żądanymi wskaźnikami.
  4. Jeśli odpowiedź brzmi 202 lub meta.pending nie jest pusta, poczekaj na Retry-After i wyślij ponownie identyczne żądanie. Dane analityczne są obliczane asynchronicznie — wskaźnik w toku oznacza brak danych, a nie wartość zerową. Nigdy nie traktuj wskaźnika w toku jako zera.
Pełne wzorce żądań, katalog wskaźników oraz przykłady z praktyki znajdziesz w sekcji „Analizy organizacji Read”.

Dostęp w ramach programu pilotażowego

Dostęp do analizy organizacji za pośrednictwem MCP i API jest opcjonalny w fazie pilotażowej. Padlet rejestruje właściciela organizacji — samo bycie administratorem nie wystarczy. Dopóki organizacja nie zostanie zarejestrowana, każde wywołanie zwraca 404 (tą samą odpowiedzią, co w przypadku nieznanej organizacji).

Obecnie obsługiwane są wyłącznie wksp_ organizacje.

Skontaktuj się z pomocą techniczną i poproś o zarejestrowanie właściciela Twojej organizacji w celu uzyskania dostępu do analiz administracyjnych.

Przykładowe komunikaty

Oto przykładowe pytania, które możesz wkleić do swojego klienta MCP. Dostosuj sformułowania do swojej szkoły, klasy lub zespołu — i zweryfikuj dane liczbowe na stronie „Analizy” podczas przygotowywania prezentacji dla klientów.

  • „Ile w bieżącym okresie rozliczeniowym w naszej szkole jest aktywnych nauczycieli w porównaniu z liczbą licencji i w których miesiącach odnotowano spadek?”
  • „Które tablice organizacji mają najwięcej wyświetleń? Podaj mi 3 najpopularniejsze tablice/środowiska testowe.”
  • „Którzy członkowie z rolą nauczyciela nie korzystali z Padlet w ciągu ostatnich 12 miesięcy?”
  • „Ilu członków nie ma domeny e-mailowej <ouremaildomain.edu>?”
Poproś o potrzebny ci wycinek danych: serię miesięczną, filtr ról, najpopularniejsze tablice według liczby postów lub odwiedzających albo podsumowanie bezpieczeństwa treści dla szkoły lub klasy. Asystent dopasuje twoje pytanie do dostępnych wskaźników.

W czym pulpit nawigacyjny nadal radzi sobie lepiej

Korzystaj ze strony „Analizy” w ustawieniach, gdy chcesz:

  • Wizualny baner „Przegląd”, wyróżnione najważniejsze możliwości oraz możliwość złożenia wniosku o szkolenie za pomocą jednego kliknięcia
  • Tabela „Wszyscy użytkownicy / Użytkownicy” z funkcją wyszukiwania, filtrami ról i możliwością pobrania pliku CSV jednym kliknięciem
  • Listy aktywnych i nieaktywnych nauczycieli do pobrania za wybrany okres, dostępne w zakładce „Przegląd” (szkoły i klasy)
  • Widok, który nie wymaga rejestracji w programie pilotażowym — sama strona „Ustawienia” jest dostępna dla uprawnionych ról bez konieczności wyrażania zgody na korzystanie z API

MCP i API sprawdzają się najlepiej, gdy wyselekcjonowane zakładki nie odpowiadają dokładnie na pytanie, którego potrzebujesz podczas rozmowy dotyczącej prezentacji lub przedłużenia umowy.

Ograniczenia:

  • Limit żądań: 60 żądań na godzinę na klucz API i organizację, w tym sondaże po upływie 202
  • Zakres dat: maksymalnie 24 miesiące w jednym żądaniu
  • Bezpieczeństwo treści: wyłącznie szkoły i klasy — zespoły otrzymują 400 dla tych wskaźników
  • Liczba członków: odzwierciedla aktualny skład, a nie historyczny obraz tego, kto należał do zespołu w danym momencie
  • „Oczekujące” ≠ zero: w odpowiedzi brakuje wskaźnika, który jest nadal obliczany; nie należy traktować go jako zera
  • Typ organizacji: wksp_ tylko na razie

Często zadawane pytania

Dlaczego otrzymuję błąd 404, gdy wysyłam zapytanie o dane analityczne?

Ponieważ punkt końcowy znajduje się w fazie pilotażowej, każdy komunikat o odmowie wygląda tak samo: brak rejestracji, nieznana organizacja lub brak dostępu – wszystkie zwracają ten sam kod 404. Upewnij się, że zalogowałeś się jako administrator (lub nauczyciel w Classroom), że Twoja organizacja jest wksp_ organizacją oraz czy Padlet zarejestrował właściciela organizacji. Skontaktuj się z pomocą techniczną, aby poprosić o rejestrację.

Czy muszę pisać kod?

Nie. Podłącz Padlet MCP, zaloguj się jako administrator i złóż prośbę prostym językiem. Ścieżka API jest opcjonalna dla programistów i zaawansowanych użytkowników, którzy już korzystają z publicznego API.

Czy to to samo, co publiczne API?

Są powiązane, ale nie stanowią tego samego produktu. Publiczne API jest przeznaczone dla programistów korzystających z klucza API. Padlet MCP jest przeznaczony dla asystentów AI, których autoryzujesz poprzez zalogowanie się. Oba mają dostęp do statystyk organizacji po jej zarejestrowaniu; możesz korzystać z jednego lub z obu.

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

Nie. Dostęp do statystyk wymaga uprawnień administratora organizacji lub nauczyciela w Classroom. Asystent ma dokładnie taki sam dostęp jak konto, na które się zalogowałeś — nic więcej.

Wydaje się, że mój klient MCP nie obsługuje statystyk. Co powinienem zrobić?

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

Powiązane

이 문서가 도움이 되었나요?

관련 문서