Hvordan beder jeg Padlet MCP om administratoranalyse (beta)?

Carla Seses profilbilledeOpdateret for 13 timer siden af Carla Sese

Har du brug for tal, som din skoles eller dit holds administrator-dashboard ikke viser på den måde, du ønsker? Forbind Padlet MCP til en AI-assistent, og bed om analyser af skolen, klasseværelset eller holdet i almindeligt sprog – eller kald selv API'et til organisationsanalyser.

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

Hvem er dette til?

Denne artikel er til:

  • Ejere og administratorer af Padlet for Schools- eller Team-konti
  • Ejere og lærere af Classroom-konti

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

Det, du allerede har

Din organisations side for analyser under Indstillinger viser allerede kuraterede faner for den aktuelle faktureringsperiode. Skoler og klasseværelser har fanerne Oversigt, Brug, Effekt, Sikkerhed, Topbrugere og Alle brugere. Hold har fanerne Generelt, Padlets og Brugere.

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

Hvad MCP / API tilføjer

Dashboardet består af kuraterede 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 sidste faktureringsperiode?")
  • Tilpassede kombinationer af engagement-, medlemskabs- og indholdssikkerhedsmetrikker
  • Månedlige serier for et datointerval
  • Opdelinger efter rolle (lærere kontra elever, oprettere kontra bidragydere)
  • De mest populære padlets, brugere og medier rangeret på den måde, du beder om
  • Svar, du kan indsætte i en QBR- eller fornyelsespræsentation
Metrikker for indholdssikkerhed (scannede elementer, markerede elementer, træfprocent) er kun tilgængelige for skoler og klasseværelser. Hvis du beder om dem for en Team-organisation, får du en fejl – ikke et nul.

Kom hurtigt i gang med Padlet MCP

  1. Forbind Padlet MCP i din AI-klient. Brug serverens URL https://mcp.padlet.com. Du finder alle konfigurationstrin under Padlet MCP Server.
  2. Log ind og godkend som administrator for den organisation, du vil forespørge. I et Classroom kan en lærer også hente analyser.
  3. Spørg i almindeligt sprog. Du behøver ikke at angive 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 i stedet bruge API'et til organisationsanalyser. Klientsupporten kan være forsinket i forhold til serveren.
Assistenten handler på dine vegne. Den kan kun hente analyser, som din indloggede konto har tilladelse til at se.

Valgfrit: API til organisationsanalyser

Foretrækker du selv at skrive scripts? Brug Public API med en API-nøgle til administratorer (eller en lærernøgle i et Classroom).

  1. Opret eller kopiér en API-nøgle fra udviklersiden under Indstillinger. Du kan læse mere i artiklen om Public API.
  2. Find dit organisations-id med GET /me?include=organizations. Du skal bruge et wksp_-id – org_-organisationer på padlet.org understøttes endnu ikke af dette endepunkt.
  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 i det tidsrum, der angives af Retry-After, og sende den identiske anmodning igen. Analyser beregnes asynkront – en afventende metrik mangler i svaret; den er ikke nul. Behandl aldrig en afventende værdi som nul.
Du finder de fulde anmodningsformater, metrikoversigten og gennemarbejdede eksempler under Læs om organisationsanalyser.

Pilotadgang

Organisationsanalyser via MCP og API'et er tilvalgsbaserede, mens funktionen er i pilotfasen. Padlet tilmelder organisationens ejer – det er ikke nok blot at være administrator. Indtil din organisation er tilmeldt, giver alle kald svaret 404 (det samme svar som for en ukendt organisation).

Indtil videre understøttes kun wksp_-organisationer.

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

Eksempler på prompts

Her er nogle forslag, du kan indsætte 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 var aktive sammenlignet med antallet af licenser, og i hvilke måneder faldt tallene?"
  • "Hvilke organisationspadlets har flest visninger? Giv mig de 3 øverste opslagstavler/sandbox."
  • "Hvilke medlemmer med lærerrollen har ikke brugt Padlet inden for 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 serie, et rollefilter, de mest populære padlets målt på opslag eller besøgende eller indholdssikkerhedsdata for en skole eller et klasseværelse. Assistenten knytter dit spørgsmål til de tilgængelige metrikker.

Hvad dashboardet stadig gør bedre

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

  • Det visuelle oversigtsbanner, fremhævelser af de største 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 pilottilmelding – selve siden under Indstillinger er tilgængelig for brugere med de rette roller uden tilmelding til API'et

MCP og API'et er bedst, når de kuraterede faner ikke besvarer det præcise spørgsmål, du har brug for til en demo eller en samtale om fornyelse.

Begrænsninger:

  • Frekvensgrænse: 60 anmodninger i timen pr. API-nøgle og organisation, inklusive forespørgsler efter et 202-svar
  • Datointerval: højst 24 måneder i én anmodning
  • Indholdssikkerhed: kun for skoler og klasseværelser – Teams får svaret 400 for disse metrikker
  • Medlemstal: afspejler den aktuelle medlemsliste, ikke et historisk øjebliksbillede af, hvem der var medlem på det pågældende tidspunkt
  • Afventer ≠ 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 endepunktet er i pilotfasen, ser alle afvisninger ens ud: Ikke tilmeldt, ukendt organisation eller manglende adgang giver alle svaret 404. Kontrollér, at du er logget ind som administrator (eller lærer i et Classroom), at din organisation er en wksp_-organisation, og at Padlet har tilmeldt organisationens ejer. Kontakt support for at anmode om tilmelding.

Skal jeg skrive kode?

Nej. Forbind Padlet MCP, log ind som administrator, og spørg i 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 adgang ved at logge ind. Begge kan få adgang til 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 Classroom. Assistenten har præcis samme adgang som den konto, du loggede ind med – ikke mere.

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 API'et til organisationsanalyser direkte. Hvis du stadig ikke har adgang, efter at organisationen er tilmeldt, så kontakt os.

Relateret

Var denne artikel nyttig?

Relaterede artikler