Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Δοκιμή και Αποσφαλμάτωση

Μάθημα 9 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Δοκιμή ανά επίπεδο
  2. Ο διακομιστής MCP
  3. Το πλήρες πρόσθετο
  4. Διάγνωση ανά επίπεδο
  5. Βασικά σημεία

Μάθημα ξαναγράφηκε στις 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 μετά από κάθε αλλαγή μεταδεδομένων και, στη συνέχεια, ξεκινήστε μια νέα συνομιλία
  • Όταν προκύπτουν προβλήματα, απομονώστε πρώτα το επίπεδο: διακομιστής, στοιχείο ή πελάτης