Cum îi solicit Padlet MCP date analitice despre Admin?

صورة الملف الشخصي لـCarla Seseتم التحديث acum 4 zile بواسطة Carla Sese

Nu găsești în tabloul de bord Admin al școlii sau al echipei cifrele de care ai nevoie? Conectează Padlet MCP la un asistent AI și cere-i, în limbaj obișnuit, analize pentru școală, classroom sau echipă, ori apelează direct API-ul de analiză a organizației.

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

Cui i se adresează

Acest articol se adresează:

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

Nu trebuie să scrii cod pentru a folosi metoda MCP. Metoda API este opțională, pentru utilizatorii avansați care lucrează deja cu API-ul public.

Ce ai deja la dispoziție

Pagina Analize a organizației din Setări afișează deja file selectate 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, Padlet-uri și Utilizatori sau 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 de ansamblu vizuală rapidă. Folosește MCP sau API-ul când ai nevoie de o perspectivă personalizată, la care filele nu răspund suficient de clar.

Ce oferă MCP / API-ul

Tabloul de bord oferă file selectate. MCP și API-ul îți permit să ceri exact perspectiva de care ai nevoie:

  • Întrebări formulate în limbaj obișnuit în clientul tău AI („care 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
  • Filtrare după roluri (profesori și elevi, creatori și colaboratori)
  • Padlet-uri, utilizatori și fișiere 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 Team, vei primi o eroare, nu valoarea zero.

Începe rapid cu Padlet MCP

  1. Conectează Padlet MCP în clientul tău AI. Folosește URL-ul serverului https://mcp.padlet.com. Instrucțiunile complete de configurare se găsesc î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 obține analize.
  3. Formulează întrebarea în limbaj obișnuit. Nu trebuie să menționezi instrumentele interne. Spune-i asistentului AI ce vrei să afli despre școala, classroom-ul sau echipa ta, iar acesta va folosi Padlet MCP în numele tău.

Iată un exemplu:

Dacă un anumit client MCP nu afișează încă răspunsuri privind analizele, încearcă un alt client compatibil cu MCP sau folosește în schimb API-ul de analiză a organizației. Suportul clienților poate rămâne în urma serverului.
Asistentul acționează în numele tău. Poate prelua doar analizele pe care contul tău conectat este autorizat să le vadă.

Opțional: API-ul de analiză a organizației

Preferi să creezi propriile scripturi? 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 Dezvoltator din Setări. Consultă articolul API-ul public pentru detalii.
  2. Găsește 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 solicitare 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 trimite din nou solicitarea identică. Analizele sunt calculate în fundal, așadar un indicator în așteptare lipsește din răspuns. Nu îl considera niciodată zero.
Structura completă a solicitărilor, catalogul de indicatori și exemplele rezolvate se găsesc în Read organization analytics.

Cine poate folosi această funcție

Analizele organizației prin Padlet MCP și API sunt disponibile pentru proprietarii și administratorii conturilor Padlet for Schools și Team, precum și pentru proprietarii și profesorii conturilor Classroom. Nu trebuie să ceri echipei Padlet să activeze această funcție.

Deocamdată sunt acceptate doar organizațiile wksp_.

Exemple de solicitări

Acestea sunt exemple pe care le poți copia în clientul MCP. Adaptează formularea la școala, classroom-ul sau echipa ta și verifică cifrele în pagina Analize când pregătești o prezentare destinată clienților.

  • „Pentru școala noastră, în această perioadă de facturare, câți profesori activi avem în comparație cu numărul de licențe și în ce luni au scăzut cifrele?”
  • „Care padlet-uri ale organizației au cele mai multe vizualizări? Dă-mi primele 3 panouri/sandbox.”
  • „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 perspectiva de care ai nevoie: o serie lunară, un filtru după rol, cele mai populare padlet-uri după numărul de postări sau de 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 când vrei:

  • Bannerul vizual Prezentare generală, evidențierile Oportunități principale și solicitarea de dezvoltare profesională cu un singur clic
  • Tabelul Toți utilizatorii / Utilizatori, cu funcție de căutare, filtre de rol și descărcare CSV cu un singur clic
  • Liste descărcabile ale profesorilor activi și inactivi pentru perioada selectată, din fila Prezentare generală (școli și classroom-uri)

MCP și API-ul sunt deosebit de utile atunci când filele selectate nu răspund exact la întrebarea 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 verificările ulterioare unui răspuns 202
  • Intervalul de date: cel mult 24 de luni într-o singură solicitare
  • Siguranța conținutului: numai pentru școli și classroom-uri. Echipele primesc un răspuns 400 pentru acești indicatori
  • Numărul membrilor: reflectă lista curentă de membri, nu o imagine istorică a persoanelor care făceau parte din organizație la momentul respectiv
  • Î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 o eroare 404 când solicit analize?

Toate refuzurile arată la fel: atât o organizație necunoscută, cât și lipsa accesului duc la un răspuns 404. Verifică dacă te-ai conectat ca administrator al organizației respective (sau ca profesor într-un Classroom) și dacă aceasta este o organizație wksp_. Încă ai probleme? Contactează serviciul de asistență.

Trebuie să scriu cod?

Nu. Conectează Padlet MCP, autentifică-te ca administrator și formulează solicitarea în limbaj obișnuit. Metoda API este opțională, pentru dezvoltatori și utilizatorii 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 prin conectare. Ambele pot accesa analizele organizației și poți folosi una dintre ele sau ambele.

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

Nu. Pentru a accesa analizele, este necesar să fii administrator al organizației sau profesor într-un Classroom. Asistentul are exact aceleași drepturi de acces ca și contul cu care te-ai conectat, nici mai multe, nici mai puține.

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

Unele aplicații cliente își actualizează lista de instrumente cu întârziere. Încearcă să reconectezi Padlet MCP, să treci la un alt client compatibil cu MCP sau să folosești direct API-ul de analiză a organizației. Dacă problema persistă, contactează-ne.

Articole conexe

هل كانت هذه المقالة مفيدة؟

مقالات ذات صلة