Kako naj Padlet MCP prosim za skrbniško analitiko (beta)?

Carla Sese’s profile pictureUpdated pred 16 urami by Carla Sese

Številke na skrbniški nadzorni plošči šole ali ekipe niso razčlenjene tako, kot bi želeli? Povežite Padlet MCP s pomočnikom z umetno inteligenco in v preprostem jeziku zaprosite za analitiko šole, učilnice ali ekipe – ali pa sami pokličite API za analitiko organizacije.

Celoten referenčni priročnik REST (katalog meritev, oblike zahtev in kode napak) najdete v dokumentaciji Branje analitike organizacije na docs.padlet.dev.

Komu je to namenjeno

Ta članek je namenjen:

  • Lastnikom in skrbnikom računov Padlet for Schools ali Team
  • Lastnikom in učiteljem računov Classroom

Za uporabo MCP vam ni treba pisati kode. Uporaba API-ja je neobvezna in namenjena naprednim uporabnikom, ki že uporabljajo javni API.

Kaj že imate

Stran Analitika vaše organizacije v nastavitvah že prikazuje izbrane zavihke za trenutno obračunsko obdobje. Šole in učilnice imajo zavihke Pregled, Uporaba, Vpliv, Varnost, Najaktivnejši uporabniki in Vsi uporabniki. Ekipe imajo zavihke Splošno, Padleti in Uporabniki ali pa zavihke Pregled, Uporaba, Vpliv, Najaktivnejši uporabniki in Vsi uporabniki, če ima vaša ekipa novo stran Analitika (beta).

Če želite hiter vizualni pregled, uporabite nadzorno ploščo. Če potrebujete prilagojen prikaz podatkov, na katerega zavihki ne odgovorijo jasno, uporabite MCP ali API.

Prednosti MCP-ja in API-ja

Nadzorna plošča ponuja izbrane zavihke. MCP in API vam omogočata, da zahtevate točno tak prikaz podatkov, kot ga potrebujete:

  • Vprašanja v preprostem jeziku v vašem odjemalcu z umetno inteligenco (»Kateri učitelji v zadnjem obračunskem obdobju niso bili aktivni?«)
  • Poljubne kombinacije meritev angažiranosti, članstva in varnosti vsebine
  • Mesečne časovne vrste za določeno časovno obdobje
  • Razčlenitve po vlogah (učitelji in učenci, ustvarjalci in sodelujoči)
  • Najbolj priljubljeni padleti, uporabniki in mediji, razvrščeni po vaših navodilih
  • Odgovore, ki jih lahko prilepite v predstavitev za četrtletni poslovni pregled ali podaljšanje naročnine
Meritve varnosti vsebine (pregledani elementi, označeni elementi, stopnja zaznavanja) so na voljo samo za šole in učilnice. Če zanje zaprosite v organizaciji Team, boste prejeli napako, ne pa ničelne vrednosti.

Hitri začetek s Padlet MCP

  1. Povežite Padlet MCP v svojem odjemalcu z umetno inteligenco. Uporabite URL strežnika https://mcp.padlet.com. Celotna navodila za nastavitev najdete v članku Strežnik Padlet MCP.
  2. Prijavite se in dovolite dostop kot skrbnik organizacije, za katero želite pridobiti podatke. V okolju Classroom lahko analitiko pridobi tudi učitelj.
  3. Vprašajte v preprostem jeziku. Ni vam treba poimenovati internih orodij. Pomočniku z umetno inteligenco povejte, kaj želite izvedeti o svoji šoli, učilnici ali ekipi, ta pa bo v vašem imenu uporabil Padlet MCP.

Primer:

Če določen odjemalec MCP še ne prikazuje odgovorov o analitiki, poskusite z drugim odjemalcem, združljivim z MCP, ali pa uporabite API za analitiko organizacije. Podpora odjemalcev lahko zaostaja za podporo strežnika.
Pomočnik deluje v vašem imenu. Pridobi lahko samo analitiko, do katere ima dostop vaš prijavljeni račun.

Izbirno: API za analitiko organizacije

Želite raje pripraviti lastne skripte? Uporabite javni API s ključem API-ja skrbnika (ali ključem učitelja v okolju Classroom).

  1. Na strani za razvijalce v nastavitvah ustvarite ali kopirajte ključ API-ja. Podrobnosti najdete v članku Javni API.
  2. ID organizacije poiščite z ukazom GET /me?include=organizations. Potrebujete ID wksp_ – organizacije org_ na spletnem mestu padlet.org za zdaj še niso podprte za to končno točko.
  3. Pošljite zahtevo POST na /organizations/{org_id}/analytics z želenimi meritvami.
  4. Če je odgovor 202 ali polje meta.pending ni prazno, počakajte toliko, kot določa Retry-After, nato pa pošljite enako zahtevo znova. Analitika se izračuna asinhrono – čakajoča meritev v odgovoru ni navedena, ne pa prikazana kot nič. Čakajoče meritve nikoli ne obravnavajte kot ničelne.
