Hogyan kérhetem le a Padlet MCP-től az Admin Analytics adatokat?

Carla Sese 的個人檔案照片由 Carla Sese 於 4 nappal ezelőtt 更新

Szükséged van olyan adatokra, amelyeket az iskola vagy a csapat adminisztrációs irányítópultja nem bont le a kívánt módon? Csatlakoztasd a Padlet MCP-t egy mesterséges intelligencia-asszisztenshez, és egyszerű nyelven kérj iskolai, osztálytermi vagy csapatelemzéseket, vagy hívd meg magad a szervezeti elemzési API-t.

A teljes REST-referencia (mutatókatalógus, kérelemformátumok és hibakódok) a docs.padlet.dev oldalon található Szervezeti elemzések olvasása című részben található.

Kiknek szól ez a cikk

Ez a cikk a következő felhasználóknak szól:

  • A Padlet for Schools vagy Team fiókok tulajdonosai és rendszergazdái
  • A Classroom-fiókok tulajdonosai és tanárai

Az MCP-útvonal használatához nem szükséges kódot írni. Az API-útvonal opcionális azoknak a haladó felhasználóknak, akik már dolgoznak a nyilvános API-val.

Ami már rendelkezésre áll

A szervezet Beállítások menüpontjában található Elemzések oldalon már megjelennek a jelenlegi számlázási időszakra vonatkozó, válogatott lapok. Az iskolák és osztálytermek esetében az Áttekintés, Használat, Hatás, Biztonság, Legaktívabb felhasználók és Minden felhasználó lapok jelennek meg. A csapatok esetében az Általános, Padletek és Felhasználók lapok jelennek meg, vagy az Áttekintés, Használat, Hatás, Legaktívabb felhasználók és Minden felhasználó lapok, ha a csapat rendelkezik az új Elemzések oldallal (béta).

Használja a műszerfalat, ha gyors vizuális áttekintésre van szüksége. Használja az MCP-t vagy az API-t, ha olyan egyedi adatokra van szüksége, amelyekre a fülek nem adnak egyértelmű választ.

Mit nyújt az MCP / API

A műszerfal válogatott lapokból áll. Az MCP és az API segítségével pontosan azt a szeletet kérheted, amire szükséged van:

  • Egyszerű nyelvű kérdések az AI-kliensben („melyik tanárok voltak inaktívak az elmúlt számlázási időszakban?”)
  • Az elkötelezettség, a tagság és a tartalombiztonsági mutatók egyedi kombinációi
  • Havi sorozatok egy adott dátumtartományon belül
  • Szerepkörök szerinti szeletek (tanárok vs. diákok, alkotók vs. közreműködők)
  • A legnépszerűbb padletek, felhasználók és médiaelemek az Ön által megadott rangsor szerint
  • Válaszok, amelyeket beilleszthet egy negyedéves eredménybeszámolóba (QBR) vagy megújítási prezentációba
A tartalombiztonsági mutatók (átvizsgált elemek, jelzett elemek, észlelési arány) kizárólag iskolák és osztálytermek számára érhetők el. Ha ezeket egy Team szervezet esetében kéri, hibaüzenet jelenik meg, nem pedig nulla érték.

Gyors kezdés a Padlet MCP-vel

  1. Csatlakoztassa a Padlet MCP-t az AI-klienséhez. Használja a szerver URL-jét https://mcp.padlet.com. A teljes beállítási útmutató a Padlet MCP Server oldalon található.
  2. Jelentkezzen be, és engedélyezze a lekérdezni kívánt szervezet rendszergazdájaként. Osztálytermi környezetben a tanár is lekérheti az elemzéseket.
  3. Kérdezzen egyszerű nyelven. Nem kell megneveznie a belső eszközöket. Mondja el az AI-asszisztensnek, mit szeretne tudni az iskolájáról, osztályáról vagy csapatáról, és az Ön nevében a Padlet MCP-t fogja használni.

Íme egy példa:

Ha egy adott MCP-kliens még nem jeleníti meg az elemzési eredményeket, próbáljon ki egy másik MCP-kompatibilis klienst, vagy használja helyette a szervezeti elemzési API-t. Előfordulhat, hogy a kliens támogatása elmarad a szerverétől.
Az asszisztensed úgy viselkedik, mintha te lennél. Csak azokat az elemzési adatokat tudja lekérni, amelyeket a bejelentkezett fiókod megtekinthet.

Opcionális: szervezeti elemzési API

Inkább saját magad írnál szkriptet? Használd a nyilvános API-t egy rendszergazdai API-kulccsal (vagy a Classroom esetében egy tanári kulccsal).

  1. Hozzon létre vagy másoljon egy API-kulcsot a Beállítások fejlesztői oldaláról. A részleteket a nyilvános API-ról szóló cikk tartalmazza.
  2. A szervezet azonosítóját a GET /me?include=organizations. Szüksége lesz egy wksp_ azonosítóra van szüksége. org_ A padlet.org oldalon található szervezeteket ez a végpont egyelőre nem támogatja.
  3. Küldjön egy POST a /organizations/{org_id}/analytics a kívánt mutatókkal.
  4. Ha a válasz 202 vagy meta.pending nem üres, várjon Retry-After és küldje el újra ugyanazt a kérést. Az elemzések a háttérben kerülnek kiszámításra, ezért a függőben lévő mutatók nem szerepelnek a válaszban. Soha ne tekintse azokat nullának.
