كيف أطلب من Padlet MCP تحليلات المشرف؟

Foto de perfil de Carla SeseActualizado قبل 4 أيام por Carla Sese

هل لا تعرض لوحة تحكم المشرف في المدرسة أو الفريق الأرقام بالطريقة التي تريدها؟ اربط Padlet MCP بمساعد ذكاء اصطناعي واطلب تحليلات للمدرسة أو الفصول الدراسية أو الفريق بلغة واضحة، أو استدعِ واجهة برمجة تحليلات المؤسسة بنفسك.

للاطلاع على مرجع REST الكامل (كتالوج المقاييس، وصيغ الطلبات، ورموز الأخطاء)، راجع قراءة تحليلات المؤسسة على docs.padlet.dev.

لمن هذا المقال

هذا المقال موجّه إلى:

  • المالكين والمشرفين في حسابات Padlet for Schools أو Team
  • المالكين والمعلمين في حسابات Classroom

لا تحتاج إلى كتابة أي شيفرة لاستخدام مسار MCP. ومسار واجهة برمجة التطبيقات اختياري للمستخدمين المتقدمين الذين يستخدمون واجهة برمجة التطبيقات العامة بالفعل.

ما لديك بالفعل

تعرض صفحة التحليلات الخاصة بمؤسستك في الإعدادات علامات تبويب منتقاة للفترة الحالية من الفوترة. تحصل المدارس والفصول الدراسية على علامات تبويب «نظرة عامة» و«الاستخدام» و«التأثير» و«السلامة» و«أفضل المستخدمين» و«جميع المستخدمين». وتحصل الفرق على «عام» و«Padlets» و«المستخدمون»، أو على «نظرة عامة» و«الاستخدام» و«التأثير» و«أفضل المستخدمين» و«جميع المستخدمين» إذا كان فريقك يستخدم صفحة التحليلات الجديدة (نسخة تجريبية).

استخدم لوحة التحكم عندما تريد لمحة مرئية سريعة. واستخدم MCP أو واجهة برمجة التطبيقات عندما تحتاج إلى تقسيم مخصص لا تجيب عنه علامات التبويب بوضوح.

ما الذي يضيفه MCP / API

تعرض لوحة التحكم علامات تبويب منتقاة. أما MCP وواجهة برمجة التطبيقات فيتيحان لك طلب التقسيم الذي تحتاج إليه تحديدًا:

  • طرح أسئلة بلغة واضحة في عميل الذكاء الاصطناعي ("أي المعلمين لم يكونوا نشطين في فترة الفوترة السابقة؟")
  • مزج مخصص لمقاييس التفاعل والعضوية وسلامة المحتوى
  • سلاسل شهرية ضمن نطاق زمني
  • تقسيم حسب الدور (المعلمون مقابل الطلاب، والمنشئون مقابل المساهمين)
  • أفضل Padlets وأفضل المستخدمين وأفضل الوسائط، مرتبة بالطريقة التي تطلبها
  • إجابات يمكنك لصقها في عرض المراجعة الفصلية للأعمال (QBR) أو عرض تجديد الاشتراك
مقاييس سلامة المحتوى (العناصر التي جرى فحصها، والعناصر التي تم الإبلاغ عنها، ومعدل الاكتشاف) متاحة للمدارس والفصول الدراسية فقط. وسيؤدي طلبها لمؤسسة من نوع Team إلى ظهور خطأ، لا إلى إرجاع قيمة صفر.

البدء السريع باستخدام Padlet MCP

  1. اربط Padlet MCP بعميل الذكاء الاصطناعي لديك. استخدم عنوان الخادم https://mcp.padlet.com. تجد خطوات الإعداد كاملة في خادم Padlet MCP.
  2. سجّل الدخول وفوّض الوصول بصفتك مشرفًا للمؤسسة التي تريد الاستعلام عنها. وفي Classroom، يمكن للمعلم أيضًا استخراج التحليلات.
  3. اطرح سؤالك بلغة واضحة. لا تحتاج إلى ذكر أسماء الأدوات الداخلية. أخبر مساعد الذكاء الاصطناعي بما تريد معرفته عن مدرستك أو صفك الدراسي أو فريقك، وسيستخدم Padlet MCP نيابةً عنك.

