Πώς ζητάω από το Padlet MCP τα Analytics Διαχειριστή;

Carla Sese 的個人檔案照片由 Carla Sese 於 πριν από 4 ημέρες 更新

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

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

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

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

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

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

Τι έχετε ήδη

Η σελίδα Analytics του οργανισμού σας στις Ρυθμίσεις εμφανίζει ήδη επιλεγμένες καρτέλες για την τρέχουσα περίοδο χρέωσης. Τα σχολεία και οι τάξεις έχουν τις καρτέλες Overview, Usage, Impact, Safety, Top users και All users. Οι ομάδες έχουν τις καρτέλες General, Padlets και Users ή τις καρτέλες Overview, Usage, Impact, Top users και All users, αν η Ομάδα σας διαθέτει τη νέα σελίδα Analytics (beta).

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

Τι προσθέτουν τα MCP / API

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

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

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

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

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

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

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

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

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

Ποιοι μπορούν να το χρησιμοποιήσουν

Τα αναλυτικά στοιχεία οργανισμού μέσω Padlet MCP και API είναι διαθέσιμα σε Ιδιοκτήτες και Διαχειριστές λογαριασμών Padlet for Schools και Team, καθώς και σε Ιδιοκτήτες και εκπαιδευτικούς λογαριασμών Classroom. Δεν χρειάζεται να ζητήσετε από το Padlet να τα ενεργοποιήσει.

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

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

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

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

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

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

  • Το οπτικό πλαίσιο Overview, τις επισημάνσεις Top opportunity και το αίτημα επαγγελματικής ανάπτυξης με ένα κλικ
  • Τον πίνακα All users / Users με αναζήτηση, φίλτρα ρόλων και λήψη CSV με ένα κλικ
  • Λήψη λιστών ενεργών και ανενεργών εκπαιδευτικών για την επιλεγμένη περίοδο από την καρτέλα Overview (σχολεία και τάξεις)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Σχετικά

這篇文章有幫助嗎?

相關文章