Επισκόπηση

Οι διαχειριστές του χώρου εργασίας μπορούν να εισαγάγουν μια αγορά plugin από το GitHub στον κατάλογο του χώρου εργασίας τους. Η αγορά είναι ένας κατάλογος JSON που παραθέτει τα plugin προς εισαγωγή. Μετά την εισαγωγή, ο καθημερινός συγχρονισμός διατηρεί τα plugin ενημερωμένα με τις αλλαγές από το αποθετήριο.


Ο συγχρονισμός της αγοράς εισάγει το περιεχόμενο των plugin — δεν συνδέει τους λογαριασμούς των μελών του χώρου εργασίας ούτε παραχωρεί πρόσβαση στις εφαρμογές που περιλαμβάνει ένα plugin.


Για μια εισαγωγή στα plugin και στις εφαρμογές που περιλαμβάνουν, δείτε: Plugin στο ChatGPT και στο Codex.

Πριν ξεκινήσετε

• Χρησιμοποιήστε έναν λογαριασμό GitHub με πρόσβαση ανάγνωσης στο αποθετήριο της αγοράς και σε κάθε άλλο αποθετήριο στο οποίο αυτή παραπέμπει. Υποστηρίζονται δημόσια και ιδιωτικά αποθετήρια στο github.com.

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

• Ελέγξτε το περιεχόμενο του αποθετηρίου. Η εισαγωγή επεξεργάζεται όλα τα έγκυρα plugin χωρίς ξεχωριστό βήμα έγκρισης για το καθένα, ενώ οι μελλοντικοί συγχρονισμοί μπορούν να προσθέσουν νέα plugin.

Τα νέα plugin ξεκινούν με πολιτική εγκατάστασης Διαθέσιμο και έλεγχο ταυτότητας κατά την εγκατάσταση. Στις νέες αγορές, ο αυτόματος καθημερινός συγχρονισμός είναι ενεργοποιημένος. Μετά την εισαγωγή, ελέγξτε τις ρυθμίσεις κάθε plugin στον χώρο εργασίας και τις απαιτούμενες εφαρμογές του.

Εισαγωγή αγοράς

1. Μεταβείτε στην Κονσόλα διαχειριστή, επιλέξτε τον επιθυμητό χώρο εργασίας του ChatGPT και ανοίξτε την ενότητα Plugin. Στη συνέχεια, επιλέξτε Προσθήκη και έπειτα Εισαγωγή αγοράς.

2. Στο πεδίο Πηγή, εισαγάγετε τη διεύθυνση URL του αποθετηρίου, όπως https://github.com/example/team-plugins. Χρησιμοποιήστε μόνο τη διεύθυνση URL του αποθετηρίου, όχι τη διεύθυνση κάποιου κλάδου ή φακέλου.

3. Αν η αγορά βρίσκεται σε υποκατάλογο, εισαγάγετε αυτόν τον κατάλογο στο πεδίο Διαδρομή. Για παράδειγμα, εισαγάγετε team-tools για το team-tools/.agents/plugins/marketplace.json. Αφήστε το πεδίο Διαδρομή κενό για τον ριζικό κατάλογο του αποθετηρίου. Μην εισαγάγετε το όνομα του αρχείου διακήρυξης.

4. Προαιρετικά, συμπληρώστε το πεδίο Κλάδος, ετικέτα ή commit. Αφήστε το κενό για να χρησιμοποιήσετε τον προεπιλεγμένο κλάδο του αποθετηρίου. Χρησιμοποιήστε έναν κλάδο για να λαμβάνετε μελλοντικά commit. Αν ορίσετε συγκεκριμένο commit, η έκδοση παραμένει σταθερή.

5. Επιλέξτε Εισαγωγή αγοράς και εξουσιοδοτήστε την πρόσβαση στο GitHub όταν σας ζητηθεί.

