Kuidas paluda Padlet MCP-lt Admin Analyticsi (beeta)?

Carla Sese profiilipiltUuendatud 16 tunni eest kasutaja Carla Sese poolt

Kas kooli või Meeskonna administraatori esipaneel ei jaga numbreid nii, nagu soovite? Ühendage Padlet MCP tehisintellekti assistendiga ja küsige lihtsas keeles kooli, klassiruumi või Meeskonna analüütikat — või kasutage ise organisatsiooni analüütika API-t.

REST-liidese täieliku viite (mõõdikute kataloogi, päringute vormingute ja veakoodide) leiate lehelt Lugege organisatsiooni analüütika kohta aadressil docs.padlet.dev.

Kellele see on mõeldud?

See artikkel on mõeldud järgmistele kasutajatele:

  • Omanikud ja administraatorid Padlet for Schools- või Team-kontodel
  • Omanikud ja õpetajad Classroomi kontodel

MCP kasutamiseks pole vaja koodi kirjutada. API kasutamine on valikuline edasijõudnud kasutajatele, kes juba kasutavad Public API-t.

Mida teil juba on

Teie organisatsiooni seadete Analüütika lehel kuvatakse juba valitud vahelehed jooksva arveldusperioodi kohta. Koolides ja klassiruumides on vahelehed Ülevaade, Kasutus, Mõju, Ohutus, Populaarseimad kasutajad ja Kõik kasutajad. Meeskondadel on vahelehed Üldine, Padletid ja Kasutajad või Ülevaade, Kasutus, Mõju, Populaarseimad kasutajad ja Kõik kasutajad, kui teie Meeskonnal on uus Analüütika leht (beetaversioon).

Kasutage esipaneeli, kui soovite kiiret visuaalset ülevaadet. Kasutage MCP-d või API-t, kui vajate kohandatud andmejaotust, millele vahelehed selget vastust ei anna.

Mida MCP / API lisab

Esipaneelil on valitud vahelehed. MCP ja API võimaldavad küsida just vajalikku andmejaotust:

  • Lihtsas keeles küsimused teie tehisintellekti kliendile („Millised õpetajad olid eelmisel arveldusperioodil passiivsed?”)
  • Kohandatud kombinatsioonid kaasatuse, liikmesuse ja sisuohutuse mõõdikutest
  • Igakuised aegridad kuupäevavahemikus
  • Rollipõhised jaotused (õpetajad ja õpilased, sisu loojad ja kaastöölised)
  • Populaarseimad padletid, kasutajad ja meediaüksused teie valitud järjestuses
  • Vastused, mille saate kopeerida kvartaliülevaatesse või lepingu uuendamise esitlusse
Sisuohutuse mõõdikud (skannitud üksused, märgistatud üksused, tuvastusmäär) on saadaval ainult koolidele ja klassiruumidele. Kui küsite neid Meeskonna organisatsiooni kohta, kuvatakse nulli asemel viga.

Kiire alustamine Padlet MCP-ga

  1. Ühendage Padlet MCP oma tehisintellekti kliendis. Kasutage serveri URL-i https://mcp.padlet.com. Täielikud seadistusjuhised leiate lehelt Padlet MCP Server.
  2. Logige sisse ja andke luba organisatsiooni administraatorina. Classroomis saab analüütikat vaadata ka õpetaja.
  3. Küsige lihtsas keeles. Te ei pea sisemiste tööriistade nimesid teadma. Öelge tehisintellekti assistendile, mida soovite oma kooli, klassiruumi või Meeskonna kohta teada, ja see kasutab teie eest Padlet MCP-d.

Siin on näide:

Kui mõni MCP-klient veel analüütika vastuseid ei kuva, proovige mõnda muud MCP-ga ühilduvat klienti või kasutage selle asemel organisatsiooni analüütika API-t. Klienditugi võib serveri arendusele järele jõudmisega viivitada.
Teie assistent tegutseb teie nimel. See saab vaadata ainult analüütikat, millele teie sisselogitud kontol on juurdepääs.

Valikuline: organisatsiooni analüütika API

Kas eelistate ise skripti kirjutada? Kasutage Public API-t administraatori API-võtmega (või Classroomis õpetaja võtmega).

  1. Looge või kopeerige API-võti seadete arendajalehelt. Lisateavet leiate artiklist Public API.
  2. Leidke oma organisatsiooni ID päringuga GET /me?include=organizations. Vajate wksp_-ID-d — padlet.org-i org_-organisatsioone see lõpp-punkt veel ei toeta.
  3. Tehke päringuga POST aadressile /organizations/{org_id}/analytics, lisades soovitud mõõdikud.
  4. Kui vastus on 202 või meta.pending pole tühi, oodake väärtuses Retry-After määratud aeg ja saatke uuesti täpselt sama päring. Analüütika arvutatakse asünkroonselt — ootel mõõdik puudub vastusest, mitte ei ole null. Ärge kunagi käsitlege ootel väärtust nullina.
Päringute täielikud vormingud, mõõdikute kataloog ja läbitöötatud näited leiate lehelt Lugege organisatsiooni analüütika kohta.

Pilootprogrammi pääs

