Kako v Padlet MCP zahtevam skrbniško analitiko?

Foto profil Carla SeseDiperbarui pred 4 dnevi oleh Carla Sese

Ne dobite številk, ki jih iščete, na skrbniški nadzorni plošči za šolo ali ekipo? Povežite Padlet MCP s pomočnikom za umetno inteligenco in v običajnem jeziku zahtevajte analitiko za šolo, učilnico ali ekipo oziroma sami pokličite API za analitiko organizacije.

Celotno referenčno dokumentacijo REST (katalog meritev, oblike zahtev in kode napak) najdete v razdelku Branje analitike organizacije na docs.padlet.dev.

Komu je to namenjeno

Ta članek je namenjen:

  • Lastnikom in skrbnikom računov Padlet za šole ali računov ekip
  • Lastnikom in učiteljem računov učilnic

Za uporabo možnosti MCP vam ni treba pisati kode. Možnost API je neobvezna za napredne uporabnike, ki že uporabljajo javni API.

Kar že imate

Na strani Analitika vaše organizacije v nastavitvah so že prikazani izbrani zavihki za trenutno obračunsko obdobje. Šole in učilnice imajo zavihke Pregled, Uporaba, Vpliv, Varnost, Najboljši uporabniki in Vsi uporabniki. Ekipe imajo zavihke Splošno, Padleti in Uporabniki ali pa Pregled, Uporaba, Vpliv, Najboljši uporabniki in Vsi uporabniki, če ima vaša ekipa novo stran z analitiko (beta).

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

Prednosti MCP-ja / API-ja

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

  • Vprašanja v običajnem jeziku v odjemalcu za umetno inteligenco (»Kateri učitelji v zadnjem obračunskem obdobju niso bili aktivni?«)
  • Poljubne kombinacije meritev dejavnosti, članstva in varnosti vsebine
  • Mesečne časovne vrste za izbrano časovno obdobje
  • Prikaze po vlogah (učitelji in učenci, ustvarjalci in sodelujoči)
  • Najboljše padlete, uporabnike in predstavnostne vsebine, razvrščene po vaših željah
  • 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 zaznave) so na voljo samo za šole in učilnice. Če jih zahtevate za organizacijo ekipe, se vrne napaka, ne pa ničelna vrednost.

Hitri začetek s Padlet MCP

  1. V odjemalcu za umetno inteligenco povežite Padlet MCP. Uporabite URL strežnika https://mcp.padlet.com. Celotna navodila za nastavitev so v članku Strežnik Padlet MCP.
  2. Prijavite se in se pooblastite kot skrbnik organizacije, za katero želite pridobiti podatke. V učilnici lahko analitiko pridobi tudi učitelj.
  3. Vprašajte v običajnem jeziku. Ni vam treba navesti imen notranjih orodij. Povejte pomočniku za umetno inteligenco, kaj želite izvedeti o svoji šoli, učilnici ali ekipi, in uporabil bo Padlet MCP v vašem imenu.

Primer:

Če vaš odjemalec MCP še ne prikazuje odgovorov o analitiki, poskusite z drugim odjemalcem, združljivim z MCP, ali uporabite API za analitiko organizacije. Podpora v odjemalcih lahko zaostaja za podporo na strežniku.
Pomočnik deluje kot vi. Pridobi lahko le analitiko, ki je dovoljena vašemu prijavljenemu računu.

Neobvezno: API za analitiko organizacije

Bi raje sami napisali skripto? Uporabite javni API s ključem API-ja za skrbnika (ali ključem učitelja v učilnici).

  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, ki se začne z wksp_. Organizacije org_ na padlet.org za to končno točko še niso podprte.
  3. Pošljite zahtevo POST na /organizations/{org_id}/analytics z želenimi meritvami.
  4. Če je odgovor 202 ali meta.pending ni prazen, počakajte toliko, kot določa Retry-After, in znova pošljite enako zahtevo. Analitika se izračuna v ozadju, zato čakajoča meritev v odgovoru manjka. Nikoli je ne obravnavajte kot nič.
Celotne oblike zahtev, katalog meritev in praktične primere najdete v razdelku Branje analitike organizacije.

Kdo jo lahko uporablja

Analitika organizacije prek Padlet MCP in API-ja je na voljo lastnikom in skrbnikom računov Padlet za šole in računov ekip ter lastnikom in učiteljem računov učilnic. Ni vam treba prositi Padleta, da jo omogoči.

Za zdaj so podprte samo organizacije wksp_.

Primeri pozivov

Spodnji primeri so začetni pozivi, ki jih lahko prilepite v odjemalca MCP. Prilagodite besedilo svoji šoli, učilnici ali ekipi, pri pripravi predstavitve za stranke pa številke preverite na strani Analitika.

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

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

Stran Analitika v nastavitvah uporabite, kadar želite:

  • Vizualno pasico Pregled, obvestila o najboljših priložnostih in možnost, da z enim klikom zahtevate strokovno izpopolnjevanje
  • Tabelo Vsi uporabniki / Uporabniki z iskanjem, filtri po vlogah in prenosom CSV-ja z enim klikom
  • Sezname aktivnih in neaktivnih učiteljev za izbrano obdobje, ki jih lahko prenesete z zavihka Pregled (šole in učilnice)

MCP in API sta najbolj uporabna takrat, ko izbrani zavihki ne odgovorijo na točno tisto vprašanje, ki ga imate za predstavitev ali pogovor o podaljšanju naročnine.

Omejitve:

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

Pogosta vprašanja

Zakaj se pri zahtevi za analitiko prikaže napaka 404?

Vse zavrnitve so videti enako: neznana organizacija ali pomanjkanje dostopa v obeh primerih vrneta 404. Preverite, ali ste prijavljeni kot skrbnik te organizacije (ali kot učitelj v učilnici) in ali je organizacija vrste wksp_. Še vedno ne gre? Obrnite se na podporo.

Ali moram pisati kodo?

Ne. Povežite Padlet MCP, prijavite se kot skrbnik in vprašajte v običajnem jeziku. Možnost API je neobvezna za razvijalce in napredne uporabnike, ki že uporabljajo javni API.

Ali je to isto kot javni API?

Povezano je, vendar ne gre za isto storitev. Javni API je namenjen razvijalcem, ki uporabljajo ključ API-ja. Padlet MCP je namenjen pomočnikom za umetno inteligenco, ki jih pooblastite s prijavo. Obe možnosti omogočata dostop do analitike organizacije, uporabite pa lahko eno ali obe.

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

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

Moj odjemalec MCP ne pozna analitike. Kaj lahko poskusim?

Nekateri odjemalci seznam orodij posodobijo z zamikom. Poskusite znova vzpostaviti povezavo s Padlet MCP, uporabiti drug odjemalec, združljiv z MCP, ali neposredno uporabiti API za analitiko organizacije. Če težave ne odpravite, se obrnite na nas.

Sorodno

Apakah artikel ini bermanfaat?

Artikel terkait