Celotne oblike zahtev, katalog meritev in primere najdete v dokumentaciji Branje analitike organizacije.

Dostop v pilotni fazi

Analitika organizacije prek MCP-ja in API-ja je v pilotni fazi na voljo samo po vključitvi. Padlet vključi lastnika organizacije – samo skrbniška vloga ne zadostuje. Dokler vaša organizacija ni vključena, vsak klic vrne odgovor 404 (enak odgovor kot za neznano organizacijo).

Za zdaj so podprte samo organizacije wksp_.

Obrnite se na podporo in jih prosite, naj za skrbniško analitiko vključijo lastnika vaše organizacije.

Primeri pozivov

Za začetek lahko te primere prilepite v odjemalca MCP. Besedilo prilagodite svoji šoli, učilnici ali ekipi – pri pripravi predstavitve za stranke pa številke preverite na strani Analitika.

  • »Koliko aktivnih učiteljev smo imeli v tej obračunskem obdobju v primerjavi s številom licenc za našo šolo in v katerih mesecih je število upadlo?«
  • »Kateri padleti v naši organizaciji imajo največ ogledov? Navedi 3 najuspešnejše table/sandbox.«
  • »Kateri člani z vlogo učitelja v zadnjih 12 mesecih niso uporabljali Padleta?«
  • »Koliko članov nima e-poštne domene <ouremaildomain.edu>?«
Zaprosite za prikaz podatkov, ki ga potrebujete: mesečno časovno vrsto, filter po vlogi, najpriljubljenejše padlete glede na število objav ali obiskovalcev oziroma skupne meritve varnosti vsebine za šolo ali učilnico. Pomočnik bo vaše vprašanje povezal z razpoložljivimi meritvami.

Kje je nadzorna plošča še vedno boljša

Stran Analitika v nastavitvah uporabite, kadar potrebujete:

  • Vizualno pasico Pregled, poudarke o najboljših priložnostih in možnost, da z enim klikom zaprosite za strokovno izobraževanje
  • Tabelo Vsi uporabniki / Uporabniki z iskanjem, filtri po vlogah in prenosom datoteke CSV z enim klikom
  • Sezname aktivnih in neaktivnih učiteljev za izbrano obdobje, ki jih lahko prenesete z zavihka Pregled (šole in učilnice)
  • Prikaz, za katerega ni potrebna vključitev v pilotni program – stran v nastavitvah je na voljo ustreznim vlogam brez vključitve prek API-ja

MCP in API sta najbolj uporabna, kadar izbrani zavihki ne odgovorijo na točno določeno vprašanje, ki ga potrebujete za predstavitev ali pogovor o podaljšanju naročnine.

Omejitve:

  • Omejitev hitrosti: 60 zahtev na uro za vsak ključ API-ja in organizacijo, vključno s ponovnimi poizvedbami po odgovoru 202
  • Časovno obdobje: največ 24 mesecev v eni zahtevi
  • Varnost vsebine: samo za šole in učilnice – ekipe za te meritve prejmejo odgovor 400
  • Število članov: odraža trenutni seznam članov, ne pa zgodovinskega posnetka članstva v določenem trenutku
  • Čakajoče ≠ nič: meritev, ki se še izračunava, v odgovoru manjka; ne obravnavajte je kot ničelno
  • Vrsta organizacije: za zdaj samo wksp_

Pogosta vprašanja

Zakaj ob zahtevi za analitiko prejmem napako 404?

Med pilotnim obdobjem so vse zavrnitve enake: če organizacija ni vključena, je neznana ali nimate dostopa, se v vseh primerih vrne odgovor 404. Preverite, ali ste prijavljeni kot skrbnik (ali učitelj v okolju Classroom), ali je vaša organizacija vrste wksp_ in ali je Padlet vključil lastnika organizacije. Za vključitev se obrnite na podporo.

Ali moram pisati kodo?

Ne. Povežite Padlet MCP, prijavite se kot skrbnik in vprašajte v preprostem jeziku. Uporaba API-ja je neobvezna in namenjena razvijalcem ter naprednim uporabnikom, ki že uporabljajo javni API.

Ali je to isto kot javni API?

Povezano je, vendar ne gre za isti način uporabe. Javni API je namenjen razvijalcem, ki uporabljajo ključ API-ja. Padlet MCP je namenjen pomočnikom z umetno inteligenco, ki jim omogočite dostop s prijavo. Ko je vaša organizacija vključena, lahko do analitike organizacije dostopate z obema; uporabite lahko enega ali oba.

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

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

Moj odjemalec MCP očitno ne pozna analitike. Kaj naj poskusim?

Nekateri odjemalci svoj seznam orodij posodobijo z zamikom. Poskusite znova vzpostaviti povezavo s Padlet MCP, preklopiti na drug odjemalec, združljiv z MCP, ali neposredno uporabiti API za analitiko organizacije. Če po vključitvi še vedno ne morete dostopati, nam pišite.

Povezano

Was this article helpful?

Related articles