Jak požádat Padlet MCP o analytiku Admina?

Profilbild von Carla SeseVor před 4 dny von Carla Sese aktualisiert

Potřebujete čísla, která přehled Admin pro školu nebo Tým nerozděluje tak, jak potřebujete? Připojte Padlet MCP k asistentovi s umělou inteligencí a požádejte ho běžným jazykem o analytiku školy, třídy nebo týmu, případně sami zavolejte analytické rozhraní API organizace.

Úplnou referenční příručku REST (katalog metrik, formáty požadavků a chybové kódy) najdete v části Čtení analytiky organizace na docs.padlet.dev.

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

K použití MCP nemusíte umět psát kód. Rozhraní API je volitelné pro pokročilé uživatele, kteří již pracují s veřejným rozhraním API.

Co už máte k dispozici

Stránka Analytika vaší organizace v Nastavení již zobrazuje přehledné karty pro aktuální fakturační období. Školy a třídy mají karty Přehled, Používání, Dopad, Bezpečnost, Nejaktivnější uživatelé a Všichni uživatelé. Týmy mají karty Obecné, Padlety a Uživatelé, případně Přehled, Používání, Dopad, Nejaktivnější uživatelé a Všichni uživatelé, pokud má váš Tým novou stránku Analytika (beta).

Pokud chcete rychlý vizuální přehled, použijte nástěnku. MCP nebo rozhraní API použijte, když potřebujete vlastní pohled, který karty nedokážou přehledně zobrazit.

Co navíc nabízí MCP / API

Nástěnka obsahuje přehledné karty. MCP a rozhraní API vám umožní vyžádat si přesně takový pohled, jaký potřebujete:

  • Otázky položené běžným jazykem v klientovi AI („Kteří učitelé byli v minulém fakturačním období neaktivní?“)
  • Vlastní kombinace metrik zapojení, členství a bezpečnosti obsahu
  • Měsíční řady za zvolené období
  • Rozdělení podle rolí (učitelé vs. studenti, tvůrci vs. přispěvatelé)
  • Nejpopulárnější padlety, uživatelé a média seřazené podle vašich požadavků
  • Odpovědi, které můžete vložit do prezentace pro čtvrtletní obchodní revizi nebo obnovení smlouvy
Metriky bezpečnosti obsahu (kontrolované položky, označené položky, míra zachycení) jsou dostupné pouze pro školy a třídy. Pokud o ně požádáte v organizaci typu Tým, zobrazí se chyba, nikoli nula.

Rychlý začátek s Padlet MCP

  1. Připojte Padlet MCP ve svém klientovi AI. 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, na kterou se chcete dotazovat. V účtu Třída může analytiku 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 AI, co chcete o své škole, třídě nebo týmu zjistit, a on za vás použije Padlet MCP.

Tady je příklad:

Pokud konkrétní klient MCP zatím nezobrazuje odpovědi z analytiky, zkuste jiného klienta kompatibilního s MCP nebo použijte analytické rozhraní API organizace. Podpora klientů může za serverem zaostávat.
Asistent jedná vaším jménem. Může získávat pouze analytické údaje, které smí zobrazit váš přihlášený účet.

Volitelné: analytické rozhraní API organizace

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

  1. Vytvořte nebo zkopírujte klíč API na stránce Vývojář v Nastavení. Podrobnosti najdete v článku Veřejné rozhraní API.
  2. Vyhledejte ID organizace pomocí příkazu GET /me?include=organizations. Hledejte ID začínající na wksp_. Organizace org_ na padlet.org zatím toto koncové rozhraní nepodporují.
  3. Odešlete požadavek POST na adresu /organizations/{org_id}/analytics s požadovanými metrikami.
  4. Pokud je odpověď 202 nebo hodnota meta.pending není prázdná, počkejte po dobu uvedenou v Retry-After a odešlete totožný požadavek znovu. Analytické údaje se počítají na pozadí, takže čekající metrika v odpovědi chybí. Nikdy ji nepovažujte za nulu.
Úplné formáty požadavků, katalog metrik a praktické příklady najdete v části Čtení analytiky organizace.

Kdo ji může používat

