Δοκιμή και Αποσφαλμάτωση
Σε αυτήν τη σελίδα
Μάθημα ξαναγράφηκε στις 3 Νοεμβρίου 2026 με βάση τις σελίδες Connect and test your plugin και Troubleshooting από την τεκμηρίωση των Προσθέτων OpenAI. Το πρώην “development playground” και οι εντολές του ανήκαν στο ανύπαρκτο SDK της πρώτης έκδοσης αυτού του μαθήματος. Πηγές: Σύνδεση και δοκιμή · Αντιμετώπιση προβλημάτων.
Δοκιμή ανά επίπεδο
Η OpenAI συνιστά να δοκιμάζετε κάθε δυνατότητα πριν αναπτύξετε το πλήρες εγκατεστημένο πρόσθετο: πρώτον τον αυτόνομο διακομιστή MCP συνδεδεμένο στο ChatGPT και έπειτα το συσκευασμένο πρόσθετο με τις δεξιότητές του. Διατηρήστε τις ερωτήσεις αξιολόγησης και τα αποτελέσματά τους καθ’ όλη τη διάρκεια της ανάπτυξης, ώστε να μπορείτε να συγκρίνετε τη συμπεριφορά μεταξύ των εκδόσεων.
Ο διακομιστής MCP
Προετοιμασία του σημείου τελικού
Πριν από τη δοκιμή στο ChatGPT, επαληθεύστε ότι ο διακομιστής είναι προσβάσιμος μέσω δημόσιου HTTPS—ή μέσω μιας Secure MCP Tunnel—ότι υποστηρίζει streamable HTTP (συνήθως στο /mcp), ότι υπάρχουν ονόματα εργαλείων, περιγραφές, σχήματα και σχολιασμοί, και ότι η ανακάλυψη ταυτοποίησης λειτουργεί για εργαλεία που απαιτούν λογαριασμό. Ένα tunnel ανάπτυξης είναι κατάλληλο για δοκιμές, αλλά όχι για υποβολή.
Επιθεώρηση
Το MCP Inspector καλεί τα εργαλεία σας απευθείας, χωρίς μοντέλο:
npx @modelcontextprotocol/inspector@latest
Υποβάλετε κάθε εργαλείο σε εξαντλητικό έλεγχο: αντιπροσωπευτικές εισόδους, οριακές περιπτώσεις, ελλείπουσες διαπιστευτήρια και κενά αποτελέσματα. Ελέγξτε την επικύρωση σχήματος, τα σφάλματα ταυτοποίησης, τους σχολιασμούς, τη συμπεριφορά επιβεβαίωσης και την έξοδο που είναι αναγνώσιμη από το μοντέλο.
Αξιολόγηση επιλογής εργαλείου
Μόλις ο διακομιστής συνδεθεί ως προσωπικό πρόσθετο (Μάθημα 4), εγκαταστήστε τον, ανοίξτε μια νέα συνομιλία, πληκτρολογήστε @ και επιλέξτε τον. Δημιουργήστε ένα σύνολο αξιολόγησης που περιλαμβάνει:
- Άμεσα αιτήματα που θα πρέπει να ενεργοποιούν ένα συγκεκριμένο εργαλείο·
- Έμμεσα αιτήματα που εκφράζουν τον ίδιο στόχο με διαφορετικό τρόπο·
- Αιτήματα παρακολούθησης που επαναχρησιμοποιούν αναγνωριστικά που αποκτήθηκαν νωρίτερα·
- Λειτουργίες εγγραφής που απαιτούν εξουσιοδότηση ή επιβεβαίωση·
- Αιτήματα εκτός πεδίου εφαρμογής που δεν πρέπει να ενεργοποιούν κανένα εργαλείο.
Για κάθε περίπτωση, καταγράψτε το επιλεγμένο εργαλείο, τα ορίσματά του, το αποτέλεσμα, τυχόν σφάλματα και τη συμπεριφορά επιβεβαίωσης. Επαναλάβετε ολόκληρο το σύνολο όποτε αλλάζετε ένα όνομα, περιγραφή, σχήμα ή σχολιασμό. Εάν ο διακομιστής επιστρέφει ένα στοιχείο διεπαφής χρήστη, δοκιμάστε τόσο το ίδιο το στοιχείο όσο και το αποτέλεσμα που είναι αναγνώσιμο από το μοντέλο.
Προβολή ακατέργαστων ανταλλαγών
Για να διαβάσετε πλήρη αιτήματα και αποκρίσεις, το API Playground δέχεται έναν διακομιστή MCP: μεταβείτε στο Tools → Add → MCP Server, εισαγάγετε τη διεύθυνση HTTPS, συνδεθείτε και, στη συνέχεια, εκτελέστε τις ερωτήσεις δοκιμής σας.
Ανανέωση μεταδεδομένων
Μετά από οποιαδήποτε αλλαγή σε όνομα, περιγραφή, σχήμα, σχολιασμό, μέθοδο ταυτοποίησης ή πόρο διεπαφής χρήστη: αναπτύξτε εκ νέου ή επανεκκινήστε τον διακομιστή, ανοίξτε τη σύνδεση στο chatgpt.com/plugins, επιλέξτε Refresh, επαληθεύστε ότι τα διαφημιζόμενα μεταδεδομένα έχουν αλλάξει και επαναλάβετε τις σχετικές δοκιμές σε μια νέα συνομιλία. Αυτή η ανανέωση ισχύει για διακομιστές που συνδέονται απευθείας· για ένα δημοσιευμένο πρόσθετο, οι ενημερώσεις εργαλείων εμπίπτουν στη συνεχή αναθεώρηση (Μάθημα 11).
Πριν από τη συσκευασία, επαληθεύστε ότι η λίστα εργαλείων αντιστοιχεί στις διαφημιζόμενες δυνατότητες, ότι τα δομημένα αποτελέσματα συμμορφώνονται με τα σχήματα εξόδου, ότι οι αποτυχίες ταυτοποίησης επιστρέφουν χρήσιμα σφάλματα, ότι οι σωστές ερωτήσεις ενεργοποιούν τα σωστά εργαλεία ενώ οι λανθασμένες δεν ενεργοποιούν κανένα, και ότι η διεπαφή χρήστη αποδίδεται χωρίς σφάλματα κονσόλας ενώ επαναφέρει σωστά την κατάστασή της.
Το πλήρες πρόσθετο
Μόλις ο διακομιστής είναι έτοιμος—ή άμεσα για ένα πρόσθετο που αποτελείται μόνο από δεξιότητες—συσκευάστε το πρόσθετο (Μάθημα 10), προσθέστε το σε μια τοπική αγορά, εγκαταστήστε το από τον κατάλογο προσθέτων και, στη συνέχεια, επαναλάβετε τα αιτήματα από το ευρετήριο περιπτώσεων χρήσης σας: άμεσα, έμμεσα, παρακολούθησης, αρνητικά και σκόπιμα αποκλεισμένες οριακές περιπτώσεις. Επαληθεύστε ότι το πρόσθετο ακολουθεί τις οδηγίες δεξιοτήτων, χρησιμοποιεί τους σωστούς πόρους, ολοκληρώνει κάθε βήμα και παράγει ένα χρήσιμο αποτέλεσμα· ότι οι δεξιότητες καλούν τα σωστά εργαλεία· και ότι η ταυτοποίηση λειτουργεί μετά την εγκατάσταση.
Διάγνωση ανά επίπεδο
Όταν κάτι πάει στραβά, ξεκινήστε απομονώνοντας το ελαττωματικό επίπεδο: διακομιστής, στοιχείο ή πελάτης ChatGPT.
| Σύμπτωμα | Υπόδειξη |
|---|---|
| Δεν εμφανίζονται εργαλεία | Λειτουργεί ο διακομιστής; Καταλήγει η διεύθυνση σε /mcp; |
| Δομημένα δεδομένα, αλλά χωρίς στοιχείο | Περιλαμβάνει το εργαλείο _meta.ui.resourceUri που δείχνει σε έναν καταχωρημένο πόρο τύπου text/html;profile=mcp-app που φορτώνεται χωρίς σφάλματα CSP; |
| Σφάλματα σχήματος | Ταιριάζουν τα μοντέλα Python ή TypeScript με το διαφημιζόμενο outputSchema; |
| Αργό στοιχείο | Υπερβαίνουν οι κλήσεις εργαλείων μερικά εκατοντάδες χιλιοστά του δευτερολέπτου; Δημιουργήστε προφίλ και χρησιμοποιήστε cache. |
| Αποτυχία φόρτωσης στοιχείου | Κονσόλα περιηγητή: παραβίαση CSP, ελλιπής δέσμη; |
| Απώλεια κατάστασης (drag-and-drop, επεξεργασία) | Καλέστε το window.openai.setWidgetState μετά από κάθε ενημέρωση και επαναφέρετε από το window.openai.widgetState κατά την τοποθέτηση. |
| Κατεστραμμένη διάταξη σε κινητά | Διαβάστε τα window.openai.displayMode και window.openai.maxHeight· αποφύγετε τα σταθερά ύψη και τις ενέργειες με το ποντίκι στην αιωρούμενη κατάσταση. |
| Το εργαλείο δεν επιλέγεται ποτέ | Ξαναγράψτε την περιγραφή ως “Χρησιμοποιήστε όταν…”, αναθεωρήστε τις αρχικές ερωτήσεις. |
| Επιλογή λάθος εργαλείου | Διευκρινίστε τα γειτονικά εργαλεία, καθορίστε αποκλεισμένες περιπτώσεις, διαχωρίστε υπερβολικά ευρεία εργαλεία. |
| Σφάλματα 401 | Συμπεριλάβετε το WWW-Authenticate στην απόκριση· επαληθεύστε τον εκδότη και το κοινό. |
invalid_client σε υπάρχουσα σύνδεση | Υπάρχει ακόμα ο καταχωρημένος πελάτης OAuth; Επαναφέρετέ τον αντί να δημιουργήσετε έναν νέο. |
| Λήξη tunnel ngrok | Επανεκκινήστε το, επαληθεύστε ότι ο τοπικός διακομιστής λειτουργεί· στην παραγωγή, χρησιμοποιήστε σταθερή φιλοξενία με ανιχνευτές υγείας. |
| Διακοπή ροής πίσω από διακομιστή μεσολάβησης | Ο εξισορροπητής φορτίου ή το CDN πρέπει να επιτρέπουν τη διέλευση της ροής HTTP χωρίς buffering. |
Εάν το πρόβλημα επιμένει, συγκεντρώστε τα αρχεία καταγραφής του διακομιστή, την κονσόλα του στοιχείου, μια μεταγραφή των κλήσεων εργαλείων και στιγμιότυπα οθόνης. Σημειώστε την ερώτηση που χρησιμοποιήθηκε και στείλτε τα πάντα στην επαφή σας στην OpenAI.
Βασικά σημεία
- Δοκιμάστε ανά επίπεδο: πρώτα τον διακομιστή μόνο του (Inspector, μετά ChatGPT) και έπειτα το πλήρες πρόσθετο
- Δημιουργήστε ένα σύνολο αξιολόγησης: άμεσα, έμμεσα, παρακολούθησης, εγγραφής και αιτήματα εκτός πεδίου εφαρμογής
- Το API Playground εμφανίζει ακατέργαστες ανταλλαγές MCP
- Κάντε Refresh μετά από κάθε αλλαγή μεταδεδομένων και, στη συνέχεια, ξεκινήστε μια νέα συνομιλία
- Όταν προκύπτουν προβλήματα, απομονώστε πρώτα το επίπεδο: διακομιστής, στοιχείο ή πελάτης