Ako môžem požiadať Padlet MCP o funkciu Admin Analytics (Beta)?

Carla Sese profilképeFrissítve pred 13 hodinami – Carla Sese által

Potrebujete čísla, ktoré vám informačný panel správcu školy alebo Tímu nerozčlení požadovaným spôsobom? Pripojte Padlet MCP k asistentovi s umelou inteligenciou a požiadajte ho bežným jazykom o analytické údaje o škole, triede alebo Tíme – alebo sami zavolajte API na analytiku organizácie.

Úplnú referenčnú príručku REST (katalóg metrík, formáty požiadaviek a chybové kódy) nájdete v dokumente Čítanie analytických údajov organizácie na docs.padlet.dev.

Pre koho je to určené

Tento článok je určený pre:

  • Vlastníkov a správcov účtov Padlet for Schools alebo Tím
  • Vlastníkov a učiteľov účtov Trieda

Na použitie MCP nemusíte písať kód. Možnosť API je určená pre pokročilých používateľov, ktorí už pracujú s verejným API.

Čo už máte k dispozícii

Stránka Analytika vašej organizácie v Nastaveniach už zobrazuje prehľadné karty za aktuálne fakturačné obdobie. Školy a triedy majú karty Prehľad, Používanie, Dopad, Bezpečnosť, Najpoužívanejší používatelia a Všetci používatelia. Tímy majú karty Všeobecné, Padlety a Používatelia.

Ak chcete rýchly vizuálny prehľad, použite informačný panel. Ak potrebujete vlastný rozpis, na ktorý karty neposkytujú jasnú odpoveď, použite MCP alebo API.

Čo prinášajú MCP a API

Informačný panel obsahuje prehľadné karty. Pomocou MCP a API si môžete vyžiadať presne taký rozpis, aký potrebujete:

  • Otázky v bežnom jazyku v klientovi s umelou inteligenciou („Ktorí učitelia boli v minulom fakturačnom období neaktívni?“)
  • Vlastné kombinácie metrík zapojenia, členstva a bezpečnosti obsahu
  • Mesačné časové rady za zvolené obdobie
  • Rozdelenie podľa rolí (učitelia verzus študenti, tvorcovia verzus prispievatelia)
  • Najpoužívanejšie padlety, používatelia a médiá zoradené podľa vašich požiadaviek
  • Odpovede, ktoré môžete vložiť do prezentácie QBR alebo prezentácie k obnoveniu predplatného
Metriky bezpečnosti obsahu (naskenované položky, označené položky, miera zachytenia) sú k dispozícii iba pre školy a triedy. Ak o ne požiadate v organizácii Tímu, zobrazí sa chyba, nie nula.

Rýchly začiatok s Padlet MCP

  1. Pripojte Padlet MCP vo svojom klientovi s umelou inteligenciou. Použite URL servera https://mcp.padlet.com. Úplný postup nastavenia nájdete v článku Server Padlet MCP.
  2. Prihláste sa a udeľte povolenie ako správca organizácie, ktorej údaje chcete vyhľadávať. V Triede môže analytiku získať aj učiteľ.
  3. Pýtajte sa bežným jazykom. Nemusíte uvádzať názvy interných nástrojov. Povedzte asistentovi s umelou inteligenciou, čo chcete zistiť o svojej škole, triede alebo Tíme, a on vo vašom mene použije Padlet MCP.

Tu je príklad:

Ak konkrétny klient MCP zatiaľ nezobrazuje analytické odpovede, skúste iného klienta kompatibilného s MCP alebo použite API na analytiku organizácie. Podpora klientov môže zaostávať za podporou servera.
Asistent koná vo vašom mene. Môže získať iba analytické údaje, ktoré smie vidieť váš prihlásený účet.

Voliteľné: API na analytiku organizácie

Chcete si vytvoriť vlastný skript? Použite verejné API s kľúčom API pre správcu (alebo s kľúčom učiteľa v Triede).

  1. Vytvorte alebo skopírujte kľúč API na stránke Vývojár v Nastaveniach. Podrobnosti nájdete v článku Verejné API.
  2. ID organizácie zistíte pomocou GET /me?include=organizations. Potrebujete ID wksp_ – organizácie org_ na padlet.org zatiaľ tento koncový bod nepodporuje.
  3. Odošlite požiadavku POST na adresu /organizations/{org_id}/analytics s požadovanými metrikami.
  4. Ak je odpoveď 202 alebo pole meta.pending nie je prázdne, počkajte podľa hlavičky Retry-After a odošlite znova tú istú požiadavku. Analytické údaje sa počítajú asynchrónne – čakajúca metrika v odpovedi chýba, neznamená nulu. Čakajúcu metriku nikdy nepovažujte za nulu.
Úplné formáty požiadaviek, katalóg metrík a praktické príklady nájdete v dokumente Čítanie analytických údajov organizácie.

Prístup počas pilotného programu

Analytika organizácie cez MCP a API je počas pilotného programu dostupná na základe dobrovoľného prihlásenia. Organizáciu do programu zaraďuje vlastník organizácie – samotné oprávnenie správcu nestačí. Kým vaša organizácia nebude zaradená, každé volanie vráti 404 (rovnakú odpoveď ako pri neznámej organizácii).

Zatiaľ sú podporované iba organizácie wksp_.

Kontaktujte podporu a požiadajte o zaradenie vlastníka vašej organizácie na používanie analytiky pre správcov.

Príklady otázok