A teljes kérésformák, a mutatókatalógus és a gyakorlati példák a Read szervezeti elemzésekben találhatók.

Ki használhatja

A Padlet MCP-n és az API-n keresztül elérhető szervezeti elemzések a Padlet for Schools és Team fiókok tulajdonosai és rendszergazdái, valamint a Classroom fiókok tulajdonosai és tanárai számára elérhetők. Nem kell kérnie a Padletet, hogy kapcsolja be.

Jelenleg csak wksp_ szervezeteket támogatja.

Példák a parancsokra

Ezek olyan kiindulási pontok, amelyeket beilleszthet az MCP-kliensébe. Igazítsa a szöveget az iskolájához, osztályához vagy csapatához, és ellenőrizze a számokat az Analytics oldalon, amikor ügyfeleknek szánt prezentációt készít.

  • „Iskolánkban ebben a számlázási időszakban hány aktív tanár volt a licencszámhoz képest, és mely hónapokban csökkent a szám?”
  • „Mely szervezeti Padlet-oldalaknak van a legtöbb megtekintése? Mutassa meg a legnépszerűbb 3 táblát/sandboxot!”
  • „Melyik tanári szerepkörrel rendelkező tagok nem használták a Padletet az elmúlt 12 hónapban?”
  • „Hány tag e-mail-címének domainje nem <ouremaildomain.edu>?”
Kérje ki a szükséges adatokat: havi sorozatot, szerepkör-szűrőt, a bejegyzések vagy látogatók száma alapján legnépszerűbb Padleteket, vagy egy iskola vagy osztály tartalombiztonsági összesítő adatait. Az asszisztens a kérdését a rendelkezésre álló mutatókhoz rendeli.

Miben jobb még mindig a műszerfal?

Maradjon a Beállítások menü Analytics oldalán, ha szeretné:

  • A vizuális Áttekintés sáv, a Legfontosabb lehetőségek kiemelések és az egy kattintással elindítható PD-kérés
  • Az „Összes felhasználó” / „Felhasználók” táblázat keresési és szerepkör-szűrőkkel, valamint egy kattintással letölthető CSV-fájllal
  • A kiválasztott időszakra vonatkozó aktív és inaktív tanárok letölthető listái az Áttekintés fülről (iskolák és osztálytermek)

Az MCP és az API akkor jönnek igazán jól, ha a szerkesztett lapok nem adnak pontos választ arra a kérdésre, amire egy bemutató vagy megújítási tárgyalás során szükséged van.

Korlátozások:

  • Kéréskorlát: óránként 60 kérés API-kulcs és szervezetenként, beleértve a 202
  • Időtartomány: legfeljebb 24 hónap egy kérésben
  • Tartalombiztonság: csak iskolák és tantermek. A Teams 400 az említett mutatókhoz
  • Tagsági számok: a jelenlegi névjegyzéket tükrözik, nem pedig egy korábbi pillanatfelvételt arról, hogy ki tartozott hozzá abban az időpontban
  • Függőben ≠ nulla: a válaszból hiányzik egy még feldolgozás alatt álló mutató; ne tekintsük nullának
  • Szervezet típusa: wksp_ jelenleg csak

GYIK

Miért kapok 404-es hibát, amikor elemzéseket kérek?

Minden elutasítás ugyanúgy néz ki: ismeretlen szervezet vagy nincs hozzáférés – mindkettő ezt a hibát eredményezi 404. Ellenőrizze, hogy bejelentkezett-e az adott szervezet rendszergazdájaként (vagy tanárként a Classroom szolgáltatásban), és hogy az egy wksp_ szervezetről van szó. Még mindig nem sikerült? Fordulj az ügyfélszolgálathoz.

Kell kódot írnom?

Nem. Csatlakozz a Padlet MCP-hez, jelentkezz be rendszergazdaként, és egyszerű nyelven fogalmazd meg a kérésedet. Az API-útvonal opcionális azoknak a fejlesztőknek és haladó felhasználóknak, akik már használják a nyilvános API-t.

Ez ugyanaz, mint a nyilvános API?

Kapcsolódik hozzá, de nem ugyanaz a termékfelület. A nyilvános API az API-kulcsot használó fejlesztőknek szól. A Padlet MCP azoknak az AI-asszisztenseknek szól, akiket bejelentkezéssel engedélyez. Mindkettő hozzáfér a szervezeti elemzésekhez, és használhatja bármelyiket vagy mindkettőt.

A diákok vagy a nem rendszergazdák is láthatják így a szervezeti elemzéseket?

Nem. Az elemzésekhez a szervezet rendszergazdájára vagy egy Classroom-tanárra van szükség. Az asszisztens pontosan ugyanolyan hozzáféréssel rendelkezik, mint az a fiók, amellyel bejelentkezett, semmi többel.

Úgy tűnik, az MCP-kliensem nem ismeri az elemzéseket. Mit tegyek?

Egyes kliensek késleltetve frissítik az eszközlistájukat. Próbáld meg újra csatlakoztatni a Padlet MCP-t, válts át egy másik MCP-kompatibilis kliensre, vagy használd közvetlenül a szervezeti elemzési API-t. Ha továbbra is problémád van, lépj kapcsolatba velünk.

Kapcsolódó

這篇文章有幫助嗎?

相關文章