Bagaimana cara meminta Analitik Admin kepada Padlet MCP?

Carla Sese profiilipiltUuendatud 4 hari yang lalu kasutaja Carla Sese poolt

Butuh angka yang tidak dapat ditampilkan sesuai keinginan di Dasbor Admin sekolah atau Tim? Hubungkan Padlet MCP ke asisten AI, lalu tanyakan analitik sekolah, ruang kelas, atau Tim dengan bahasa sehari-hari, atau panggil sendiri API analitik organisasi.

Untuk referensi REST lengkap (katalog metrik, format permintaan, dan kode error), lihat Membaca analitik organisasi di docs.padlet.dev.

Untuk siapa artikel ini

Artikel ini ditujukan untuk:

  • Pemilik dan Admin di akun Padlet for Schools atau Tim
  • Pemilik dan guru di akun ruang kelas

Anda tidak perlu menulis kode untuk menggunakan jalur MCP. Jalur API bersifat opsional bagi pengguna tingkat lanjut yang sudah menggunakan API Publik.

Yang sudah tersedia

Halaman Analitik organisasi di Pengaturan sudah menampilkan tab pilihan untuk periode penagihan saat ini. Sekolah dan ruang kelas memiliki tab Ikhtisar, Penggunaan, Dampak, Keamanan, Pengguna teratas, dan Semua pengguna. Tim memiliki tab Umum, Padlet, dan Pengguna, atau Ikhtisar, Penggunaan, Dampak, Pengguna teratas, dan Semua pengguna jika Tim Anda memiliki halaman Analitik baru (beta).

Gunakan dasbor untuk melihat ringkasan visual dengan cepat. Gunakan MCP atau API jika Anda memerlukan tampilan khusus yang tidak dapat dijawab dengan jelas oleh tab yang tersedia.

Fitur tambahan MCP / API

Dasbor menyediakan tab pilihan. MCP dan API memungkinkan Anda meminta tampilan yang benar-benar dibutuhkan:

  • Pertanyaan dengan bahasa sehari-hari di klien AI Anda ("guru mana yang tidak aktif pada periode penagihan terakhir?")
  • Kombinasi khusus metrik keterlibatan, keanggotaan, dan keamanan konten
  • Rangkaian data bulanan dalam rentang tanggal tertentu
  • Tampilan berdasarkan peran (guru vs. siswa, pembuat vs. kontributor)
  • Padlet, pengguna, dan media teratas yang diurutkan sesuai permintaan Anda
  • Jawaban yang dapat disalin ke presentasi QBR atau perpanjangan
Metrik keamanan konten (item yang dipindai, item yang ditandai, tingkat deteksi) hanya tersedia untuk sekolah dan ruang kelas. Jika diminta untuk organisasi Tim, akan muncul error, bukan nilai nol.

Mulai cepat dengan Padlet MCP

  1. Hubungkan Padlet MCP di klien AI Anda. Gunakan URL server https://mcp.padlet.com. Petunjuk penyiapan lengkap tersedia di Server Padlet MCP.
  2. Masuk dan berikan otorisasi sebagai Admin organisasi yang ingin Anda kueri. Di ruang kelas, guru juga dapat mengambil data analitik.
  3. Ajukan pertanyaan dengan bahasa sehari-hari. Anda tidak perlu menyebutkan nama alat internal. Beri tahu asisten AI apa yang ingin Anda ketahui tentang sekolah, ruang kelas, atau Tim Anda, dan asisten akan menggunakan Padlet MCP untuk membantu Anda.

Berikut contohnya:

Jika klien MCP tertentu belum menampilkan jawaban analitik, coba klien lain yang kompatibel dengan MCP atau gunakan API analitik organisasi. Dukungan klien mungkin belum mengikuti pembaruan server.
Asisten bertindak sebagai Anda. Asisten hanya dapat mengambil data analitik yang boleh dilihat oleh akun Anda yang sedang masuk.

Opsional: API analitik organisasi

Lebih suka membuat skrip sendiri? Gunakan API Publik dengan kunci API Admin (atau kunci guru untuk ruang kelas).

  1. Buat atau salin kunci API dari halaman Developer di Pengaturan. Detailnya tersedia di artikel API Publik.
  2. Temukan ID organisasi Anda dengan GET /me?include=organizations. Gunakan ID wksp_. Organisasi org_ di padlet.org belum didukung untuk endpoint ini.
  3. Kirim POST ke /organizations/{org_id}/analytics dengan metrik yang Anda inginkan.
  4. Jika responsnya 202 atau meta.pending tidak kosong, tunggu selama Retry-After, lalu kirim ulang permintaan yang sama persis. Analitik dihitung di latar belakang, sehingga metrik yang masih tertunda tidak disertakan dalam respons. Jangan pernah menganggapnya bernilai nol.
