Kuidas küsida Padleti MCP-lt administraatori analüütikat?

Фото профиля Carla SeseОбновлено 4 päeva eest пользователем Carla Sese

Kas kooli või Meeskonna Administraatori esipaneel ei kuva vajalikke numbreid soovitud viisil? Ühenda Padlet MCP tehisintellekti assistendiga ja küsi kooli, klassiruumi või Meeskonna analüütikat lihtsas keeles või kutsu ise organisatsiooni analüütika API-t.

REST API täieliku viite (mõõdikute kataloogi, päringute vormingute ja veakoodide) leiad dokumendist Organisatsiooni analüütika lugemine aadressil docs.padlet.dev.

Kellele see mõeldud on?

See artikkel on mõeldud järgmistele kasutajatele:

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

MCP kasutamiseks ei pea koodi kirjutama. API kasutamine on valikuline neile edasijõudnud kasutajatele, kes juba kasutavad avalikku API-t.

Mis sul juba olemas on?

Organisatsiooni Analytics-lehel jaotises Seaded on juba valitud vahekaardid praeguse arveldusperioodi kohta. Koolide ja klassiruumide vahelehed on Ülevaade, Kasutus, Mõju, Turvalisus, Populaarsed kasutajad ja Kõik kasutajad. Meeskondadel on vahelehed Üldine, Padletid ja Kasutajad või Ülevaade, Kasutus, Mõju, Populaarsed kasutajad ja Kõik kasutajad, kui sinu Meeskonnal on uus Analyticsi leht (beetaversioon).

Kasuta esipaneeli, kui soovid kiiret visuaalset ülevaadet. Kasuta MCP-d või API-t, kui vajad kohandatud lõiget, millele vahelehed selget vastust ei anna.

Mida MCP / API lisab?

Esipaneelil on valitud vahelehed. MCP ja API võimaldavad küsida täpselt vajalikku lõiget:

  • Lihtsas keeles küsimused sinu tehisintellekti kliendis ("millised õpetajad olid eelmisel arveldusperioodil passiivsed?")
  • Kaasatuse, liikmesuse ja sisuturvalisuse mõõdikute kohandatud kombinatsioonid
  • Kuupõhised aegridad kuupäevavahemiku lõikes
  • Rollipõhised lõiked (õpetajad vs. õpilased, loojad vs. kaasautorid)
  • Populaarseimad padletid, kasutajad ja meedia soovitud järjestuses
  • Vastused, mida saad kopeerida kvartaliülevaatesse või pikendamise esitlusse
Sisuturvalisuse mõõdikud (skannitud üksused, märgistatud üksused, tuvastamismäär) on saadaval ainult koolidele ja klassiruumidele. Kui küsid neid Meeskonna organisatsiooni kohta, saad vastuseks vea, mitte nulli.

Kiire alustamine Padlet MCP-ga

  1. Ühenda Padlet MCP oma tehisintellekti kliendis. Kasuta serveri URL-i https://mcp.padlet.com. Täielikud seadistusjuhised leiad artiklist Padlet MCP Server.
  2. Logi sisse ja anna luba selle organisatsiooni administraatorina, mille kohta soovid päringuid teha. Klassiruumis saab analüütikat vaadata ka õpetaja.
  3. Küsi lihtsas keeles. Sa ei pea sisemiste tööriistade nimesid teadma. Ütle tehisintellekti assistendile, mida soovid oma kooli, klassiruumi või Meeskonna kohta teada, ja 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 omast maha jääda.
Assistent tegutseb sinu nimel. See saab vaadata ainult analüütikat, millele sinu sisselogitud kontol on juurdepääs.

Valikuline: organisatsiooni analüütika API

Kas eelistad ise skripti kirjutada? Kasuta avalikku API-t administraatori API-võtmega (või klassiruumi puhul õpetaja võtmega).

  1. Loo või kopeeri API-võti seadete arendajalehel. Lisateavet leiad artiklist Avalik API.
  2. Leia oma organisatsiooni ID käsuga GET /me?include=organizations. Otsi wksp_-ga algavat ID-d. Aadressil padlet.org asuvaid org_-organisatsioone see otspunkt veel ei toeta.
  3. Saada päringuga POST aadressile /organizations/{org_id}/analytics soovitud mõõdikud.
  4. Kui vastus on 202 või meta.pending pole tühi, oota päises määratud Retry-After-i aega ja saada täpselt sama päring uuesti. Analüütika arvutatakse taustal, nii et ootel mõõdik vastusest puudub. Ära kunagi käsitle seda nullina.
Täielikud päringuvormingud, mõõdikute kataloog ja näited leiad dokumendist Organisatsiooni analüütika lugemine.

