Kaip paprašyti „Padlet MCP“ suteikti prieigą prie „Admin Analytics“ (beta versija)?

Carla Sese’s profile pictureUpdated prieš 13 valandų by Carla Sese

Reikia duomenų, kurių mokyklos ar komandos administratoriaus valdymo skydas nepateikia taip, kaip norėtumėte? Susiekite „Padlet MCP“ su AI asistentu ir paprašykite mokyklos, klasės ar komandos analizės paprasta kalba – arba patys iškvieskite organizacijos analizės API.

Išsamią REST informaciją (rodiklių katalogą, užklausų formas ir klaidų kodus) rasite skyriuje „Organizacijos analizės peržiūra“ svetainėje docs.padlet.dev.

Kam skirtas šis straipsnis

Šis straipsnis skirtas:

  • „Padlet for Schools“ arba „Team“ paskyrų savininkams ir administratoriams
  • „Classroom“ paskyrų savininkams ir mokytojams

Norėdami naudoti MCP kelią, jums nereikia rašyti kodo. Šis API kelias yra neprivalomas pažengusiems vartotojams, kurie jau dirba su viešuoju API.

Ką jau turite

Jūsų organizacijos „Analitika“ puslapyje, esančiame „Nustatymai“, jau rodomi atrinkti skirtukai, skirti dabartiniam atsiskaitymo laikotarpiui. Mokykloms ir klasėms rodomi skirtukai „Apžvalga“, „Naudojimas“, „Poveikis“, „Saugumas“, „Populiariausi vartotojai“ ir „Visi vartotojai“. Komandoms rodomi skirtukai „Bendrieji“, „Padletai“ ir „Vartotojai“.

Naudokite informacijos suvestinę, kai norite greitai gauti vizualią apžvalgą. Naudokite MCP arba API, kai reikia individualizuotos informacijos, kurios skirtukai nepateikia pakankamai aiškiai.

Ką suteikia MCP / API

Pagrindinis skydelis – tai atrinkti skirtukai. MCP ir API leidžia užklausti būtent tokią informaciją, kokios jums reikia:

  • Paprastais klausimais savo AI kliente („kurie mokytojai buvo neaktyvūs per paskutinį atsiskaitymo laikotarpį?“)
  • Individualūs aktyvumo, narystės ir turinio saugumo rodiklių deriniai
  • Mėnesiniai duomenų rinkiniai pagal datų intervalą
  • Duomenų segmentai pagal vaidmenis (mokytojai ir mokiniai, kūrėjai ir prisidedantys asmenys)
  • Populiariausi „Padlet“ įrašai, populiariausi vartotojai ir populiariausios medijos, surūšiuoti pagal jūsų užklausą
  • Atsakymai, kuriuos galite įklijuoti į QBR ar atnaujinimo pristatymą
Turinio saugumo rodikliai (patikrinti elementai, pažymėti elementai, aptikimo rodiklis) prieinami tik mokykloms ir klasėms. Jei jų prašoma „Team“ organizacijoje, grąžinama klaida, o ne nulis.

Greitasis pradžios vadovas su „Padlet MCP“

  1. Prijunkite „Padlet MCP“ savo AI kliente. Naudokite serverio URL https://mcp.padlet.com. Išsamūs nustatymo žingsniai pateikiami „Padlet MCP Server“.
  2. Prisijunkite ir patvirtinkite savo tapatybę kaip organizacijos, apie kurią norite gauti informaciją, administratorius. Klasėje mokytojas taip pat gali gauti analizės duomenis.
  3. Klauskite paprasta kalba. Nereikia nurodyti vidinių įrankių pavadinimų. Pasakykite AI asistentui, ką norite sužinoti apie savo mokyklą, klasę ar komandą, ir jis jūsų vardu pasinaudos „Padlet MCP“.

Štai pavyzdys:

Jei tam tikra MCP programa dar nerodo analitinių duomenų, pabandykite kitą su MCP suderinamą programą arba vietoj to naudokite organizacijos analitikos API. Programos palaikymas gali atsilikti nuo serverio.
Jūsų asistentas veikia jūsų vardu. Jis gali gauti tik tuos analitinius duomenis, kuriuos leidžiama matyti jūsų prisijungusiai paskyrai.

Pasirinktinai: organizacijos analitikos API

Norite patys parašyti skriptą? Naudokite viešąjį API su administratoriaus API raktu (arba mokytojo raktu „Classroom“ aplinkoje).

  1. Sukurkite arba nukopijuokite API raktą iš „Nustatymai“ skyriaus „Kūrėjo“ puslapio. Išsami informacija pateikta straipsnyje apie viešąjį API.
  2. Savo organizacijos ID rasite naudodami GET /me?include=organizations. Jums reikalingas wksp_ ID — org_ padlet.org organizacijos šiuo metu dar nepalaikomos šiame galiniame taške.
  3. Siųskite POST į /organizations/{org_id}/analytics su norimais rodikliais.
  4. Jei atsakymas yra 202 arba meta.pending nėra tuščias, palaukite, kol Retry-After ir vėl išsiųskite identišką užklausą. Analitika skaičiuojama asinchroniškai — laukiamas rodiklis reiškia, kad jo nėra, o ne kad jis lygus nuliui. Niekada nelaikykite laukiamo rodiklio lygiu nuliui.
Išsamūs užklausų šablonai, rodiklių katalogas ir praktiniai pavyzdžiai pateikiami skyriuje „Organizacijos analizė“.

Prieiga prie bandomosios versijos

