Πώς μπορώ να ζητήσω από το Padlet MCP τα Admin Analytics (Beta);
Atjaunināts πριν από 13 ώρες (autors: Carla Sese)Χρειάζεστε στοιχεία που ο Πίνακας Ελέγχου Διαχείρισης του σχολείου ή της ομάδας δεν αναλύει με τον τρόπο που θέλετε; Συνδέστε το Padlet MCP με έναν βοηθό τεχνητής νοημοσύνης και ζητήστε αναλυτικά στοιχεία για το σχολείο, την τάξη ή την ομάδα με απλή γλώσσα — ή καλέστε εσείς οι ίδιοι το API αναλυτικών στοιχείων του οργανισμού.
Σε ποιους απευθύνεται
Αυτό το άρθρο απευθύνεται σε:
- Ιδιοκτήτες και διαχειριστές λογαριασμών Padlet for Schools ή Team
- Ιδιοκτήτες και εκπαιδευτικούς σε λογαριασμούς Classroom
Δεν χρειάζεται να γράψετε κώδικα για να χρησιμοποιήσετε τη διαδρομή MCP. Η διαδρομή API είναι προαιρετική για τους προχωρημένους χρήστες που ήδη εργάζονται με το Δημόσιο API.
Τι έχετε ήδη
Η σελίδα «Αναλυτικά στοιχεία» του οργανισμού σας στις «Ρυθμίσεις» εμφανίζει ήδη επιλεγμένες καρτέλες για την τρέχουσα περίοδο χρέωσης. Τα σχολεία και οι τάξεις έχουν τις καρτέλες «Επισκόπηση», «Χρήση», «Αντίκτυπος», «Ασφάλεια», «Κορυφαίοι χρήστες» και «Όλοι οι χρήστες». Οι ομάδες έχουν τις καρτέλες «Γενικά», «Padlets» και «Χρήστες».
- Στατιστικά στοιχεία λογαριασμού σχολείου (Padlet for Schools και Classroom)
- Αναλυτικά στοιχεία λογαριασμού ομάδας
Χρησιμοποιήστε τον πίνακα ελέγχου όταν θέλετε μια γρήγορη οπτική εικόνα. Χρησιμοποιήστε το MCP ή το API όταν χρειάζεστε μια προσαρμοσμένη ανάλυση που οι καρτέλες δεν παρέχουν με την ίδια σαφήνεια.
Τι προσθέτει το MCP / API
Ο πίνακας ελέγχου αποτελείται από επιλεγμένες καρτέλες. Το MCP και το API σας επιτρέπουν να ζητήσετε ακριβώς τη λεπτομερή ανάλυση που χρειάζεστε:
- Ερωτήσεις σε απλή γλώσσα στον πελάτη AI σας («ποιοι εκπαιδευτικοί ήταν ανενεργοί την τελευταία περίοδο χρέωσης;»)
- Προσαρμοσμένοι συνδυασμοί δεικτών αφοσίωσης, συμμετοχής και ασφάλειας περιεχομένου
- Μηνιαίες σειρές δεδομένων για ένα εύρος ημερομηνιών
- Τμήματα ανά ρόλο (εκπαιδευτικοί έναντι μαθητών, δημιουργοί έναντι συνεισφερόντων)
- Τα κορυφαία padlets, οι κορυφαίοι χρήστες και τα κορυφαία μέσα, ταξινομημένα σύμφωνα με το πώς τα ζητάτε
- Απαντήσεις που μπορείτε να επικολλήσετε σε μια παρουσίαση QBR ή ανανέωσης
Γρήγορη εκκίνηση με το Padlet MCP
- Συνδέστε το Padlet MCP στον πελάτη AI σας. Χρησιμοποιήστε τη διεύθυνση URL του διακομιστή
https://mcp.padlet.com. Τα πλήρη βήματα ρύθμισης βρίσκονται στο Padlet MCP Server. - Συνδεθείτε και εξουσιοδοτήστε τον εαυτό σας ως διαχειριστής του οργανισμού για τον οποίο θέλετε να υποβάλετε ερώτηση. Σε μια τάξη, ένας εκπαιδευτικός μπορεί επίσης να ανακτήσει αναλυτικά στοιχεία.
- Κάντε την ερώτησή σας με απλά λόγια. Δεν χρειάζεται να αναφέρετε τα εσωτερικά εργαλεία. Πείτε στον βοηθό τεχνητής νοημοσύνης τι θέλετε να μάθετε για το σχολείο, την τάξη ή την ομάδα σας, και αυτός θα χρησιμοποιήσει το Padlet MCP εκ μέρους σας.
Ακολουθεί ένα παράδειγμα:
Προαιρετικό: API αναλυτικών στοιχείων οργανισμού
Προτιμάτε να δημιουργήσετε μόνοι σας το σενάριο; Χρησιμοποιήστε το Δημόσιο API με ένα κλειδί API διαχειριστή (ή ένα κλειδί εκπαιδευτικού στο Classroom).
- Δημιουργήστε ή αντιγράψτε ένα κλειδί API από τη σελίδα "Προγραμματιστές" στις Ρυθμίσεις σας. Λεπτομέρειες θα βρείτε στο άρθρο για το δημόσιο API.
- Βρείτε το αναγνωριστικό του οργανισμού σας με
GET /me?include=organizations. Χρειάζεστε έναwksp_αναγνωριστικό —org_οι οργανισμοί στο padlet.org δεν υποστηρίζονται ακόμη για αυτό το endpoint. - Στείλτε ένα
POSTστο/organizations/{org_id}/analyticsμε τις μετρήσεις που επιθυμείτε. - Εάν η απάντηση είναι
202ήmeta.pendingδεν είναι κενή, περιμένετε γιαRetry-Afterκαι στείλτε ξανά το ίδιο αίτημα. Οι αναλύσεις υπολογίζονται ασύγχρονα — μια εκκρεμής μέτρηση σημαίνει απουσία, όχι μηδέν. Μην θεωρείτε ποτέ την εκκρεμή τιμή ως μηδέν.
Πρόσβαση στο πιλοτικό πρόγραμμα
404 (την ίδια απάντηση με έναν άγνωστο οργανισμό).Προς το παρόν υποστηρίζονται μόνο
wksp_ οργανισμοί υποστηρίζονται προς το παρόν.Επικοινωνήστε με την υποστήριξη και ζητήστε τους να εγγράψουν τον ιδιοκτήτη του οργανισμού σας για αναλυτικά στοιχεία διαχειριστή.
Παραδείγματα προτροπών
Αυτά είναι παραδείγματα που μπορείτε να επικολλήσετε στον πελάτη MCP σας. Προσαρμόστε τη διατύπωση ώστε να ταιριάζει με το σχολείο, την τάξη ή την ομάδα σας — και επαληθεύστε τους αριθμούς σε σύγκριση με τη σελίδα «Αναλυτικά» όταν προετοιμάζετε μια παρουσίαση για τους πελάτες.
- «Για το σχολείο μας αυτή την περίοδο χρέωσης, πόσοι ενεργοί εκπαιδευτικοί υπάρχουν σε σχέση με τις άδειες χρήσης και ποιοι μήνες παρουσίασαν πτώση;»
- «Ποια padlets του οργανισμού έχουν τις περισσότερες προβολές; Δώστε μου τα 3 κορυφαία boards/sandbox.»
- «Ποια μέλη με ρόλο εκπαιδευτικού δεν έχουν χρησιμοποιήσει το Padlet τους τελευταίους 12 μήνες;»
- «Πόσα μέλη δεν έχουν το domain email <ouremaildomain.edu>;»
Σε τι εξακολουθεί να υπερέχει ο πίνακας ελέγχου
Μείνετε στη σελίδα «Analytics» στις «Ρυθμίσεις» όταν θέλετε:
- Το οπτικό banner «Επισκόπηση», τις επισημάνσεις κορυφαίων ευκαιριών και την αίτηση επαγγελματικής ανάπτυξης με ένα κλικ
- Ο πίνακας «Όλοι οι χρήστες / Χρήστες» με αναζήτηση, φίλτρα ρόλων και λήψη CSV με ένα κλικ
- Λίστες ενεργών και ανενεργών εκπαιδευτικών για την επιλεγμένη περίοδο, με δυνατότητα λήψης από την καρτέλα «Επισκόπηση» (σχολεία και τάξεις)
- Μια προβολή που δεν απαιτεί εγγραφή στο πιλοτικό πρόγραμμα — η ίδια η σελίδα «Ρυθμίσεις» είναι διαθέσιμη σε επιλέξιμους ρόλους χωρίς να απαιτείται ενεργοποίηση του API
Το MCP και το API αποδίδουν καλύτερα όταν οι επιλεγμένες καρτέλες δεν απαντούν ακριβώς στην ερώτηση που χρειάζεστε για μια επίδειξη ή μια συζήτηση ανανέωσης.
Περιορισμοί:
- Όριο αιτημάτων: 60 αιτήματα ανά ώρα ανά κλειδί API και οργανισμό, συμπεριλαμβανομένων των δημοσκοπήσεων μετά από
202 - Χρονικό εύρος: το πολύ 24 μήνες σε ένα αίτημα
- Ασφάλεια περιεχομένου: μόνο για σχολεία και τάξεις — οι ομάδες λαμβάνουν
400για αυτούς τους δείκτες - Αριθμός μελών: αντανακλά τον τρέχοντα κατάλογο, όχι ένα ιστορικό στιγμιότυπο του ποιος ανήκε εκείνη τη στιγμή
- «Σε εκκρεμότητα» ≠ μηδέν: μια μέτρηση που βρίσκεται ακόμη σε επεξεργασία λείπει από την απάντηση· μην την αντιμετωπίζετε ως μηδέν
- Τύπος οργανισμού:
wksp_μόνο προς το παρόν
Συχνές ερωτήσεις
Γιατί λαμβάνω σφάλμα 404 όταν ζητώ αναλυτικά στοιχεία;
Ενώ το endpoint βρίσκεται σε πιλοτική φάση, κάθε απόρριψη εμφανίζεται με τον ίδιο τρόπο: «δεν έχετε εγγραφεί», «άγνωστος οργανισμός» ή «καμία πρόσβαση» 404. Βεβαιωθείτε ότι έχετε συνδεθεί ως διαχειριστής (ή εκπαιδευτικός στο Classroom), ότι ο οργανισμός σας είναι wksp_ οργανισμός και ότι το Padlet έχει εγγράψει τον ιδιοκτήτη του οργανισμού. Επικοινωνήστε με την υποστήριξη για να ζητήσετε εγγραφή.
Πρέπει να γράψω κώδικα;
Όχι. Συνδέστε το Padlet MCP, συνδεθείτε ως διαχειριστής και υποβάλετε το αίτημά σας με απλά λόγια. Η διαδρομή API είναι προαιρετική για προγραμματιστές και προχωρημένους χρήστες που χρησιμοποιούν ήδη το Δημόσιο API.
Είναι το ίδιο με το Δημόσιο API;
Σχετίζεται, αλλά δεν είναι το ίδιο προϊόν. Το Δημόσιο API προορίζεται για προγραμματιστές που χρησιμοποιούν κλειδί API. Το Padlet MCP προορίζεται για βοηθούς τεχνητής νοημοσύνης που εξουσιοδοτείτε με τη σύνδεσή σας. Και τα δύο έχουν πρόσβαση στα αναλυτικά στοιχεία του οργανισμού μόλις εγγραφεί ο οργανισμός σας· μπορείτε να χρησιμοποιήσετε το ένα ή και τα δύο.
Μπορούν οι μαθητές ή οι μη διαχειριστές να δουν τα αναλυτικά στοιχεία του οργανισμού με αυτόν τον τρόπο;
Όχι. Για τα αναλυτικά στοιχεία απαιτείται διαχειριστής του οργανισμού ή εκπαιδευτικός σε ένα Classroom. Ο βοηθός έχει ακριβώς την ίδια πρόσβαση με τον λογαριασμό με τον οποίο συνδεθήκατε — τίποτα περισσότερο.
Ο πελάτης MCP μου δεν φαίνεται να αναγνωρίζει τα στατιστικά στοιχεία. Τι πρέπει να δοκιμάσω;
Ορισμένοι πελάτες ενημερώνουν τη λίστα εργαλείων τους με καθυστέρηση. Δοκιμάστε να επανασυνδέσετε το Padlet MCP, να αλλάξετε σε άλλο πρόγραμμα-πελάτη συμβατό με το MCP ή να χρησιμοποιήσετε απευθείας το API στατιστικών στοιχείων του οργανισμού. Εάν εξακολουθείτε να αντιμετωπίζετε προβλήματα πρόσβασης μετά την εγγραφή, επικοινωνήστε μαζί μας.