Kes saab seda kasutada?

Organisatsiooni analüütika Padlet MCP ja API kaudu on saadaval Padlet for Schools ja Meeskonna kontode omanikele ja administraatoritele ning klassiruumi kontode omanikele ja õpetajatele. Sul pole vaja paluda Padletil seda sisse lülitada.

Praegu toetatakse ainult wksp_-organisatsioone.

Näidispäringud

Need on alustuseks sobivad päringud, mille saad MCP klienti kopeerida. Kohanda sõnastust oma kooli, klassiruumi või Meeskonna järgi ning kontrolli numbreid Analyticsi lehelt, kui koostad klientidele mõeldud esitlust.

  • "Mitu õpetajat oli meie koolis sel arveldusperioodil aktiivne, võrreldes litsentside arvuga, ja millistel kuudel näitajad langesid?"
  • "Millistel organisatsiooni padletitel on kõige rohkem vaatamisi? Nimeta 3 populaarseimat tahvlit/sandbox'i."
  • "Millised õpetaja rolliga liikmed pole Padletit viimase 12 kuu jooksul kasutanud?"
  • "Mitmel liikmel pole e-posti domeeniks <ouremaildomain.edu>?"
Küsi vajalikku lõiget: kuupõhist aegrida, rollifiltrit, postituste või külastajate arvu järgi populaarseimaid padleteid või kooli või klassiruumi sisuturvalisuse koondandmeid. Assistent seostab sinu küsimuse saadaolevate mõõdikutega.

Milles on esipaneel endiselt parem?

Kasuta seadete Analyticsi lehte, kui soovid järgmist:

  • Visuaalne Ülevaatebänner, võimaluste esiletõsted ja ühe klõpsuga professionaalse arengu taotlus
  • Kõik kasutajad / Kasutajad tabel koos otsingu, rollifiltrite ja ühe klõpsuga CSV allalaadimisega
  • Valitud perioodi aktiivsete ja passiivsete õpetajate allalaaditavad loendid vahekaardilt Ülevaade (koolid ja klassiruumid)

MCP ja API on eriti kasulikud siis, kui valitud vahelehed ei vasta täpselt küsimusele, mida vajad demo või lepingu pikendamise aruteluks.

Piirangud:

  • Päringupiirang: 60 päringut tunnis API-võtme ja organisatsiooni kohta, sh pärast 202 vastust tehtavad korduspäringud
  • Kuupäevavahemik: ühe päringuga kuni 24 kuud
  • Sisuturvalisus: ainult koolidele ja klassiruumidele. Meeskonnad saavad nende mõõdikute puhul vastuseks 400
  • Liikmete arv: kajastab praegust nimekirja, mitte ajaloolist ülevaadet sellest, kes kuulus organisatsiooni konkreetsel ajal
  • Ootel ≠ null: arvutamisel olev mõõdik vastusest puudub; ära käsitle seda nullina
  • Organisatsiooni tüüp: praegu ainult wksp_

Korduma kippuvad küsimused

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

Kõik ligipääsukeelud näevad ühesugused välja: nii tundmatu organisatsiooni kui ka juurdepääsu puudumise korral tagastatakse 404. Kontrolli, et logisid sisse selle organisatsiooni administraatorina (või klassiruumi puhul õpetajana) ning et tegu on wksp_-organisatsiooniga. Ikka ei õnnestu? Võta ühendust klienditoega.

Kas pean koodi kirjutama?

Ei. Ühenda Padlet MCP, logi sisse administraatorina ja küsi lihtsas keeles. API kasutamine on valikuline arendajatele ja edasijõudnud kasutajatele, kes juba kasutavad avalikku API-t.

Kas see on sama mis avalik API?

Need on seotud, kuid tegu pole sama kasutusvõimalusega. Avalik API on mõeldud arendajatele, kes kasutavad API-võtit. Padlet MCP on mõeldud tehisintellekti assistentidele, millele annad loa sisselogimise kaudu. Mõlemaga saab organisatsiooni analüütikale ligi ning 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 klassiruumi õpetaja. Assistendil on täpselt samad õigused kui kontol, millega sisse logisid, mitte midagi enamat.

MCP klient ei paista analüütikast teadvat. Mida peaksin proovima?

Mõnel kliendil võtab tööriistade loendi uuendamine aega. Proovi Padlet MCP uuesti ühendada, minna üle mõnele teisele MCP-ga ühilduvale kliendile või kasutada otse organisatsiooni analüütika API-t. Kui probleem püsib, võta meiega ühendust.

Seotud artiklid

Была ли эта статья полезной?

Похожие статьи