Αρχιτεκτονική: Εργαλεία, Πόροι και Διεπαφή
Σε αυτήν τη σελίδα
Μάθημα αναδιατυπωμένο στις 3 Νοεμβρίου 2026 με βάση τις σελίδες MCP server, Plugin architecture και Skills της τεκμηρίωσης των OpenAI Plugins. Η παλιά αρχιτεκτονική “actions, widgets, commerce” περιέγραφε ένα SDK που δεν υπάρχει πλέον. Πηγές: MCP server · Plugin architecture · Skills.
Επισκόπηση
Ένα πρόσθετο (plugin) αποτελείται από ανεξάρτητα στρώματα. Οι δεξιότητες (Skills) παρέχουν το εγχειρίδιο λειτουργίας, ο διακομιστής MCP παρέχει τις δυνατότητες και η διεπαφή προσφέρει έναν οπτικό τρόπο αλληλεπίδρασης όταν αυτό κρίνεται απαραίτητο.
Plugin
├── Skills
└── MCP Server (προαιρετικό)
├── Εργαλεία και δομημένα αποτελέσματα
└── Πόροι διεπαφής (προαιρετικό)
Κάθε στρώμα έχει διακριτό ρόλο. Η τεκμηρίωση συνοψίζει τα όρια ως εξής: ο διακομιστής MCP παρέχει δεδομένα, πιστοποίηση, εξουσιοδότηση και ενέργειες· η δεξιότητα παρέχει επαναχρησιμοποιήσιμες οδηγίες, παραδείγματα και πρότυπα εγγράφων.
Τι Εκθέτει ένας Διακομιστής MCP
Ένας διακομιστής MCP μπορεί να εκθέτει τέσσερις τύπους οντοτήτων:
- Εργαλεία (Tools): Συναρτήσεις που καλεί το μοντέλο με δομημένες εισόδους.
- Πόροι (Resources): Δεδομένα ή περιεχόμενο που ο πελάτης μπορεί να διαβάσει.
- Προτροπές (Prompts): Επαναχρησιμοποιήσιμα πρότυπα προτροπών.
- Οδηγίες (Instructions): Εντολές που εφαρμόζονται σε ολόκληρο τον διακομιστή.
Τα πρόσθετα βασίζονται κυρίως στα εργαλεία. Κάθε εργαλείο διαθέτει όνομα, περιγραφή, σχήμα εισόδου και προαιρετικά σχήμα εξόδου. Αυτά τα πεδία επιτρέπουν στο μοντέλο να αποφασίζει πότε θα καλέσει το εργαλείο και πώς θα χρησιμοποιήσει το αποτέλεσμά του.
Η Ροή του Αιτήματος
Όταν ένας χρήστης υποβάλλει ένα αίτημα που ταιριάζει με ένα εργαλείο, εκτελούνται διαδοχικά τέσσερα βήματα:
- Ο πελάτης ανακαλύπτει τα εργαλεία που εκθέτει ο διακομιστής MCP.
- Το μοντέλο επιλέγει ένα εργαλείο και παρέχει ορίσματα που συμμορφώνονται με το σχήμα εισόδου του.
- Ο διακομιστής επικυρώνει το αίτημα, εκτελεί τη λειτουργία και επιστρέφει ένα αποτέλεσμα.
- Το μοντέλο χρησιμοποιεί αυτό το αποτέλεσμα για να συνεχίσει τη συνομιλία.
Ένα αποτέλεσμα εργαλείου μπορεί να αποτελείται από τρία μέρη. Το structuredContent μεταφέρει συνοπτικά δεδομένα που το μοντέλο μπορεί να επιθεωρήσει και να επαναχρησιμοποιήσει σε επόμενες κλήσεις. Το content μεταφέρει κείμενο ή άλλο περιεχόμενο MCP που βοηθά το μοντέλο να διαμορφώσει μια απάντηση. Το _meta μεταφέρει δεδομένα προοριζόμενα για τον πελάτη και κρυμμένα από το μοντέλο—κρυμμένα, αλλά όχι προστατευμένα. Αυτό το πεδίο δεν αντικαθιστά την εξουσιοδότηση ή την ασφαλή αποθήκευση.
Μεταφορά και Εξουσιοδότηση
Σε περιβάλλον παραγωγής, αναπτύξτε έναν διακομιστή MCP σε μια σταθερή διεύθυνση HTTPS χρησιμοποιώντας τη μεταφορά streamable HTTP του πρωτοκόλλου, συνήθως σε μια διαδρομή /mcp. Εάν τα εργαλεία διαβάζουν ιδιωτικά δεδομένα ή ενεργούν εξ ονόματος ενός χρήστη, προστατεύστε τον διακομιστή με τη ροή εξουσιοδότησης που ορίζει η προδιαγραφή MCP—OAuth, την οποία αναλύει το Μάθημα 8.
Η Διεπαφή: Ένα Προαιρετικό Στρώμα
Ένα εργαλείο πρέπει να λειτουργεί χωρίς διεπαφή: το συνοπτικό κείμενο και ένα δομημένο αποτέλεσμα συχνά αρκούν για να ανταποκριθεί το μοντέλο. Μια διεπαφή έχει νόημα όταν ο χρήστης χρειάζεται να επιθεωρήσει, να συγκρίνει, να τροποποιήσει, να επιβεβαιώσει ή να περιηγηθεί σε δομημένες πληροφορίες—μια σύγκριση προϊόντων, ένα editable χρονοδιάγραμμα ή έναν χάρτη. Ένας απλός έλεγχος κατάστασης γενικά δεν χρειάζεται κάτι τέτοιο.
Όταν υπάρχει, η διεπαφή είναι ένας πόρος που δηλώνει ο διακομιστής. Το ChatGPT την εμφανίζει σε ένα iframe όταν το συσχετισμένο εργαλείο την επιστρέφει. Το ChatGPT υλοποιεί το ανοιχτό πρότυπο MCP Apps: η διεπαφή επικοινωνεί με τον οικοδεσπότη μέσω JSON-RPC χρησιμοποιώντας postMessage. Επεκτάσεις ειδικές για το ChatGPT, προσβάσιμες μέσω window.openai, συμπληρώνουν το πρότυπο όταν αυτό δεν καλύπτει μια συγκεκριμένη ανάγκη. Το Μάθημα 6 καλύπτει αυτό το θέμα.
Δεξιότητες: Το Στρώμα Ροής Εργασίας
Μια δεξιότητα (skill) είναι ένας φάκελος που περιέχει ένα αρχείο SKILL.md—ένα όνομα, μια περιγραφή που λέει στο μοντέλο πότε να το λάβει υπόψη, οδηγίες—και, εάν χρειάζεται, αναφορές, scripts ή πρότυπα. Το μοντέλο βλέπει αρχικά μόνο το όνομα και την περιγραφή· φορτώνει τις πλήρεις οδηγίες όταν το αίτημα ταιριάζει με τη δεξιότητα ή όταν ο χρήστης την επικαλείται άμεσα. Εξ ου και η συμβουλή της OpenAI: γράψτε την περιγραφή με βάση τον στόχο του χρήστη και τις συνθήκες ενεργοποίησης, και κρατήστε τις λεπτομέρειες βήμα προς βήμα στο κυρίως σώμα.
Τι Συμβαίνει με το Εμπόριο;
Η πώληση μέσω ενός πρόσθετου δεν αποτελεί ξεχωριστό στρώμα. Είναι μια διαδρομή που μπορεί να υποστηρίξει η προαιρετική διεπαφή, αξιοποιώντας το Checkout API που τεκμηριώνεται από την OpenAI. Το Μάθημα 7 εξηγεί πώς λειτουργεί και τους περιορισμούς του.
Βασικά σημεία
- Ένας διακομιστής MCP εκθέτει εργαλεία, πόρους, προτροπές και οδηγίες· τα πρόσθετα βασίζονται κυρίως στα εργαλεία
- Ένα αποτέλεσμα εργαλείου συνδυάζει τα
structuredContent,contentκαι_meta(κρυμμένα από το μοντέλο, αλλά όχι ασφαλή) - Παραγωγή: σταθερό HTTPS, μεταφορά streamable HTTP, εξουσιοδότηση σύμφωνα με την προδιαγραφή MCP
- Η διεπαφή είναι ένας προαιρετικός πόρος που εμφανίζεται από το ChatGPT σύμφωνα με το πρότυπο MCP Apps
- Οι δεξιότητες διαχειρίζονται τη ροή εργασίας· ο διακομιστής διαχειρίζεται τα δεδομένα, την εξουσιοδότηση και τις ενέργειες