Cum îi cer lui Padlet MCP Analizele administratorului (Beta)?

Fotografia de profil a utilizatorului Carla SeseActualizat acum 16 ore de Carla Sese

Ai nevoie de numere pe care tabloul de bord Admin al școlii sau al Echipei nu le afișează așa cum vrei? Conectează Padlet MCP la un asistent AI și cere-i, în limbaj obișnuit, analize pentru școală, classroom sau echipă — sau apelează tu API-ul de analiză pentru organizații.

Pentru referința REST completă (catalogul de indicatori, structurile cererilor și codurile de eroare), consultă Read organization analytics pe docs.padlet.dev.

Cui i se adresează

Acest articol se adresează:

  • Proprietarilor și administratorilor de conturi Padlet for Schools sau Team
  • Proprietarilor și profesorilor de conturi Classroom

Nu trebuie să scrii cod pentru a folosi metoda MCP. Metoda API este opțională și se adresează utilizatorilor avansați care folosesc deja API-ul public.

Ce ai deja

Pagina Analize a organizației tale din Setări afișează deja file organizate pentru perioada de facturare curentă. Școlile și classroom-urile au filele Prezentare generală, Utilizare, Impact, Siguranță, Utilizatori de top și Toți utilizatorii. Echipele au filele General, Padlets și Utilizatori sau filele Prezentare generală, Utilizare, Impact, Utilizatori de top și Toți utilizatorii, dacă Echipa ta are noua pagină Analize (beta).

Folosește tabloul de bord când vrei o imagine vizuală rapidă. Folosește MCP sau API-ul când ai nevoie de o segmentare personalizată la care filele nu răspund la fel de bine.

Ce oferă MCP / API

Tabloul de bord are file organizate. MCP și API-ul îți permit să ceri exact segmentarea de care ai nevoie:

  • Întrebări în limbaj obișnuit, adresate clientului tău AI („ce profesori au fost inactivi în ultima perioadă de facturare?”)
  • Combinații personalizate de indicatori privind implicarea, apartenența și siguranța conținutului
  • Serii lunare pentru un interval de date
  • Segmentări după rol (profesori vs. elevi, creatori vs. colaboratori)
  • Padlet-uri, utilizatori și elemente media de top, clasate după criteriile cerute
  • Răspunsuri pe care le poți copia într-o prezentare QBR sau de reînnoire
Indicatorii privind siguranța conținutului (elemente scanate, elemente semnalate, rata de detectare) sunt disponibili numai pentru școli și classroom-uri. Dacă îi soliciți pentru o organizație de tip Team, vei primi o eroare, nu valoarea zero.

Începe rapid cu Padlet MCP

  1. Conectează Padlet MCP în clientul tău AI. Folosește adresa URL a serverului https://mcp.padlet.com. Instrucțiunile complete de configurare sunt în Padlet MCP Server.
  2. Conectează-te și autorizează-te ca administrator al organizației pentru care vrei să faci interogarea. Într-un Classroom, și un profesor poate solicita analize.
  3. Adresează întrebări în limbaj obișnuit. Nu trebuie să menționezi instrumentele interne. Spune-i asistentului AI ce vrei să afli despre școală, classroom sau echipă, iar acesta va folosi Padlet MCP în numele tău.

Iată un exemplu:

Dacă un anumit client MCP nu afișează încă răspunsuri despre analize, încearcă un alt client compatibil cu MCP sau folosește în schimb API-ul de analiză pentru organizații. Suportul clienților poate întârzia față de cel al serverului.
Asistentul acționează în numele tău. Poate extrage doar analizele pe care contul cu care te-ai conectat are permisiunea să le vadă.

Opțional: API-ul de analiză pentru organizații

Preferi să creezi singur scriptul? Folosește API-ul public cu o cheie API de administrator (sau o cheie de profesor pentru un Classroom).

  1. Creează sau copiază o cheie API din pagina Developer din Setări. Găsești detalii în articolul API public.
  2. Află ID-ul organizației cu GET /me?include=organizations. Ai nevoie de un ID wksp_ — organizațiile org_ de pe padlet.org nu sunt încă acceptate pentru acest endpoint.
  3. Trimite o cerere POST către /organizations/{org_id}/analytics, cu indicatorii doriți.
  4. Dacă răspunsul este 202 sau meta.pending nu este gol, așteaptă intervalul indicat de Retry-After și retrimite aceeași cerere. Analizele sunt calculate asincron — un indicator în așteptare lipsește, nu are valoarea zero. Nu considera niciodată că o valoare în așteptare este zero.
Structurile complete ale cererilor, catalogul de indicatori și exemplele practice sunt disponibile în Read organization analytics.

Acces în perioada pilot

