Miten pyydän Padlet MCP:ltä järjestelmänvalvojan analytiikkaa (beta)?

Carla Sesen profiilikuvaPäivitetty 13 tuntia sitten käyttäjän Carla Sese toimesta

Eivätkö koulun tai Tiimin ylläpitäjän ohjauspaneelin luvut jakaudu haluamallasi tavalla? Yhdistä Padlet MCP tekoälyavustajaan ja pyydä koulun, luokkahuoneen tai Tiimin analytiikkaa tavallisella kielellä – tai kutsu organisaation analytiikka-API:a itse.

Katso täydellinen REST-viite (mittariluettelo, pyyntöjen rakenteet ja virhekoodit) docs.padlet.dev-sivuston osiosta Lue organisaation analytiikasta.

Kenelle tämä on tarkoitettu?

Tämä artikkeli on tarkoitettu seuraaville:

  • Omistajille ja ylläpitäjille, joilla on Padlet for Schools- tai Tiimi-tili
  • Omistajille ja opettajille, joilla on Classroom-tili

MCP:n käyttö ei edellytä koodaamista. API on valinnainen vaihtoehto tehokäyttäjille, jotka jo käyttävät julkista API:a.

Mitä sinulla jo on käytössäsi

Organisaatiosi Asetusten Analytiikka-sivulla näkyy jo kuluvan laskutuskauden valikoidut välilehdet. 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.

Käytä ohjauspaneelia, kun haluat nopeasti visuaalisen yhteenvedon. Käytä MCP:tä tai API:a, kun tarvitset mukautetun näkymän, johon välilehtien tiedot eivät vastaa riittävän tarkasti.

Mitä MCP / API tarjoaa lisää

Ohjauspaneelissa on valikoidut välilehdet. MCP:n ja API:n avulla voit pyytää juuri tarvitsemasi näkymän:

  • Esitä kysymyksiä tavallisella kielellä tekoälysovelluksessasi (”Ketkä opettajista eivät olleet aktiivisia viime laskutuskaudella?”)
  • Yhdistä haluamallasi tavalla aktiivisuus-, jäsenyys- ja sisällön turvallisuuteen liittyviä mittareita
  • Kuukausittaiset aikasarjat valitulla ajanjaksolla
  • Roolikohtaiset näkymät (opettajat ja opiskelijat, sisällöntuottajat ja avustajat)
  • Suosituimmat padletit, käyttäjät ja mediat pyytämälläsi järjestyksellä
  • Vastaukset, jotka voit liittää neljännesvuosikatsaukseen tai uusimisesitykseen
Sisällön turvallisuuteen liittyvät mittarit (tarkistetut kohteet, merkityt kohteet, tunnistusaste) ovat käytettävissä vain kouluissa ja luokkahuoneissa. Jos pyydät niitä Tiimi-organisaatiolta, saat virheen etkä nollatulosta.

Aloita nopeasti Padlet MCP:n käyttö

  1. Yhdistä Padlet MCP tekoälysovellukseesi. Käytä palvelimen URL-osoitetta https://mcp.padlet.com. Täydelliset käyttöönotto-ohjeet ovat artikkelissa Padlet MCP -palvelin.
  2. Kirjaudu sisään ja anna valtuutus sen organisaation ylläpitäjänä, jonka tietoja haluat kysellä. Classroomissa myös opettaja voi hakea analytiikkaa.
  3. Esitä kysymys tavallisella kielellä. Sisäisiä työkaluja ei tarvitse nimetä. Kerro tekoälyavustajalle, mitä haluat tietää koulustasi, luokkahuoneestasi tai Tiimistäsi, niin se käyttää Padlet MCP:tä puolestasi.

Tässä esimerkki:

Jos tietty MCP-sovellus ei vielä näytä analytiikan vastauksia, kokeile toista MCP-yhteensopivaa sovellusta tai käytä sen sijaan organisaation analytiikka-API:a. Sovellusten tuki voi laahata palvelimen kehityksen jäljessä.
Avustaja toimii sinun puolestasi. Se voi hakea vain sellaista analytiikkaa, jonka tarkasteluun kirjautuneella tililläsi on oikeus.

Valinnainen: organisaation analytiikka-API

Haluatko mieluummin tehdä skriptin itse? Käytä julkista API:a ylläpitäjän API-avaimella (tai opettajan avaimella Classroomissa).

  1. Luo tai kopioi API-avain Asetusten Developer-sivulta. Lisätietoja on julkista API:a käsittelevässä artikkelissa.
  2. Etsi organisaatiosi tunnus komennolla GET /me?include=organizations. Tarvitset wksp_-tunnuksen – padlet.org-sivuston org_-organisaatioita ei vielä tueta tässä päätepisteessä.
  3. Lähetä POST-pyyntö osoitteeseen /organizations/{org_id}/analytics ja sisällytä siihen haluamasi mittarit.
  4. Jos vastaus on 202 tai meta.pending ei ole tyhjä, odota Retry-After-arvoa ja lähetä täsmälleen sama pyyntö uudelleen. Analytiikka lasketaan asynkronisesti – odottavaa mittaria ei ole vastauksessa, eikä sen arvo ole nolla. Älä koskaan käsittele odottavaa arvoa nollana.
Täydelliset pyyntörakenteet, mittariluettelo ja esimerkit löytyvät osiosta Lue organisaation analytiikasta.

Pilottiohjelmaan pääsy