Organisatsiooni analüütika kasutamine MCP ja API kaudu on pilootprogrammi ajal valikuline. Padlet lisab programmi organisatsiooni omaniku — ainult administraatoriks olemisest ei piisa. Kuni teie organisatsioon pole programmi lisatud, vastab iga päring veaga 404 (sama vastus mis tundmatu organisatsiooni puhul).

Praegu toetatakse ainult wksp_-organisatsioone.

Võtke ühendust klienditoega ja paluge lisada teie organisatsiooni omanik administraatorite analüütika programmi.

Näidisküsimused

Need on alustuseks sobivad päringud, mille saate oma MCP-kliendisse kleepida. Kohandage sõnastust oma kooli, klassiruumi või Meeskonna järgi — ning kontrollige numbreid analüütika lehelt, kui valmistate ette klientidele mõeldud esitlust.

  • „Mitu õpetajat oli meie koolis sel arveldusperioodil aktiivne võrreldes litsentside arvuga ja millistel kuudel näitajad langesid?”
  • „Millistel organisatsiooni padlettidel on kõige rohkem vaatamisi? Loetle kolm populaarseimat tahvlit/sandboxi.”
  • „Millised õpetaja rolliga liikmed pole viimase 12 kuu jooksul Padletit kasutanud?”
  • „Kui paljudel liikmetel pole e-posti domeeniks <ouremaildomain.edu>?”
Küsige vajalikku andmejaotust: kuude kaupa aegrida, rollifiltrit, postituste või külastajate järgi populaarseimaid padlette või kooli või klassiruumi sisuohutuse koondandmeid. Assistent seostab teie küsimuse saadaolevate mõõdikutega.

Milles on esipaneel endiselt parem?

Kasutage seadete analüütika lehte, kui soovite järgmist:

  • Visuaalne Ülevaate bänner, soovitused parimate võimaluste kohta ja ühe klõpsuga esitatav professionaalse arengu taotlus
  • Tabel Kõik kasutajad / Kasutajad koos otsingu, rollifiltrite ja ühe klõpsuga CSV allalaadimisega
  • Valitud perioodi aktiivsete ja passiivsete õpetajate allalaaditavad loendid vahelehel Ülevaade (koolides ja klassiruumides)
  • Vaade, mis ei nõua pilootprogrammi lisamist — seadete leht on sobilike rollidega kasutajatele saadaval ka ilma API kasutamise loata

MCP ja API on eriti kasulikud, kui valitud vahelehed ei vasta täpselt küsimusele, mida vajate demo või lepingu uuendamise arutelu jaoks.

Piirangud:

  • Päringupiirang: 60 päringut tunnis API-võtme ja organisatsiooni kohta, sealhulgas pärast 202 vastust tehtavad päringud
  • Kuupäevavahemik: ühe päringuga saab küsida kõige rohkem 24 kuu andmeid
  • Sisuohutus: ainult koolidele ja klassiruumidele — Meeskonnad saavad nende mõõdikute puhul vastuseks 400
  • Liikmete arv: kajastab praegust nimekirja, mitte ajaloolist ülevaadet liikmesusest kindlal ajahetkel
  • Ootel ≠ null: arvutamisel olev mõõdik puudub vastusest; ärge käsitlege seda nullina
  • Organisatsiooni tüüp: praegu ainult wksp_

Korduma kippuvad küsimused

Miks kuvatakse analüütika päringul viga 404?

Kui lõpp-punkt on pilootprogrammis, on kõigi keeldumiste vastus sama: programmi lisamata, tundmatu organisatsioon või juurdepääsu puudumine annavad kõik vastuseks 404. Veenduge, et olete sisse logitud administraatorina (või Classroomis õpetajana), teie organisatsioon on wksp_-organisatsioon ja Padlet on programmi lisanud organisatsiooni omaniku. Programmi lisamise taotlemiseks võtke ühendust klienditoega.

Kas pean koodi kirjutama?

Ei. Ühendage Padlet MCP, logige sisse administraatorina ja küsige lihtsas keeles. API kasutamine on valikuline arendajatele ja edasijõudnud kasutajatele, kes juba kasutavad Public API-t.

Kas see on sama mis Public API?

Need on seotud, kuid tegemist pole sama tooteliidesega. Public API on mõeldud arendajatele, kes kasutavad API-võtit. Padlet MCP on mõeldud tehisintellekti assistentidele, millele annate loa sisse logides. Kui teie organisatsioon on programmi lisatud, pääseb organisatsiooni analüütikale ligi mõlema kaudu; võite kasutada üht või mõlemat.

Kas õpilased või mitte-administraatorid saavad sel viisil organisatsiooni analüütikat vaadata?

Ei. Analüütika vaatamiseks peab olema organisatsiooni administraator või Classroomi õpetaja. Assistendil on täpselt sama juurdepääs nagu kontol, millega sisse logisite — mitte midagi enamat.

Tundub, et mu MCP-klient ei tunne analüütikat ära. Mida peaksin proovima?

Mõni klient uuendab oma tööriistade loendit viivitusega. Proovige Padlet MCP uuesti ühendada, kasutada mõnda muud MCP-ga ühilduvat klienti või otse organisatsiooni analüütika API-t. Kui juurdepääs on pärast programmi lisamist endiselt blokeeritud, võtke meiega ühendust.

Seotud artiklid

Kas see artikkel oli abiks?

Seotud artiklid