Cum îi cer lui Padlet MCP statistici Admin (Beta)?

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

Ai nevoie de date pe care Tabloul de bord administrativ al școlii sau al echipei nu le prezintă așa cum dorești? Conectează Padlet MCP la un asistent AI și solicită analize privind școala, clasa sau echipa folosind un limbaj simplu — sau apelează tu însuți API-ul de analize organizaționale.

Pentru referința completă REST (catalogul de metrici, tipurile de solicitări și codurile de eroare), consultați secțiunea „Citirea analizelor organizaționale” pe docs.padlet.dev.

Cui se adresează acest articol

Acest articol se adresează:

  • Proprietarilor și administratorilor conturilor Padlet pentru școli sau echipe
  • Proprietarilor și profesorilor cu conturi Classroom

Nu este necesar să scrieți cod pentru a utiliza calea MCP. Calea API este opțională pentru utilizatorii avansați care lucrează deja cu API-ul public.

Ce aveți deja

Pagina „Analize” a organizației dvs. din „Setări” afișează deja file selectate pentru perioada de facturare curentă. Școlile și clasele au la dispoziție „Prezentare generală”, „Utilizare”, „Impact”, „Siguranță”, „Utilizatori de top” și „Toți utilizatorii”. Echipele au la dispoziție „General”, „Padlet-uri” și „Utilizatori”.

Utilizați tabloul de bord atunci când doriți o imagine de ansamblu rapidă. Utilizați MCP sau API-ul atunci când aveți nevoie de o analiză personalizată pe care filele nu o oferă în mod clar.

Ce adaugă MCP / API

Tabloul de bord conține file organizate. MCP și API-ul vă permit să solicitați exact segmentul de care aveți nevoie:

  • Întrebări formulate în limbaj simplu în clientul dvs. AI („care profesori au fost inactivi în ultima perioadă de facturare?”)
  • Combinații personalizate de indicatori privind implicarea, calitatea de membru și siguranța conținutului
  • Seriile lunare pe un interval de date
  • Segmente pe roluri (profesori vs. elevi, creatori vs. colaboratori)
  • Cele mai populare padleturi, utilizatori și materiale media, clasificate conform cerințelor dvs.
  • Răspunsuri pe care le puteți insera într-un raport QBR sau într-o prezentare de reînnoire
Indicatorii de siguranță a conținutului (elemente scanate, elemente semnalate, rata de detectare) sunt disponibili numai pentru școli și săli de clasă. Solicitarea acestora într-o organizație de tip „Echipă” generează o eroare, nu valoarea zero.

Începere rapidă cu Padlet MCP

  1. Conectați Padlet MCP în clientul dvs. AI. Utilizați adresa URL a serverului https://mcp.padlet.com. Pașii completi de configurare se găsesc în Padlet MCP Server.
  2. Autentificați-vă și autorizați-vă ca administrator al organizației pe care doriți să o interogați. Într-o clasă, un profesor poate, de asemenea, să extragă date analitice.
  3. Formulați întrebarea în limbaj simplu. Nu este necesar să menționați numele instrumentelor interne. Spuneți-i asistentului AI ce doriți să aflați despre școala, clasa sau echipa dvs., iar acesta va utiliza Padlet MCP în numele dvs.

Iată un exemplu:

Dacă un anumit client MCP nu afișează încă răspunsuri analitice, încercați un alt client compatibil cu MCP sau utilizați în schimb API-ul de analiză al organizației. Suportul clientului poate rămâne în urma serverului.
Asistentul tău acționează în numele tău. El poate extrage doar datele analitice pe care contul tău conectat are permisiunea să le vadă.

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

Preferi să scrii singur un script? Folosește API-ul public cu o cheie API de administrator (sau o cheie de profesor în Classroom).

  1. Creați sau copiați o cheie API din pagina „Dezvoltatori” din „Setări”. Detaliile se găsesc în articolul despre API-ul public.
  2. Găsiți ID-ul organizației dvs. cu GET /me?include=organizations. Ai nevoie de un wksp_ ID — org_ organizațiile de pe padlet.org nu sunt încă acceptate pentru acest punct final.
  3. Trimiteți un POST la /organizations/{org_id}/analytics cu metricile dorite.
  4. Dacă răspunsul este 202 sau meta.pending nu este gol, așteaptă Retry-After și trimiteți din nou aceeași solicitare. Analizele sunt calculate asincron — o metrică în așteptare este absentă, nu zero. Nu tratați niciodată „în așteptare” ca fiind zero.
