Hvordan ber jeg Padlet MCP om Admin-analyse?

Profielfoto van Carla SeseBijgewerkt for 4 døgn siden door Carla Sese

Får du ikke tallene i Admin-dashbordet for skolen eller Teamet delt opp slik du ønsker? Koble Padlet MCP til en AI-assistent og be om analyser for skolen, klasserommet eller Teamet på vanlig språk, eller kall organisasjonens analyse-API selv.

Se Les om organisasjonsanalyser på docs.padlet.dev for den fullstendige REST-referansen (målkatalog, forespørselsformater og feilkoder).

Hvem dette er for

Denne artikkelen er for:

  • Ei­ere og administratorer av Padlet for Schools- eller Team-kontoer
  • Ei­ere og lærere på Classroom-kontoer

Du trenger ikke å skrive kode for å bruke MCP-metoden. API-metoden er valgfri for avanserte brukere som allerede bruker Public API.

Dette har du allerede

Organisasjonens side for Analyser i Innstillinger viser allerede utvalgte faner for den gjeldende faktureringsperioden. Skoler og klasserom har Oversikt, Bruk, Effekt, Sikkerhet, Toppbrukere og Alle brukere. Team har Generelt, Padlets og Brukere, eller Oversikt, Bruk, Effekt, Toppbrukere og Alle brukere hvis Teamet ditt har den nye analysesiden (beta).

Bruk dashbordet når du vil ha en rask visuell oversikt. Bruk MCP eller API-et når du trenger en egendefinert inndeling som fanene ikke besvarer like godt.

Hva MCP / API gir deg

Dashbordet har utvalgte faner. Med MCP og API-et kan du be om akkurat den inndelingen du trenger:

  • Spørsmål på vanlig språk i AI-klienten din ("hvilke lærere var inaktive i forrige faktureringsperiode?")
  • Egendefinerte kombinasjoner av måltall for engasjement, medlemskap og innholdssikkerhet
  • Månedlige tidsserier for en datoperiode
  • Inndeling etter rolle (lærere vs. elever, opprettere vs. bidragsytere)
  • Topp-padlets, toppbrukere og mest brukte medier rangert slik du ber om
  • Svar du kan lime inn i en QBR- eller fornyelsespresentasjon
Måltall for innholdssikkerhet (skannede elementer, flaggede elementer, treffprosent) er bare tilgjengelige for skoler og klasserom. Hvis du ber om dem for en Team-organisasjon, får du en feil, ikke null.

Kom raskt i gang med Padlet MCP

  1. Koble Padlet MCP til AI-klienten din. Bruk serveradressen https://mcp.padlet.com. Du finner alle konfigurasjonstrinnene i Padlet MCP Server.
  2. Logg inn og gi tilgang som administrator for organisasjonen du vil hente data fra. I et Classroom kan også en lærer hente analyser.
  3. Spør på vanlig språk. Du trenger ikke å oppgi navn på interne verktøy. Fortell AI-assistenten hva du vil vite om skolen, klasserommet eller Teamet ditt, så bruker den Padlet MCP på dine vegne.

Her er et eksempel:

Hvis en bestemt MCP-klient ennå ikke viser analyseresultater, kan du prøve en annen MCP-kompatibel klient eller bruke organisasjonens analyse-API i stedet. Klientstøtten kan komme på etterskudd i forhold til serveren.
Assistenten handler på dine vegne. Den kan bare hente analyser som den påloggede kontoen din har tilgang til.

Valgfritt: organisasjonens analyse-API

Vil du heller lage skript selv? Bruk Public API med en administrator-API-nøkkel (eller en lærernøkkel for et Classroom).

  1. Opprett eller kopier en API-nøkkel fra Utvikler-siden i Innstillinger. Du finner mer informasjon i artikkelen om Public API.
  2. Finn organisasjons-ID-en din med GET /me?include=organizations. Du skal bruke en wksp_-ID. Organisasjoner med org_-ID på padlet.org støttes foreløpig ikke av dette endepunktet.
  3. Send en POST-forespørsel til /organizations/{org_id}/analytics med måltallene du ønsker.
  4. Hvis svaret er 202 eller meta.pending ikke er tomt, venter du til Retry-After og sender den identiske forespørselen på nytt. Analyser beregnes i bakgrunnen, så måltall som fortsatt behandles, mangler i svaret. Ikke behandle dem som null.