Analizele organizațiilor prin MCP și API sunt disponibile pe bază de înscriere voluntară pe durata perioadei pilot. Padlet înscrie proprietarul organizației — simplul fapt că ești administrator nu este suficient. Până la înscrierea organizației tale, fiecare apel va returna 404 (același răspuns ca pentru o organizație necunoscută).

Deocamdată sunt acceptate doar organizațiile wksp_.

Contactează serviciul de asistență și cere înscrierea proprietarului organizației tale pentru acces la analizele de administrator.

Exemple de prompturi

Le poți copia ca punct de plecare în clientul MCP. Adaptează formularea la școala, classroom-ul sau echipa ta și verifică numerele în pagina Analize când pregătești o prezentare destinată clienților.

  • „Pentru școala noastră, în această perioadă de facturare, câți profesori au fost activi comparativ cu numărul de licențe și în ce luni au scăzut cifrele?”
  • „Ce padlet-uri ale organizației au cele mai multe vizualizări? Arată-mi primele 3 tablouri/sandbox-uri.”
  • „Care membri cu rol de profesor nu au folosit Padlet în ultimele 12 luni?”
  • „Câți membri nu au domeniul de e-mail <ouremaildomain.edu>?”
Cere segmentarea de care ai nevoie: o serie lunară, un filtru după rol, padlet-urile de top în funcție de postări sau vizitatori ori totalurile privind siguranța conținutului pentru o școală sau un classroom. Asistentul va asocia întrebarea ta cu indicatorii disponibili.

Ce face în continuare mai bine tabloul de bord

Folosește pagina Analize din Setări dacă vrei:

  • Bannerul vizual Prezentare generală, evidențierile oportunităților de top și solicitarea de formare profesională cu un singur clic
  • Tabelul Toți utilizatorii / Utilizatori, cu funcție de căutare, filtre după rol și descărcare CSV cu un singur clic
  • Liste descărcabile cu profesorii activi și inactivi pentru perioada selectată, din fila Prezentare generală (școli și classroom-uri)
  • O vizualizare care nu necesită înscrierea în perioada pilot — pagina Setări este disponibilă rolurilor eligibile fără activarea accesului API

MCP și API-ul sunt utile când filele organizate nu răspund la întrebarea exactă de care ai nevoie pentru o demonstrație sau o discuție despre reînnoire.

Limitări:

  • Limită de solicitări: 60 de solicitări pe oră pentru fiecare cheie API și organizație, inclusiv interogările repetate după un răspuns 202
  • Interval de date: cel mult 24 de luni într-o singură cerere
  • Siguranța conținutului: doar pentru școli și classroom-uri — pentru acești indicatori, echipele primesc un răspuns 400
  • Numărul membrilor: reflectă lista curentă de membri, nu o situație istorică a apartenenței la un anumit moment
  • În așteptare ≠ zero: un indicator încă în curs de calcul lipsește din răspuns; nu îl considera zero
  • Tipul organizației: deocamdată, doar wksp_

Întrebări frecvente

De ce primesc 404 când solicit analize?

Cât timp endpoint-ul este în perioada pilot, toate refuzurile arată la fel: organizație neînscrisă, organizație necunoscută sau lipsă de acces — toate returnează 404. Asigură-te că te-ai conectat ca administrator (sau ca profesor într-un Classroom), că organizația ta este de tip wksp_ și că Padlet a înscris proprietarul organizației. Contactează serviciul de asistență pentru a solicita înscrierea.

Trebuie să scriu cod?

Nu. Conectează Padlet MCP, autentifică-te ca administrator și adresează întrebări în limbaj obișnuit. Metoda API este opțională și se adresează dezvoltatorilor și utilizatorilor avansați care folosesc deja API-ul public.

Este același lucru cu API-ul public?

Sunt asociate, dar nu reprezintă aceeași interfață de produs. API-ul public este destinat dezvoltatorilor care folosesc o cheie API. Padlet MCP este destinat asistenților AI pe care îi autorizezi conectându-te. Ambele pot accesa analizele organizației după înscrierea acesteia; le poți folosi pe oricare dintre ele sau pe amândouă.

Pot elevii sau persoanele care nu sunt administratori să vadă astfel analizele organizației?

Nu. Pentru a accesa analizele, trebuie să fii administratorul organizației sau profesor într-un Classroom. Asistentul are exact același nivel de acces ca și contul cu care te-ai conectat — nimic mai mult.

Clientul meu MCP pare să nu știe despre analize. Ce pot încerca?

Este posibil ca unele cliente să-și actualizeze lista de instrumente cu întârziere. Încearcă să reconectezi Padlet MCP, să folosești un alt client compatibil cu MCP sau să apelezi direct API-ul de analiză pentru organizații. Dacă tot nu ai acces după înscriere, contactează-ne.

Articole conexe

A fost acest articol util?

Articole similare