Formele complete ale cererilor, catalogul de metrici și exemplele practice se găsesc în secțiunea „Analize privind organizația” din Read.

Acces la faza pilot

Analiza organizației prin MCP și API este opțională în faza pilot. Padlet înscrie proprietarul organizației — nu este suficient să fii doar administrator. Până când organizația ta nu este înscrisă, fiecare apel primește 404 (același răspuns ca în cazul unei organizații necunoscute).

Deocamdată sunt acceptate doar wksp_ organizațiile sunt acceptate deocamdată.

Contactați serviciul de asistență și rugați-i să înscrie proprietarul organizației dvs. pentru analizele de administrator.

Exemple de solicitări

Iată câteva exemple pe care le puteți introduce în clientul MCP. Adaptați formularea în funcție de școala, clasa sau echipa dumneavoastră — și verificați cifrele pe pagina „Analize” atunci când pregătiți o prezentare destinată clienților.

  • „Pentru școala noastră, în această perioadă de facturare, câți profesori activi există în comparație cu licențele și în ce luni s-a înregistrat o scădere?”
  • „Care padlet-uri ale organizației au cele mai multe vizualizări? Prezentați-mi primele 3 panouri/spații de testare.”
  • „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>?”
Solicitați segmentul de care aveți nevoie: o serie lunară, un filtru după rol, cele mai populare Padlet-uri după postări sau vizitatori, sau totalurile privind siguranța conținutului pentru o școală sau o clasă. Asistentul va corela întrebarea dvs. cu indicatorii disponibili.

Ce face încă mai bine tabloul de bord

Rămâneți la pagina „Analize” din „Setări” atunci când doriți:

  • Bannerul vizual „Prezentare generală”, mențiunile privind oportunitățile de top și solicitarea de dezvoltare 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
  • Listele descărcabile cu profesorii activi și inactivi pentru perioada selectată, din fila „Prezentare generală” (școli și clase)
  • O vizualizare care nu necesită înscriere în programul pilot — pagina „Setări” în sine este disponibilă pentru rolurile eligibile fără a fi necesară activarea API-ului

MCP și API-ul își demonstrează adevărata valoare atunci când filele selectate nu răspund exact la întrebarea de care aveți nevoie pentru o demonstrație sau o discuție privind reînnoirea.

Limitări:

  • Limită de rate: 60 de solicitări pe oră per cheie API și organizație, inclusiv sondajele după un 202
  • Interval de date: cel mult 24 de luni într-o singură solicitare
  • Siguranța conținutului: numai școală și clasă — echipele primesc o 400 pentru aceste metrici
  • Numărul de membri: reflectă lista actuală, nu o imagine istorică a celor 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 tratați ca fiind zero
  • Tipul organizației: wksp_ doar pentru moment

Întrebări frecvente

De ce primesc un cod 404 când solicit date analitice?

Atât timp cât punctul final se află în faza pilot, toate refuzurile au același aspect: „nu este înscris”, „organizație necunoscută” sau „fără acces” 404. Asigurați-vă că v-ați autentificat ca administrator (sau profesor într-o clasă), că organizația dvs. este o wksp_ organizație și că Padlet a înscris proprietarul organizației. Contactează serviciul de asistență pentru a solicita înscrierea.

Trebuie să scriu cod?

Nu. Conectați-vă la Padlet MCP, autentificați-vă ca administrator și formulați solicitarea în limbaj simplu. Calea 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 legate, dar nu reprezintă aceeași interfață de produs. API-ul public este destinat dezvoltatorilor care utilizează o cheie API. Padlet MCP este destinat asistenților AI pe care îi autorizați prin autentificare. Ambele pot accesa statisticile organizației odată ce organizația dvs. este înscrisă; puteți utiliza una dintre ele sau pe amândouă.

Pot elevii sau utilizatorii care nu sunt administratori să vadă statisticile organizației în acest mod?

Nu. Analizele necesită un administrator al organizației sau un profesor dintr-o clasă. Asistentul are exact același acces ca și contul cu care v-ați autentificat — nimic mai mult.

Se pare că clientul meu MCP nu recunoaște statisticile. Ce ar trebui să încerc?

Unii clienți își actualizează lista de instrumente cu o întârziere. Încercați să reconectați Padlet MCP, să treceți la un alt client compatibil cu MCP sau să utilizați direct API-ul de analize ale organizației. Dacă întâmpinați în continuare probleme după înscriere, contactați-ne.

Legat de

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

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