Kā lūgt Padlet MCP administratora analīzi (beta versija)?

Профилна снимка на Carla SeseАктуализирано pirms 13 stundām от Carla Sese

Vai skolas vai komandas administratora paneļa dati nav sadalīti tā, kā jūs vēlaties? Savienojiet Padlet MCP ar AI palīgu un lūdziet skolas, klases vai komandas analītiku vienkāršā valodā — vai arī paši izsauciet organizācijas analītikas API.

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

Kam šis raksts ir domāts

Šis raksts ir paredzēts:

  • „Padlet for Schools” vai „Team” kontu īpašniekiem un administratoriem
  • „Classroom” kontu īpašniekiem un skolotājiem

Lai izmantotu MCP ceļu, nav nepieciešams rakstīt kodu. API ceļš ir fakultatīvs pieredzējušiem lietotājiem, kuri jau strādā ar publisko API.

Kas jums jau ir pieejams

Jūsu organizācijas analītikas lapā iestatījumos jau ir redzamas atlasītas cilnes par pašreizējo norēķinu periodu. Skolām un klasēm ir pieejamas cilnes „Pārskats”, „Izmantošana”, „Ietekme”, „Drošība”, „Populārākie lietotāji” un „Visi lietotāji”. Komandām ir pieejamas cilnes „Vispārīgi”, „Padlets” un „Lietotāji”.

Izmantojiet vadības paneli, ja vēlaties ātri iegūt vizuālu pārskatu. Izmantojiet MCP vai API, ja jums nepieciešama pielāgota informācija, ko cilnes nesniedz pietiekami skaidri.

Ko piedāvā MCP / API

Dashboard ir rūpīgi atlasītas cilnes. MCP un API ļauj jums pieprasīt tieši to informāciju, kas jums nepieciešama:

  • Vienkāršā valodā formulēti jautājumi jūsu AI klientā („kuri skolotāji bija neaktīvi pēdējā norēķinu periodā?”)
  • Pielāgotas iesaistīšanās, dalības un satura drošības rādītāju kombinācijas
  • Mēneša sērijas noteiktā datu diapazonā
  • Datu segmenti pēc lomām (skolotāji pret skolēniem, veidotāji pret līdzdalībniekiem)
  • Populārākie padleti, populārākie lietotāji un populārākie mediji, kas sarindoti atbilstoši jūsu pieprasījumam
  • Atbildes, kuras varat ielīmēt QBR vai atjaunošanas prezentācijā
Satura drošības rādītāji (pārbaudītie elementi, atzīmētie elementi, atklāšanas rādītājs) ir pieejami tikai skolām un klasēm. Ja tos pieprasa Team organizācijā, tiek atgriezta kļūda, nevis nulle.

Ātrs sākums ar Padlet MCP

  1. Savienojiet Padlet MCP ar savu AI klientu. Izmantojiet servera URL https://mcp.padlet.com. Pilnīga konfigurācijas instrukcija atrodama sadaļā „Padlet MCP Server”.
  2. Piesakieties un autorizējieties kā tās organizācijas administrators, par kuru vēlaties iegūt informāciju. Klasē arī skolotājs var iegūt analītiskos datus.
  3. Uzdodiet jautājumu vienkāršā valodā. Nav nepieciešams nosaukt iekšējos rīkus. Pastāstiet AI palīgam, ko vēlaties uzzināt par savu skolu, klasi vai komandu, un tas jūsu vietā izmantos Padlet MCP.

Lūk, piemērs:

Ja konkrētais MCP klients vēl neparāda analītikas atbildes, izmēģiniet citu ar MCP saderīgu klientu vai izmantojiet organizācijas analītikas API. Klienta atbalsts var atpalikt no servera.
Jūsu palīgs darbojas jūsu vietā. Tas var iegūt tikai tos analītiskos datus, kurus drīkst apskatīt jūsu pieteiktais konts.

Pēc izvēles: organizācijas analītikas API

Vēlaties to izstrādāt paši? Izmantojiet publisko API ar administratora API atslēgu (vai skolotāja atslēgu Classroom).

  1. Izveidojiet vai nokopējiet API atslēgu no izstrādātāja lapas savos iestatījumos. Sīkāka informācija ir rakstā par publisko API.
  2. Atrodiet savas organizācijas identifikatoru, izmantojot GET /me?include=organizations. Jums ir nepieciešams wksp_ ID — org_ organizācijas padlet.org šim galapunktam vēl netiek atbalstītas.
  3. Nosūtiet POST uz /organizations/{org_id}/analytics ar vēlamajiem rādītājiem.
  4. Ja atbilde ir 202 vai meta.pending nav tukša, pagaidiet, līdz Retry-After un nosūtiet identisku pieprasījumu vēlreiz. Analītika tiek aprēķināta asinhroni — gaidošais rādītājs ir neesošs, nevis nulle. Nekad neuzskatiet gaidošo rādītāju par nulli.
Pilnās pieprasījumu formas, rādītāju katalogs un praktiskie piemēri ir pieejami sadaļā „Lasīt organizācijas analītiku”.

Piekļuve izmēģinājuma versijai

Organizācijas analītika, izmantojot MCP un API, pilotposmā ir pieejama pēc pieteikšanās. Padlet reģistrē organizācijas īpašnieku — vienkārši būt par administratoru nav pietiekami. Kamēr jūsu organizācija nav reģistrēta, katrs izsaukums atbild 404 (tā pati atbilde kā nezināmai organizācijai).