6. Ελέγξτε τα Αποτελέσματα εισαγωγής και έπειτα ανοίξτε κάθε plugin που εισήχθη για να ρυθμίσετε την πολιτική εγκατάστασής του και τυχόν απαιτούμενες εφαρμογές.

Η αρχική εισαγωγή μπορεί να διαρκέσει έως και 1 ώρα για πολύ μεγάλες αγορές. Οι επόμενοι καθημερινοί συγχρονισμοί συνήθως διαρκούν λίγα λεπτά.

Αν δεν είναι δυνατή η εισαγωγή ενός plugin, η αναφορά εξηγεί το σφάλμα. Τα υπόλοιπα έγκυρα plugin μπορούν να εισαχθούν κανονικά.

Υποστηριζόμενες μορφές

Ο επιλεγμένος κατάλογος πρέπει να περιέχει μια διακήρυξη σε υποστηριζόμενη μορφή:

• .agents/plugins/marketplace.json για μια αγορά Codex.

• .claude-plugin/marketplace.json για μια αγορά συμβατή με το Claude.

• .claude-plugin/plugin.json για ένα αυτόνομο plugin Claude όταν δεν υπάρχει διακήρυξη αγοράς.

Οι καταχωρίσεις της αγοράς μπορούν να παραπέμπουν σε φακέλους plugin στο ίδιο αποθετήριο ή σε υποστηριζόμενες πηγές αποθετηρίων GitHub. Η εισαγωγή στον χώρο εργασίας δεν υποστηρίζει άλλες υπηρεσίες φιλοξενίας Git ή πηγές από μητρώα πακέτων, όπως το npm.

Για τις υποστηριζόμενες μορφές, παραδείγματα JSON και τα πεδία πηγής, δείτε: Διαχείριση plugin.

Ρύθμιση πρόσβασης στον χώρο εργασίας

Το GitHub παρέχει το περιεχόμενο των plugin, ενώ οι ρυθμίσεις του χώρου εργασίας ελέγχουν την εγκατάσταση και τον έλεγχο ταυτότητας. Η εισαγωγή και ο συγχρονισμός δεν εφαρμόζουν τις τιμές πολιτικής του αποθετηρίου, όπως AVAILABLE ή ON_USE. Διαμορφώστε αυτές τις ρυθμίσεις για κάθε plugin στον χώρο εργασίας σας.


Στην Πολιτική εγκατάστασης, επιλέξτε Διαθέσιμο ή Εγκατεστημένο για κάθε επιλέξιμο ρόλο. Οι απαιτούμενες εφαρμογές πρέπει επίσης να είναι ενεργοποιημένες, ενώ τα μέλη πρέπει να έχουν πρόσβαση στη συνδεδεμένη υπηρεσία και να ολοκληρώσουν τυχόν απαιτούμενο έλεγχο ταυτότητας.


Ο συγχρονισμός μιας ενημέρωσης plugin ή η μεταφορά της διαχείρισης ενός υπάρχοντος plugin στο GitHub διατηρεί τις πολιτικές του στον χώρο εργασίας. Η εισαγωγή ενός plugin δεν παραχωρεί πρόσβαση σε εφαρμογές ούτε συνδέει τους λογαριασμούς των μελών.


Για την πλοήγηση στον χώρο εργασίας, την πρόσβαση σε εφαρμογές και τα στοιχεία ελέγχου του χώρου εργασίας, δείτε: Στοιχεία ελέγχου διαχειριστή, ασφάλεια και συμμόρφωση για plugin και εφαρμογές.

Διατήρηση των plugin ενημερωμένων

Οι νέες αγορές ελέγχουν καθημερινά για ενημερώσεις. Για να ζητήσετε ενημέρωση χωρίς να περιμένετε τον αυτόματο συγχρονισμό:

1. Μεταβείτε στην Κονσόλα διαχειριστή, επιλέξτε τον επιθυμητό χώρο εργασίας του ChatGPT και ανοίξτε την ενότητα Plugin.

