Πώς μπορώ να ζητήσω από το Padlet MCP τα αναλυτικά στοιχεία διαχειριστή (Beta);

Η φωτογραφία προφίλ του/της Carla SeseΕνημερώθηκε πριν από 16 ώρες από Carla Sese

Χρειάζεστε αριθμούς που ο πίνακας διαχείρισης για Διαχειριστές του σχολείου ή της Ομάδας δεν παρουσιάζει όπως θέλετε; Συνδέστε το Padlet MCP με έναν βοηθό AI και ζητήστε αναλυτικά στοιχεία για το σχολείο, την τάξη ή την ομάδα σας σε απλή γλώσσα — ή καλέστε μόνοι σας το API αναλυτικών στοιχείων οργανισμού.

Για την πλήρη αναφορά REST (κατάλογο μετρήσεων, μορφές αιτημάτων και κωδικούς σφαλμάτων), ανατρέξτε στο Read organization analytics στη διεύθυνση docs.padlet.dev.

Σε ποιους απευθύνεται

Αυτό το άρθρο απευθύνεται σε:

  • Ιδιοκτήτες και Διαχειριστές λογαριασμών Padlet for Schools ή Team
  • Ιδιοκτήτες και εκπαιδευτικούς λογαριασμών Classroom

Δεν χρειάζεται να γράψετε κώδικα για να χρησιμοποιήσετε τη μέθοδο MCP. Η μέθοδος API είναι προαιρετική για προχωρημένους χρήστες που χρησιμοποιούν ήδη το Public API.

Τι έχετε ήδη στη διάθεσή σας

Η σελίδα Analytics του οργανισμού σας στις Ρυθμίσεις εμφανίζει ήδη επιλεγμένες καρτέλες για την τρέχουσα περίοδο χρέωσης. Τα σχολεία και οι τάξεις διαθέτουν τις καρτέλες Επισκόπηση, Χρήση, Αντίκτυπος, Ασφάλεια, Κορυφαίοι χρήστες και Όλοι οι χρήστες. Οι ομάδες διαθέτουν τις καρτέλες Γενικά, Padlet και Χρήστες ή, αν η Ομάδα σας έχει τη νέα σελίδα Analytics (beta), τις καρτέλες Επισκόπηση, Χρήση, Αντίκτυπος, Κορυφαίοι χρήστες και Όλοι οι χρήστες.

Χρησιμοποιήστε τον πίνακα διαχείρισης όταν θέλετε μια γρήγορη οπτική εικόνα. Χρησιμοποιήστε το MCP ή το API όταν χρειάζεστε μια προσαρμοσμένη ανάλυση που δεν καλύπτεται επαρκώς από τις καρτέλες.

Τι προσθέτει το MCP / API

Ο πίνακας διαχείρισης περιλαμβάνει επιλεγμένες καρτέλες. Το MCP και το API σάς επιτρέπουν να ζητάτε ακριβώς την ανάλυση που χρειάζεστε:

  • Ερωτήσεις σε απλή γλώσσα στον πελάτη AI που χρησιμοποιείτε («Ποιοι εκπαιδευτικοί ήταν ανενεργοί την προηγούμενη περίοδο χρέωσης;»)
  • Προσαρμοσμένους συνδυασμούς μετρήσεων αλληλεπίδρασης, συμμετοχής και ασφάλειας περιεχομένου
  • Μηνιαίες χρονοσειρές για ένα εύρος ημερομηνιών
  • Αναλύσεις ανά ρόλο (εκπαιδευτικοί έναντι μαθητών, δημιουργοί έναντι συνεισφερόντων)
  • Κορυφαία padlet, χρήστες και πολυμέσα, ταξινομημένα όπως ζητάτε
  • Απαντήσεις που μπορείτε να επικολλήσετε σε μια παρουσίαση QBR ή ανανέωσης
