Ako požiadam Padlet MCP o analytiku správcu?

Carla Sese 的個人檔案照片由 Carla Sese 於 pred 4 dňami 更新

Chýbajú vám v Admin Dashboarde školy alebo tímu čísla rozčlenené tak, ako potrebujete? Prepojte Padlet MCP s asistentom AI a požiadajte ho bežným jazykom o analytické údaje školy, triedy alebo tímu, prípadne sami zavolajte rozhranie API na analytické údaje organizácie.

Úplnú referenčnú dokumentáciu REST (katalóg metrík, štruktúry požiadaviek a kódy chýb) nájdete v časti Čítanie analytických údajov organizácie na docs.padlet.dev.

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ímových účtov
  • Vlastníkov a učiteľov účtov Triedy

Na používanie MCP nemusíte písať kód. Rozhranie 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 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 alebo Prehľad, Používanie, Vplyv, Najaktívnejší používatelia a Všetci používatelia, ak má váš tím novú stránku Analytika (beta).

Ak chcete rýchly vizuálny prehľad, použite tabuľu. Ak potrebujete vlastné rozčlenenie, na ktoré karty neodpovedajú dostatočne presne, použite MCP alebo rozhranie API.

Čo prináša MCP / rozhranie API

Tabuľa obsahuje pripravené karty. MCP a rozhranie API vám umožňujú vyžiadať si presne také rozčlenenie, aké potrebujete:

  • Otázky v bežnom jazyku v klientovi AI („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 roly (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 na štvrťročné hodnotenie podnikania (QBR) alebo obnovenie
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 typu Tím, zobrazí sa chyba, nie nula.

Rýchly začiatok s Padlet MCP

  1. Pripojte Padlet MCP vo svojom klientovi AI. 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 oprávnenie ako správca organizácie, ktorej údaje chcete vyhľadávať. V Triede môže analytické údaje získavať aj učiteľ.
  3. Pýtajte sa bežným jazykom. Nemusíte uvádzať názvy interných nástrojov. Povedzte asistentovi AI, čo chcete vedieť 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 odpovede na analytické otázky, skúste iného klienta kompatibilného s MCP alebo použite rozhranie API na analytické údaje organizácie. Podpora klientov môže zaostávať za serverom.
Asistent koná vo vašom mene. Môže získavať iba analytické údaje, ktoré má vaše prihlásené konto oprávnenie zobrazovať.

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

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

  1. Vytvorte alebo skopírujte kľúč API na stránke Developer v Nastaveniach. Podrobnosti nájdete v článku Verejné rozhranie API.
  2. Zistite ID organizácie pomocou GET /me?include=organizations. Potrebujete ID wksp_. Organizácie org_ na padlet.org zatiaľ toto rozhranie 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 na hodnotu Retry-After a odošlite totožnú požiadavku znova. Analytické údaje sa vypočítavajú na pozadí, takže čakajúca metrika v odpovedi chýba. Nikdy ju nepovažujte za nulu.
Úplné štruktúry požiadaviek, katalóg metrík a praktické príklady nájdete v časti Čítanie analytických údajov organizácie.

Kto to môže používať

Analytické údaje organizácie cez Padlet MCP a rozhranie API sú k dispozícii vlastníkom a správcom účtov Padlet for Schools a tímových účtov, ako aj vlastníkom a učiteľom účtov Triedy. Nemusíte žiadať Padlet, aby túto funkciu zapol.

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

Príklady výziev

Tieto príklady môžete skopírovať do klienta MCP. Upravte znenie podľa svojej školy, triedy alebo tímu a pred prípravou prezentácie pre zákazníkov porovnajte čísla so stránkou Analytika.

  • „Koľko aktívnych učiteľov máme v škole v tomto fakturačnom období v porovnaní s počtom licencií a v ktorých mesiacoch došlo k poklesu?“
  • „Ktoré padlety v 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>?“
Požiadajte o potrebné rozčlenenie: mesačný časový rad, filter podľa roly, najobľúbenejšie padlety podľa počtu príspevkov alebo návštevníkov či súhrnné údaje o bezpečnosti obsahu pre školu alebo triedu. Asistent priradí vašu otázku k dostupným metrikám.

V čom je tabuľa stále lepšia

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

  • Vizuálny banner Prehľad, upozornenia na najlepšie príležitosti a možnosť požiadať o profesionálny rozvoj jedným kliknutím
  • Tabuľku Všetci používatelia / Používatelia s vyhľadávaním, filtrami podľa roly a stiahnutím súboru CSV jedným kliknutím
  • Zoznamy aktívnych a neaktívnych učiteľov za vybrané obdobie na stiahnutie, dostupné na karte Prehľad (školy a triedy)

MCP a rozhranie API sa hodia vtedy, keď pripravené karty neposkytujú presnú odpoveď, ktorú potrebujete na ukážku alebo rokovanie o obnovení.

Obmedzenia:

  • Limit požiadaviek: 60 požiadaviek za hodinu na jeden kľúč API a organizáciu vrátane opakovaných kontrol po odpovedi 202
  • Dátumové obdobie: najviac 24 mesiacov v jednej požiadavke
  • Bezpečnosť obsahu: iba pre školy a triedy. Pre tieto metriky sa tímom vráti chyba 400
  • Počty členov: odrážajú aktuálny zoznam členov, nie historický prehľad členstva v danom čase
  • Čakajúca metrika ≠ 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

Prečo sa mi pri žiadosti o analytické údaje zobrazuje chyba 404?

Všetky odmietnutia vyzerajú rovnako: pri neznámej organizácii aj pri chýbajúcom prístupe sa vracia chyba 404. Skontrolujte, či ste sa prihlásili ako správca (alebo učiteľ v Triede) danej organizácie a či má ID wksp_. Stále si neviete rady? Kontaktujte 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. Rozhranie API je voliteľné pre vývojárov a pokročilých používateľov, ktorí už používajú verejné rozhranie API.

Je to to isté ako verejné rozhranie API?

Súvisí s ním, ale nejde o to isté rozhranie produktu. Verejné rozhranie API je určené vývojárom, ktorí používajú kľúč API. Padlet MCP je určený asistentom AI, ktorým udelíte oprávnenie po prihlásení. Obe umožňujú prístup k analytickým údajom organizácie a môžete používať jedno z nich alebo obe.

Môžu si takto zobraziť analytické údaje organizácie študenti alebo používatelia bez práv správcu?

Nie. Na prístup k analytickým údajom je potrebné byť správcom organizácie alebo učiteľom v Triede. Asistent má presne rovnaké oprávnenia ako konto, ktorým ste sa prihlásili, a nič navyše.

Zdá sa, že môj klient MCP o analytike nevie. Čo mám skúsiť?

Niektorí klienti aktualizujú zoznam nástrojov s oneskorením. Skúste znova pripojiť Padlet MCP, prejsť na iného klienta kompatibilného s MCP alebo použiť priamo rozhranie API na analytické údaje organizácie. Ak si stále neviete rady, ozvite sa nám.

Súvisiace články

這篇文章有幫助嗎?

相關文章