Hvordan beder jeg Padlet MCP om administratoranalyse (beta)?

Carla Seses profilbilledeOpdateret for 16 timer siden af Carla Sese

Har tallene i skolens eller dit Holds Admin-dashboard ikke den opdeling, du ønsker? Forbind Padlet MCP til en AI-assistent, og bed om analyser af skolen, klasseværelset eller dit Hold i et almindeligt sprog -- eller brug selv organisationens analyse-API.

Se Læs om organisationsanalyser på docs.padlet.dev for den fulde REST-reference (metrikoversigt, anmodningsformater og fejlkoder).

Hvem er dette til?

Denne artikel er til:

  • Ejere og administratorer på Padlet for Schools- eller Hold-konti
  • Ejere og lærere på klasseværelseskonti

Du behøver ikke at kunne skrive kode for at bruge MCP-metoden. API-metoden er valgfri for avancerede brugere, der allerede arbejder med Public API.

Det, du allerede har

Din organisations side for Analyser under Indstillinger viser allerede udvalgte faner for den aktuelle faktureringsperiode. Skoler og klasseværelser har Oversigt, Brug, Effekt, Sikkerhed, Topbrugere og Alle brugere. Hold har Generelt, Padlets og Brugere eller Oversigt, Brug, Effekt, Topbrugere og Alle brugere, hvis dit Hold har den nye analyseside (beta).

Brug dashboardet, når du vil have et hurtigt visuelt overblik. Brug MCP eller API'et, når du har brug for en tilpasset opdeling, som fanerne ikke besvarer så præcist.

Hvad MCP / API giver dig

Dashboardet består af udvalgte faner. Med MCP og API'et kan du bede om præcis den opdeling, du har brug for:

  • Spørgsmål i almindeligt sprog i din AI-klient ("hvilke lærere var inaktive i den seneste faktureringsperiode?")
  • Tilpassede kombinationer af engagement-, medlemskabs- og indholdssikkerhedsmetrikker
  • Månedlige tidsserier for et datointerval
  • Opdelinger efter rolle (lærere vs. elever, oprettere vs. bidragydere)
  • De mest populære padlets, brugere og medier, rangeret efter dine ønsker
  • Svar, som du kan indsætte i en QBR- eller fornyelsespræsentation
Metrikker for indholdssikkerhed (scannede elementer, markerede elementer, registreringsprocent) er kun tilgængelige for skoler og klasseværelser. Hvis du beder om dem for en Hold-organisation, får du en fejl, ikke værdien nul.

Hurtig start med Padlet MCP

  1. Forbind Padlet MCP i din AI-klient. Brug serverens URL https://mcp.padlet.com. Du finder de fulde konfigurationstrin i Padlet MCP-server.
  2. Log ind og godkend som administrator for den organisation, du vil forespørge. I et klasseværelse kan en lærer også hente analyser.
  3. Spørg i et almindeligt sprog. Du behøver ikke at nævne interne værktøjer. Fortæl AI-assistenten, hvad du vil vide om din skole, dit klasseværelse eller dit Hold, så bruger den Padlet MCP på dine vegne.

Her er et eksempel:

Hvis en bestemt MCP-klient endnu ikke viser analysesvar, kan du prøve en anden MCP-kompatibel klient eller bruge organisationens analyse-API i stedet. Klienter kan være forsinkede med at understøtte serveren.
Assistenten handler på dine vegne. Den kan kun hente analyser, som din indloggede konto har adgang til at se.

Valgfrit: organisationens analyse-API

Vil du hellere skrive et script selv? Brug Public API med en API-nøgle til administratorer (eller en lærernøgle i et klasseværelse).

  1. Opret eller kopiér en API-nøgle fra siden Developer under Indstillinger. Du kan finde flere oplysninger i artiklen Public API.
  2. Find dit organisations-id med GET /me?include=organizations. Du skal bruge et wksp_-id — organisationer med org_ på padlet.org understøttes endnu ikke af dette endpoint.
  3. Send en POST-anmodning til /organizations/{org_id}/analytics med de metrikker, du ønsker.
  4. Hvis svaret er 202, eller meta.pending ikke er tom, skal du vente det tidsrum, der er angivet i Retry-After, og sende den identiske anmodning igen. Analyser beregnes asynkront — en afventende metrik mangler i svaret; den er ikke nul. Behandl aldrig afventende som nul.
Du finder fulde anmodningsformater, metrikoversigten og gennemarbejdede eksempler i Læs om organisationsanalyser.

Adgang til pilotprogrammet

