Kā lūgt Padlet MCP nodrošināt administratoru analīzi (beta versijā)?

Carla Sese profila attēlsAtjaunināts pirms 16 stundām (autors: Carla Sese)

Vai jūsu skolas vai Komandas administratora panelī vajadzīgie dati nav sadalīti tā, kā vēlaties? Pievienojiet Padlet MCP AI asistentam un vienkāršā valodā pieprasiet skolas, klases vai Komandas analītikas datus, vai arī paši izmantojiet organizācijas analītikas API.

Pilnu REST atsauci (rādītāju katalogu, pieprasījumu formātus un kļūdu kodus) skatiet vietnē docs.padlet.dev, sadaļā Organizācijas analītikas datu lasīšana.

Kam tas paredzēts

Šis raksts ir paredzēts:

  • Īpašniekiem un administratoriem Padlet for Schools vai Team kontos
  • Īpašniekiem un skolotājiem Classroom kontos

Lai izmantotu MCP, kods nav jāraksta. API izmantošana nav obligāta un paredzēta pieredzējušiem lietotājiem, kuri jau strādā ar Publisko API.

Kas jums jau ir pieejams

Organizācijas sadaļā Iestatījumi pieejamajā lapā Analītika jau ir atlasītas cilnes ar datiem par pašreizējo norēķinu periodu. Skolām un klasēm pieejams pārskats, lietojums, ietekme, drošība, aktīvākie lietotāji un visi lietotāji. Komandām pieejamas cilnes Vispārīgi, Padlet un Lietotāji; ja jūsu Komandai ir jaunā analītikas lapa (beta versija), pieejams pārskats, lietojums, ietekme, aktīvākie lietotāji un visi lietotāji.

Ja vēlaties ātri iegūt vizuālu pārskatu, izmantojiet paneli. Ja vajadzīgs pielāgots datu griezums, ko ar cilnēm ērti iegūt nevar, izmantojiet MCP vai API.

Ko sniedz MCP / API

Panelī ir atlasītas cilnes. MCP un API ļauj pieprasīt tieši tādu datu griezumu, kāds jums vajadzīgs:

  • Uzdodiet jautājumus dabiskā valodā savam AI klientam (“kuri skolotāji iepriekšējā norēķinu periodā nebija aktīvi?”)
  • Pielāgotas iesaistes, dalības un satura drošības rādītāju kombinācijas
  • Mēnešu dati izvēlētā datumu diapazonā
  • Lomu griezumi (skolotāji un skolēni, satura veidotāji un līdzautori)
  • Aktīvākie padleti, lietotāji un mediji, sarindoti pēc jūsu pieprasījuma
  • Atbildes, ko varat ievietot ceturkšņa biznesa pārskatā vai līguma atjaunošanas prezentācijā
Satura drošības rādītāji (pārbaudītie vienumi, atzīmētie vienumi, noteikšanas rādītājs) ir pieejami tikai skolām un klasēm. Ja tos pieprasīsiet Team organizācijai, tiks parādīta kļūda, nevis nulle.

Ātrs sākums ar Padlet MCP

  1. Pievienojiet Padlet MCP savam AI klientam. Izmantojiet servera URL https://mcp.padlet.com. Pilnas iestatīšanas instrukcijas skatiet sadaļā Padlet MCP serveris.
  2. Pierakstieties un autorizējieties kā tās organizācijas administrators, par kuru vēlaties iegūt datus. Classroom kontā analītikas datus var iegūt arī skolotājs.
  3. Uzdodiet jautājumu dabiskā valodā. Nav jānosauc iekšējie rīki. Pastāstiet AI asistentam, ko vēlaties uzzināt par savu skolu, klasi vai Komandu, un tas jūsu vietā izmantos Padlet MCP.

Piemērs:

