Miten pyydän Padlet MCP:ltä ylläpitäjän analytiikkaa?

Фото профілю Carla SeseОновлено 4 päivää sitten користувачем Carla Sese

Eivätkö koulun tai Tiimin ylläpitäjän ohjauspaneelin numerot ole haluamallasi tavalla jäsenneltyjä? Yhdistä Padlet MCP tekoälyavustajaan ja pyydä koulua, luokkahuonetta tai Tiimiä koskevia analytiikkatietoja tavallisella kielellä tai kutsu organisaation analytiikka-APIa itse.

REST-rajapinnan täydellinen viite (mittariluettelo, pyyntömuodot ja virhekoodit) löytyy osoitteesta Lue organisaation analytiikasta docs.padlet.dev-sivustolla.

Kenelle tämä on tarkoitettu

Tämä artikkeli on tarkoitettu seuraaville:

  • Omistajille ja ylläpitäjille Padlet for Schools- tai Tiimi-tileillä
  • Omistajille ja opettajille Classroom-tileillä

MCP-tavan käyttö ei edellytä koodin kirjoittamista. API-vaihtoehto on tarkoitettu edistyneille käyttäjille, jotka käyttävät jo Public APIa.

Mitä sinulla jo on

Organisaatiosi Asetusten Analytiikka-sivulla näkyy jo valmiiksi koostettuja välilehtiä nykyiseltä laskutuskaudelta. Kouluilla ja luokkahuoneilla on välilehdet Yleiskatsaus, Käyttö, Vaikuttavuus, Turvallisuus, Suosituimmat käyttäjät ja Kaikki käyttäjät. Tiimeillä on välilehdet Yleiset, Padletit ja Käyttäjät tai Yleiskatsaus, Käyttö, Vaikuttavuus, Suosituimmat käyttäjät ja Kaikki käyttäjät, jos Tiimilläsi on uusi analytiikkasivu (beetaversio).

Käytä ohjauspaneelia, kun haluat nopeasti visuaalisen yleiskuvan. Käytä MCP:tä tai APIa, kun tarvitset mukautetun rajauksen, johon välilehdet eivät vastaa riittävän selkeästi.

Mitä MCP / API tarjoaa

Ohjauspaneelissa on valmiiksi koostetut välilehdet. MCP:n ja API:n avulla voit pyytää juuri tarvitsemaasi rajausta:

  • Tavallisella kielellä esitettyjä kysymyksiä tekoälysovelluksessasi (”Ketkä opettajat eivät olleet aktiivisia viime laskutuskaudella?”)
  • Mukautettuja yhdistelmiä sitoutumisen, jäsenyyden ja sisällön turvallisuuden mittareista
  • Kuukausittaisia aikasarjoja ajanjaksolta
  • Roolikohtaisia rajauksia (opettajat vs. oppilaat, sisällöntuottajat vs. avustajat)
  • Suosituimmat padletit, käyttäjät ja mediat haluamallasi järjestyksellä
  • Vastauksia, jotka voit liittää neljännesvuosikatsaukseen tai uusimisesitykseen
Sisällön turvallisuutta koskevat mittarit (skannatut kohteet, merkityt kohteet, havaintoaste) ovat käytettävissä vain kouluissa ja luokkahuoneissa. Niiden pyytäminen Tiimi-organisaatiolta palauttaa virheen, ei nollaa.

Aloita Padlet MCP:n käyttö

  1. Yhdistä Padlet MCP tekoälysovellukseesi. Käytä palvelimen URL-osoitetta https://mcp.padlet.com. Täydelliset määritysohjeet ovat artikkelissa Padlet MCP Server.
  2. Kirjaudu sisään ja valtuuta käyttö organisaation ylläpitäjänä. Classroom-tilillä myös opettaja voi hakea analytiikkatietoja.
  3. Esitä kysymys tavallisella kielellä. Sisäisten työkalujen nimiä ei tarvitse mainita. Kerro tekoälyavustajalle, mitä haluat tietää koulustasi, luokkahuoneestasi tai Tiimistäsi, niin se käyttää Padlet MCP:tä puolestasi.

Tässä on esimerkki:

Jos jokin MCP-sovellus ei vielä näytä analytiikkavastauksia, kokeile toista MCP-yhteensopivaa sovellusta tai käytä sen sijaan organisaation analytiikka-APIa. Sovellusten tuki voi päivittyä palvelinta hitaammin.
Avustaja toimii sinun nimissäsi. Se voi hakea vain sellaisia analytiikkatietoja, joita kirjautuneella tililläsi on oikeus nähdä.

Valinnainen: organisaation analytiikka-API

Haluatko mieluummin tehdä skriptin itse? Käytä Public APIa ylläpitäjän API-avaimella (tai opettajan avaimella Classroom-tilillä).

  1. Luo tai kopioi API-avain Asetusten Developer-sivulta. Lisätietoja on Public API -artikkelissa.
  2. Etsi organisaatiosi tunnus komennolla GET /me?include=organizations. Etsi wksp_-tunnusta. org_-organisaatioita osoitteessa padlet.org ei vielä tueta tässä päätepisteessä.
  3. Lähetä POST-pyyntö osoitteeseen /organizations/{org_id}/analytics ja määritä haluamasi mittarit.
  4. Jos vastaus on 202 tai meta.pending ei ole tyhjä, odota Retry-After-arvon mukainen aika ja lähetä täsmälleen sama pyyntö uudelleen. Analytiikkatiedot lasketaan taustalla, joten odottava mittari puuttuu vastauksesta. Älä koskaan tulkitse sitä nollaksi.
Täydelliset pyyntömuodot, mittariluettelo ja esimerkit löytyvät artikkelista Lue organisaation analytiikasta.

