Hogyan kérhetem le a Padlet MCP-től az Admin Analytics (béta) funkciót?

Szüksége van olyan számokra, amelyeket az iskolai vagy csapatszintű Admin irányítópult nem a kívánt bontásban jelenít meg? Csatlakoztassa a Padlet MCP-t egy AI-asszisztenshez, és kérdezzen rá az iskolai, tantermi vagy csapatszintű elemzésekre hétköznapi nyelven – vagy hívja meg közvetlenül a szervezeti elemzési API-t.

Kinek szól?

Ez a cikk a következőknek szól:

• Tulajdonosoknak és adminoknak a Padlet for Schools vagy Team-fiókokban
• Tulajdonosoknak és tanároknak a Classroom-fiókokban

Az MCP használatához nem kell kódot írnia. Az API használata nem kötelező; azoknak a haladó felhasználóknak szól, akik már használják a Public API-t.

Amivel már rendelkezik

A szervezete Elemzések oldala a Beállításokban már megjeleníti az aktuális számlázási időszakra vonatkozó, előre összeállított füleket. Az iskolák és a tantermek az Áttekintés, Használat, Hatás, Biztonság, Legaktívabb felhasználók és Összes felhasználó füleket kapják. A csapatoknál az Általános, Padletek és Felhasználók fülek érhetők el; ha a csapata az új Elemzések oldalt használja (béta), akkor az Áttekintés, Használat, Hatás, Legaktívabb felhasználók és Összes felhasználó fülek jelennek meg.

• Iskolai fiók elemzései (Padlet for Schools és Classroom)
• Csapatfiók elemzései

Ha gyors, vizuális áttekintésre van szüksége, használja az irányítópultot. Ha olyan egyéni bontásra van szüksége, amelyre a fülek nem adnak egyértelmű választ, használja az MCP-t vagy az API-t.

Mit tesz hozzá az MCP / API?

Az irányítópulton előre összeállított fülek találhatók. Az MCP-vel és az API-val pontosan a kívánt bontásban kérhet adatokat:

• Hétköznapi nyelven feltehető kérdések az AI-kliensben („Mely tanárok voltak inaktívak az előző számlázási időszakban?”)
• Az aktivitási, tagsági és tartalombiztonsági mérőszámok egyéni kombinációi
• Havi adatsorok egy adott dátumtartományra
• Szerepkör szerinti bontások (tanárok és diákok, létrehozók és közreműködők)
• A kért szempont szerint rangsorolt legnépszerűbb padletek, felhasználók és médiatartalmak
• Válaszok, amelyeket beilleszthet egy negyedéves üzleti áttekintőbe vagy megújítási prezentációba

Gyors kezdés a Padlet MCP-vel

1. Csatlakoztassa a Padlet MCP-t az AI-klienséhez. Használja a szerver URL-címét: https://mcp.padlet.com. A teljes beállítási útmutatót a Padlet MCP Server oldalon találja.
2. Jelentkezzen be, majd engedélyezze a hozzáférést annak a szervezetnek az adminjaként, amelyről adatokat szeretne lekérni. Classroom esetén tanárként is lekérheti az elemzéseket.
3. Tegye fel a kérdését hétköznapi nyelven. Nem kell megneveznie a belső eszközöket. Mondja el az AI-asszisztensnek, mit szeretne megtudni az iskolájáról, tanterméről vagy csapatáról, és az Ön nevében a Padlet MCP-t fogja használni.

Íme egy példa:

Nem kötelező: szervezeti elemzési API

Inkább saját maga készítene belőle szkriptet? Használja a Public API-t egy admin API-kulccsal (Classroom esetén tanári kulccsal is).

1. Hozzon létre vagy másoljon le egy API-kulcsot a Beállítások Fejlesztői oldaláról. A részleteket a Public API cikkben találja.
2. Keresse meg a szervezete azonosítóját a GET /me?include=organizations végponttal. Egy wksp_ azonosítóra van szüksége – a padlet.org oldalon található org_ szervezeteket ez a végpont egyelőre nem támogatja.
3. Küldjön egy POST kérést a /organizations/{org_id}/analytics végpontra a kívánt mérőszámokkal.
4. Ha a válasz 202, vagy a meta.pending nem üres, várja meg a Retry-After időtartam végét, majd küldje el újra ugyanazt a kérést. Az elemzések aszinkron módon készülnek – a feldolgozás alatt álló mérőszám nem szerepel a válaszban, nem pedig nulla. Soha ne tekintse a függőben lévő értéket nullának.

Kísérleti hozzáférés

Példakérdések

Ezeket a mintakérdéseket bemásolhatja az MCP-kliensbe. Igazítsa a megfogalmazást az iskolájához, tanterméhez vagy csapatához, és mielőtt ügyfeleknek szánt prezentációt készít, ellenőrizze az adatokat az Elemzések oldalon.

• „Hány aktív tanárunk volt ebben a számlázási időszakban az iskolánkban a licencek számához képest, és mely hónapokban csökkent az aktivitás?”
• „Mely szervezeti padleteket tekintették meg a legtöbbször? Sorold fel a 3 legnépszerűbb táblát/sandboxot.”
• „Mely tanári szerepkörű tagok nem használták a Padletet az elmúlt 12 hónapban?”
• „Hány olyan tag van, akinek az e-mail-címe nem a <ouremaildomain.edu> tartományhoz tartozik?”

Amiben az irányítópult továbbra is jobb

Használja a Beállítások Elemzések oldalát, ha a következőkre van szüksége:

• Vizuális Áttekintés fejléc, „Legfontosabb lehetőség” kiemelések és egylépéses szakmai továbbképzési kérelem
• Az Összes felhasználó / Felhasználók táblázat keresési lehetőséggel, szerepkör szerinti szűrőkkel és egylépéses CSV-letöltéssel
• Az adott időszak aktív és inaktív tanárainak letölthető listája az Áttekintés fülről (iskolák és tantermek esetén)
• Olyan nézet, amelyhez nincs szükség a kísérleti programba való felvételre – a Beállítások oldal megfelelő szerepkörökkel API-hozzáférés engedélyezése nélkül is elérhető

Az MCP és az API akkor nyújtja a legtöbbet, ha az előre összeállított fülek nem adnak választ arra a konkrét kérdésre, amely egy bemutatóhoz vagy megújítási egyeztetéshez szükséges.

Korlátozások:

• Híváskorlát: óránként 60 kérés API-kulcsonként és szervezetenként, beleértve a 202 válasz utáni ismételt lekérdezéseket is
• Dátumtartomány: egy kérés legfeljebb 24 hónapra vonatkozhat
• Tartalombiztonság: csak iskolák és tantermek esetén – a csapatok 400 hibát kapnak ezekre a mérőszámokra
• Tagsági létszámok: az aktuális névsort tükrözik, nem azt, hogy egy adott időpontban kik tartoztak a szervezethez
• A függőben lévő nem nulla: a még feldolgozás alatt álló mérőszám hiányzik a válaszból; ne tekintse nullának
• Szervezettípus: egyelőre csak wksp_

Gyakori kérdések

Kapcsolódó cikkek

• Padlet MCP Server
• Iskolai fiók elemzései
• Csapatfiók elemzései
• Public API
• Szervezeti elemzések lekérése (fejlesztői dokumentáció)