Kaip paprašyti „Padlet MCP“ administratoriaus analitikos?

Fotografia de profil a utilizatorului Carla SeseActualizat prieš 4 dienas de Carla Sese

Reikia skaičių, kurių mokyklos ar komandos administratoriaus darbalaukio ataskaitose nerandate? Prijunkite Padlet MCP prie DI asistento ir įprasta kalba teiraukitės apie mokyklos, klasės ar komandos analizę arba patys naudokite organizacijos analizės API.

Visą REST nuorodą (rodiklių katalogą, užklausų struktūrą ir klaidų kodus) rasite svetainės docs.padlet.dev skiltyje Organizacijos analizės peržiūra.

Kam skirta

Šis straipsnis skirtas:

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

Norint naudotis MCP, kodo rašyti nereikia. API naudojimas pasirenkamas ir skirtas pažengusiems naudotojams, kurie jau dirba su viešąja API.

Ką jau turite

Organizacijos puslapyje Analizė, esančiame skiltyje „Nustatymai“, jau pateikiami parinkti einamojo atsiskaitymo laikotarpio skirtukai. Mokykloms ir klasėms rodomi skirtukai „Apžvalga“, „Naudojimas“, „Poveikis“, „Sauga“, „Populiariausi naudotojai“ ir „Visi naudotojai“. Komandoms rodomi skirtukai „Bendra“, „Padlet“ ir „Naudotojai“ arba, jei jūsų komanda turi naują analizės puslapį (beta versiją), „Apžvalga“, „Naudojimas“, „Poveikis“, „Populiariausi naudotojai“ ir „Visi naudotojai“.

Naudokite darbalaukį, jei norite greitai peržvelgti vaizdinę informaciją. Naudokite MCP arba API, jei reikia pritaikyto duomenų pjūvio, kurio skirtukai aiškiai neparodo.

Ką suteikia MCP / API

Darbalaukyje pateikiami parinkti skirtukai. Naudodami MCP ir API galite paprašyti būtent jums reikalingo duomenų pjūvio:

  • Užduoti klausimus įprasta kalba DI kliente („kurie mokytojai praėjusį atsiskaitymo laikotarpį buvo neaktyvūs?“)
  • Pasirinktinai derinti įsitraukimo, narystės ir turinio saugos rodiklius
  • Peržiūrėti mėnesinius duomenis pasirinktu laikotarpiu
  • Filtruoti pagal vaidmenis (mokytojai ir mokiniai, kūrėjai ir bendraautoriai)
  • Rikiuoti populiariausius padletus, naudotojus ir medijos failus pagal nurodytus kriterijus
  • Gauti atsakymus, kuriuos galite įtraukti į ketvirčio verslo apžvalgą ar sutarties pratęsimo pristatymą
Turinio saugos rodikliai (nuskaityti elementai, pažymėti elementai, aptikimo dažnis) prieinami tik mokykloms ir klasėms. Paprašius jų komandos organizacijoje, grąžinama klaida, o ne nulis.

Greita pradžia su Padlet MCP

  1. Prijunkite Padlet MCP prie savo DI kliento. Naudokite serverio URL https://mcp.padlet.com. Visus sąrankos veiksmus rasite puslapyje Padlet MCP serveris.
  2. Prisijunkite ir suteikite prieigą kaip organizacijos, kurios duomenų norite teirautis, administratorius. Jei naudojate Classroom, analizę taip pat gali gauti mokytojas.
  3. Užduokite klausimą įprasta kalba. Vidinių įrankių įvardyti nereikia. Pasakykite DI asistentui, ką norite sužinoti apie savo mokyklą, klasę ar komandą, o jis jūsų vardu pasinaudos Padlet MCP.

Pavyzdys:

Jei konkrečiame MCP kliente analizės atsakymai dar nerodomi, išbandykite kitą su MCP suderinamą klientą arba naudokite organizacijos analizės API. Klientų palaikymas gali atsilikti nuo serverio.
Asistentas veikia jūsų vardu. Jis gali gauti tik tą analizės informaciją, kurią leidžiama matyti jūsų paskyrai.

Pasirinktinai: organizacijos analizės API

Norite patys kurti scenarijus? Naudokite viešąją API su administratoriaus API raktu (arba Classroom mokytojo raktu).

  1. Sukurkite arba nukopijuokite API raktą iš „Nustatymų“ skilties „Kūrėjai“. Daugiau informacijos rasite straipsnyje apie viešąją API.
  2. Organizacijos ID raskite naudodami GET /me?include=organizations. Ieškokite ID, prasidedančio wksp_. Šis galinis taškas kol kas nepalaiko org_ organizacijų svetainėje padlet.org.
  3. Siųskite POST užklausą adresu /organizations/{org_id}/analytics ir nurodykite norimus rodiklius.
  4. Jei atsakymas yra 202 arba meta.pending nėra tuščias, palaukite laiką, nurodytą antraštėje Retry-After, ir vėl siųskite identišką užklausą. Analizė apskaičiuojama fone, todėl laukiamas rodiklis atsakyme nepateikiamas. Niekada nelaikykite jo nuliu.
Visą užklausų struktūrą, rodiklių katalogą ir pavyzdžius rasite puslapyje Organizacijos analizės peržiūra.