Organisaation analytiikan käyttö MCP:n ja API:n kautta on pilottivaiheessa vapaaehtoista. Padlet ottaa mukaan organisaation omistajan – pelkkä ylläpitäjän rooli ei riitä. Ennen kuin organisaatiosi on otettu mukaan, jokainen kutsu palauttaa virheen 404 (sama vastaus kuin tuntemattomasta organisaatiosta).

Tällä hetkellä tuetaan vain wksp_-organisaatioita.

Ota yhteyttä tukeen ja pyydä heitä ottamaan organisaatiosi omistaja mukaan ylläpitäjän analytiikkaa varten.

Esimerkkikehotteita

Nämä ovat aloituskehotteita, jotka voit liittää MCP-sovellukseesi. Muokkaa sanamuotoja koulullesi, luokkahuoneellesi tai Tiimillesi sopiviksi – ja tarkista luvut Analytiikka-sivulta, kun valmistelet asiakkaille esitettävää aineistoa.

  • ”Kuinka monta opettajaa oli aktiivisia tänä laskutuskautena koulussamme lisenssien määrään verrattuna, ja minä kuukausina aktiivisuus laski?”
  • ”Millä organisaatiomme padleteista on eniten katselukertoja? Näytä kolme suosituinta taulua/sandboxia.”
  • ”Ketkä opettajan roolissa olevista jäsenistä eivät ole käyttäneet Padletiä viimeisten 12 kuukauden aikana?”
  • ”Kuinka monen jäsenen sähköpostiosoitteessa ei ole verkkotunnusta <ouremaildomain.edu>?”
Pyydä tarvitsemaasi näkymää: kuukausittaista aikasarjaa, roolisuodatinta, julkaisu- tai kävijämäärän perusteella suosituimpia padletteja tai koulun tai luokkahuoneen sisällön turvallisuuteen liittyviä kokonaistietoja. Avustaja yhdistää kysymyksesi saatavilla oleviin mittareihin.

Missä ohjauspaneeli on edelleen parempi

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

  • Visuaalisen Yleiskatsaus-bannerin, suosituimmat mahdollisuudet -nostot ja yhden napsautuksen PD-pyynnön
  • Kaikki käyttäjät / Käyttäjät -taulukon, jossa on haku, roolisuodattimet ja CSV-tiedoston lataus yhdellä napsautuksella
  • Valitun ajanjakson aktiivisten ja passiivisten opettajien ladattavat luettelot Yleiskatsaus-välilehdeltä (koulut ja luokkahuoneet)
  • Näkymän, joka ei edellytä pilottiohjelmaan mukaan ottamista – Asetukset-sivu on sellaisenaan niiden käytettävissä, joilla on siihen oikeuttava rooli, eikä API:n käytön erillistä hyväksyntää tarvita

MCP ja API ovat parhaimmillaan silloin, kun valikoidut välilehdet eivät vastaa täsmällisesti kysymykseen, johon tarvitset vastauksen esittelyä tai sopimuksen uusimisesta keskustelua varten.

Rajoitukset:

  • Pyynnön 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 virheen 400
  • Jäsenmäärät: perustuvat nykyiseen jäsenlistaan, eivät historialliseen tilannekuvaan senhetkisistä jäsenistä
  • Odottaa ≠ nolla: yhä laskettavaa mittaria ei näy vastauksessa. Älä käsittele sitä nollana.
  • Organisaatiotyyppi: tällä hetkellä vain wksp_

Usein kysytyt kysymykset

Miksi saan virheen 404 pyytäessäni analytiikkaa?

Päätepisteen ollessa pilottivaiheessa kaikista estetyistä pyynnöistä tulee sama vastaus: organisaatiota ei ole otettu mukaan, sitä ei tunneta tai käyttöoikeus puuttuu – kaikissa tapauksissa palautuu 404. Varmista, että olet kirjautunut sisään ylläpitäjänä (tai opettajana Classroomissa), organisaatiosi tunnus alkaa wksp_ ja Padlet on ottanut mukaan organisaation omistajan. Pyydä mukaan ottamista ottamalla yhteyttä tukeen.

Tarvitseeko minun kirjoittaa koodia?

Ei. Yhdistä Padlet MCP, kirjaudu sisään ylläpitäjänä ja esitä kysymys tavallisella kielellä. API on valinnainen vaihtoehto kehittäjille ja tehokäyttäjille, jotka jo käyttävät julkista API:a.

Onko tämä sama asia kuin julkinen API?

Ne liittyvät toisiinsa, mutta ovat eri käyttöliittymiä. Julkinen API on kehittäjille, jotka käyttävät API-avainta. Padlet MCP on tekoälyavustajille, joille annat valtuutuksen kirjautumalla sisään. Molemmilla voi käyttää organisaation analytiikkaa, kun organisaatiosi on otettu mukaan ohjelmaan. Voit käyttää kumpaa tahansa tai molempia.

Voivatko opiskelijat tai muut kuin ylläpitäjät tarkastella organisaation analytiikkaa tällä tavalla?

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

MCP-sovellukseni ei tunnu tunnistavan analytiikkaa. Mitä voisin 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-API:a. Jos et vieläkään pääse käyttämään sitä, vaikka sinut on otettu mukaan, ota meihin yhteyttä.

Aiheeseen liittyvää

Oliko tästä artikkelista apua?

Aiheeseen liittyvät artikkelit