Hvordan ber jeg Padlet MCP om Admin-analyse (beta)?

Profilbildet til Carla SeseOppdatert for 16 timer siden av Carla Sese

Trenger du tall som Admin-dashbordet for skolen eller Teamet ikke viser slik du ønsker? Koble Padlet MCP til en AI-assistent, og be om analyser av skolen, klasserommet eller Teamet i naturlig språk – eller bruk organisasjonsanalyse-API-et selv.

Du finner den fullstendige REST-referansen (metrikkkatalog, forespørselsformater og feilkoder) under Les om organisasjonsanalyse på docs.padlet.dev.

Hvem er dette for?

Denne artikkelen er for:

  • Eiendomsansvarlige og administratorer for Padlet for Schools- eller Team-kontoer
  • Eiendomsansvarlige og lærere for 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 gjeldende faktureringsperiode. 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 et tilpasset utsnitt som fanene ikke gir et godt svar på.

Dette får du med MCP/API

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

  • Spørsmål i naturlig språk i AI-klienten din («Hvilke lærere var inaktive i forrige faktureringsperiode?»)
  • Tilpassede kombinasjoner av engasjements-, medlemskaps- og innholdssikkerhetsmetrikker
  • Månedlige tidsserier for et datointervall
  • Utsnitt etter rolle (lærere kontra elever, opprettere kontra bidragsytere)
  • Populære padleter, brukere og medier rangert slik du ber om
  • Svar du kan lime inn i en QBR- eller fornyelsespresentasjon
Metrikker for innholdssikkerhet (skannede elementer, flaggede elementer, treffsikkerhet) er bare tilgjengelige for skoler og klasserom. Hvis du ber om disse for en Team-organisasjon, får du en feilmelding, 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 fullstendige oppsettinstruksjoner 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. Still spørsmål i naturlig språk. Du trenger ikke å oppgi navn på interne verktøy. Fortell AI-assistenten hva du vil vite om skolen, klasserommet eller Teamet, så bruker den Padlet MCP på dine vegne.

Her er et eksempel:

Hvis en bestemt MCP-klient ennå ikke viser analysesvar, kan du prøve en annen MCP-kompatibel klient eller bruke API-et for organisasjonsanalyse i stedet. Klientstøtten kan ligge etter serveren.
Assistenten handler på dine vegne. Den kan bare hente analyser som den innloggede kontoen din har tilgang til.

Valgfritt: API for organisasjonsanalyse

Vil du heller lage skript selv? Bruk Public API med en API-nøkkel for administratorer (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 trenger en ID som begynner med wksp_ — organisasjoner med org_ på padlet.org støttes ikke for dette endepunktet ennå.
  3. Send en POST-forespørsel til /organizations/{org_id}/analytics med metrikkene du ønsker.
  4. Hvis svaret er 202 eller meta.pending ikke er tom, venter du på Retry-After og sender den identiske forespørselen på nytt. Analyser beregnes asynkront – metrikker som fortsatt behandles, utelates; de er ikke null. Ikke behandle dem som null.
Du finner fullstendige forespørselsformater, metrikkkatalogen og eksempler i Les om organisasjonsanalyse.

Pilottilgang

Organisasjonsanalyse via MCP og API-et er valgfritt mens løsningen er i pilot. Padlet registrerer organisasjonens eier – det er ikke nok å være administrator. Før organisasjonen er registrert, svarer alle kall med 404 (samme svar som for en ukjent organisasjon).

Foreløpig støttes bare organisasjoner med wksp_.

Kontakt brukerstøtte og be dem registrere organisasjonens eier for administratoranalyser.

Eksempler på spørsmål

Her er forslag du kan lime inn i MCP-klienten din. Tilpass ordlyden 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 hadde en nedgang?»
  • «Hvilke padleter i organisasjonen har flest visninger? Vis meg de tre ø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 utsnittet du trenger: en månedlig tidsserie, et rollefilter, de mest populære padletene etter innlegg eller besøkende, eller totalsummer for innholdssikkerhet for en skole eller et klasserom. Assistenten kobler spørsmålet ditt til de tilgjengelige metrikkene.

Dette er dashbordet fortsatt best på

Bruk analysesiden i Innstillinger når du vil ha:

  • Det visuelle oversiktsbanneret, fremhevede muligheter og muligheten til å be om faglig utvikling med ett klikk
  • Tabellen Alle brukere/Brukere med søk, rollefiltre og CSV-nedlasting med ett klikk
  • Nedlastbare lister over aktive og inaktive lærere for den valgte perioden fra fanen Oversikt (skoler og klasserom)
  • En visning som ikke krever pilotregistrering – Innstillinger-siden er tilgjengelig for kvalifiserte roller uten API-registrering

MCP og API-et er nyttige når de utvalgte fanene ikke svarer på akkurat det du trenger til en demo eller fornyelsessamtale.

Begrensninger:

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

Vanlige spørsmål

Hvorfor får jeg 404 når jeg ber om analyser?

Mens endepunktet er i pilot, ser alle avslag like ut: manglende registrering, ukjent organisasjon eller manglende tilgang gir alle 404. Kontroller at du er logget inn som administrator (eller lærer i et Classroom), at organisasjonen din har en ID som begynner med wksp_, og at Padlet har registrert organisasjonens eier. Kontakt brukerstøtte for å be om registrering.

Må jeg skrive kode?

Nei. Koble til Padlet MCP, logg inn som administrator og still spørsmål i naturlig språk. API-metoden er valgfri for utviklere og avanserte brukere som allerede bruker Public API.

Er dette det samme som Public API?

Det henger sammen, men er ikke det samme produktet. 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 når organisasjonen din er registrert; du kan bruke én av dem 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 API-et for organisasjonsanalyse direkte. Hvis du fortsatt ikke får tilgang etter registreringen, ta kontakt med oss.

Relatert

Var denne artikkelen nyttig?

Relaterte artikler

Gå til diagnosessiden

Feilsøk Padlet-problemer ved hjelp av diagnostiske verktøy på nettet eller mobilen, og kontakt kundestøtte med resultatene hvis nødvendig.

Hvordan tilbakestiller jeg Apple-ID-en min?

Tilbakestill Apple-ID-en din for Padlet ved å fjerne den fra Apple-ID-innstillingene og logge på igjen.

Jeg vil jobbe hos Padlet. Hvor skal jeg søke?

Utforsk karrieremuligheter hos Padlet og søk på ledige stillinger på padlet.jobs.

Hva skjer med dataene dine når en konto slettes?

Forstå hva som skjer når du sletter Padlet-kontoen din, og hvordan du kan gjenopprette den innen 14 dager.