إليك مثالًا:

إذا لم يعرض عميل MCP معيّن إجابات التحليلات بعد، فجرّب عميلًا آخر متوافقًا مع MCP، أو استخدم واجهة برمجة تحليلات المؤسسة بدلًا من ذلك. فقد يتأخر دعم العميل عن دعم الخادم.
يعمل المساعد بالنيابة عنك، ولا يمكنه استخراج سوى التحليلات التي يحق لحسابك المسجل دخوله الاطلاع عليها.

اختياري: واجهة برمجة تحليلات المؤسسة

هل تفضّل كتابة النصوص البرمجية بنفسك؟ استخدم واجهة برمجة التطبيقات العامة مع مفتاح API خاص بـمشرف (أو مفتاح معلم في Classroom).

  1. أنشئ مفتاح API أو انسخه من صفحة المطوّرين في الإعدادات. تجد التفاصيل في مقالة واجهة برمجة التطبيقات العامة.
  2. اعثر على معرّف مؤسستك باستخدام GET /me?include=organizations. المطلوب معرّف يبدأ بـ wksp_. مؤسسات org_ على padlet.org غير مدعومة حاليًا في نقطة النهاية هذه.
  3. أرسل طلب POST إلى /organizations/{org_id}/analytics متضمنًا المقاييس التي تريدها.
  4. إذا كانت الاستجابة 202 أو لم تكن meta.pending فارغة، فانتظر المدة المحددة في Retry-After ثم أعد إرسال الطلب نفسه تمامًا. تُحتسب التحليلات في الخلفية، ولذلك لا يظهر المقياس قيد الانتظار في الاستجابة. لا تعتبره أبدًا صفرًا.
تجد صيغ الطلبات الكاملة وكتالوج المقاييس والأمثلة التطبيقية في قراءة تحليلات المؤسسة.

من يمكنه استخدام هذه الميزة

تحليلات المؤسسة عبر Padlet MCP وواجهة برمجة التطبيقات متاحة للمالكين والمشرفين في حسابات Padlet for Schools وTeam، وللمالكين والمعلمين في حسابات Classroom. لا تحتاج إلى مطالبة Padlet بتفعيلها.

المؤسسات التي تحمل معرّفًا يبدأ بـ wksp_ هي المدعومة حاليًا فقط.

مطالبات نموذجية

هذه أمثلة يمكنك لصقها في عميل MCP. عدّل الصياغة لتناسب مدرستك أو صفك الدراسي أو فريقك، وتحقق من الأرقام بمقارنتها بصفحة التحليلات عند إعداد عرض موجّه للعملاء.

  • "بالنسبة إلى مدرستنا في فترة الفوترة الحالية، كم عدد المعلمين النشطين مقارنةً بعدد التراخيص، وفي أي الأشهر انخفض النشاط؟"
  • "أي Padlets في مؤسستنا حصلت على أكبر عدد من المشاهدات؟ أعطني أفضل 3 لوحات/sandbox."
  • "أي الأعضاء الذين لديهم دور معلم لم يستخدموا Padlet خلال آخر 12 شهرًا؟"
  • "كم عدد الأعضاء الذين لا ينتمون إلى نطاق البريد الإلكتروني <ouremaildomain.edu>؟"
اطلب التقسيم الذي تحتاج إليه: سلسلة شهرية، أو تصفية حسب الدور، أو أفضل Padlets حسب عدد المنشورات أو الزوار، أو إجمالي مقاييس سلامة المحتوى لمدرسة أو صف دراسي. وسيطابق المساعد سؤالك مع المقاييس المتاحة.

ما تزال لوحة التحكم تتفوق فيه