Ja konkrētais MCP klients vēl nevar parādīt analītikas atbildes, izmēģiniet citu ar MCP saderīgu klientu vai izmantojiet organizācijas analītikas API. Klientu atbalsts var atpalikt no servera iespējām.
Asistents rīkojas jūsu vārdā. Tas var iegūt tikai tos analītikas datus, kurus ir atļauts redzēt jūsu pierakstītajam kontam.

Papildiespēja: organizācijas analītikas API

Vēlaties izveidot skriptu pats? Izmantojiet Publisko API ar administratora API atslēgu (vai skolotāja atslēgu Classroom kontā).

  1. Izveidojiet vai nokopējiet API atslēgu lapā Izstrādātāji sadaļā Iestatījumi. Plašāku informāciju skatiet rakstā Publiskais API.
  2. Atrodiet savas organizācijas ID ar GET /me?include=organizations. Meklējiet ID, kas sākas ar wksp_ — org_ organizācijas vietnē padlet.org šim galapunktam pagaidām netiek atbalstītas.
  3. Nosūtiet POST pieprasījumu uz /organizations/{org_id}/analytics, norādot vajadzīgos rādītājus.
  4. Ja atbilde ir 202 vai meta.pending nav tukšs, uzgaidiet norādīto laiku galvenē Retry-After un vēlreiz nosūtiet identisku pieprasījumu. Analītikas dati tiek aprēķināti asinhroni, tāpēc gaidīšanas režīmā esošs rādītājs atbildē nav iekļauts — tas nav nulle. Nekad neuzskatiet gaidīšanas režīmā esošu rādītāju par nulli.
Pilnus pieprasījumu formātus, rādītāju katalogu un piemērus skatiet sadaļā Organizācijas analītikas datu lasīšana.

Piekļuve izmēģinājuma versijai

Organizācijas analītikas izmantošana ar MCP un API izmēģinājuma periodā ir jāaktivizē pēc izvēles. Padlet pievieno programmai organizācijas īpašnieku — ar administratora tiesībām vien nepietiek. Kamēr jūsu organizācija nav pievienota programmai, katrs pieprasījums atgriezīs 404 (tādu pašu atbildi kā nezināmai organizācijai).

Pagaidām tiek atbalstītas tikai organizācijas ar ID, kas sākas ar wksp_.

Sazinieties ar atbalsta dienestu un lūdziet pievienot jūsu organizācijas īpašnieku administratoru analītikas programmai.

Uzvedņu piemēri

Varat nokopēt šos sākuma piemērus un ielīmēt savā MCP klientā. Pielāgojiet formulējumu savai skolai, klasei vai Komandai un, gatavojot klientiem paredzētu prezentāciju, pārbaudiet skaitļus analītikas lapā.

  • “Cik aktīvu skolotāju un licenču mums bija šajā norēķinu periodā, un kuros mēnešos rādītāji kritās?”
  • “Kuriem organizācijas padletiem ir visvairāk skatījumu? Parādi trīs populārākos dēļus/sandbox.”
  • “Kuri dalībnieki ar skolotāja lomu pēdējo 12 mēnešu laikā nav izmantojuši Padlet?”
  • “Cik dalībniekiem nav e-pasta domēna <ouremaildomain.edu>?”
Pieprasiet vajadzīgo datu griezumu: mēnešu datus, lomu filtru, populārākos padletus pēc ziņu vai apmeklētāju skaita vai skolas vai klases satura drošības rādītājus. Asistents saistīs jūsu jautājumu ar pieejamajiem rādītājiem.

Ko joprojām labāk var paveikt panelī

Izmantojiet analītikas lapu sadaļā Iestatījumi, ja nepieciešams:

  • Vizuāls pārskata reklāmkarogs, sadaļas “Labākās iespējas” izcēlumi un iespēja ar vienu klikšķi pieprasīt profesionālo pilnveidi
  • Tabula “Visi lietotāji” / “Lietotāji” ar meklēšanu, lomu filtriem un iespēju ar vienu klikšķi lejupielādēt CSV failu
  • Atlasītā perioda aktīvo un neaktīvo skolotāju saraksti, ko var lejupielādēt pārskata cilnē (skolām un klasēm)
  • Skats, kam nav nepieciešama pievienošanās izmēģinājuma programmai — Iestatījumu lapa ir pieejama atbilstošo lomu lietotājiem bez API aktivizēšanas

