Los complementos empaquetan personalizaciones para superficies compatibles Copilot. Los formatos de complemento, los componentes y las ubicaciones admitidas varían según el entorno. Use la documentación de la plataforma en la que planea instalar el complemento.
Manifiestos del complemento
Un complemento se describe mediante un manifiesto plugin.json. Agent Plugins define un formato de complemento portátil para superficies compatibles. El manifiesto está en la raíz del directorio del complemento y declara el esquema de complementos del agente. Para Agent Plugins 1.0, usa https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
Copilot CLI también reconoce el esquema 1.1.0.
El formato compartido de plugins de Agent define ubicaciones estándar para algunos componentes. La compatibilidad con esos componentes puede diferir según la superficie:
| Componente | Ubicación de los complementos del agente | Notes |
|---|---|---|
| Aptitudes | skills/ | Las superficies compatibles pueden descubrir habilidades en esta ubicación. |
| Servidores MCP | ||
mcp.json en la raíz del complemento | Las superficies compatibles pueden detectar la configuración del servidor MCP en esta ubicación. | |
| componentes específicos de Surface | Un directorio con espacio de nombres, como com.github.copilot/ | La disponibilidad y los componentes admitidos dependen de Surface. |
Un directorio de Agent Plugins 1.0 puede usar esta estructura:
my-plugin/
├── plugin.json
├── skills/
│ └── deploy/
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
El plugin.json manifiesto declara el esquema de Plugins de agente. Las ubicaciones skills/ y raíz mcp.json están definidas por los complementos del agente. El com.github.copilot/ directorio contiene componentes específicos de Copilot, no componentes portátiles de Agent Plugins. Los componentes que una superficie carga desde este directorio dependen de esa superficie. Para el Copilot CLI, consulte Referencia del plugin CLI de GitHub Copilot.
Copilot CLI también admite un formato de complemento heredado Copilot . Usa diferentes comportamientos de detección de componentes y rutas de acceso de componente configurables. Para los campos de manifiesto, validación, ubicaciones de archivos y comportamiento específico de la CLI, consulte Referencia del plugin CLI de GitHub Copilot.
Visual Studio Code documenta el formato de creación del complemento y el comportamiento admitido en la referencia de creación de complementos del agente. No suponga que un comportamiento de componente o manifiesto que se admite en una superficie también se admite en otra.
Catálogo del Marketplace
Un marketplace.json catálogo proporciona metadatos sobre un marketplace y enumera complementos en su matriz de nivel plugins superior. Cada entrada del complemento puede incluir su nombre, descripción, versión y origen. La fuente identifica dónde se encuentran los archivos del complemento. Para Copilot CLI, marketplace.json es el único componente de Marketplace necesario. Otras superficies pueden tener requisitos adicionales.
El nombre de Marketplace procede de su name campo, no del nombre del repositorio. Un identificador de complemento combina el nombre del complemento con el nombre de Marketplace:
PLUGIN-NAME@MARKETPLACE-NAME
Mantenga los nombres de marketplace y complementos estables cuando la configuración haga referencia a ellos. Al cambiar un nombre de Marketplace, se cambian los identificadores de complemento usados por esas configuraciones.
Los campos de catálogo y las ubicaciones de archivos compatibles pueden variar según el entorno. Para ver los campos y ubicaciones completos del catálogo de Marketplace de Copilot CLI, consulte Referencia del plugin CLI de GitHub Copilot. Para ver los pasos para publicar un catálogo en un GitHub repositorio, consulte Creación y uso compartido de un marketplace de complementos en GitHub.
Usar complementos
Agregar un marketplace hace que sus complementos estén disponibles para examinar. Instalar un complemento lo agrega a un entorno. Al habilitar un complemento, sus componentes están disponibles en sesiones en ese entorno. Para obtener instrucciones específicas de la superficie, consulte: