Kako zaprosim Padlet MCP za Admin Analytics (Beta)?

Carla Sesen profiilikuvaPäivitetty pred 13 urami käyttäjän Carla Sese toimesta

Potrebujete podatke, ki jih nadzorna plošča šole ali ekipe ne razčlenjuje tako, kot bi želeli? Povežite Padlet MCP z umetno inteligenco in v preprostem jeziku zaprosite za analitiko šole, razreda ali ekipe – ali pa sami pokličite API za analitiko organizacije.

Celoten referenčni priročnik za REST (katalog kazalnikov, oblike zahtevkov in kode napak) najdete v članku »Preberite analitiko organizacije« na docs.padlet.dev.

Za koga je ta članek namenjen

Ta članek je namenjen:

  • Lastnike in skrbnike računov Padlet za šole ali ekipe
  • Lastnike in učitelje na računih Classroom

Za uporabo poti MCP ni potrebno pisati kode. Pot API je neobvezna za napredne uporabnike, ki že delajo z javnim API-jem.

Kaj že imate

Na strani »Analitika« v nastavitvah vaše organizacije so že prikazani izbrani zavihki za trenutno obračunsko obdobje. Šole in učilnice imajo na voljo zavihke »Pregled«, »Uporaba«, »Vpliv«, »Varnost«, »Najbolj aktivni uporabniki« in »Vsi uporabniki«. Ekipe imajo na voljo zavihke »Splošno«, »Padleti« in »Uporabniki«.

Uporabite nadzorno ploščo, kadar želite hiter vizualni pregled. Uporabite MCP ali API, kadar potrebujete prilagojene podatke, na katere zavihki ne odgovarjajo dovolj jasno.

Kaj dodajata MCP in API

Nadzorna plošča je sestavljena iz izbranih zavihkov. MCP in API vam omogočata, da zahtevate točno tisto informacijo, ki jo potrebujete:

  • Vprašanja v preprostem jeziku v vašem AI odjemalcu („kateri učitelji so bili v zadnjem obračunskem obdobju neaktivni?“)
  • Po meri sestavljene kombinacije kazalnikov angažiranosti, članstva in varnosti vsebin
  • Mesečne serije v določenem časovnem obdobju
  • Segmenti po vlogah (učitelji proti učencem, ustvarjalci proti sodelavcem)
  • Najboljši padleti, najboljši uporabniki in najboljši mediji, razvrščeni po vaših merilih
  • Odgovori, ki jih lahko vstavite v poročilo o četrtletnem pregledu (QBR) ali predstavitev za podaljšanje naročnine
Kazalniki varnosti vsebin (pregledani elementi, označeni elementi, stopnja odkrivanja) so na voljo le za šole in učilnice. Če jih zahtevate v organizaciji Team, se prikaže napaka, ne pa vrednost nič.

Hiter začetek z Padlet MCP

  1. Povežite Padlet MCP v svojem AI odjemalcu. Uporabite URL strežnika https://mcp.padlet.com. Celotni postopek nastavitve je opisan v Padlet MCP Server.
  2. Prijavite se in se avtorizirajte kot skrbnik organizacije, o kateri želite pridobiti podatke. V učilnici lahko analitiko pridobi tudi učitelj.
  3. Vprašajte v preprostem jeziku. Ni vam treba navajati imen notranjih orodij. Povejte AI pomočniku, kaj želite vedeti o svoji šoli, učilnici ali ekipi, in ta bo v vašem imenu uporabil Padlet MCP.

Tukaj je primer:

Če določena aplikacija MCP še ne prikazuje odgovorov na analitična vprašanja, poskusite z drugo aplikacijo, združljivo z MCP, ali pa namesto tega uporabite API za analitiko organizacije. Podpora aplikacij lahko zaostaja za strežnikom.
Vaš pomočnik deluje v vašem imenu. Pridobiva lahko le analitične podatke, ki jih lahko vidi vaš prijavljeni račun.

Neobvezno: API za analitiko organizacije

Raje bi ga sami programirali? Uporabite javni API z upraviteljskim API-ključem (ali učiteljevim ključem v Classroomu).

  1. Ustvarite ali kopirajte API-ključ na strani za razvijalce v nastavitvah. Podrobnosti najdete v članku o javnem API-ju.
  2. ID vaše organizacije poiščite s GET /me?include=organizations. Potrebujete wksp_ ID — org_ organizacije na padlet.org za to končno točko še niso podprte.
  3. Pošljite POST na /organizations/{org_id}/analytics z želenimi metrikami.
  4. Če je odgovor 202 ali meta.pending ni prazen, počakajte na Retry-After in ponovno pošljite enako zahtevo. Analitika se izračunava asinhrono – metrika v obdelavi pomeni, da ni na voljo, ne pa da je enaka nič. Nikoli ne obravnavajte stanja »v obdelavi« kot nič.
Celotne oblike zahtevkov, katalog kazalnikov in praktični primeri so na voljo v razdelku Analitika organizacije.

Pilotni dostop

Analitika organizacije prek MCP in API je v pilotni fazi na voljo le ob prijavi. Padlet vpiše lastnika organizacije — samo vloga skrbnika ni dovolj. Dokler vaša organizacija ni vpisana, vsak klic odgovori 404 (enak odgovor kot pri neznani organizaciji).

Trenutno so podprte le wksp_ organizacije.

Obrnite se na podporo in jih prosite, naj vpišejo lastnika vaše organizacije za analitiko za administratorje.

Primeri navodil

To so začetni primeri, ki jih lahko prilepite v svoj MCP-odjemalec. Besedilo prilagodite svoji šoli, razredu ali ekipi – številke pa preverite na strani »Analitika«, ko pripravljate predstavitev za stranke.

  • »Koliko aktivnih učiteljev v primerjavi s številom licenc je v tem obračunskem obdobju v naši šoli in v katerih mesecih je število upadlo?«
  • »Kateri padleti organizacije imajo največ ogledov? Prikaži mi 3 najbolj priljubljene table/peskovnike.«
  • »Kateri člani z vlogo učitelja niso uporabljali Padleta v zadnjih 12 mesecih?«
  • »Koliko članov nima e-poštne domene <ouremaildomain.edu>?«
Zahtevajte podatke, ki jih potrebujete: mesečne serije, filter po vlogah, najbolj priljubljene Padlete po objavah ali obiskovalcih ali skupne vrednosti varnosti vsebin za šolo ali razred. Pomočnik bo vaše vprašanje uskladil z razpoložljivimi kazalniki.

V čem je nadzorna plošča še vedno boljša

Ostanite na strani »Analitika« v nastavitvah, kadar želite:

  • vizualni pas z pregledom, opombe o najboljših priložnostih in zahtevo za strokovno izpopolnjevanje z enim klikom
  • Tabela Vsi uporabniki / Uporabniki z iskanjem, filtri po vlogah in prenosom v CSV z enim klikom
  • Seznami aktivnih in neaktivnih učiteljev za izbrano obdobje, ki jih lahko prenesete iz zavihka »Pregled« (šole in učilnice)
  • Pogled, ki ne zahteva vključitve v pilotni program – stran »Nastavitve« je na voljo upravičenim vlogam brez vključitve v API

MCP in API se izkažeta, ko izbrani zavihki ne odgovorijo natančno na vprašanje, ki ga potrebujete za predstavitev ali pogovor o podaljšanju naročnine.

Omejitve:

  • Omejitev števila zahtevkov: 60 zahtevkov na uro na API-ključ in organizacijo, vključno z anketami po 202
  • Časovno obdobje: največ 24 mesecev v enem zahtevku
  • Varnost vsebine: samo šola in učilnica — ekipe dobijo 400 za te kazalnike
  • Število članov: odraža trenutni seznam, ne pa zgodovinskega posnetka tega, kdo je bil v tistem trenutku član
  • V obdelavi ≠ nič: v odgovoru manjka kazalnik, ki se še izračunava; ga ne obravnavajte kot nič
  • Vrsta organizacije: wksp_ zaenkrat le

Pogosta vprašanja

Zakaj dobim napako 404, ko zahtevam analitiko?

Medtem ko je končna točka v pilotni fazi, so vsi zavrnjeni zahtevki enaki: »ni registriran«, »neznana organizacija« ali »brez dostopa« 404. Preverite, ali ste se prijavili kot skrbnik (ali učitelj v Classroomu), ali je vaša organizacija wksp_ organizacija ter da je Padlet registriral lastnika organizacije. Obrnite se na podporo uporabnikom in zaprosite za registracijo.

Ali moram pisati kodo?

Ne. Povežite se s Padlet MCP, prijavite se kot skrbnik in zahtevajte v preprostem jeziku. Pot do API-ja je neobvezna za razvijalce in napredne uporabnike, ki že uporabljajo javni API.

Ali je to isto kot javni API?

Je povezano, vendar ne gre za isti uporabniški vmesnik. Javni API je namenjen razvijalcem, ki uporabljajo API-ključ. Padlet MCP je namenjen AI-pomočnikom, ki jih pooblastite s prijavo. Oba lahko dostopata do analitike organizacije, ko je vaša organizacija vpisana; lahko uporabite enega ali oba.

Ali lahko na ta način analitiko organizacije vidijo tudi učenci ali uporabniki, ki niso skrbniki?

Ne. Za dostop do analitike je potreben skrbnik organizacije ali učitelj v Classroomu. Pomočnik ima natanko enak dostop kot račun, s katerim ste se prijavili – nič več.

Zdi se, da moj MCP-odjemalec ne pozna analitike. Kaj naj poskusim?

Nekateri odjemalci posodabljajo svoj seznam orodij z zamikom. Poskusite ponovno povezati Padlet MCP, preklopiti na drugega odjemalca, združljivega z MCP, ali neposredno uporabiti API za analitiko organizacije. Če ste po registraciji še vedno blokirani, se obrnite na nas.

Povezano

Oliko tästä artikkelista apua?

Aiheeseen liittyvät artikkelit

Dostop do strani za diagnostiko

Odpravite težave s Padletom z uporabo diagnostičnih orodij na spletu ali mobilnem telefonu, nato pa se po potrebi obrnite na podporo uporabnikom z rezultati.

Kako ponastavim svoj Apple ID?

Ponastavite svoj Apple ID za Padlet tako, da ga odstranite iz nastavitev Apple ID in se ponovno prijavite.

Vodnik za učitelje: Nasveti za zaključek šolskega leta

Pripravite svoj račun Padlet za naslednje šolsko leto z izvozom, urejanjem in čiščenjem padletov in članov.

Želim delati v podjetju Padlet. Kje naj oddam prijavo?

Raziščite možnosti za kariero v podjetju Padlet in se prijavite na razpoložljiva delovna mesta na padlet.jobs.