Prieiga prie organizacijos analitikos per MCP ir API bandomojo laikotarpio metu yra savanoriška. „Padlet“ registruoja organizacijos savininką — vien administratoriaus teisių turėjimo nepakanka. Kol jūsų organizacija nėra užregistruota, į kiekvieną užklausą atsakoma 404 (tas pats atsakymas kaip ir nežinomai organizacijai).

Šiuo metu palaikomos tik wksp_ organizacijos.

Susisiekite su palaikymo tarnyba ir paprašykite, kad jūsų organizacijos savininkas būtų užregistruotas administratoriaus analitikai.

Pavyzdiniai užklausų šablonai

Tai yra pavyzdžiai, kuriuos galite įklijuoti į savo MCP klientą. Pritaikykite tekstą pagal savo mokyklą, klasę ar komandą – ir, ruošdami pristatymą klientams, patikrinkite skaičius „Analitikos“ puslapyje.

  • „Kiek mūsų mokykloje šiuo atsiskaitymo laikotarpiu yra aktyvių mokytojų, palyginti su licencijų skaičiumi, ir kuriais mėnesiais šis skaičius sumažėjo?“
  • „Kurių organizacijos „Padlet“ lentų peržiūrų skaičius yra didžiausias? Pateikite 3 populiariausias lentas / bandomąsias aplinkas.“
  • „Kurie nariai, turintys mokytojo vaidmenį, per pastaruosius 12 mėnesių nenaudojo „Padlet“?“
  • „Kiek narių neturi el. pašto domeno <ouremaildomain.edu>?“
Paprašykite jums reikalingos informacijos dalies: mėnesinių duomenų serijos, filtravimo pagal vaidmenį, populiariausių „Padlet“ lentų pagal įrašų skaičių ar lankytojų skaičių arba turinio saugumo statistikos mokykloje ar klasėje. Asistentas susies jūsų klausimą su turimais rodikliais.

Ką informacinė panelė vis dar daro geriau

Naudokitės „Analitika“ puslapiu nustatymuose, kai norite:

  • Vizualus „Apžvalga“ baneris, svarbiausių galimybių išskyrimai ir profesinio tobulinimosi prašymas vienu paspaudimu
  • Lentelė „Visi vartotojai / Vartotojai“ su paieška, vaidmenų filtrais ir galimybė atsisiųsti CSV failą vienu paspaudimu
  • Atsisiunčiamus aktyvių ir neaktyvių mokytojų sąrašus už pasirinktą laikotarpį iš skirtuko „Apžvalga“ (mokyklos ir klasės)
  • Peržiūra, kuriai nereikia registruotis bandomajai versijai – pats „Nustatymai“ puslapis yra prieinamas atitinkamų vaidmenų vartotojams be API sutikimo

MCP ir API ypač praverčia, kai parengti skyriai neatsako į konkretų klausimą, kurio jums reikia demonstravimo ar sutarties pratęsimo pokalbiui.

Apribojimai:

  • Užklausų limitas: 60 užklausų per valandą vienam API raktui ir organizacijai, įskaitant apklausas po 202
  • Laikotarpis: ne daugiau kaip 24 mėnesiai viename užklausime
  • Turinio saugumas: tik mokykla ir klasė — „Teams“ gauna 400 už šiuos rodiklius
  • Narių skaičius: atspindi dabartinį sąrašą, o ne istorinę momentinę nuotrauką, kas tuo metu priklausė
  • „Laukiama“ ≠ nulis: atsakyme trūksta rodiklio, kuris vis dar skaičiuojamas; jo nelaikykite nuliu
  • Organizacijos tipas: wksp_ tik kol kas

DUK

Kodėl gaunu 404 klaidą, kai prašau pateikti analitinius duomenis?

Kol galinis taškas yra bandomojoje versijoje, kiekvienas atmetimas atrodo vienodai: „neįregistruotas“, „nežinoma organizacija“ arba „nėra prieigos“ 404. Patikrinkite, ar prisijungėte kaip administratorius (arba mokytojas „Classroom“ sistemoje), ar jūsų organizacija yra wksp_ organizacija ir kad „Padlet“ įtraukė organizacijos savininką. Susisiekite su palaikymo komanda, kad paprašytumėte įtraukti organizaciją.

Ar man reikia rašyti kodą?

Ne. Prijunkite „Padlet MCP“, prisijunkite kaip administratorius ir pateikite užklausą paprasta kalba. API kelias yra neprivalomas kūrėjams ir pažengusiems vartotojams, kurie jau naudoja viešąjį API.

Ar tai tas pats, kas viešasis API?

Susiję, bet tai nėra tas pats produktas. Viešoji API skirta kūrėjams, naudojantiems API raktą. „Padlet MCP“ skirta AI asistentams, kuriuos įgaliojate prisijungdami. Abu gali pasiekti organizacijos analitinius duomenis, kai jūsų organizacija bus įtraukta; galite naudoti vieną iš jų arba abu.

Ar mokiniai ar ne administratoriai gali šiuo būdu matyti organizacijos analitinius duomenis?

Ne. Analitikai prieiti gali tik organizacijos administratorius arba „Classroom“ mokytojas. Asistentas turi lygiai tokią pačią prieigą kaip ir paskyra, su kuria prisijungėte – nieko daugiau.

Atrodo, kad mano MCP klientas nežino apie analitinius duomenis. Ką turėčiau pabandyti?

Kai kurios programos savo įrankių sąrašą atnaujina su vėlavimu. Pabandykite iš naujo prijungti „Padlet MCP“, pereiti prie kitos su „MCP“ suderinamos programos arba tiesiogiai naudoti organizacijos analizės API. Jei po registracijos vis dar susiduriate su kliūtimis, susisiekite su mumis.

Susiję

Was this article helpful?

Related articles