Format permintaan lengkap, katalog metrik, dan contoh penerapannya tersedia di Membaca analitik organisasi.

Siapa yang dapat menggunakannya

Analitik organisasi melalui Padlet MCP dan API tersedia bagi Pemilik dan Admin akun Padlet for Schools dan Tim, serta Pemilik dan guru di akun ruang kelas. Anda tidak perlu meminta Padlet untuk mengaktifkannya.

Saat ini, hanya organisasi wksp_ yang didukung.

Contoh prompt

Berikut beberapa contoh awal yang dapat Anda salin ke klien MCP. Sesuaikan kata-katanya dengan sekolah, ruang kelas, atau Tim Anda, lalu cocokkan angka-angkanya dengan halaman Analitik saat menyiapkan presentasi untuk pelanggan.

  • "Untuk sekolah kami pada periode penagihan ini, berapa jumlah guru aktif dibandingkan jumlah lisensi, dan bulan apa saja yang mengalami penurunan?"
  • "Padlet organisasi mana yang paling banyak dilihat? Berikan 3 board/sandbox teratas."
  • "Anggota mana yang berperan sebagai guru dan belum menggunakan Padlet dalam 12 bulan terakhir?"
  • "Berapa anggota yang tidak memiliki domain email <ouremaildomain.edu>?"
Minta tampilan yang Anda perlukan: rangkaian data bulanan, filter peran, Padlet teratas berdasarkan jumlah postingan atau pengunjung, atau total keamanan konten untuk sekolah atau ruang kelas. Asisten akan mencocokkan pertanyaan Anda dengan metrik yang tersedia.

Keunggulan dasbor

Gunakan halaman Analitik di Pengaturan jika Anda menginginkan:

  • Banner Ikhtisar visual, sorotan Peluang teratas, dan permintaan PD sekali klik
  • Tabel Semua pengguna / Pengguna dengan fitur pencarian, filter peran, dan unduhan CSV sekali klik
  • Daftar guru aktif dan tidak aktif yang dapat diunduh untuk periode yang dipilih, dari tab Ikhtisar (sekolah dan ruang kelas)

MCP dan API paling berguna saat tab pilihan tidak dapat menjawab pertanyaan spesifik yang Anda perlukan untuk demo atau pembahasan perpanjangan.

Batasan:

  • Batas laju: 60 permintaan per jam untuk setiap kunci API dan organisasi, termasuk pemeriksaan status setelah 202
  • Rentang tanggal: maksimal 24 bulan dalam satu permintaan
  • Keamanan konten: hanya untuk sekolah dan ruang kelas. Tim akan menerima 400 untuk metrik tersebut
  • Jumlah keanggotaan: mencerminkan daftar anggota saat ini, bukan cuplikan historis tentang siapa yang menjadi anggota pada waktu tertentu
  • Tertunda ≠ nol: metrik yang masih dihitung tidak disertakan dalam respons; jangan menganggapnya bernilai nol
  • Jenis organisasi: saat ini hanya wksp_

Tanya Jawab Umum

Mengapa saya menerima 404 saat meminta analitik?

Semua penolakan terlihat sama: organisasi yang tidak dikenal maupun tidak adanya akses sama-sama menghasilkan 404. Pastikan Anda masuk sebagai Admin (atau guru di ruang kelas) organisasi tersebut dan organisasi itu memiliki ID wksp_. Masih mengalami kendala? Hubungi dukungan.

Apakah saya perlu menulis kode?

Tidak. Hubungkan Padlet MCP, masuk sebagai Admin, lalu ajukan pertanyaan dengan bahasa sehari-hari. Jalur API bersifat opsional bagi developer dan pengguna tingkat lanjut yang sudah menggunakan API Publik.

Apakah ini sama dengan API Publik?

Terkait, tetapi bukan produk yang sama. API Publik ditujukan bagi developer yang menggunakan kunci API. Padlet MCP ditujukan bagi asisten AI yang Anda beri otorisasi dengan masuk. Keduanya dapat mengakses analitik organisasi, dan Anda dapat menggunakan salah satunya atau keduanya.

Apakah siswa atau pengguna non-Admin dapat melihat analitik organisasi dengan cara ini?

Tidak. Untuk mengakses analitik, Anda harus menjadi Admin organisasi atau guru di ruang kelas. Asisten memiliki akses yang persis sama dengan akun yang Anda gunakan untuk masuk, tidak lebih.

Klien MCP saya tampaknya tidak mengenali analitik. Apa yang harus saya coba?

Beberapa klien membutuhkan waktu untuk memperbarui daftar alatnya. Coba hubungkan kembali Padlet MCP, beralih ke klien lain yang kompatibel dengan MCP, atau gunakan API analitik organisasi secara langsung. Jika masih mengalami kendala, hubungi kami.

Terkait

Kas see artikkel oli abiks?

Seotud artiklid