2. Ανοίξτε την ενότητα Αγορές και επιλέξτε την αγορά.

3. Επιλέξτε Συγχρονισμός τώρα.

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

Έλεγχος αποτελεσμάτων συγχρονισμού

Μετά τον συγχρονισμό, ελέγξτε την κατάστασή του και την αποθηκευμένη αναφορά. Η ένδειξη Ολοκληρώθηκε — N σφάλματα σημαίνει ότι ο συγχρονισμός ολοκληρώθηκε, αλλά δεν ήταν δυνατή η επεξεργασία ορισμένων plugin.


Αν μια ενημέρωση υπάρχοντος plugin δεν είναι έγκυρη, διατηρείται η τελευταία λειτουργική έκδοσή του. Οι υπόλοιπες έγκυρες ενημερώσεις μπορούν να ολοκληρωθούν κανονικά. Διορθώστε το πρόβλημα που αναφέρεται στο GitHub και έπειτα επιλέξτε Συγχρονισμός τώρα για να δοκιμάσετε ξανά.


Αν στην προβολή διαχειριστή εμφανίζεται η επιλογή Ανανέωση για ένα plugin που εισήχθη μεμονωμένα, χρησιμοποιήστε την για να ανανεώσετε αυτό το plugin. Η επιλογή Ανανέωση λίστας plugin επαναφορτώνει μόνο την εμφανιζόμενη λίστα· δεν πραγματοποιεί συγχρονισμό από το GitHub.

Τι ισχύει για την αφαίρεση και τη διαγραφή

Η αφαίρεση μιας καταχώρισης από το αποθετήριο δεν διαγράφει το αντίγραφό της που έχει εισαχθεί στον χώρο εργασίας. Το plugin επισημαίνεται ως Δεν υπάρχει πλέον στην πηγή.


Η διαγραφή της αγοράς στο ChatGPT διαγράφει όλα τα plugin που εισήχθησαν από αυτήν. Μη διαγράφετε μια αγορά για να επανασυνδέσετε το GitHub ή να αλλάξετε τον κάτοχό της.

Επανασύνδεση ή αλλαγή πρόσβασης στο GitHub

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

Επανασύνδεση του αρχικού λογαριασμού

1. Βεβαιωθείτε ότι ο λογαριασμός GitHub που χρησιμοποιήθηκε για την εισαγωγή εξακολουθεί να έχει πρόσβαση σε όλα τα απαιτούμενα αποθετήρια.

2. Ζητήστε από τον διαχειριστή που εισήγαγε αρχικά την αγορά να ανοίξει το plugin GitHub στο ChatGPT και να επανασυνδέσει τον λογαριασμό του.

Μεταβίβαση σε νέο διαχειριστή

Ο νέος διαχειριστής του χώρου εργασίας μπορεί να εισαγάγει την ίδια αγορά χρησιμοποιώντας τη δική του σύνδεση GitHub:

1. Μεταβείτε στην Κονσόλα διαχειριστή, επιλέξτε τον επιθυμητό χώρο εργασίας του ChatGPT και ανοίξτε την ενότητα Plugin. Στη συνέχεια, επιλέξτε Προσθήκη > Εισαγωγή αγοράς.

2. Στα πεδία Πηγή, Διαδρομή και Κλάδος, ετικέτα ή commit, εισαγάγετε τις ίδιες τιμές που χρησιμοποιήθηκαν για την υπάρχουσα αγορά.

3. Επιλέξτε Εισαγωγή αγοράς και εξουσιοδοτήστε την πρόσβαση στο GitHub όταν σας ζητηθεί.

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

Μεταφορά της διαχείρισης ενός υπάρχοντος plugin στο GitHub