Du finner fullstendige forespørselsformater, målkatalogen og gjennomarbeidede eksempler under Les om organisasjonsanalyser.

Hvem kan bruke dette

Organisasjonsanalyser via Padlet MCP og API-et er tilgjengelig for eiere og administratorer av Padlet for Schools- og Team-kontoer, samt for eiere og lærere på Classroom-kontoer. Du trenger ikke å be Padlet om å aktivere det.

Foreløpig støttes bare organisasjoner med wksp_-ID.

Eksempler på spørsmål

Dette er forslag du kan lime inn i MCP-klienten din. Tilpass formuleringene til skolen, klasserommet eller Teamet ditt, og kontroller tallene mot Analysesiden når du lager en presentasjon for kunder.

  • "For skolen vår i denne faktureringsperioden: Hvor mange aktive lærere har vi sammenlignet med antall lisenser, og hvilke måneder gikk tallene ned?"
  • "Hvilke padlets i organisasjonen har flest visninger? Vis meg de 3 øverste tavlene/sandboxene."
  • "Hvilke medlemmer med lærerrolle har ikke brukt Padlet de siste 12 månedene?"
  • "Hvor mange medlemmer har ikke e-postdomenet <ouremaildomain.edu>?"
Be om den inndelingen du trenger: en månedlig tidsserie, et rollefilter, de beste padlet-ene etter antall innlegg eller besøkende, eller totalsummer for innholdssikkerhet på en skole eller i et klasserom. Assistenten kobler spørsmålet ditt til de tilgjengelige måltallene.

Dette gjør dashbordet fortsatt bedre

Bruk Analysesiden i Innstillinger når du vil ha:

  • Det visuelle banneret på Oversikt, fremhevede muligheter og muligheten til å be om faglig utvikling med ett klikk
  • Tabellen Alle brukere / Brukere med søk, rollefiltre og nedlasting av CSV med ett klikk
  • Nedlastbare lister over aktive og inaktive lærere for den valgte perioden fra fanen Oversikt (skoler og klasserom)

MCP og API-et er best når de utvalgte fanene ikke besvarer det nøyaktige spørsmålet du trenger svar på før en demo eller fornyelsessamtale.

Begrensninger:

  • Frekvensgrense: 60 forespørsler per time per API-nøkkel og organisasjon, inkludert avspørringer etter et 202-svar
  • Datoperiode: maksimalt 24 måneder i én forespørsel
  • Innholdssikkerhet: bare for skoler og klasserom. Team får en 400-feil for disse måltallene
  • Medlemstall: gjenspeiler den nåværende medlemslisten, ikke et historisk øyeblikksbilde av hvem som var medlem på det aktuelle tidspunktet
  • Ventende ≠ null: måltall som fortsatt beregnes, mangler i svaret. Ikke behandle dem som null
  • Organisasjonstype: foreløpig bare wksp_

Vanlige spørsmål

Hvorfor får jeg en 404-feil når jeg ber om analyser?

Alle avslag ser like ut: Både en ukjent organisasjon og manglende tilgang gir 404. Kontroller at du er logget inn som administrator (eller som lærer i et Classroom) for organisasjonen, og at den har en wksp_-ID. Står du fortsatt fast? Kontakt brukerstøtte.

Må jeg skrive kode?

Nei. Koble til Padlet MCP, logg inn som administrator og spør på vanlig språk. API-metoden er valgfri for utviklere og avanserte brukere som allerede bruker Public API.

Er dette det samme som Public API?

De henger sammen, men er ikke den samme løsningen. Public API er for utviklere som bruker en API-nøkkel. Padlet MCP er for AI-assistenter du gir tilgang til ved å logge inn. Begge kan hente organisasjonsanalyser, og du kan bruke den ene eller begge.

Kan elever eller andre enn administratorer se organisasjonsanalyser på denne måten?

Nei. Analyser krever at du er administrator for organisasjonen eller lærer i et Classroom. Assistenten har nøyaktig samme tilgang som kontoen du logget inn med, ikke noe mer.

Det virker ikke som MCP-klienten min kjenner til analyser. Hva bør jeg prøve?

Noen klienter oppdaterer verktøylisten med forsinkelse. Prøv å koble til Padlet MCP på nytt, bytt til en annen MCP-kompatibel klient eller bruk organisasjonens analyse-API direkte. Hvis du fortsatt står fast, kan du kontakte oss.

Relatert

Was dit artikel nuttig?

Gerelateerde artikelen