Analytika organizace přes Padlet MCP a rozhraní API je dostupná vlastníkům a Adminům účtů Padlet pro školy a Tým a také vlastníkům a učitelům účtů Třída. Nemusíte žádat Padlet o její aktivaci.

V současné době jsou podporovány pouze organizace wksp_.

Příklady zadání

Tato zadání můžete zkopírovat do svého klienta MCP. Upravte jejich znění podle své školy, třídy nebo týmu a při přípravě prezentace pro zákazníky porovnejte čísla se stránkou Analytika.

  • „Kolik aktivních učitelů máme v této fakturační periodě ve srovnání s počtem licencí a ve kterých měsících došlo k poklesu?“
  • „Které padlety naší organizace mají nejvíce zobrazení? Uveď tři nejúspěšnější nástěnky/sandbox.“
  • „Kteří členové s rolí učitele nepoužívali Padlet posledních 12 měsíců?“
  • „Kolik členů nemá e-mailovou doménu <ouremaildomain.edu>?“
Požádejte o potřebný pohled: měsíční řadu, filtr podle role, nejpopulárnější padlety podle příspěvků nebo návštěvníků či souhrnné údaje o bezpečnosti obsahu pro školu nebo třídu. Asistent přiřadí váš dotaz k dostupným metrikám.

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

Pokud potřebujete následující údaje, použijte stránku Analytika v Nastavení:

  • Vizuální banner Přehled, upozornění na největší příležitosti a možnost jedním kliknutím požádat o profesní rozvoj
  • Tabulku Všichni uživatelé / Uživatelé s vyhledáváním, filtrováním podle rolí a stažením souboru 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)

MCP a rozhraní API jsou užitečné, když přehledné karty neodpovídají přesně na otázku, kterou potřebujete pro ukázku nebo jednání o obnovení smlouvy.

Omezení:

  • Omezení počtu 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 pokrýt nejvýše 24 měsíců
  • Bezpečnost obsahu: pouze pro školy a třídy. U týmů se pro tyto metriky zobrazí chyba 400
  • Počty členů: vycházejí z aktuálního seznamu členů, nikoli z historického přehledu toho, kdo byl členem v dané době
  • Čekající výpočet ≠ nula: metrika, která se stále počítá, v odpovědi chybí; nepovažujte ji za nulu
  • Typ organizace: zatím pouze wksp_

Časté dotazy

Proč se mi při požadavku na analytiku zobrazuje chyba 404?

Všechna zamítnutí vypadají stejně: neznámá organizace i nedostatečný přístup vracejí kód 404. Zkontrolujte, zda jste přihlášeni jako Admin dané organizace (nebo jako učitel v účtu Třída) a zda jde o organizaci wksp_. Stále si nevíte rady? Kontaktujte podporu.

Musím umět psát kód?

Ne. Připojte Padlet MCP, přihlaste se jako Admin a ptejte se běžným jazykem. Rozhraní API je volitelné pro vývojáře a pokročilé uživatele, kteří již používají veřejné rozhraní API.

Je to totéž co veřejné rozhraní API?

Souvisí spolu, ale jde o různé způsoby použití. Veřejné rozhraní API je určeno vývojářům, kteří používají klíč API. Padlet MCP je určeno asistentům AI, kterým udělíte oprávnění přihlášením. Obojí umožňuje přístup k analytice organizace a můžete používat jednu nebo obě možnosti.

Mohou tímto způsobem zobrazit analytiku organizace studenti nebo uživatelé bez práv Admina?

Ne. K analytice je potřeba mít práva Admina organizace nebo být učitelem v účtu Třída. Asistent má přesně stejná oprávnění jako účet, kterým jste se přihlásili, a žádná další.

Můj klient MCP zřejmě o analytice neví. Co mám zkusit?

Některým klientům se seznam nástrojů aktualizuje se zpožděním. Zkuste Padlet MCP znovu připojit, přejít na jiného klienta kompatibilního s MCP nebo použít přímo analytické rozhraní API organizace. Pokud si stále nevíte rady, ozvěte se nám.

Související články

War dieser Artikel hilfreich?

Verwandte Artikel