Kuka voi käyttää tätä

Organisaation analytiikka Padlet MCP:n ja API:n kautta on käytettävissä Padlet for Schools- ja Tiimi-tilien omistajille ja ylläpitäjille sekä Classroom-tilien omistajille ja opettajille. Sinun ei tarvitse pyytää Padletia ottamaan sitä käyttöön.

Toistaiseksi tuetaan vain wksp_-organisaatioita.

Esimerkkikehotteita

Nämä ovat aloituskehotteita, jotka voit kopioida MCP-sovellukseesi. Muokkaa sanamuotoa koulusi, luokkahuoneesi tai Tiimisi mukaan ja tarkista luvut Analytiikka-sivulta, kun valmistelet asiakkaille esiteltävää esitystä.

  • ”Kuinka monta opettajaa oli aktiivisia koulussamme tällä laskutuskaudella lisenssien määrään verrattuna, ja minä kuukausina aktiivisuus laski?”
  • ”Millä organisaatiomme padleteilla on eniten katselukertoja? Listaa kolme suosituinta taulua/sandboxia.”
  • ”Ketkä opettajan roolissa olevat jäsenet eivät ole käyttäneet Padletia viimeisten 12 kuukauden aikana?”
  • ”Kuinka monella jäsenellä ei ole sähköpostiosoitetta toimialueessa <ouremaildomain.edu>?”
Pyydä tarvitsemaasi rajausta: kuukausittaista aikasarjaa, roolisuodatusta, suosituimpia padleteja julkaisujen tai kävijöiden mukaan tai koulun tai luokkahuoneen sisällön turvallisuuden kokonaislukuja. Avustaja yhdistää kysymyksesi käytettävissä oleviin mittareihin.

Mitä ohjauspaneelissa tehdään edelleen paremmin

Käytä Asetusten Analytiikka-sivua, kun haluat:

  • Visuaalisen Yleiskatsaus-bannerin, tärkeimmät mahdollisuudet korostavat nostot ja mahdollisuuden pyytää ammatillista kehityskoulutusta yhdellä napsautuksella
  • Kaikki käyttäjät / Käyttäjät -taulukon, jossa on haku, roolisuodattimet ja CSV-tiedoston lataus yhdellä napsautuksella
  • Ladattavat luettelot valitun ajanjakson aktiivisista ja passiivisista opettajista Yleiskatsaus-välilehdeltä (koulut ja luokkahuoneet)

MCP ja API ovat parhaimmillaan silloin, kun valmiiksi koostetut välilehdet eivät vastaa täsmälliseen kysymykseen, johon tarvitset vastauksen esittelyä tai uusimisneuvottelua varten.

Rajoitukset:

  • Nopeusrajoitus: 60 pyyntöä tunnissa API-avainta ja organisaatiota kohden, mukaan lukien 202-vastauksen jälkeiset kyselyt
  • Päivämääräväli: enintään 24 kuukautta yhdessä pyynnössä
  • Sisällön turvallisuus: vain kouluille ja luokkahuoneille. Tiimit saavat näitä mittareita pyytäessään 400-virheen
  • Jäsenmäärät: kuvaavat nykyistä jäsenistöä, eivät historiallista tilannekuvaa silloisista jäsenistä
  • Odottaa ≠ nolla: yhä laskettava mittari puuttuu vastauksesta; älä tulkitse sitä nollaksi
  • Organisaation tyyppi: toistaiseksi vain wksp_

Usein kysyttyä

Miksi saan analytiikkaa pyytäessäni 404-virheen?

Kaikki estot näyttävät samanlaisilta: tuntematon organisaatio ja käyttöoikeuksien puuttuminen palauttavat molemmat 404-virheen. Tarkista, että olet kirjautunut kyseisen organisaation ylläpitäjänä (tai opettajana Classroom-tilillä) ja että kyseessä on wksp_-organisaatio. Etkö vieläkään pääse eteenpäin? Ota yhteyttä tukeen.

Tarvitseeko minun kirjoittaa koodia?

Ei. Yhdistä Padlet MCP, kirjaudu sisään ylläpitäjänä ja esitä kysymyksesi tavallisella kielellä. API-vaihtoehto on vapaaehtoinen kehittäjille ja edistyneille käyttäjille, jotka käyttävät jo Public APIa.

Onko tämä sama asia kuin Public API?

Liittyvät toisiinsa, mutta kyseessä eivät ole sama tuote. Public API on kehittäjille, jotka käyttävät API-avainta. Padlet MCP on tarkoitettu tekoälyavustajille, joille annat käyttöoikeuden kirjautumalla sisään. Molemmilla voi käyttää organisaation analytiikkaa, ja voit käyttää kumpaa tahansa tai molempia.

Voivatko oppilaat tai muut kuin ylläpitäjät nähdä organisaation analytiikan tällä tavalla?

Eivät. Analytiikan käyttö edellyttää organisaation ylläpitäjän tai Classroom-tilin opettajan oikeuksia. Avustajalla on täsmälleen samat käyttöoikeudet kuin tilillä, jolla kirjauduit sisään, ei enempää.

Vaikuttaa siltä, ettei MCP-sovellukseni tunne analytiikkaa. Mitä voin kokeilla?

Joissakin sovelluksissa työkaluluettelon päivittyminen viivästyy. Kokeile yhdistää Padlet MCP uudelleen, vaihtaa toiseen MCP-yhteensopivaan sovellukseen tai käyttää suoraan organisaation analytiikka-APIa. Jos et vieläkään pääse eteenpäin, ota meihin yhteyttä.

Aiheeseen liittyvää

Чи була ця стаття корисною?

Пов’язані статті