استخدم صفحة التحليلات في الإعدادات عندما تريد:

  • الشريط المرئي «نظرة عامة»، والتنبيهات حول أفضل فرص التحسين، وطلب التطوير المهني بنقرة واحدة
  • جدول «جميع المستخدمين» / «المستخدمون» مع إمكانية البحث والتصفية حسب الدور والتنزيل بنقرة واحدة بصيغة CSV
  • قوائم قابلة للتنزيل بالمعلمين النشطين وغير النشطين للفترة المحددة من علامة تبويب «نظرة عامة» (للمدارس والفصول الدراسية)

يتألق MCP وواجهة برمجة التطبيقات عندما لا تجيب علامات التبويب المنتقاة عن السؤال المحدد الذي تحتاج إليه لعرض توضيحي أو محادثة تجديد الاشتراك.

القيود:

  • حدّ الطلبات: 60 طلبًا في الساعة لكل مفتاح API ومؤسسة، بما في ذلك طلبات التحقق بعد استجابة 202
  • النطاق الزمني: 24 شهرًا كحد أقصى في الطلب الواحد
  • سلامة المحتوى: للمدارس والفصول الدراسية فقط. وستتلقى الفرق استجابة 400 عند طلب هذه المقاييس
  • أعداد العضوية: تعكس قائمة الأعضاء الحالية، لا لقطة تاريخية لمن كانوا أعضاء في ذلك الوقت
  • قيد الانتظار لا يعني صفرًا: المقياس الذي لا يزال قيد الاحتساب لا يظهر في الاستجابة؛ فلا تعتبره صفرًا
  • نوع المؤسسة: يقتصر حاليًا على wksp_

الأسئلة الشائعة

لماذا أتلقى خطأ 404 عند طلب التحليلات؟

تبدو جميع حالات الرفض متشابهة: فالمؤسسة غير المعروفة أو عدم امتلاك صلاحية الوصول يؤديان كلاهما إلى استجابة 404. تأكد من تسجيل الدخول بصفتك مشرفًا (أو معلمًا في Classroom) لتلك المؤسسة، ومن أن معرّفها يبدأ بـ wksp_. ما زلت تواجه مشكلة؟ تواصل مع الدعم.

هل أحتاج إلى كتابة شيفرة؟

لا. اربط Padlet MCP، وسجّل الدخول بصفتك مشرفًا، واطرح سؤالك بلغة واضحة. مسار واجهة برمجة التطبيقات اختياري للمطوّرين والمستخدمين المتقدمين الذين يستخدمون واجهة برمجة التطبيقات العامة بالفعل.

هل هذه هي واجهة برمجة التطبيقات العامة نفسها؟

إنهما مرتبطتان، لكنهما ليستا الواجهة نفسها. واجهة برمجة التطبيقات العامة مخصصة للمطوّرين الذين يستخدمون مفتاح API. أما Padlet MCP فهو مخصص لمساعدي الذكاء الاصطناعي الذين تفوّضهم عبر تسجيل الدخول. يمكن لكليهما الوصول إلى تحليلات المؤسسة، ويمكنك استخدام أي منهما أو كليهما.

هل يمكن للطلاب أو غير المشرفين الاطلاع على تحليلات المؤسسة بهذه الطريقة؟

لا. تتطلب التحليلات أن تكون مشرفًا للمؤسسة، أو معلمًا في Classroom. ويتمتع المساعد بالصلاحيات نفسها تمامًا التي يتمتع بها الحساب الذي سجلت الدخول به، ولا يتجاوزها.

يبدو أن عميل MCP الذي أستخدمه لا يعرف شيئًا عن التحليلات. ماذا أفعل؟

قد يتأخر تحديث قائمة الأدوات لدى بعض العملاء. جرّب إعادة ربط Padlet MCP، أو الانتقال إلى عميل آخر متوافق مع MCP، أو استخدام واجهة برمجة تحليلات المؤسسة مباشرةً. وإذا استمرت المشكلة، فتواصل معنا.

مقالات ذات صلة

¿Te resultó útil este artículo?

Artículos relacionados