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

Συσκευασία του πρόσθετου

Μάθημα 10 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Γιατί η συσκευασία
  2. Δομή ενός φορητού πακέτου
  3. Δήλωση του διακομιστή MCP
  4. Μεταδεδομένα ειδικά για την OpenAI
  5. Η γρήγορη λύση: @plugin-creator
  6. Τοπικές αγορές
  7. Hooks: μόνο για επιτραπέζιους υπολογιστές
  8. Βασικά σημεία

Μάθημα ξαναγραμμένο στις 3 Νοεμβρίου 2026 με βάση τη σελίδα Package your plugin στην τεκμηρίωση των Πρόσθετων OpenAI. Το προηγούμενο μάθημα περιέγραφε τη δημιουργία ενός «πακέτου» για ένα ανύπαρκτο «Κατάστημα ChatGPT» χρησιμοποιώντας ένα ελλιπές αρχείο manifest. Ένα πρόσθετο συσκευάζεται με ένα αρχείο manifest plugin.json που ακολουθεί το σχήμα Agent Plugins. Πηγή: Package your plugin.

Γιατί η συσκευασία

Αφού έχετε γράψει τις δεξιότητές σας και, εάν χρειάζεται, έχετε κατασκευάσει τον διακομιστή MCP, το τελικό βήμα είναι η συναρμολόγησή τους σε μια μονάδα εγκατάστασης. Η συσκευασία προσδίδει στο πρόσθετό σας μια σταθερή ταυτότητα και ενημερώνει το ChatGPT και το Codex ποιες δεξιότητες, συνδέσεις διακομιστών MCP και πόροι ανήκουν μαζί. Η λογική διεπαφής χρήστη και η αυθεντικοποίηση παραμένουν εντός του διακομιστή MCP· το αρχείο manifest απλώς συνδέει αυτή την ενσωμάτωση με το υπόλοιπο πακέτο.

Δομή ενός φορητού πακέτου

Ένα φορητό πρόσθετο διαθέτει ένα αρχείο manifest plugin.json στη ρίζα του, το οποίο δηλώνει το σχήμα Agent Plugins. Ο φάκελος μπορεί επίσης να περιέχει έναν κατάλογο skills/, ένα αρχείο mcp.json για διακομιστές MCP που διανέμονται με το πρόσθετο, και οπτικά στοιχεία στον κατάλογο assets/.

mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│   └── compte-rendu/
│       └── SKILL.md
└── assets/
    ├── icon.png
    └── logo.png

Το ελάχιστο αρχείο manifest χωράει σε λίγες μόνο γραμμές. Το όνομα, σταθερό και σε μορφή kebab-case, λειτουργεί τόσο ως αναγνωριστικό όσο και ως χώρος ονομάτων για τα συστατικά· οι δεξιότητες εντοπίζονται αυτόματα στον κατάλογο skills/ χωρίς να χρειάζεται ρητή δήλωση.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "notes-equipe",
  "version": "0.1.0",
  "description": "Team notes and meeting minutes"
}

Κάθε δεξιότητα βρίσκεται στο skills/<name>/SKILL.md, με μια κεφαλίδα που παρέχει το όνομα και την περιγραφή της, ακολουθούμενη από οδηγίες:

---
name: compte-rendu
description: Drafts meeting minutes from team notes.
---

Retrieve meeting notes using list_notes, group them by topic,
then draft a summary: decisions, action items with owners, and open points.

Δήλωση του διακομιστή MCP

Οι διακομιστές MCP που διανέμονται με το πρόσθετο δηλώνονται στο mcp.json στη ρίζα, χρησιμοποιώντας το αντίστοιχο σχήμα και καθορίζοντας έναν τύπο μεταφοράς για κάθε διακομιστή:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "notes": {
      "type": "streamable-http",
      "url": "https://notes.example.com/mcp"
    }
  }
}

Η αυθεντικοποίηση του διακομιστή δηλώνεται στο ίδιο αυτό αρχείο, υπό το πεδίο extensions["com.openai"].auth για κάθε διακομιστή· ανήκει στον διακομιστή και όχι στο αρχείο manifest. Για δημόσια υποβολή, υποβάλλετε το απομακρυσμένο endpoint HTTPS· οι τοπικοί διακομιστές ακολουθούν μια ξεχωριστή διαδρομή που προορίζεται για πρόσθετα επιτραπέζιων υπολογιστών.

Μεταδεδομένα ειδικά για την OpenAI