Organisationsanalyser via MCP og API er valgfrit tilmeldt i pilotfasen. Padlet tilmelder organisationens ejer — det er ikke nok alene at være administrator. Indtil din organisation er tilmeldt, returnerer alle kald 404 (det samme svar som for en ukendt organisation).

Indtil videre understøttes kun organisationer med wksp_.

Kontakt support, og bed dem tilmelde organisationens ejer til administratoranalyser.

Eksempler på spørgsmål

Her er forslag, du kan kopiere ind i din MCP-klient. Tilpas formuleringen til din skole, dit klasseværelse eller dit Hold — og kontrollér tallene på analysesiden, når du forbereder en præsentation til kunder.

  • "For vores skole i denne faktureringsperiode: Hvor mange lærere er aktive sammenlignet med antallet af licenser, og hvilke måneder havde et fald?"
  • "Hvilke padlets i organisationen har flest visninger? Vis mig de 3 mest populære boards/sandbox."
  • "Hvilke medlemmer med lærerrollen har ikke brugt Padlet i de seneste 12 måneder?"
  • "Hvor mange medlemmer har ikke e-maildomænet <ouremaildomain.edu>?"
Bed om den opdeling, du har brug for: en månedlig tidsserie, et rollefilter, populære padlets efter antal opslag eller besøgende eller samlet indholdssikkerhed for en skole eller et klasseværelse. Assistenten kobler dit spørgsmål til de tilgængelige metrikker.

Det, dashboardet stadig gør bedre

Brug analysesiden under Indstillinger, når du vil have:

  • Det visuelle banner Oversigt, fremhævede muligheder og en anmodning om faglig udvikling med ét klik
  • Tabellen Alle brugere / Brugere med søgning, rollefiltre og CSV-download med ét klik
  • Downloadbare lister over aktive og inaktive lærere for den valgte periode fra fanen Oversigt (skoler og klasseværelser)
  • En visning, der ikke kræver tilmelding til pilotprogrammet — selve siden Indstillinger er tilgængelig for kvalificerede roller uden tilmelding til API'et

MCP og API'et er særligt nyttige, når de udvalgte faner ikke besvarer det præcise spørgsmål, du har brug for til en demo eller en fornyelsessamtale.

Begrænsninger:

  • Frekvensbegrænsning: 60 anmodninger i timen pr. API-nøgle og organisation, inklusive gentagne forespørgsler efter et 202
  • Datointerval: højst 24 måneder i én anmodning
  • Indholdssikkerhed: kun skoler og klasseværelser — Hold får en 400-fejl for disse metrikker
  • Medlemstal: afspejler den aktuelle medlemsliste, ikke et historisk øjebliksbillede af, hvem der var medlem på det pågældende tidspunkt
  • Afventende ≠ nul: en metrik, der stadig beregnes, mangler i svaret; behandl den ikke som nul
  • Organisationstype: indtil videre kun wksp_

Ofte stillede spørgsmål

Hvorfor får jeg en 404-fejl, når jeg beder om analyser?

Mens endpointet er i pilotfasen, ser alle afvisninger ens ud: Manglende tilmelding, ukendt organisation eller manglende adgang giver alle 404. Kontrollér, at du er logget ind som administrator (eller lærer i et klasseværelse), at din organisation har et wksp_-id, og at Padlet har tilmeldt organisationens ejer. Kontakt support for at anmode om tilmelding.

Skal jeg kunne skrive kode?

Nej. Forbind Padlet MCP, log ind som administrator, og spørg i et almindeligt sprog. API-metoden er valgfri for udviklere og avancerede brugere, der allerede bruger Public API.

Er dette det samme som Public API?

De hænger sammen, men er ikke den samme produktflade. Public API er til udviklere, der bruger en API-nøgle. Padlet MCP er til AI-assistenter, som du giver tilladelse ved at logge ind. Begge kan hente organisationsanalyser, når din organisation er tilmeldt; du kan bruge den ene eller begge.

Kan elever eller ikke-administratorer se organisationsanalyser på denne måde?

Nej. Analyser kræver, at du er administrator for organisationen eller lærer i et klasseværelse. Assistenten har præcis samme adgang som den konto, du er logget ind med — hverken mere eller mindre.

Min MCP-klient ser ikke ud til at kende til analyser. Hvad kan jeg prøve?

Nogle klienter opdaterer deres værktøjsliste med forsinkelse. Prøv at forbinde Padlet MCP igen, skift til en anden MCP-kompatibel klient, eller brug organisationens analyse-API direkte. Hvis du stadig ikke kan få adgang efter tilmelding, så kontakt os.

Relateret

Var denne artikel nyttig?

Relaterede artikler