Οι μετρήσεις ασφάλειας περιεχομένου (σαρωμένα στοιχεία, στοιχεία που επισημάνθηκαν, ποσοστό εντοπισμού) διατίθενται μόνο για σχολεία και τάξεις. Αν τις ζητήσετε για έναν οργανισμό τύπου Team, θα εμφανιστεί σφάλμα και όχι μηδενική τιμή.

Γρήγορη εκκίνηση με το Padlet MCP

  1. Συνδέστε το Padlet MCP στον πελάτη AI που χρησιμοποιείτε. Χρησιμοποιήστε τη διεύθυνση URL του διακομιστή https://mcp.padlet.com. Τα πλήρη βήματα εγκατάστασης βρίσκονται στο Padlet MCP Server.
  2. Συνδεθείτε και δώστε εξουσιοδότηση ως Διαχειριστής του οργανισμού για τον οποίο θέλετε να υποβάλετε ερωτήματα. Σε ένα Classroom, μπορεί επίσης να αντλήσει αναλυτικά στοιχεία ένας εκπαιδευτικός.
  3. Κάντε ερωτήσεις σε απλή γλώσσα. Δεν χρειάζεται να αναφέρετε εσωτερικά εργαλεία. Πείτε στον βοηθό AI τι θέλετε να μάθετε για το σχολείο, την τάξη ή την ομάδα σας και θα χρησιμοποιήσει το Padlet MCP για λογαριασμό σας.

Δείτε ένα παράδειγμα:

Αν ένας συγκεκριμένος πελάτης MCP δεν εμφανίζει ακόμη απαντήσεις για αναλυτικά στοιχεία, δοκιμάστε έναν άλλον πελάτη συμβατό με MCP ή χρησιμοποιήστε το API αναλυτικών στοιχείων οργανισμού. Η υποστήριξη από τους πελάτες μπορεί να καθυστερεί σε σχέση με τον διακομιστή.
Ο βοηθός ενεργεί ως εσείς. Μπορεί να αντλήσει μόνο τα αναλυτικά στοιχεία που επιτρέπεται να βλέπει ο λογαριασμός σας μετά τη σύνδεση.

Προαιρετικά: API αναλυτικών στοιχείων οργανισμού

Προτιμάτε να γράψετε δικά σας σκριπτ; Χρησιμοποιήστε το Public API με ένα κλειδί API Διαχειριστή (ή με κλειδί εκπαιδευτικού σε ένα Classroom).

  1. Δημιουργήστε ή αντιγράψτε ένα κλειδί API από τη σελίδα Developer στις Ρυθμίσεις σας. Λεπτομέρειες θα βρείτε στο άρθρο Public API.
  2. Βρείτε το αναγνωριστικό του οργανισμού σας με το GET /me?include=organizations. Χρειάζεστε ένα αναγνωριστικό wksp_ — οι οργανισμοί org_ στο padlet.org δεν υποστηρίζονται ακόμη από αυτό το τελικό σημείο.
  3. Στείλτε ένα αίτημα POST στο /organizations/{org_id}/analytics με τις μετρήσεις που θέλετε.
  4. Αν η απόκριση είναι 202 ή το meta.pending δεν είναι κενό, περιμένετε όσο υποδεικνύει το Retry-After και στείλτε ξανά το ίδιο αίτημα. Τα αναλυτικά στοιχεία υπολογίζονται ασύγχρονα — μια μέτρηση που εκκρεμεί απουσιάζει, δεν είναι μηδενική. Μην εκλαμβάνετε ποτέ τις εκκρεμείς μετρήσεις ως μηδενικές.
Οι πλήρεις μορφές αιτημάτων, ο κατάλογος μετρήσεων και παραδείγματα υπάρχουν στο Read organization analytics.

Πρόσβαση στο πιλοτικό πρόγραμμα

