Jak si v Padlet MCP vyžádám analýzy pro správce (beta)?

Potřebujete čísla, která nástěnka Admina školy nebo Týmu nerozděluje tak, jak potřebujete? Propojte Padlet MCP s asistentem s umělou inteligencí a zeptejte se běžným jazykem na analytické údaje o škole, třídě nebo Týmu – případně sami zavolejte rozhraní API pro analytické údaje organizace.

Pro koho je tento článek určen

Tento článek je určen:

• Vlastníkům a Adminům účtů Padlet pro školy nebo Tým
• Vlastníkům a učitelům účtů Třída

Pro použití MCP nemusíte psát kód. Rozhraní API je volitelné a určené zkušeným uživatelům, kteří už pracují s veřejným rozhraním API.

Co už máte k dispozici

Stránka Analytika vaší organizace v Nastavení už nyní zobrazuje přehledné karty za aktuální fakturační období. Školy a třídy mají karty Přehled, Využití, Dopad, Bezpečnost, Nejaktivnější uživatelé a Všichni uživatelé. Týmy mají karty Obecné, Padlety a Uživatelé.

• Analytika školního účtu (Padlet pro školy a Třída)
• Analytika účtu Týmu

Chcete-li rychlý vizuální přehled, použijte nástěnku. Pokud potřebujete vlastní rozdělení dat, které karty přesně neposkytují, použijte MCP nebo rozhraní API.

Co přináší MCP / rozhraní API

Nástěnka obsahuje přehledné karty. MCP a rozhraní API vám umožňují požádat přesně o rozdělení dat, které potřebujete:

• Otázky v běžném jazyce v klientovi s umělou inteligencí („Kteří učitelé byli v minulém fakturačním období neaktivní?“)
• Vlastní kombinace metrik zapojení, členství a bezpečnosti obsahu
• Měsíční přehledy za zadané období
• Rozdělení podle rolí (učitelé a studenti, tvůrci a přispěvatelé)
• Nejlepší padlety, uživatelé a média seřazená podle vašich pokynů
• Odpovědi, které můžete vložit do prezentace pro čtvrtletní obchodní přehled nebo prodloužení smlouvy

Rychlý začátek s Padlet MCP

1. Připojte Padlet MCP ve svém klientovi s umělou inteligencí. Použijte adresu serveru https://mcp.padlet.com. Úplný postup nastavení najdete v článku Server Padlet MCP.
2. Přihlaste se a udělte oprávnění jako Admin organizace, jejíž údaje chcete zjišťovat. V účtu Třída může analytické údaje získávat také učitel.
3. Ptejte se běžným jazykem. Nemusíte uvádět názvy interních nástrojů. Řekněte asistentovi s umělou inteligencí, co chcete vědět o své škole, třídě nebo Týmu, a on za vás použije Padlet MCP.

Tady je příklad:

Volitelné: rozhraní API pro analytické údaje organizace

Chcete si vytvořit vlastní skript? Použijte veřejné rozhraní API s klíčem API typu Admin (nebo s klíčem učitele v účtu Třída).

1. Vytvořte nebo zkopírujte klíč API na stránce pro vývojáře v Nastavení. Podrobnosti najdete v článku Veřejné rozhraní API.
2. Vyhledejte ID své organizace pomocí příkazu GET /me?include=organizations. Potřebujete ID wksp_ – organizace org_ na webu padlet.org zatím tento koncový bod nepodporují.
3. Odešlete požadavek POST na adresu /organizations/{org_id}/analytics s požadovanými metrikami.
4. Pokud je odpověď 202 nebo není meta.pending prázdné, počkejte po dobu uvedenou v hlavičce Retry-After a odešlete totožný požadavek znovu. Analytické údaje se počítají asynchronně – čekající metrika v odpovědi chybí, není rovna nule. Čekající hodnotu nikdy nepovažujte za nulu.

Přístup v rámci pilotního provozu

Příklady pokynů

Toto jsou návrhy, které můžete vložit do klienta MCP. Upravte formulaci podle své školy, třídy nebo Týmu a před přípravou prezentace pro zákazníky ověřte čísla na stránce Analytika.

• „Kolik učitelů bylo v tomto fakturačním období v naší škole aktivních v porovnání s počtem licencí a ve kterých měsících došlo k poklesu?“
• „Které padlety v naší organizaci mají nejvíc zobrazení? Ukaž mi tři nejlepší nástěnky nebo sandboxy.“
• „Kteří členové s rolí učitele Padlet za posledních 12 měsíců nepoužili?“
• „Kolik členů nemá e-mailovou doménu <ouremaildomain.edu>?“

V čem je nástěnka stále lepší

Stránku Analytika v Nastavení použijte, pokud chcete:

• Vizuální banner Přehled, upozornění na největší příležitosti a možnost odeslat žádost o profesní rozvoj jedním kliknutím
• Tabulku Všichni uživatelé / Uživatelé s vyhledáváním, filtry rolí a možností stáhnout CSV jedním kliknutím
• Stažitelné seznamy aktivních a neaktivních učitelů za vybrané období na kartě Přehled (školy a třídy)
• Zobrazení, které nevyžaduje zařazení do pilotního provozu – stránka Nastavení je dostupná oprávněným rolím bez přihlášení k rozhraní API

MCP a rozhraní API vyniknou, když přehledné karty neodpovídají přesně na otázku, kterou potřebujete zodpovědět při ukázce nebo jednání o prodloužení smlouvy.

Omezení:

• Omezení četnosti požadavků: 60 požadavků za hodinu na jeden klíč API a organizaci, včetně opakovaných dotazů po odpovědi 202
• Rozsah dat: v jednom požadavku lze zadat nejvýše 24 měsíců
• Bezpečnost obsahu: pouze školy a třídy – u těchto metrik vrátí Týmy chybu 400
• Počty členů: vycházejí ze současného seznamu členů, nikoli z historického přehledu členství v daném okamžiku
• Čekající ≠ nula: metrika, jejíž výpočet stále probíhá, v odpovědi chybí; nepovažujte ji za nulu
• Typ organizace: prozatím pouze wksp_

Časté dotazy

Související články

• Server Padlet MCP
• Analytika školního účtu
• Analytika účtu Týmu
• Veřejné rozhraní API
• Čtení analytických údajů organizace (dokumentace pro vývojáře)