Padlet MCP'den Yönetici Analitiği (Beta) için nasıl istekte bulunabilirim?

Okul veya takım Yönetici Paneli’ndeki veriler istediğiniz şekilde sınıflandırılmıyor mu? Padlet MCP’yi bir yapay zeka asistanına bağlayın ve okul, sınıf veya takım analizlerini sade bir dille isteyin — ya da kuruluş analitiği API’sini kendiniz çağırın.

Bu makale kimler içindir

Bu makale şunlar içindir:

• Padlet for Schools veya Takım hesaplarının sahipleri ve yöneticileri
• Classroom hesaplarındaki sahipler ve öğretmenler

MCP yolunu kullanmak için kod yazmanıza gerek yoktur. API yolu, halihazırda Genel API ile çalışan ileri düzey kullanıcılar için isteğe bağlıdır.

Elinizde olanlar

Ayarlar'daki kuruluşunuzun Analitik sayfasında, mevcut fatura dönemi için seçilmiş sekmeler zaten gösterilmektedir. Okullar ve sınıflar için Genel Bakış, Kullanım, Etki, Güvenlik, En çok kullanan kullanıcılar ve Tüm kullanıcılar sekmeleri bulunur. Takımlar için ise Genel, Padlet'ler ve Kullanıcılar sekmeleri bulunur.

• Okul hesabı analitiği (Padlet for Schools ve Classroom)
• Takım hesabı analitiği

Hızlı bir görsel özet elde etmek istediğinizde kontrol panelini kullanın. Sekmelerin net bir cevap vermediği durumlarda, özel bir kesit elde etmek için MCP veya API'yi kullanın.

MCP / API'nin sağladığı avantajlar

Kontrol paneli, önceden düzenlenmiş sekmelerden oluşur. MCP ve API, tam olarak ihtiyacınız olan bilgiyi almanızı sağlar:

• AI istemcinizde sade dilde sorular ("son fatura döneminde hangi öğretmenler aktif değildi?")
• Etkileşim, üyelik ve içerik güvenliği metriklerinin özel kombinasyonları
• Belirli bir tarih aralığını kapsayan aylık seriler
• Rol dilimleri (öğretmenler ve öğrenciler, içerik oluşturucular ve katkıda bulunanlar)
• İstediğiniz şekilde sıralanmış en popüler padletler, en popüler kullanıcılar ve en popüler medya içerikleri
• QBR veya yenileme sunumuna yapıştırabileceğiniz yanıtlar

Padlet MCP ile hızlı başlangıç

1. AI istemcinize Padlet MCP'yi bağlayın. Sunucu URL'sini kullanın https://mcp.padlet.com. Tam kurulum adımları Padlet MCP Sunucusu'nda yer almaktadır.
2. Sorgulamak istediğiniz kuruluşun yöneticisi olarak oturum açın ve yetkilendirme yapın. Bir Sınıf ortamında, öğretmenler de analiz verilerini alabilir.
3. Sorguyu sade bir dille yapın. Dahili araçların adını belirtmenize gerek yoktur. AI asistanına okulunuz, sınıfınız veya ekibiniz hakkında ne bilmek istediğinizi söyleyin; asistan sizin adınıza Padlet MCP'yi kullanacaktır.

İşte bir örnek:

İsteğe bağlı: kuruluş analitiği API'si

Kendiniz komut dosyası yazmayı mı tercih edersiniz? Yönetici API anahtarı (veya Classroom'da öğretmen anahtarı) ile Genel API'yi kullanın.

1. Ayarlar'daki Geliştirici sayfasından bir API anahtarı oluşturun veya kopyalayın. Ayrıntılar, Genel API makalesinde yer almaktadır.
2. Kuruluş kimliğinizi şu şekilde bulun GET /me?include=organizations. İhtiyacınız olan şey bir wksp_ kimlik — org_ padlet.org'daki kuruluşlar bu uç nokta için henüz desteklenmemektedir.
3. Bir POST istek gönderin /organizations/{org_id}/analytics istediğiniz metrikleri içeren bir istek gönderin.
4. Yanıt 202 veya meta.pending boş değilse, Retry-After ve aynı isteği tekrar gönderin. Analizler eşzamansız olarak hesaplanır — bekleyen bir metrik, sıfır değil, yoktur. Bekleyen metrikleri asla sıfır olarak değerlendirmeyin.

Pilot erişim

Örnek komutlar

Bunlar, MCP istemcinize yapıştırabileceğiniz başlangıç örnekleridir. İfadeleri okulunuza, sınıfınıza veya ekibinize uyacak şekilde düzenleyin ve müşterilere sunacağınız bir sunum hazırlarken sayıları Analitik sayfasıyla karşılaştırarak doğrulayın.

• "Bu fatura döneminde okulumuzda aktif öğretmen sayısı ile lisans sayısı karşılaştırıldığında durum nedir ve hangi aylarda düşüş yaşandı?"
• "Hangi kuruluş Padlet'leri en çok görüntüleniyor? En çok görüntülenen ilk 3 pano/deneme ortamını gösterin."
• "Öğretmen rolüne sahip üyelerden hangileri son 12 ay içinde Padlet'i kullanmadı?"
• "<ouremaildomain.edu> e-posta etki alanına sahip olmayan kaç üye var?"

Kontrol panelinin hâlâ daha iyi yaptığı şeyler

İstediğiniz zaman Ayarlar'daki Analitik sayfasını kullanın:

• Görsel Genel Bakış başlığı, En iyi fırsatlar açıklamaları ve tek tıklamayla PD talebi
• Arama, rol filtreleri ve tek tıklamayla CSV indirme özelliğine sahip Tüm kullanıcılar / Kullanıcılar tablosu
• Genel Bakış sekmesinden (okullar ve sınıflar) seçilen dönem için aktif ve pasif öğretmenlerin indirilebilir listeleri
• Pilot kaydı gerektirmeyen bir görünüm — Ayarlar sayfası, API'ye kaydolmaya gerek kalmadan uygun rollere açıktır

MCP ve API, özenle hazırlanmış sekmelerin bir demo veya yenileme görüşmesi için ihtiyacınız olan soruyu tam olarak yanıtlamadığı durumlarda öne çıkar.

Sınırlamalar:

• İstek sınırı: API anahtarı ve kuruluş başına saatte 60 istek; buna, bir 202
• Tarih aralığı: tek bir istekte en fazla 24 ay
• İçerik güvenliği: Yalnızca okul ve sınıf — Teams, 400 bu metrikler için
• Üye sayıları: o anda kimin üye olduğuna dair geçmiş bir anlık görüntü değil, mevcut üye listesini yansıtır
• Beklemede ≠ sıfır: Hala hesaplanmakta olan bir metrik yanıtta yer almamaktadır; bunu sıfır olarak değerlendirmeyin
• Kuruluş türü: wksp_ şimdilik sadece

Sıkça Sorulan Sorular

İlgili

• Padlet MCP Sunucusu
• Okul hesabı analitiği
• Takım hesabı analitiği
• Genel API
• Kuruluş analizlerini okuma (geliştirici belgeleri)