Τα αναλυτικά στοιχεία οργανισμού μέσω MCP και API είναι προαιρετικά κατά τη διάρκεια του πιλοτικού προγράμματος. Η Padlet εγγράφει τον ιδιοκτήτη του οργανισμού — το να είστε απλώς Διαχειριστής δεν αρκεί. Μέχρι να εγγραφεί ο οργανισμός σας, κάθε κλήση επιστρέφει 404 (την ίδια απόκριση με έναν άγνωστο οργανισμό).

Προς το παρόν υποστηρίζονται μόνο οργανισμοί wksp_.

Επικοινωνήστε με την υποστήριξη και ζητήστε να εγγράψουν τον ιδιοκτήτη του οργανισμού σας για πρόσβαση στα αναλυτικά στοιχεία Διαχειριστή.

Ενδεικτικές προτροπές

Μπορείτε να αντιγράψετε αυτά τα παραδείγματα στον πελάτη MCP που χρησιμοποιείτε. Προσαρμόστε τη διατύπωση στο σχολείο, την τάξη ή την ομάδα σας — και επαληθεύστε τους αριθμούς στη σελίδα Analytics όταν ετοιμάζετε μια παρουσίαση για πελάτες.

  • «Για το σχολείο μας αυτήν την περίοδο χρέωσης, πόσοι εκπαιδευτικοί είναι ενεργοί σε σχέση με τον αριθμό των αδειών και ποιους μήνες σημειώθηκε πτώση;»
  • «Ποια padlet του οργανισμού έχουν τις περισσότερες προβολές; Δώσε μου τα 3 κορυφαία board/sandbox.»
  • «Ποια μέλη με ρόλο εκπαιδευτικού δεν έχουν χρησιμοποιήσει το Padlet τους τελευταίους 12 μήνες;»
  • «Πόσα μέλη δεν έχουν τη διεύθυνση ηλεκτρονικού ταχυδρομείου με τον τομέα <ouremaildomain.edu>;»
Ζητήστε την ανάλυση που χρειάζεστε: μηνιαία χρονοσειρά, φίλτρο ρόλου, κορυφαία padlet βάσει αναρτήσεων ή επισκεπτών ή σύνολα ασφάλειας περιεχομένου για ένα σχολείο ή μια τάξη. Ο βοηθός θα αντιστοιχίσει την ερώτησή σας στις διαθέσιμες μετρήσεις.

Τι εξακολουθεί να κάνει καλύτερα ο πίνακας διαχείρισης

Χρησιμοποιήστε τη σελίδα Analytics στις Ρυθμίσεις όταν θέλετε:

  • Το οπτικό πλαίσιο Επισκόπησης, τις επισημάνσεις κορυφαίων ευκαιριών και τη δυνατότητα υποβολής αιτήματος για επιμόρφωση με ένα κλικ
  • Τον πίνακα Όλοι οι χρήστες / Χρήστες με αναζήτηση, φίλτρα ρόλων και λήψη CSV με ένα κλικ
  • Λήψη καταλόγων ενεργών και ανενεργών εκπαιδευτικών για την επιλεγμένη περίοδο από την καρτέλα Επισκόπηση (σχολεία και τάξεις)
  • Μια προβολή που δεν απαιτεί εγγραφή στο πιλοτικό πρόγραμμα — η ίδια η σελίδα Ρυθμίσεων είναι διαθέσιμη σε κατάλληλους ρόλους χωρίς ενεργοποίηση πρόσβασης API

Το MCP και το API είναι ιδανικά όταν οι επιλεγμένες καρτέλες δεν απαντούν ακριβώς στην ερώτηση που χρειάζεστε για μια παρουσίαση ή μια συζήτηση ανανέωσης.