Μπορείτε να χρησιμοποιήσετε μια αγορά για να διαχειρίζεστε ένα υπάρχον plugin του χώρου εργασίας που μεταφορτώθηκε ως συμπιεσμένο αρχείο ή δεν τελεί ακόμη υπό διαχείριση από πηγή GitHub. Το υπάρχον plugin πρέπει να βρίσκεται στον ίδιο χώρο εργασίας και να έχει το ίδιο όνομα plugin. Δεν μπορείτε να αναλάβετε με αυτόν τον τρόπο τη διαχείριση ενός plugin που ελέγχεται από διαφορετική πηγή GitHub.


Για να προσδιορίσετε το υπάρχον plugin στην αγορά σας:

1. Μεταβείτε στην Κονσόλα διαχειριστή, επιλέξτε τον επιθυμητό χώρο εργασίας του ChatGPT και ανοίξτε την ενότητα Plugin. Ανοίξτε το plugin.

2. Αντιγράψτε το αναγνωριστικό του plugin που βρίσκεται μετά το /admin/plugins/ στη διεύθυνση URL του.

3. Προσθέστε αυτό το αναγνωριστικό ως pluginId δίπλα στα name και source, στην αντίστοιχη καταχώριση του πίνακα plugins της αγοράς. Μην το προσθέσετε στο αρχείο plugin.json του plugin.

Το plugin διατηρεί το αναγνωριστικό του, τις ρυθμίσεις κοινής χρήσης και τις πολιτικές του χώρου εργασίας. Το GitHub γίνεται η πηγή για τις μελλοντικές ενημερώσεις, επομένως οι επόμενες μεταφορτώσεις συμπιεσμένων αρχείων δεν μπορούν να αντικαταστήσουν το plugin.


Για ένα παράδειγμα μετεγκατάστασης και τις σχετικές απαιτήσεις, δείτε: Διαχείριση plugin.

Αναφορά σε υπάρχουσα εφαρμογή

Ένα plugin μπορεί να αναφέρεται σε μια υπάρχουσα εφαρμογή μέσω του .app.json στον ριζικό κατάλογο του plugin. Συμπεριλάβετε την τελεία στην αρχή του ονόματος αρχείου και χρησιμοποιήστε το αναγνωριστικό της εφαρμογής, όχι το αναγνωριστικό ενός plugin. Για ένα εγγενές plugin, ορίστε το πεδίο apps στο .codex-plugin/plugin.json σε ./.app.json.


Η αναφορά δεν δημιουργεί εφαρμογή ούτε παραχωρεί πρόσθετα δικαιώματα. Εξακολουθούν να ισχύουν οι υπάρχουσες ρυθμίσεις πρόσβασης και ελέγχου ταυτότητας της εφαρμογής στον χώρο εργασίας, οι έλεγχοι ενεργειών και τα δικαιώματα της συνδεδεμένης υπηρεσίας.


Για τη μορφή JSON, δείτε: Διαχείριση plugin.

Τι σημαίνει η ένδειξη «Μόνο για υπολογιστή»

Ένα plugin με την ένδειξη Μόνο για υπολογιστή δεν μπορεί να εκτελεστεί στη διαδικτυακή έκδοση του ChatGPT. Τα εισαγόμενα plugin μπορεί να λάβουν αυτήν την ένδειξη όταν δηλώνουν διακομιστές MCP, για παράδειγμα στο mcp.json ή στο .mcp.json, ακόμη και αν ένας διακομιστής χρησιμοποιεί απομακρυσμένη διεύθυνση URL HTTPS.


Η προσθήκη μιας αναφοράς .app.json δεν αφαιρεί από μόνη της την ένδειξη Μόνο για υπολογιστή. Κάθε εφαρμογή στην οποία γίνεται αναφορά πρέπει να είναι διαθέσιμη για τον ρόλο του μέλους, ενώ εξακολουθούν να ισχύουν οι συνήθεις απαιτήσεις πρόσβασης και ελέγχου ταυτότητάς της.