Criar plugins

Para criar ou submeter um plugin, utilize a documentação completa para criadores em developers.openai.com.

Criar e submeter um plugin

Esta página apresenta uma breve introdução. Um plugin é um pacote instalável que pode incluir competências, um MCP server ou ambos. Um MCP server também pode devolver uma IU opcional.

O ChatGPT e o Codex partilham um único diretório universal de plugins. Publique um plugin público uma vez para que a mesma entrada possa ser descoberta nas superfícies suportadas de ambos os produtos. Durante o desenvolvimento, utilize um marketplace local para testar o pacote antes de o submeter ao diretório universal.

Para distribuir através do GitHub num espaço de trabalho, consulte Gestão de plugins.

Comece por uma competência enquanto ainda estiver a aperfeiçoar um fluxo de trabalho pessoal. Crie um plugin quando pretender partilhar esse fluxo de trabalho, empacotar competências relacionadas, estabelecer ligação a um serviço externo ou distribuir uma capacidade estável por uma equipa.

Criar um plugin com @plugin-creator

Para efetuar a configuração mais rapidamente, utilize a competência @plugin-creator integrada no modo ChatGPT Work ou $plugin-creator no Codex.

@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

A skill cria um manifesto de compatibilidade .codex-plugin/plugin.json suportado, organiza a pasta do plugin e pode adicionar o plugin a um marketplace local. Esta estrutura inicial difere do formato portátil plugin.json na raiz utilizado no exemplo manual. Consulte a estrutura inicial para conhecer os ficheiros e diretórios opcionais.

1. Reveja .codex-plugin/plugin.json.
2. Verifique cada skill incluída em skills/ à luz das orientações sobre o cumprimento de instruções.
3. Atualize o ChatGPT ou o Codex e instale o plugin a partir da respetiva origem no marketplace local.
4. Teste o plugin numa nova conversa com pedidos representativos.

Se o plugin incluir um MCP server, primeiro crie e teste esse servidor e, em seguida, forneça a @plugin-creator os detalhes da ligação registada. Siga o fluxo de trabalho completo para MCP servers para ferramentas, autenticação, implementação e testes.

Criar manualmente um plugin apenas com competências

Um pacote portátil mínimo de Agent Plugins contém um manifesto na raiz e pelo menos uma skill:

meeting-follow-up/
├── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

Crie plugin.json na raiz do plugin:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps"
}

Os pacotes portáteis detetam automaticamente as skills em skills/. Adicione skills/meeting-follow-up/SKILL.md:

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

Utilize um nome de plugin estável em kebab case. Mantenha a descrição da competência suficientemente específica para que o ChatGPT e o Codex reconheçam quando o fluxo de trabalho se aplica.

Utilize @plugin-creator para adicionar a pasta a um marketplace local e, em seguida, instale-a e teste-a antes de a partilhar.

Prosseguir para a documentação para criadores

Para consultar a documentação completa para criadores, utilize a documentação de Plugins. Esta abrange:

• Arquitetura de plugins
• Criação de competências
• Criação de um MCP server
• Adição de uma IU opcional
• Empacotamento de um plugin
• Teste de um plugin
• Submissão e publicação

Para procurar, instalar, ativar ou remover plugins, consulte Utilizar plugins.