Περιορισμοί:

  • Όριο ρυθμού αιτημάτων: 60 αιτήματα ανά ώρα για κάθε κλειδί API και οργανισμό, συμπεριλαμβανομένων των επαναληπτικών ελέγχων μετά από μια απόκριση 202
  • Εύρος ημερομηνιών: έως 24 μήνες ανά αίτημα
  • Ασφάλεια περιεχομένου: μόνο για σχολεία και τάξεις — για αυτές τις μετρήσεις, οι ομάδες λαμβάνουν απόκριση 400
  • Αριθμός μελών: αντικατοπτρίζει τον τρέχοντα κατάλογο μελών, όχι ιστορικό στιγμιότυπο των μελών που ανήκαν στον οργανισμό τη συγκεκριμένη περίοδο
  • Εκκρεμεί ≠ μηδέν: μια μέτρηση που υπολογίζεται ακόμη απουσιάζει από την απόκριση· μην την εκλαμβάνετε ως μηδενική
  • Τύπος οργανισμού: προς το παρόν υποστηρίζεται μόνο το wksp_

Συχνές ερωτήσεις

Γιατί λαμβάνω απόκριση 404 όταν ζητώ αναλυτικά στοιχεία;

Κατά τη διάρκεια του πιλοτικού προγράμματος, όλες οι περιπτώσεις άρνησης έχουν την ίδια απόκριση: μη εγγεγραμμένος οργανισμός, άγνωστος οργανισμός ή έλλειψη πρόσβασης επιστρέφουν απόκριση 404. Βεβαιωθείτε ότι συνδεθήκατε ως Διαχειριστής (ή ως εκπαιδευτικός σε ένα Classroom), ότι ο οργανισμός σας είναι τύπου wksp_ και ότι η Padlet έχει εγγράψει τον ιδιοκτήτη του οργανισμού. Επικοινωνήστε με την υποστήριξη για να ζητήσετε την εγγραφή.

Χρειάζεται να γράψω κώδικα;

Όχι. Συνδέστε το Padlet MCP, συνδεθείτε ως Διαχειριστής και κάντε ερωτήσεις σε απλή γλώσσα. Η μέθοδος API είναι προαιρετική για προγραμματιστές και προχωρημένους χρήστες που χρησιμοποιούν ήδη το Public API.

Είναι το ίδιο με το Public API;

Σχετίζονται, αλλά δεν είναι το ίδιο προϊόν. Το Public API απευθύνεται σε προγραμματιστές που χρησιμοποιούν κλειδί API. Το Padlet MCP απευθύνεται σε βοηθούς AI στους οποίους δίνετε εξουσιοδότηση συνδεόμενοι. Και τα δύο μπορούν να έχουν πρόσβαση στα αναλυτικά στοιχεία οργανισμού μόλις εγγραφεί ο οργανισμός σας· μπορείτε να χρησιμοποιήσετε το ένα ή και τα δύο.

Μπορούν οι μαθητές ή οι μη Διαχειριστές να δουν έτσι τα αναλυτικά στοιχεία οργανισμού;

Όχι. Για τα αναλυτικά στοιχεία απαιτείται Διαχειριστής του οργανισμού ή εκπαιδευτικός σε ένα Classroom. Ο βοηθός έχει ακριβώς τα ίδια δικαιώματα πρόσβασης με τον λογαριασμό που χρησιμοποιήσατε για να συνδεθείτε — τίποτα περισσότερο.

Ο πελάτης MCP που χρησιμοποιώ δεν φαίνεται να γνωρίζει τα αναλυτικά στοιχεία. Τι μπορώ να δοκιμάσω;

Ορισμένοι πελάτες ενημερώνουν τη λίστα εργαλείων τους με καθυστέρηση. Δοκιμάστε να επανασυνδέσετε το Padlet MCP, να μεταβείτε σε άλλον πελάτη συμβατό με MCP ή να χρησιμοποιήσετε απευθείας το API αναλυτικών στοιχείων οργανισμού. Αν εξακολουθείτε να μην έχετε πρόσβαση μετά την εγγραφή, επικοινωνήστε μαζί μας.

Σχετικά

Ήταν αυτό το άρθρο χρήσιμο;

Σχετικά άρθρα