Ippakkja l-plugin
F'din il-paġna
Lezzjoni miktuba mill-ġdid fit-3 ta’ Novembru 2026 ibbażata fuq il-paġna Package your plugin fid-dokumentazzjoni tal-OpenAI Plugins. Il-lezzjoni preċedenti kienet tiddeskrivi l-bini ta’ “pakkett” għal “ChatGPT Store” li ma jeżistix billi tuża manifest nieqes. Plugin jiġi ppakkjat b’manifest
plugin.jsonli jsegwi l-iskema tal-Agent Plugins. Sors: Package your plugin.
Għaliex tippakkja
Ladarba tkun kitbet il-ħiliet tiegħek u, jekk meħtieġ, bnejt is-server MCP, l-aħħar pass huwa li tgħaqqadhom f’unità installabbli. L-ippakkjar jagħti lill-plugin tiegħek identità stabbli u jgħid lil ChatGPT u Codex liema ħiliet, konnessjonijiet tas-server MCP, u riżorsi jappartjenu flimkien. Il-loġika tal-UI u tal-awtentikazzjoni tibqa’ ġos-server MCP; il-manifest sempliċiment jgħaqqad dik l-integrazzjoni mal-bqija tal-pakkett.
Struttura ta’ pakkett portabbli
Plugin portabbli għandu manifest plugin.json fil-għerq tiegħu, li jiddikjara l-iskema tal-Agent Plugins. Il-folder jista’ jkun fih ukoll direttorju skills/, fajl mcp.json għas-servers MCP distribwiti mal-plugin, u assi viżwali f’assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Il-manifest minimu jidħol f’ftit linji biss. L-isem, stabbli u f’kebab-case, iservi bħala l-identifikatur u n-namespace għall-komponenti; il-ħiliet jiġu skoperti awtomatikament f’skills/ mingħajr ma jeħtieġu dikjarazzjoni espliċita.
{
"$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"
}
Kull ħila tgħix f’skills/<isem>/SKILL.md, b’intestatura li tipprovdi l-isem u d-deskrizzjoni tagħha, segwita mill-istruzzjonijiet:
---
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.
Id-dikjarazzjoni tas-server MCP
Is-servers MCP distribwiti mal-plugin huma ddikjarati f’mcp.json fil-għerq, bl-użu tal-iskema korrispondenti u l-ispeċifikazzjoni ta’ tip ta’ trasport għal kull server:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
L-awtentikazzjoni tas-server hija ddikjarata f’dan l-istess fajl, taħt extensions["com.openai"].auth għal kull server—din tappartjeni lis-server, mhux lill-manifest. Għas-sottomissjoni pubblika, tibgħat l-endpoint HTTPS remot; is-servers lokali jsegwu mogħdija separata rriżervata għall-plugins tad-desktop.
Metadejta speċifika għall-OpenAI
Il-preżentazzjoni tad-direttorju, il-mapep għas-servers MCP diġà rreġistrati, u l-hooks huma ddikjarati fl-oġġett extensions.com.openai tal-plugin.json tal-għerq, filwaqt li l-identità portabbli (name, version, description) tibqa’ fil-għerq:
{
"$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"
}
}
}
}
Il-mogħdijiet f’dan l-oġġett huma relattivi għall-għerq tal-plugin u jibdew b’./. L-assi viżwali (composerIcon, logo, screenshots) għandhom preferibbilment imorru f’./assets/. Il-qasam apps jintuża biss biex jipponta lejn fajl .app.json li fih il-mapep għas-servers MCP diġà rreġistrati f’ChatGPT.
Tista’ wkoll tiddikjara ħila ta’ onboarding permezz ta’ extensions.com.openai.onboardingSkill (pereżempju, ./skills/setup/SKILL.md): din tgħid lill-utent wara l-installazzjoni biex jagħżel workspace jew jissettja preferenzi. Ipprovaha f’konversazzjoni ġdida u waqt installazzjoni li għadha għaddejja.
Format iktar antik, b’manifest f’.codex-plugin/plugin.json, għadu aċċettat għall-kompatibbiltà: jintuża biss jekk l-oġġett extensions.com.openai ikun nieqes, peress li t-tnejn ma jingħaqdux. Il-pakketti ġodda għandhom jużaw il-plugin.json tal-għerq.
Il-mogħdija mgħaġġla: @plugin-creator
ChatGPT u Codex jinkludu ħila, @plugin-creator, li tiġġenera l-istruttura għalik—attwalment fil-format ta’ kompatibbiltà .codex-plugin/. Biex tgħaqqad server MCP miegħu, l-ewwel konnettja dak is-server f’ChatGPT (Add custom MCP server, imbagħad Create as a plugin), innota l-ID tekniku tal-konnessjoni mill-URL tal-browser—jibda b’plugin_asdk_app—u pprovdieh lil @plugin-creator fil-Modalità Work (jew lil $plugin-creator f’Codex). Il-ħila tista’ toħloq ukoll entrata fis-suq personali, li tippermettilek tinstalla u tittestja l-plugin mis-sors tad-direttorju lokali tiegħek.
Swieq lokali
Suq huwa katalogu JSON ta’ plugins. Iservi għall-kitba, l-ittestjar, u d-distribuzzjoni fit-tim flimkien mad-direttorju pubbliku: fil-Modalità Work jew f’Codex, kull suq jidher bħala sors li jista’ jintgħażel fid-direttorju tal-plugins. Hekk se tittestja l-plugin sħiħ qabel ma tissottomettieh (Lezzjoni 9).
Hooks: biss għad-desktop
Il-hooks taċ-ċiklu tal-ħajja huma appoġġjati biss għall-plugins installati manwalment fl-app desktop ta’ Codex, u plugin li fihom mhuwiex eliġibbli għad-direttorju pubbliku. Jekk il-plugin tiegħek huwa mmirat għall-pubblikazzjoni, ħallihom barra.
Punti Ewlenin
- Pakkett portabbli:
plugin.json(skema tal-Agent Plugins),skills/,mcp.json,assets/ - Is-server MCP huwa ddikjarat f’
mcp.jsonbit-tip ta’ trasport tiegħu; l-awtentikazzjoni tmur hemmhekk ukoll - Il-preżentazzjoni, il-mapep, u l-ħila ta’ onboarding imorru f’
extensions.com.openai @plugin-creatorjiġġenera l-istruttura; suq lokali huwa għall-ittestjar- Plugin b’hooks mhuwiex eliġibbli għad-direttorju pubbliku