Nome: greet Descrição: Cumprimenta o usuário e oferece ajuda. --- Cumprimenta brevemente o usuário e pergunta como pode ajudar. Se o plugin ...
Cumprimentar brevemente o usuário e perguntar como pode ajudar.
### Etapa 4: Adicionar MCP somente quando necessário
Se o plugin precisar de ferramentas, adicione:
```Plaintext
mcp.json
Não é obrigatório que um plugin configure um MCP vazio apenas para ser válido.
A ausência de componentes opcionais em determinadas posições não é considerada um erro.
Teste o núcleo portátil em cada cliente que você planeja suportar.
Não presuma que "compatível com plugins de agente" significa que todos os componentes e transportes estão implementados.
Os clientes podem adotar componentes de forma progressiva.
Um pacote mais útil pode ter a seguinte estrutura:
reporting-plugin/
├── plugin.json
├── skills/
│ └── weekly-report/
│ └── SKILL.md
├── mcp.json
└── bin/
└── reporting-server
Manifesto:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "reporting-plugin",
"version": "1.0.0",
"description": "Fluxos de trabalho e ferramentas portáteis de relatórios."
}
Configuração MCP:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"reporting": {
"type": "stdio",
"command": "./bin/reporting-server",
"cwd": "${PLUGIN_ROOT}"
}
}
}
Um cliente em conformidade com o padrão pode descobrir:
Sem que o autor precise reorganizar esses componentes portáteis em estruturas completamente diferentes para cada cliente.
Uma parte cuidadosamente projetada da especificação é que muitas falhas de componentes são locais, e não catastróficas.
Por exemplo:
Isso é essencial em um ecossistema real de múltiplos clientes.
Um plugin pode fornecer:
Habilidade A
Habilidade B
Servidor MCP A
Servidor MCP B
Extensões de cliente
Se um cliente não suporta um transporte específico, o restante útil e portátil deve continuar funcionando sempre que possível.
Caso contrário, a interoperabilidade se torna frágil: um recurso opcional não suportado desabilitaria o plugin inteiro.
Os clientes não precisam implementar todos os recursos do v1.
Um cliente que suporta apenas habilidades ainda pode estar em conformidade se carregar corretamente o manifesto e implementar o comportamento relevante das habilidades.
Um cliente que suporta MCP deve atender às regras de transporte aplicáveis.
Esse modelo incremental reduz a barreira de adoção.
Clientes menores podem começar com:
plugin.json
+
skills/
E adicionar MCP posteriormente.
Clientes maiores podem implementar o núcleo portátil completo, além de seus próprios namespaces de extensão.
O título do AIBase descreve a introdução dos plugins de agente pela OpenAI.
A OpenAI é claramente um participante importante.
Os documentos oficiais de governança tornam o modelo de propriedade mais amplo.
Os plugins de agente se apresentam como
um projeto neutro em relação a fornecedores e governado pela comunidade.
Seu comitê técnico de direção é composto por mantenedores principais independentes, sem assentos corporativos reservados.
O estatuto estabelece:
A página inicial do projeto atualmente lista mantenedores principais iniciais representando:
Essa estrutura multiforncedor é importante porque os padrões de interoperabilidade ganham credibilidade quando clientes concorrentes têm um caminho de participação.
A página oficial de compatibilidade atualmente lista:
Isso é um ponto de partida mais forte do que um padrão suportado apenas por seu criador original.
A matriz de suporte ainda não é idêntica.
Por exemplo, vários clientes listados atualmente suportam SSE tradicional, enquanto ChatGPT e Codex listam atualmente stdio e Streamable HTTP.
O resultado importante é que o formato de pacote já atravessa as fronteiras entre fornecedores.
Autores de plugins agora podem segmentar um núcleo compartilhado sem assumir que cada ambiente de agente é um ecossistema completamente separado.
Quando os agentes executam trabalho real, o problema da fragmentação de plugins se destaca ainda mais.
Um chatbot simples pode operar com uma pequena lista fixa de ferramentas.
Um agente sério pode precisar de:
À medida que esses componentes se multiplicam, a portabilidade se torna infraestrutura.
Sem um mecanismo de empacotamento compartilhado, cada empresa corre o risco de manter uma matriz como esta:
Capacidades × Cliente de agente × Versão × Plataforma
Um formato de pacote portátil reduz uma dimensão dessa matriz.
Ele não elimina o trabalho específico do cliente.
Mas reduz o esforço duplicado necessário para manter um núcleo reutilizável consistente.
Esses três conceitos estão relacionados, mas não devem ser confundidos.
| Padrão | Função principal |
|---|---|
| Habilidades de agente | Definem ativos reutilizáveis de instruções/fluxos de trabalho para agentes |
| MCP | Define a comunicação entre clientes de IA e servidores externos de ferramentas/dados |
| Plugins de agente | Definem como empacotar habilidades e configurações MCP de forma portátil |
Um modelo mental útil é:
Habilidades
= o que o agente deve saber ou como deve trabalhar
MCP
= como o agente se conecta a capacidades externas
Plugins de agente
= como essas partes reutilizáveis são empacotadas para funcionar em clientes compatíveis
Portanto, os plugins de agente são uma camada acima dos padrões de componentes existentes, e não um substituto para eles.
Descreva sua ideia uma vez e o We0 AI pode gerar um site de apresentacao, paginas e CMS, alem de ajudar a atrair clientes e trafego apos o lancamento.
Uma geração completa de projetos para registro gratuito
Melhor para experimentar um fluxo de geração completo e ver rapidamente um primeiro rascunho do projeto.
O escopo do padrão é deliberadamente estreito.
Ele não resolve todos os problemas de compatibilidade entre agentes.
modelos
O mesmo plugin pode se comportar de maneira diferente quando carregado em modelos diferentes.
Um cliente pode exigir confirmação antes de executar uma ação, enquanto outro usa políticas em nível de espaço de trabalho.
OAuth e armazenamento de credenciais continuam gerenciados pelo cliente.
Os clientes podem implementar subconjuntos diferentes.
Esses continuam definidos por cada cliente.
A distribuição permanece fora do escopo da especificação central.
A inclusão de caminhos no pacote não equivale a isolamento em tempo de execução.
Portabilidade significa que clientes podem descobrir e carregar componentes com base em um contrato compartilhado. Isso não significa que cada runtime de agente raciocinará ou invocará o componente exatamente da mesma forma.
Plugins portáteis podem ampliar o alcance da distribuição.
Isso também aumenta a importância de configurações de segurança por padrão.
Evite armazenar credenciais nos seguintes locais:
plugin.json
cabeçalho do mcp.json
valores de variáveis de ambiente no mcp.json
arquivos empacotados
Use autenticação gerenciada pelo cliente.
Não confie em escapar do diretório raiz do plugin para acessar arquivos arbitrários do host.
Servidores stdio podem iniciar processos.
Usuários e administradores empresariais devem estar cientes do que estão instalando.
Plugins que precisam apenas de leitura não devem exigir operações de escrita.
Servidores MCP remotos devem ter políticas claras de propriedade, privacidade e uso de dados.
Mesmo que a estrutura de diretórios permaneça válida, mudanças no comportamento do servidor podem constituir alterações de quebra.
Determine quais partes do plugin atual são verdadeiramente reutilizáveis:
Habilidades (Skills)
Servidores MCP
Metadados compartilhados
Migre comportamentos exclusivos do cliente para os namespaces de extensão correspondentes.
Declare explicitamente o Agent Plugins 1.0.0 no plugin.json.
Coloque as habilidades de agente portáveis em:
skills//SKILL.md
Use o arquivo de nível raiz:
mcp.json
Em vez de depender apenas de arquivos de configuração nativos do cliente.
Migre credenciais para os sistemas de autenticação de cada cliente.
A interoperabilidade deve ser verificada por demonstração prática, e não presumida.
Como a especificação atual ainda está marcada como rascunho de trabalho, monitore mudanças no repositório do projeto, discussões, padrões e páginas de compatibilidade.
| Declaração | Status |
|---|---|
| A especificação Agent Plugins 1.0.0 foi publicada | Confirmado |
| A especificação define o empacotamento portátil de habilidades e servidores MCP | Confirmado |
O arquivo raiz plugin.json é obrigatório | Confirmado |
skills/ é o local fixo das habilidades | Confirmado |
O arquivo raiz mcp.json é o local da configuração MCP | Confirmado |
| stdio e Streamable HTTP são os transportes MCP padrão | Confirmado |
| O SSE legado é reconhecido, mas opcional para clientes | Confirmado |
| Extensões específicas do cliente usam namespaces de domínio reverso | Confirmado |
| Distribuição, instalação, permissões e experiência do usuário foram padronizadas | Não; explicitamente fora do escopo |
| Hooks (ganchos) são componentes portáveis do Agent Plugins v1 | Não; eles podem ser extensões do cliente |
| A OpenAI possui ou gerencia exclusivamente o Agent Plugins | Não |
| O projeto é neutro em relação a fornecedores e governado pela comunidade | Confirmado pela governança oficial |
| A versão 1.0.0 é uma norma final totalmente congelada | Não; a página da especificação está atualmente marcada como rascunho de trabalho |
| Todo cliente compatível suporta todos os componentes e transportes MCP | Não |
| ChatGPT, Codex, VS Code, Cursor, GitHub Copilot e Kiro estão listados como compatíveis | Confirmado na página de compatibilidade atual |
O Agent Plugins 1.0 é um formato de pacote aberto e neutro em relação a fornecedores para extensões reutilizáveis de agentes de IA. Ele padroniza como configurar Agent Skills e servidores MCP em um diretório de plugin portátil.
Não. A OpenAI participa do projeto e oferece suporte ao formato no ChatGPT e no Codex, mas o projeto oficial é governado pela comunidade e é neutro em relação a fornecedores. Sua equipe inicial de mantenedores principais inclui pessoas ligadas à Amazon, Cursor, Microsoft, OpenAI e Vercel.
Cada plugin requer um arquivo raiz plugin.json. As habilidades podem ser armazenadas em skills/, enquanto os servidores MCP podem ser descritos no arquivo raiz mcp.json; funcionalidades específicas do cliente podem usar extensões de namespace.
Não. O MCP continua definindo o protocolo usado entre clientes e servidores MCP. O Agent Plugins define uma forma portátil de empacotar configurações de servidores MCP e outros componentes reutilizáveis de agentes.
Não como componentes centrais portáveis. A versão 1 padroniza Habilidades e servidores MCP; hooks podem ser implementados por meio de namespaces de extensão específicos do cliente, onde houver suporte.
A página oficial de compatibilidade lista atualmente VS Code, Cursor, GitHub Copilot, ChatGPT e Codex, e Kiro. Eles suportam transportes MCP diferentes, portanto, os autores devem consultar a matriz atualizada.
Não. O padrão cobre descoberta de pacotes e componentes portáveis; não aborda modelos, interfaces de permissão, fluxos de autenticação, mercados ou comportamentos de tempo de execução específicos do cliente. Plugins podem ser portáveis, mas não necessariamente produzir o mesmo comportamento de execução.
1.0.0 é a versão publicada atual e fornece o padrão. A página da especificação marca atualmente o status do projeto como “rascunho de trabalho”, portanto, os desenvolvedores devem continuar acompanhando os processos públicos de governança e versionamento.
mcp.json.org/compatible-clients): Matriz de suporte atual para VS Code, Cursor, GitHub Copilot, ChatGPT e Codex, e Kiro.
O Agent Plugins 1.0 resolve um problema prático no crescente ecossistema de agentes: desenvolvedores empacotam repetidamente as mesmas habilidades e integrações MCP de formas diferentes para cada cliente.
A especificação define um núcleo pequeno e portátil — o plugin.json obrigatório, habilidades no diretório skills/, configuração MCP em mcp.json, regras de empacotamento, esquemas versionados e extensões de cliente com namespace. Distribuição, mercados, permissões, autenticação e interface do usuário permanecem sob controle do cliente.
O projeto lista suporte para vários clientes de agente importantes, incluindo VS Code, Cursor, GitHub Copilot, ChatGPT e Codex, e Kiro. Isso faz dele mais do que um formato de plugin exclusivo da OpenAI, embora a OpenAI seja um dos mantenedores participantes.
A versão 1.0.0 é o contrato atualmente publicado, embora a página de especificação ainda a rotule como rascunho de trabalho. Os desenvolvedores podem adotá-la agora, mas devem acompanhar os processos públicos de governança e versionamento.
A principal mudança é simples: em vez de reescrever as mesmas extensões de agente para cada plataforma, os desenvolvedores podem tratar habilidades e integrações MCP como componentes portáteis com uma estrutura de pacote unificada.
Comece com uma frase e tenha um site completo em minutos.
