كيف أطلب من Padlet MCP تحليلات المشرف (الإصدار التجريبي)؟
تم التحديث قبل 16 ساعة بواسطة Carla Seseهل تحتاج إلى أرقام لا يعرضها لوحة تحكم المشرف في المدرسة أو الفريق بالطريقة التي تريدها؟ اربط Padlet MCP بمساعد ذكاء اصطناعي واطلب تحليلات المدرسة أو الفصول الدراسية أو الفريق بلغة بسيطة، أو استدعِ واجهة برمجة التطبيقات لتحليلات المؤسسة بنفسك.
لمن هذا الدليل؟
هذا المقال موجّه إلى:
- المالكين والمشرفين في حسابات Padlet for Schools أو Team
- المالكين والمعلمين في حسابات Classroom
لا تحتاج إلى كتابة التعليمات البرمجية لاستخدام مسار MCP. مسار واجهة برمجة التطبيقات اختياري للمستخدمين المتقدمين الذين يستخدمون واجهة برمجة التطبيقات العامة بالفعل.
ما المتاح لديك بالفعل
تعرض صفحة التحليلات في مؤسستك ضمن الإعدادات علامات تبويب منتقاة للفترة الحالية للفوترة. تحصل المدارس والفصول الدراسية على علامات التبويب: نظرة عامة، والاستخدام، والأثر، والسلامة، وأبرز المستخدمين، وجميع المستخدمين. تحصل الفرق على علامات التبويب: عام، وPadlets، والمستخدمون؛ أو نظرة عامة، والاستخدام، والأثر، وأبرز المستخدمين، وجميع المستخدمين، إذا كان لدى فريقك صفحة التحليلات الجديدة (نسخة تجريبية).
- تحليلات حساب المدرسة (Padlet for Schools وClassroom)
- تحليلات حساب الفريق
استخدم لوحة التحكم عندما تريد لمحة مرئية سريعة. واستخدم MCP أو واجهة برمجة التطبيقات عندما تحتاج إلى تقسيم مخصص لا تجيب عنه علامات التبويب بوضوح.
ما الذي يضيفه MCP و/أو API؟
تعرض لوحة التحكم علامات تبويب منتقاة. أما MCP وواجهة برمجة التطبيقات فيتيحان لك طلب التقسيم الذي تحتاج إليه تحديدًا:
- طرح أسئلة بلغة بسيطة في عميل الذكاء الاصطناعي («أي المعلمين لم يكونوا نشطين في فترة الفوترة السابقة؟»)
- مزج مخصص لمقاييس التفاعل والعضوية وسلامة المحتوى
- سلاسل شهرية ضمن نطاق زمني
- تقسيمات حسب الدور (المعلمون مقابل الطلاب، ومنشئو المحتوى مقابل المساهمين)
- ترتيب أبرز padlets والمستخدمين والوسائط بالطريقة التي تطلبها
- إجابات يمكنك إدراجها في عرض مراجعة الأعمال ربع السنوية أو عرض التجديد
بدء سريع باستخدام 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، أو استخدام واجهة برمجة التطبيقات لتحليلات المؤسسة مباشرةً. إذا استمر تعذّر الوصول بعد التسجيل، تواصل معنا.
