Kuidas taotleda Padlet MCP-lt haldaja analüütikat (beeta)?

Carla Sese profiilipiltUuendatud 13 tunni eest kasutaja Carla Sese poolt

Kas sinu kooli või Meeskonna administraatori juhtpaneel ei kuva vajalikke numbreid soovitud viisil? Ühenda Padlet MCP tehisintellekti assistendiga ja küsi kooli, klassiruumi või Meeskonna analüütikat tavakeeles – või kasuta ise organisatsiooni analüütika API-t.

REST API täieliku teatmiku (mõõdikute kataloogi, päringuvormingute ja veakoodide) leiad docs.padlet.dev-i lehelt Read organization analytics.

Kellele see on mõeldud?

See artikkel on mõeldud järgmistele kasutajatele:

  • Omanikud ja administraatorid Padlet for Schoolsis või Meeskonna kontodel
  • Omanikud ja õpetajad klassiruumikontodel

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

Mis sul juba olemas on

Seadete lehel kuvatakse sinu organisatsiooni Analyticsi jaotises kureeritud vahelehed praeguse arveldusperioodi kohta. Koolide ja klassiruumide vahelehed on Overview, Usage, Impact, Safety, Top users ja All users. Meeskondadel on vahelehed General, Padlets ja Users.

Kasuta juhtpaneeli kiire visuaalse ülevaate saamiseks. Kasuta MCP-d või API-t siis, kui vajad kohandatud vaadet, millele vahelehed selget vastust ei anna.

Mida MCP / API lisab

Juhtpaneel pakub kureeritud vahelehti. MCP ja API võimaldavad küsida täpselt vajalikku vaadet:

  • Esita tehisintellekti kliendis tavakeeles küsimusi („Millised õpetajad olid eelmisel arveldusperioodil mitteaktiivsed?”)
  • Koosta kaasatuse, liikmesuse ja sisuturvalisuse mõõdikutest kohandatud kombinatsioone
  • Vaata kuupõhiseid andmeridu valitud kuupäevavahemikus
  • Vaata andmeid rollide kaupa (õpetajad vs. õpilased, loojad vs. kaastöölised)
  • Reasta populaarseimad padletid, kasutajad ja meediaüksused sinu valitud viisil
  • Saad vastused, mille saad lisada kvartaliülevaate või uuendamise esitlusse
Sisuturvalisuse mõõdikud (skannitud üksused, märgistatud üksused, tuvastusmäär) on saadaval ainult koolidele ja klassiruumidele. Kui küsid neid Meeskonna organisatsiooni kohta, tagastatakse nulli asemel viga.

Alustamine Padlet MCP-ga

  1. Ühenda Padlet MCP oma tehisintellekti kliendiga. Kasuta serveri URL-i https://mcp.padlet.com. Täielikud seadistusjuhised leiad lehelt Padlet MCP Server.
  2. Logi sisse ja anna volitus selle organisatsiooni administraatorina, mille kohta soovid päringuid teha. Classroomis saab analüütikat vaadata ka õpetaja.
  3. Esita küsimus tavakeeles. Sisemiste tööriistade nimesid pole vaja teada. Ütle tehisintellekti assistendile, mida soovid oma kooli, klassiruumi või Meeskonna kohta teada, ning see kasutab sinu eest Padlet MCP-d.

Näiteks:

Kui mõni MCP klient ei kuva veel analüütika vastuseid, proovi mõnda muud MCP-ga ühilduvat klienti või kasuta selle asemel organisatsiooni analüütika API-t. Klienditugi võib serveri võimalustest maha jääda.
Assistent tegutseb sinu nimel. See saab hankida ainult analüütikat, mille vaatamiseks on sinu sisselogitud kontol luba.

Valikuline: organisatsiooni analüütika API

Kas eelistad ise skripti kirjutada? Kasuta Public API-t administraatori API-võtmega (või Classroomi õpetaja võtmega).

  1. Loo API-võti või kopeeri see seadete arendajalehelt. Lisateavet leiad artiklist Public API.
  2. Leia oma organisatsiooni ID päringuga GET /me?include=organizations. Vaja läheb wksp_-ga algavat ID-d — padlet.org-i org_-organisatsioone see lõpp-punkt veel ei toeta.
  3. Saada päringuga POST aadressile /organizations/{org_id}/analytics mõõdikud, mida soovid.
  4. Kui vastus on 202 või meta.pending pole tühi, oota ära Retry-After ja saada täpselt sama päring uuesti. Analüütika arvutatakse asünkroonselt — ootel mõõdik puudub vastusest, see ei ole null. Ära käsitle ootel mõõdikut kunagi nullina.
Täielikud päringuvormingud, mõõdikute kataloogi ja näited leiad lehelt Read organization analytics.

Pilootprogrammis osalemine

Organisatsiooni analüütika kasutamine MCP ja API kaudu on pilootprogrammi ajal vabatahtlik. Padlet lisab programmi organisatsiooni omaniku — ainult administraatori õigustest ei piisa. Enne organisatsiooni lisamist tagastab iga päring vastuse 404 (sama vastus nagu tundmatu organisatsiooni korral).

