كيف أطلب من Padlet MCP تحليلات المشرف (إصدار تجريبي)؟
تم التحديث قبل 13 ساعة بواسطة Carla Seseهل لا تعرض الأرقام التي تحتاج إليها لوحة تحكم المشرف في المدرسة أو الفريق بالطريقة التي تريدها؟ اربط Padlet MCP بمساعد ذكاء اصطناعي واطلب تحليلات المدرسة أو الفصل الدراسي أو الفريق بلغة بسيطة، أو استدعِ واجهة برمجة تطبيقات تحليلات المؤسسة بنفسك.
لمن هذا المقال؟
هذا المقال مخصص لما يلي:
- المالكين والمشرفين في حسابات Padlet for Schools أو Team
- المالكين والمعلمين في حسابات Classroom
لا تحتاج إلى كتابة أي شيفرة لاستخدام مسار MCP. أما مسار واجهة برمجة التطبيقات فهو اختياري للمستخدمين المتقدمين الذين يستخدمون واجهة برمجة التطبيقات العامة بالفعل.
ما المتاح لك بالفعل؟
تعرض صفحة التحليلات الخاصة بمؤسستك في الإعدادات علامات تبويب منتقاة للفترة الحالية من الفوترة. في المدارس والفصول الدراسية، تتوفر علامات التبويب «نظرة عامة» و«الاستخدام» و«الأثر» و«السلامة» و«أبرز المستخدمين» و«كل المستخدمين». أما الفرق، فتتوفر لها علامات التبويب «عام» و«Padlets» و«المستخدمون».
- تحليلات حساب المدرسة (Padlet for Schools وClassroom)
- تحليلات حساب الفريق
استخدم لوحة التحكم عندما تريد عرضًا مرئيًا سريعًا. واستخدم MCP أو واجهة برمجة التطبيقات عندما تحتاج إلى عرض مخصص لا تجيب عنه علامات التبويب بوضوح.
ما الذي يضيفه MCP / API؟
تتضمن لوحة التحكم علامات تبويب منتقاة. أما MCP وواجهة برمجة التطبيقات، فيتيحان لك طلب العرض المحدد الذي تحتاج إليه:
- طرح أسئلة بلغة بسيطة في عميل الذكاء الاصطناعي («أي المعلمين لم يكونوا نشطين في فترة الفوترة السابقة؟»)
- مزج مخصص لمقاييس التفاعل والعضوية وسلامة المحتوى
- سلاسل شهرية ضمن نطاق زمني
- تقسيم حسب الدور (المعلمون مقابل الطلاب، والمنشئون مقابل المساهمين)
- ترتيب أبرز Padlets والمستخدمين والوسائط بالطريقة التي تحددها
- إجابات يمكنك إدراجها في عرض مراجعة الأعمال ربع السنوية (QBR) أو عرض التجديد
البدء السريع باستخدام Padlet MCP
- اربط Padlet MCP بعميل الذكاء الاصطناعي لديك. استخدم عنوان URL للخادم
https://mcp.padlet.com. ستجد خطوات الإعداد الكاملة في خادم Padlet MCP. - سجّل الدخول وامنح الإذن بصفتك مشرفًا في المؤسسة التي تريد الاستعلام عنها. وفي Classroom، يمكن للمدرس أيضًا استخراج التحليلات.
- اطرح سؤالك بلغة بسيطة. لست بحاجة إلى ذكر أسماء الأدوات الداخلية. أخبر مساعد الذكاء الاصطناعي بما تريد معرفته عن مدرستك أو فصلك الدراسي أو فريقك، وسيستخدم Padlet MCP نيابةً عنك.
إليك مثالًا:
اختياري: واجهة برمجة تطبيقات تحليلات المؤسسة
هل تفضل تنفيذ ذلك برمجيًا بنفسك؟ استخدم واجهة برمجة التطبيقات العامة مع مفتاح API خاص بـمشرف (أو مفتاح معلم في Classroom).
- أنشئ مفتاح API أو انسخه من صفحة المطوّر في الإعدادات. تجد التفاصيل في مقال واجهة برمجة التطبيقات العامة.
- اعثر على معرّف مؤسستك باستخدام
GET /me?include=organizations. المطلوب معرّفwksp_— مؤسساتorg_على padlet.org غير مدعومة في نقطة النهاية هذه حتى الآن. - أرسل طلب
POSTإلى/organizations/{org_id}/analyticsمع المقاييس التي تريدها. - إذا كان الرد
202أو لم تكنmeta.pendingفارغة، فانتظر مدةRetry-Afterوأرسل الطلب نفسه تمامًا مرة أخرى. تُحتسب التحليلات بشكل غير متزامن — ويعني غياب مقياس قيد الانتظار أنه لم يكتمل احتسابه، لا أنه يساوي صفرًا. لا تعتبر القيمة قيد الانتظار صفرًا أبدًا.
الوصول التجريبي
404 (وهو الرد نفسه الذي يظهر عند الاستعلام عن مؤسسة غير معروفة).لا تُدعم حاليًا سوى المؤسسات ذات المعرّف
wksp_.تواصل مع الدعم واطلب منهم تسجيل مالك مؤسستك لإتاحة تحليلات المشرف.
أمثلة على الطلبات
هذه أمثلة أولية يمكنك لصقها في عميل MCP. عدّل الصياغة لتناسب مدرستك أو فصلك الدراسي أو فريقك، وتحقق من الأرقام بمقارنتها بصفحة التحليلات عند إعداد عرض مخصص للعملاء.
- «بالنسبة إلى مدرستنا في فترة الفوترة هذه، كم عدد المعلمين النشطين مقارنةً بعدد التراخيص، وفي أي الأشهر انخفض النشاط؟»
- «ما Padlets التابعة للمؤسسة الأكثر مشاهدة؟ أعطني أفضل 3 لوحات/sandbox.»
- «أي الأعضاء الذين لديهم دور معلم لم يستخدموا Padlet خلال آخر 12 شهرًا؟»
- «كم عدد الأعضاء الذين لا ينتهي نطاق بريدهم الإلكتروني بـ <ouremaildomain.edu>؟»
ما الذي تظل لوحة التحكم أفضل فيه؟
استخدم صفحة التحليلات في الإعدادات عندما تريد:
- لافتة «نظرة عامة» المرئية، وتنبيهات «أبرز فرص التحسين»، وطلب تطوير مهني بنقرة واحدة
- جدول «كل المستخدمين» / «المستخدمون» مع البحث وتصفية الأدوار وتنزيل ملف CSV بنقرة واحدة
- قوائم قابلة للتنزيل بالمعلمين النشطين وغير النشطين للفترة المحددة، من علامة تبويب «نظرة عامة» (للمدارس والفصول الدراسية)
- عرضًا لا يتطلب التسجيل في البرنامج التجريبي — فصفحة الإعدادات نفسها متاحة للأدوار المؤهلة دون الحاجة إلى تفعيل الوصول إلى واجهة برمجة التطبيقات
يتألق MCP وواجهة برمجة التطبيقات عندما لا تجيب علامات التبويب المنتقاة عن السؤال المحدد الذي تحتاج إليه لعرض توضيحي أو لمحادثة تجديد.
القيود:
- حدّ معدل الطلبات: 60 طلبًا في الساعة لكل مفتاح API ومؤسسة، بما في ذلك الاستعلامات المتكررة بعد
202 - النطاق الزمني: 24 شهرًا كحد أقصى في الطلب الواحد
- سلامة المحتوى: للمدارس والفصول الدراسية فقط — تتلقى الفرق استجابة
400عند طلب هذه المقاييس - أعداد العضوية: تعكس قائمة الأعضاء الحالية، وليس لقطة تاريخية للأعضاء في وقت سابق
- القيمة قيد الانتظار لا تساوي صفرًا: يغيب المقياس الذي لا يزال قيد الاحتساب عن الرد؛ فلا تعتبره صفرًا
- نوع المؤسسة:
wksp_فقط في الوقت الحالي
الأسئلة الشائعة
لماذا تظهر لي استجابة 404 عندما أطلب التحليلات؟
أثناء البرنامج التجريبي، تبدو جميع حالات الرفض متشابهة: فعدم التسجيل أو المؤسسة غير المعروفة أو عدم وجود صلاحية، كلها تُرجع 404. تأكد من تسجيل الدخول بصفتك مشرفًا (أو معلمًا في Classroom)، ومن أن معرّف مؤسستك يبدأ بـ wksp_، ومن أن Padlet سجّلت مالك المؤسسة. تواصل مع الدعم لطلب التسجيل.
هل أحتاج إلى كتابة شيفرة؟
لا. اربط Padlet MCP، وسجّل الدخول بصفتك مشرفًا، ثم اطرح سؤالك بلغة بسيطة. مسار واجهة برمجة التطبيقات اختياري للمطورين والمستخدمين المتقدمين الذين يستخدمون واجهة برمجة التطبيقات العامة بالفعل.
هل هذه هي واجهة برمجة التطبيقات العامة نفسها؟
هناك صلة بينهما، لكنهما ليستا الواجهة نفسها. واجهة برمجة التطبيقات العامة مخصصة للمطورين الذين يستخدمون مفتاح API. أما Padlet MCP، فهو مخصص لمساعدي الذكاء الاصطناعي الذين تمنحهم الإذن بتسجيل الدخول. ويمكن لكليهما الوصول إلى تحليلات المؤسسة بعد تسجيل مؤسستك؛ ويمكنك استخدام أحدهما أو كليهما.
هل يمكن للطلاب أو لغير المشرفين الاطلاع على تحليلات المؤسسة بهذه الطريقة؟
لا. تتطلب التحليلات أن تكون مشرفًا في المؤسسة، أو معلمًا في Classroom. ولا يتمتع المساعد إلا بصلاحيات الحساب الذي سجّلت الدخول به — ولا يتجاوزها.
يبدو أن عميل MCP لا يتعرف على التحليلات. ما الذي يمكنني تجربته؟
قد يتأخر تحديث قائمة الأدوات في بعض العملاء. جرّب إعادة ربط Padlet MCP، أو الانتقال إلى عميل آخر متوافق مع MCP، أو استخدام واجهة برمجة تطبيقات تحليلات المؤسسة مباشرةً. إذا استمر تعذّر الوصول بعد التسجيل، فتواصل معنا.