Kas gali naudotis

Organizacijos analizė per Padlet MCP ir API prieinama Padlet for Schools ir Team paskyrų savininkams bei administratoriams ir Classroom paskyrų savininkams bei mokytojams. Nereikia prašyti Padlet įjungti šios funkcijos.

Kol kas palaikomos tik wksp_ organizacijos.

Pavyzdinės užklausos

Šias užklausas galite nukopijuoti į savo MCP klientą. Pritaikykite formuluotes savo mokyklai, klasei ar komandai ir, rengdami klientams skirtą pristatymą, palyginkite skaičius su puslapio „Analizė“ duomenimis.

  • „Kiek šiuo atsiskaitymo laikotarpiu mūsų mokykloje yra aktyvių mokytojų, palyginti su turimų licencijų skaičiumi, ir kuriais mėnesiais rodikliai sumažėjo?“
  • „Kuriuose organizacijos padletuose apsilankoma dažniausiai? Pateik 3 populiariausias lentas / sandbox.“
  • „Kurie nariai, turintys mokytojo vaidmenį, per pastaruosius 12 mėnesių nesinaudojo Padlet?“
  • „Kiek narių neturi el. pašto domeno <ouremaildomain.edu>?“
Paprašykite reikiamo duomenų pjūvio: mėnesinių duomenų, filtro pagal vaidmenį, populiariausių padletų pagal įrašus ar lankytojus arba mokyklos ar klasės turinio saugos rodiklių sumų. Asistentas susies jūsų klausimą su prieinamais rodikliais.

Kuo darbalaukis vis dar pranašesnis

Naudokite puslapį „Analizė“, esantį skiltyje „Nustatymai“, jei norite:

  • Vaizdinės apžvalgos juostos, svarbiausių galimybių išnašų ir galimybės vienu spustelėjimu pateikti profesinio tobulėjimo užklausą
  • Lentelės „Visi naudotojai“ / „Naudotojai“ su paieška, vaidmenų filtrais ir galimybe vienu spustelėjimu atsisiųsti CSV failą
  • Pasirinkto laikotarpio aktyvių ir neaktyvių mokytojų sąrašų, kuriuos galima atsisiųsti iš skirtuko „Apžvalga“ (mokykloms ir klasėms)

MCP ir API ypač naudingi, kai parinkti skirtukai neatsako į konkretų klausimą, kuris kyla rengiant demonstraciją ar kalbantis dėl sutarties pratęsimo.

Apribojimai:

  • Užklausų dažnio limitas: 60 užklausų per valandą vienam API raktui ir organizacijai, įskaitant užklausas po 202 atsakymo
  • Laikotarpis: viena užklausa gali apimti ne daugiau kaip 24 mėnesius
  • Turinio sauga: taikoma tik mokykloms ir klasėms. Komandoms, paprašius šių rodiklių, pateikiama 400 klaida
  • Narių skaičius: rodo dabartinį narių sąrašą, o ne istorinį vaizdą, kas priklausė organizacijai tuo metu
  • Laukiama ≠ nulis: vis dar skaičiuojamas rodiklis atsakyme nepateikiamas; nelaikykite jo nuliu
  • Organizacijos tipas: kol kas palaikomos tik wksp_ organizacijos

DUK

Kodėl gaunu 404 klaidą, kai prašau analizės?

Visi prieigos atmetimo atvejai atrodo vienodai: jei organizacija nežinoma arba neturite prieigos, abiem atvejais grąžinama 404. Patikrinkite, ar prisijungėte kaip tos organizacijos administratorius (arba Classroom mokytojas) ir ar jos ID prasideda wksp_. Vis tiek nepavyksta? Susisiekite su palaikymo komanda.

Ar reikia rašyti kodą?

Ne. Prijunkite Padlet MCP, prisijunkite kaip administratorius ir užduokite klausimą įprasta kalba. API naudojimas pasirenkamas ir skirtas kūrėjams bei pažengusiems naudotojams, kurie jau naudojasi viešąja API.

Ar tai tas pats, kas viešoji API?

Šios priemonės susijusios, bet tai nėra tas pats produktas. Viešąją API naudoja kūrėjai, turintys API raktą. Prie Padlet MCP prisijungiate ir suteikiate jam prieigą. Abiem priemonėmis galima pasiekti organizacijos analizę, tad galite naudoti vieną iš jų arba abi.

Ar mokiniai arba ne administratoriai tokiu būdu gali peržiūrėti organizacijos analizę?

Ne. Analizę gali peržiūrėti tik organizacijos administratorius arba Classroom mokytojas. Asistentas turi lygiai tokią pačią prieigą kaip paskyra, prie kurios prisijungėte, ir nieko daugiau.

MCP klientas, atrodo, nežino apie analizę. Ką turėčiau išbandyti?

Kai kurių klientų įrankių sąrašas atnaujinamas ne iš karto. Pabandykite iš naujo prijungti Padlet MCP, perjungti į kitą su MCP suderinamą klientą arba tiesiogiai naudoti organizacijos analizės API. Jei vis tiek nepavyksta, susisiekite su mumis.

Susiję straipsniai

A fost acest articol util?

Articole similare