Η παρουσίαση του καταλόγου, οι αντιστοιχίσεις με ήδη καταχωρημένους διακομιστές MCP και τα hooks δηλώνονται στο αντικείμενο extensions.com.openai του κεντρικού plugin.json, ενώ η φορητή ταυτότητα (name, version, description) παραμένει στη ρίζα:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "notes-equipe",
  "version": "0.1.0",
  "description": "Team notes and meeting minutes",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Team Notes",
        "shortDescription": "Notes and meeting minutes",
        "developerName": "Your Team",
        "category": "Productivity",
        "capabilities": ["Read", "Write"],
        "websiteURL": "https://example.com",
        "privacyPolicyURL": "https://example.com/privacy",
        "termsOfServiceURL": "https://example.com/terms",
        "defaultPrompt": ["Use Team Notes to draft Monday's meeting minutes."],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      }
    }
  }
}

Οι διαδρομές σε αυτό το αντικείμενο είναι σχετικές με τη ρίζα του πρόσθετου και ξεκινούν με ./. Τα οπτικά στοιχεία (composerIcon, logo, screenshots) πρέπει κατά προτίμηση να τοποθετούνται στο ./assets/. Το πεδίο apps χρησιμοποιείται μόνο για να δείξει σε ένα αρχείο .app.json που περιέχει αντιστοιχίσεις προς διακομιστές MCP ήδη καταχωρημένους στο ChatGPT.

Μπορείτε επίσης να δηλώσετε μια δεξιότητα εισαγωγής (onboarding skill) μέσω του extensions.com.openai.onboardingSkill (για παράδειγμα, ./skills/setup/SKILL.md): αυτή καθοδηγεί τον χρήστη μετά την εγκατάσταση για να επιλέξει έναν χώρο εργασίας ή να ορίσει προτιμήσεις. Δοκιμάστε την σε μια νέα συνομιλία και κατά τη διάρκεια μιας εγκατάστασης που βρίσκεται σε εξέλιξη.

Μια παλαιότερη μορφή, με ένα αρχείο manifest στο .codex-plugin/plugin.json, γίνεται ακόμη δεκτή για λόγους συμβατότητας: χρησιμοποιείται μόνο εάν το αντικείμενο extensions.com.openai απουσιάζει, καθώς τα δύο δεν συγχωνεύονται. Τα νέα πακέτα πρέπει να χρησιμοποιούν το κεντρικό plugin.json.

Η γρήγορη λύση: @plugin-creator

Το ChatGPT και το Codex περιλαμβάνουν μια δεξιότητα, την @plugin-creator, που δημιουργεί τη δομή για εσάς—προς το παρόν στη μορφή συμβατότητας .codex-plugin/. Για να συνδέσετε έναν διακομιστή MCP σε αυτήν, συνδέστε πρώτα εκείνον τον διακομιστή στο ChatGPT (Add custom MCP server και έπειτα Create as a plugin), σημειώστε το τεχνικό ID σύνδεσης από τη διεύθυνση URL του προγράμματος περιήγησης—ξεκινά με plugin_asdk_app—και παρέχετέ το στην @plugin-creator σε λειτουργία Work (ή στο $plugin-creator στο Codex). Η δεξιότητα μπορεί επίσης να δημιουργήσει μια καταχώρηση προσωπικής αγοράς, επιτρέποντάς σας να εγκαταστήσετε και να δοκιμάσετε το πρόσθετο από την πηγή του τοπικού σας καταλόγου.

Τοπικές αγορές

Μια αγορά (marketplace) είναι ένας κατάλογος JSON προσθέτων. Χρησιμεύει για τη συγγραφή, τη δοκιμή και τη διανομή στην ομάδα παράλληλα με τον δημόσιο κατάλογο: σε λειτουργία Work ή στο Codex, κάθε αγορά εμφανίζεται ως μια επιλέξιμη πηγή στον κατάλογο προσθέτων. Έτσι θα δοκιμάσετε το πλήρες πρόσθετο πριν το υποβάλετε (Μάθημα 9).

Hooks: μόνο για επιτραπέζιους υπολογιστές

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

Βασικά σημεία

  • Ένα φορητό πακέτο: plugin.json (σχήμα Agent Plugins), skills/, mcp.json, assets/
  • Ο διακομιστής MCP δηλώνεται στο mcp.json με τον τύπο μεταφοράς του· εκεί πηγαίνει και η αυθεντικοποίηση
  • Η παρουσίαση, οι αντιστοιχίσεις και η δεξιότητα εισαγωγής πηγαίνουν στο extensions.com.openai
  • Το @plugin-creator δημιουργεί τη δομή· μια τοπική αγορά χρησιμεύει για δοκιμές
  • Ένα πρόσθετο με hooks δεν είναι επιλέξιμο για τον δημόσιο κατάλογο