Praegu toetatakse ainult wksp_-organisatsioone.

Võta ühendust kasutajatoega ja palu lisada oma organisatsiooni omanik administraatori analüütika kasutajaks.

Näidisküsimused

Siin on näited, mida saad oma MCP klienti kopeerida. Kohanda sõnastust oma kooli, klassiruumi või Meeskonna järgi ning kontrolli kliendile mõeldud esitlust ette valmistades arve Analyticsi lehelt üle.

  • „Kui palju oli meie koolis sel arveldusperioodil aktiivseid õpetajaid võrreldes litsentside arvuga ja millistel kuudel näitajad langesid?”
  • „Millistel meie organisatsiooni padletitel on kõige rohkem vaatamisi? Esita kolm populaarseimat tahvlit/sandboxi.”
  • „Millised õpetaja rolliga liikmed pole viimase 12 kuu jooksul Padletit kasutanud?”
  • „Kui paljudel liikmetel puudub e-posti aadressis domeen <ouremaildomain.edu>?”
Küsi vajalikku vaadet: kuupõhist andmerida, rollifiltrit, postituste või külastajate arvu järgi populaarseimaid padleteid või kooli või klassiruumi sisuturvalisuse koondnäitajaid. Assistent seostab sinu küsimuse saadaolevate mõõdikutega.

Milles on juhtpaneel endiselt parem?

Kasuta seadete Analyticsi lehte, kui soovid järgmist:

  • Visuaalset Overview bännerit, Top opportunity esiletõsteid ja ühe klõpsuga PD-päringut
  • All users / Users tabelit koos otsingu, rollifiltrite ja ühe klõpsuga CSV allalaadimisega
  • Valitud perioodi aktiivsete ja mitteaktiivsete õpetajate allalaaditavaid loendeid Overview vahelehelt (koolid ja klassiruumid)
  • Vaadet, mille jaoks pole vaja pilootprogrammi lisamist — seadete leht on sobilike rollidega kasutajatele kättesaadav ilma API kasutamise nõusolekuta

MCP ja API on kasulikud siis, kui kureeritud vahelehed ei vasta täpselt küsimusele, mis sul on demo või uuendamise aruteluks vaja.

Piirangud:

  • Päringupiirang: 60 päringut tunnis ühe API-võtme ja organisatsiooni kohta, sealhulgas päringud pärast vastust 202
  • Kuupäevavahemik: ühe päringuga saab küsida kuni 24 kuu andmeid
  • Sisuturvalisus: ainult koolidele ja klassiruumidele — Meeskondade puhul tagastatakse nende mõõdikute päringu korral 400
  • Liikmete arv: kajastab praegust liikmeskonda, mitte ajaloolist hetkeseisu selle kohta, kes kuulus organisatsiooni valitud ajal
  • Ootel ≠ null: veel arvutatav mõõdik puudub vastusest; ära käsitle seda nullina
  • Organisatsiooni tüüp: praegu ainult wksp_

Korduma kippuvad küsimused

Miks saan analüütikat küsides vastuseks 404?

Kui lõpp-punkt on pilootprogrammis, näeb iga keeldumise vastus ühesugune välja: lisamata organisatsiooni, tundmatu organisatsiooni ja juurdepääsu puudumise korral tagastatakse 404. Kontrolli, et logisid sisse administraatorina (või Classroomis õpetajana), et sinu organisatsioon algab tähisega wksp_ ning et Padlet on lisanud programmi organisatsiooni omaniku. Lisamise taotlemiseks võta ühendust kasutajatoega.

Kas pean koodi kirjutama?

Ei. Ühenda Padlet MCP, logi sisse administraatorina ja esita küsimus tavakeeles. API kasutamine on valikuline ning mõeldud arendajatele ja edasijõudnud kasutajatele, kes juba kasutavad Public API-t.

Kas see on sama mis Public API?

Need on omavahel seotud, kuid tegemist pole sama tooteliidesega. Public API on mõeldud arendajatele, kes kasutavad API-võtit. Padlet MCP on mõeldud tehisintellekti assistentidele, kellele annad juurdepääsu sisselogimisega. Kui sinu organisatsioon on programmi lisatud, pääsevad mõlemad organisatsiooni analüütikale ligi; võid kasutada üht või mõlemat.

Kas õpilased või mitteadministraatorid 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 mis kontol, millega sisse logisid — mitte midagi enamat.

MCP klient ei paista analüütikast teadvat. Mida võiksin proovida?

Mõni klient uuendab oma tööriistade loendit viivitusega. Proovi Padlet MCP ühendus uuesti luua, kasuta mõnda muud MCP-ga ühilduvat klienti või kasuta otse organisatsiooni analüütika API-t. Kui pärast programmi lisamist ei pääse sa endiselt ligi, võta meiega ühendust.

Seotud artiklid

Kas see artikkel oli abiks?

Seotud artiklid