MCP un API noder, ja atlasītās cilnes nesniedz atbildi uz konkrēto jautājumu, kas vajadzīgs demonstrācijai vai sarunai par līguma atjaunošanu.

Ierobežojumi:

  • Pieprasījumu ierobežojums: 60 pieprasījumi stundā katrai API atslēgas un organizācijas kombinācijai, ieskaitot atkārtotus pieprasījumus pēc 202 atbildes
  • Datumu diapazons: vienā pieprasījumā ne vairāk kā 24 mēneši
  • Satura drošība: tikai skolām un klasēm — Team organizācijām, pieprasot šos rādītājus, tiek atgriezta kļūda 400
  • Dalībnieku skaits: atspoguļo pašreizējo dalībnieku sarakstu, nevis vēsturisku momentuzņēmumu par to, kas bija organizācijas dalībnieki konkrētajā laikā
  • Gaida apstrādi ≠ nulle: aprēķināšanas procesā esošs rādītājs atbildē nav iekļauts; neuzskatiet to par nulli
  • Organizācijas veids: pagaidām tiek atbalstītas tikai organizācijas ar ID, kas sākas ar wksp_

Bieži uzdotie jautājumi

Kāpēc, pieprasot analītikas datus, tiek parādīta kļūda 404?

Kamēr galapunkts ir izmēģinājuma versijā, visiem atteikuma iemesliem tiek parādīta viena un tā pati atbilde: organizācija nav pievienota programmai, tā nav zināma vai jums nav piekļuves — visos gadījumos tiek atgriezta kļūda 404. Pārliecinieties, ka esat pierakstījies kā administrators (vai skolotājs Classroom kontā), ka jūsu organizācijas ID sākas ar wksp_ un ka Padlet ir pievienojis programmu organizācijas īpašniekam. Lai pieprasītu pievienošanu programmai, sazinieties ar atbalsta dienestu.

Vai man jāraksta kods?

Nē. Pievienojiet Padlet MCP, pierakstieties kā administrators un uzdodiet jautājumu dabiskā valodā. API ir papildu iespēja izstrādātājiem un pieredzējušiem lietotājiem, kuri jau izmanto Publisko API.

Vai tas ir tas pats, kas Publiskais API?

Šie rīki ir saistīti, taču nav viens un tas pats. Publiskais API paredzēts izstrādātājiem, kuri izmanto API atslēgu. Padlet MCP paredzēts AI asistentiem, kurus autorizējat, pierakstoties. Kad jūsu organizācija būs pievienota programmai, ar abiem rīkiem varēs piekļūt organizācijas analītikai. Varat izmantot vienu vai abus.

Vai skolēni vai lietotāji, kas nav administratori, šādi var skatīt organizācijas analītikas datus?

Nē. Analītikas datiem var piekļūt organizācijas administrators vai skolotājs Classroom kontā. Asistentam ir tieši tādas pašas piekļuves tiesības kā kontam, kurā pierakstījāties, un ne vairāk.

Mans MCP klients, šķiet, nezina par analītiku. Ko man izmēģināt?

Dažos klientos rīku saraksts tiek atjaunināts ar aizkavi. Mēģiniet atkārtoti pievienot Padlet MCP, pārslēgties uz citu ar MCP saderīgu klientu vai tieši izmantot organizācijas analītikas API. Ja pēc pievienošanās programmai joprojām nevarat piekļūt datiem, sazinieties ar mums.

Saistītie raksti

Vai šis raksts bija noderīgs?

Saistītie raksti