Tieto úvodné otázky môžete vložiť do svojho klienta MCP. Upravte ich podľa svojej školy, triedy alebo Tímu a pri príprave prezentácie určenej zákazníkom si čísla overte na stránke Analytika.

  • „Koľko aktívnych učiteľov a licencií mala naša škola v tomto fakturačnom období a v ktorých mesiacoch došlo k poklesu?“
  • „Ktoré padlety v našej organizácii majú najviac zobrazení? Uveďte 3 najlepšie tabule/sandboxy.“
  • „Ktorí členovia s rolou učiteľa nepoužívali Padlet za posledných 12 mesiacov?“
  • „Koľko členov nemá e-mailovú doménu <ouremaildomain.edu>?“
Požiadajte o potrebný rozpis: mesačný časový rad, filter podľa roly, najpoužívanejšie padlety podľa príspevkov alebo návštevníkov či celkové údaje o bezpečnosti obsahu pre školu alebo triedu. Asistent priradí vašu otázku k dostupným metrikám.

V čom je informačný panel stále lepší

Stránku Analytika v Nastaveniach používajte, ak potrebujete:

  • Vizuálny banner Prehľad, odporúčania v časti Najlepšie príležitosti a možnosť požiadať o profesijný rozvoj jedným kliknutím
  • Tabuľku Všetci používatelia/Používatelia s vyhľadávaním, filtrami rolí a stiahnutím súboru CSV jedným kliknutím
  • Zoznamy aktívnych a neaktívnych učiteľov za vybrané obdobie na stiahnutie z karty Prehľad (školy a triedy)
  • Zobrazenie, ktoré nevyžaduje zaradenie do pilotného programu – samotná stránka Nastavenia je dostupná oprávneným rolám bez aktivácie prístupu k API

MCP a API sú užitočné vtedy, keď prehľadné karty neposkytujú presnú odpoveď, ktorú potrebujete na ukážku alebo rozhovor o obnovení predplatného.

Obmedzenia:

  • Limit požiadaviek: 60 požiadaviek za hodinu na jeden kľúč API a organizáciu vrátane opakovaných požiadaviek po odpovedi 202
  • Časové obdobie: v jednej požiadavke možno zadať najviac 24 mesiacov
  • Bezpečnosť obsahu: iba pre školy a triedy – pri vyžiadaní týchto metrík pre Tímy sa vráti chyba 400
  • Počet členov: odráža aktuálny zoznam členov, nie historický stav členstva v danom čase
  • Čakajúce ≠ nula: metrika, ktorej výpočet ešte prebieha, v odpovedi chýba; nepovažujte ju za nulu
  • Typ organizácie: zatiaľ iba wksp_

Časté otázky

Prečo sa mi pri žiadosti o analytiku zobrazuje chyba 404?

Počas pilotného programu sa všetky zamietnuté požiadavky zobrazujú rovnako: nezaradená organizácia, neznáma organizácia alebo nedostatočný prístup – vo všetkých prípadoch sa vráti 404. Overte, že ste sa prihlásili ako správca (alebo učiteľ v Triede), vaša organizácia má ID wksp_ a Padlet zaradil vlastníka organizácie. Požiadajte o zaradenie cez podporu.

Musím písať kód?

Nie. Pripojte Padlet MCP, prihláste sa ako správca a pýtajte sa bežným jazykom. Možnosť API je voliteľná pre vývojárov a pokročilých používateľov, ktorí už používajú verejné API.

Je to to isté ako verejné API?

Súvisia spolu, ale nejde o to isté rozhranie. Verejné API je určené vývojárom, ktorí používajú kľúč API. Padlet MCP je určený asistentom s umelou inteligenciou, ktorým udelíte oprávnenie po prihlásení. Keď je vaša organizácia zaradená, obidve možnosti umožňujú prístup k analytike organizácie; môžete použiť jednu alebo obe.

Môžu týmto spôsobom zobrazovať analytiku organizácie študenti alebo používatelia bez oprávnenia správcu?

Nie. Na prístup k analytike je potrebný správca organizácie alebo učiteľ v Triede. Asistent má presne rovnaký prístup ako účet, ktorým ste sa prihlásili – nič viac.

Môj klient MCP akoby nepoznal analytiku. Čo mám skúsiť?

Niektorým klientom sa zoznam nástrojov aktualizuje s oneskorením. Skúste znova pripojiť Padlet MCP, prejsť na iného klienta kompatibilného s MCP alebo priamo použiť API na analytiku organizácie. Ak vám prístup stále nefunguje ani po zaradení, obráťte sa na nás.

Súvisiace články

Hasznos volt ez a cikk?

Kapcsolódó cikkek

Prístup na stránku diagnostiky

Vyriešte problémy s Padletom pomocou diagnostických nástrojov na webe alebo v mobilnej aplikácii a v prípade potreby kontaktujte podporu s výsledkami.

Ako môžem obnoviť svoje Apple ID?

Obnovte svoje Apple ID pre Padlet tak, že ho odstránite z nastavení Apple ID a znovu sa prihlásite.

Príručka pre učiteľov: Tipy na zakončenie školského roka

Pripravte si svoj účet Padlet na nasledujúci školský rok exportovaním, organizovaním a upratovaním padletov a členov.

Chcem pracovať v spoločnosti Padlet. Kam mám poslať žiadosť?

Objavte kariérne príležitosti v spoločnosti Padlet a uchádzajte sa o voľné pracovné pozície na stránke padlet.jobs.