Ako požiadať Padlet MCP o analytiku správcu (beta)?

Neposkytuje vám číselné údaje na paneli správcu školy alebo Tímu v takom členení, aké potrebujete? Pripojte Padlet MCP k asistentovi s umelou inteligenciou a požiadajte ho o analytické údaje o škole, triede alebo Tíme v bežnom jazyku — alebo sami zavolajte rozhranie API na analytické údaje o organizácii.

Pre koho je tento článok 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 Classroom

Na používanie MCP nemusíte písať kód. Použitie rozhrania API je voliteľné pre pokročilých používateľov, ktorí už pracujú s verejným rozhraním API.

Čo už máte k dispozícii

Stránka Analytika vašej organizácie v Nastaveniach už zobrazuje pripravené karty s údajmi za aktuálne fakturačné obdobie. Školy a triedy majú karty Prehľad, Používanie, Vplyv, Bezpečnosť, Najaktívnejší používatelia a Všetci používatelia. Tímy majú karty Všeobecné, Padlety a Používatelia, prípadne Prehľad, Používanie, Vplyv, Najaktívnejší používatelia a Všetci používatelia, ak má váš Tím novú stránku Analytika (beta).

• Analytika školského účtu (Padlet for Schools a Classroom)
• Analytika účtu Tímu

Ak chcete rýchly vizuálny prehľad, použite panel. Ak potrebujete vlastné členenie, ktoré karty neposkytujú, použite MCP alebo rozhranie API.

Čo prináša MCP a rozhranie API

Panel ponúka pripravené karty. Pomocou MCP a rozhrania API si môžete vyžiadať presne tie údaje, ktoré potrebujete:

• Otázky v bežnom jazyku v AI klientovi („Ktorí učitelia boli počas minulého fakturačného obdobia neaktívni?“)
• Vlastné kombinácie metrík zapojenia, členstva a bezpečnosti obsahu
• Mesačné časové rady za vybraté obdobie
• Členenie podľa rolí (učitelia a študenti, tvorcovia a prispievatelia)
• Najobľúbenejš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 zmluvy

Začíname s Padlet MCP

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

Tu je príklad:

Voliteľné: rozhranie API na analytické údaje o organizácii

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

1. Vytvorte alebo skopírujte kľúč API na stránke Vývojár v Nastaveniach. Podrobnosti nájdete v článku Verejné rozhranie API.
2. Zistite ID svojej organizácie pomocou príkazu GET /me?include=organizations. Potrebujete ID s prefixom wksp_ — organizácie org_ na padlet.org toto rozhranie zatiaľ 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 identickú požiadavku znova. Analytické údaje sa počítajú asynchrónne — čakajúca metrika v odpovedi chýba, neznamená nulu. Čakajúcu metriku nikdy nepovažujte za nulu.

Prístup v rámci pilotného programu

Príklady otázok

Tu je niekoľko úvodných otázok, ktoré môžete vložiť do svojho MCP klienta. Upravte ich podľa svojej školy, triedy alebo Tímu — a pri príprave prezentácie pre zákazníkov overte čísla na stránke Analytika.

• „Koľko aktívnych učiteľov máme v škole počas tohto fakturačného obdobia v porovnaní s počtom licencií a v ktorých mesiacoch došlo k poklesu?“
• „Ktoré padlety v našej organizácii majú najviac zobrazení? Uveď tri najlepšie nástenky/sandbox.“
• „Ktorí členovia s rolou učiteľa nepoužili Padlet za posledných 12 mesiacov?“
• „Koľko členov nemá e-mailovú doménu <ouremaildomain.edu>?“

V čom je panel stále lepší

Ak potrebujete, použite stránku Analytika v Nastaveniach:

• Vizuálny banner Prehľad, výzvy na využitie najväčších príležitostí a možnosť odoslať žiadosť o profesionálny rozvoj jedným kliknutím
• Tabuľku Všetci používatelia/Používatelia s vyhľadávaním, filtrami podľa rolí a sťahovaním súboru CSV jedným kliknutím
• Stiahnuteľné zoznamy aktívnych a neaktívnych učiteľov za vybraté obdobie na karte Prehľad (školy a triedy)
• Zobrazenie, ktoré nevyžaduje zaradenie do pilotného programu — samotná stránka Nastavenia je dostupná používateľom s oprávnenými rolami aj bez prihlásenia na používanie rozhrania API

MCP a rozhranie API sa hodia, keď pripravené karty neodpovedajú na konkrétnu otázku, ktorú potrebujete vyriešiť pri ukážke alebo rokovaní o obnovení zmluvy.

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 požiadavke na tieto metriky pre Tímy sa zobrazí chyba 400
• Počty členov: vyjadrujú aktuálny zoznam členov, nie historický stav členstva v danom čase
• Čakajúce ≠ nula: metrika, ktorá sa ešte počíta, v odpovedi chýba; nepovažujte ju za nulu
• Typ organizácie: zatiaľ iba wksp_

Časté otázky

Súvisiace články

• Server Padlet MCP
• Analytika školského účtu
• Analytika účtu Tímu
• Verejné rozhranie API
• Čítanie analytických údajov o organizácii (dokumentácia pre vývojárov)