Hvordan beder jeg Padlet MCP om administratoranalyse?

Carla Seseのプロフィール写真Carla Seseがfor 4 dage sidenに更新

Har du brug for tal, som skolens eller Holdets Admin-dashboard ikke viser på den måde, du ønsker? Forbind Padlet MCP med en AI-assistent, og bed om analyser af skolen, klasseværelset eller Holdet i et almindeligt sprog, eller kald selv organisationens analyse-API.

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

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 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 med 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 et tilpasset udsnit, som fanerne ikke besvarer så præcist.

Hvad MCP/API tilføjer

Dashboardet består af udvalgte faner. Med MCP og API'et kan du spørge efter præcis det udsnit, 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 metrikker for engagement, medlemskab og indholdssikkerhed
  • Månedlige serier for et datointerval
  • Opdelinger efter rolle (lærere kontra elever, oprettere kontra bidragydere)
  • Populære padlets, brugere og medier rangeret efter dine kriterier
  • Svar, du kan indsætte i en QBR- eller fornyelsespræsentation
Metrikker for indholdssikkerhed (scannede elementer, markerede elementer, registreringsgrad) er kun tilgængelige for skoler og klasseværelser. Hvis du anmoder 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 alle opsætningstrin i Padlet MCP-server.
  2. Log ind, og godkend som administrator af 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 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 i stedet bruge organisationens analyse-API. Klientunderstøttelsen kan være forsinket i forhold til serveren.
Din assistent handler på dine vegne. Den kan kun hente analyser, som din indloggede konto har tilladelse til at se.

Valgfrit: organisationens analyse-API

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

  1. Opret eller kopiér en API-nøgle fra siden Udvikler under Indstillinger. Du finder flere oplysninger i artiklen om 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 slutpunkt.
  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 er angivet i Retry-After, og sende den identiske anmodning igen. Analyser beregnes i baggrunden, så en metrik, der afventer, mangler i svaret. Behandl den aldrig som nul.
Du finder alle anmodningsformater, metrikoversigten og gennemarbejdede eksempler under Læs om organisationsanalyser.

Hvem kan bruge det?

Organisationsanalyser via Padlet MCP og API'et er tilgængelige for ejere og administratorer af Padlet for Schools- og Team-konti samt for ejere og lærere på Classroom-konti. Du behøver ikke bede Padlet om at aktivere funktionen.

Indtil videre understøttes kun organisationer med wksp_.

Eksempler på forespørgsler

Her er nogle eksempler, 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 aktive lærere har vi sammenlignet med antallet af licenser, og hvilke måneder var tallene lavere?"
  • "Hvilke padlets i organisationen har flest visninger? Giv mig de tre øverste tavler/sandboxe."
  • "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 det udsnit, du har brug for: en månedlig serie, et rollefilter, populære padlets efter antal opslag eller besøgende eller samlede tal for indholdssikkerhed for en skole eller et klasseværelse. Assistenten omsætter 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 med oversigten, fremhævelser af de vigtigste muligheder og en knap til at anmode om professionel udvikling
  • Tabellen Alle brugere/Brugere med søgning, rollefiltre og mulighed for at downloade en CSV-fil med ét klik
  • Downloadbare lister over aktive og inaktive lærere for den valgte periode fra fanen Oversigt (skoler og klasseværelser)

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

Begrænsninger:

  • Anmodningsgrænse: 60 anmodninger i timen pr. API-nøgle og organisation, inklusive gentagne forespørgsler efter et 202-svar
  • Datointerval: højst 24 måneder pr. anmodning
  • Indholdssikkerhed: kun for 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
  • 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?

Alle afviste anmodninger ser ens ud: En ukendt organisation og manglende adgang giver begge svaret 404. Kontrollér, at du er logget ind som administrator (eller lærer på et Classroom) af den pågældende organisation, og at det er en wksp_-organisation. Sidder du stadig fast? Kontakt support.

Skal jeg kunne 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 hente organisationsanalyser, og du kan bruge den ene eller begge.

Kan elever eller andre end administratorer se organisationsanalyser på denne måde?

Nej. Analyser kræver, at du er administrator af organisationen eller lærer på et Classroom. Assistenten har præcis samme adgang som den konto, du loggede ind med, hverken mere eller mindre.

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

Nogle klienter opdaterer deres værktøjsliste med forsinkelse. Prøv at genoprette forbindelsen til Padlet MCP, skifte til en anden MCP-kompatibel klient eller bruge organisationens analyse-API direkte. Hvis du stadig sidder fast, så kontakt os.

Relateret

この記事は役に立ちましたか?

関連記事