Pašlaik tiek atbalstītas tikai wksp_ pašlaik tiek atbalstītas organizācijas.

Sazinieties ar atbalsta dienestu un lūdziet reģistrēt jūsu organizācijas īpašnieku administratora analītikai.

Piemēri

Šie ir sākuma jautājumi, kurus varat ielīmēt savā MCP klientā. Pielāgojiet formulējumu, lai tas atbilstu jūsu skolai, klasei vai komandai — un, gatavojot prezentāciju klientiem, pārbaudiet skaitļus, salīdzinot tos ar „Analītikas” lapu.

  • „Cik daudz aktīvo skolotāju salīdzinājumā ar licencēm ir mūsu skolā šajā norēķinu periodā un kuros mēnešos skaits samazinājās?”
  • „Kuru organizācijas Padlet dēļiem ir visvairāk skatījumu? Norādiet man 3 populārākos dēļus/sandbox.”
  • „Kuri locekļi ar skolotāja lomu pēdējo 12 mēnešu laikā nav izmantojuši Padlet?”
  • „Cik daudziem lietotājiem nav e-pasta domēna <ouremaildomain.edu>?”
Lūdziet vajadzīgo informāciju: ikmēneša datus, filtrēšanu pēc lomas, populārākos Padletus pēc ierakstiem vai apmeklētāju skaita, vai satura drošības kopskaitļus skolai vai klasei. Palīgs sasaistīs jūsu jautājumu ar pieejamajiem rādītājiem.

Kādas funkcijas paneļam joprojām padodas labāk

Izmantojiet „Analītikas” lapu iestatījumos, ja vēlaties:

  • Vizuālo pārskata baneri, populārāko iespēju izcēlumus un PD pieprasījumu ar vienu klikšķi
  • Tabula „Visi lietotāji / Lietotāji” ar meklēšanas funkciju, lomu filtriem un CSV faila lejupielādi ar vienu klikšķi
  • Lejupielādējami aktīvo un neaktīvo skolotāju saraksti par izvēlēto periodu no cilnes „Pārskats” (skolas un klases)
  • Skats, kam nav nepieciešama dalība pilotprojektā — pati iestatījumu lapa ir pieejama atbilstošajām lomām bez API piesakīšanās

MCP un API izceļas gadījumos, kad atlasītās cilnes nesniedz precīzu atbildi uz jautājumu, kas jums nepieciešams demonstrācijas vai līguma atjaunošanas sarunā.

Ierobežojumi:

  • Pieprasījumu limits: 60 pieprasījumi stundā uz vienu API atslēgu un organizāciju, ieskaitot aptaujas pēc 202
  • Laika periods: ne vairāk kā 24 mēneši vienā pieprasījumā
  • Satura drošība: tikai skola un klase — „Teams” saņem 400 par šiem rādītājiem
  • Dalībnieku skaits: atspoguļo pašreizējo sarakstu, nevis vēsturisku momentuzņēmumu par to, kuri tajā brīdī piederēja pie komandas
  • „Gaida apstrādi“ ≠ nulle: atbildē trūkst rādītāja, kas vēl tiek aprēķināts; to nedrīkst uzskatīt par nulli
  • Organizācijas tips: wksp_ tikai pagaidām

Bieži uzdotie jautājumi

Kāpēc, pieprasot analītiku, saņemu 404 kļūdu?

Kamēr galapunkts atrodas izmēģinājuma posmā, visi atteikumi izskatās vienādi: nav reģistrēts, nezināma organizācija vai nav piekļuves — visi atgriež 404. Pārliecinieties, ka esat pieteicies kā administrators (vai skolotājs Classroom vidē), ka jūsu organizācija ir wksp_ organizācija un ka Padlet ir reģistrējis organizācijas īpašnieku. Sazinieties ar atbalsta dienestu, lai pieprasītu reģistrāciju.

Vai man ir jāraksta kods?

Nē. Savienojiet Padlet MCP, piesakieties kā administrators un veiciet pieprasījumu vienkāršā valodā. API ceļš ir fakultatīvs izstrādātājiem un pieredzējušiem lietotājiem, kuri jau izmanto publisko API.

Vai tas ir tas pats, kas publiskais API?

Tie ir saistīti, bet nav viens un tas pats produkts. Publiskais API ir paredzēts izstrādātājiem, kuri izmanto API atslēgu. Padlet MCP ir paredzēts AI palīgiem, kurus jūs autorizējat, piesakoties. Abi var piekļūt organizācijas analītikai, tiklīdz jūsu organizācija ir reģistrēta; jūs varat izmantot vienu vai abus.

Vai studenti vai lietotāji, kas nav administratori, šādā veidā var apskatīt organizācijas analītiku?

Nē. Lai piekļūtu analītikai, ir nepieciešams organizācijas administrators vai Classroom skolotājs. Asistents ir tiesīgs piekļūt tieši tikpat daudz, cik konts, ar kuru esat pieteicies — ne vairāk.

Šķiet, ka mans MCP klients nezina par analītiku. Ko man vajadzētu mēģināt?

Daži klienti savu rīku sarakstu atjaunina ar nelielu kavēšanos. Mēģiniet atkārtoti savienot Padlet MCP, pāriet uz citu ar MCP saderīgu klientu vai tieši izmantot organizācijas analītikas API. Ja pēc reģistrācijas joprojām rodas problēmas, sazinieties ar mums.

Saistīts

Полезна ли беше тази статия?

Свързани статии