# Referencia sobre complementos y la tienda

Busque los términos del complemento compartido y la tienda, los formatos de archivo y los vínculos a la documentación específica de la superficie.

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/NAME/SKILL.md`                                                                           | 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:

```text
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](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference#components).

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](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference).

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](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference). 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:

```text
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](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference#marketplacejson). 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](/es/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces).

## 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:

* [Uso de complementos en Visual Studio Code](/es/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [Búsqueda e instalación de complementos para GitHub Copilot CLI](/es/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [Personalización del aplicación Copilot de GitHub](/es/copilot/how-tos/github-copilot-app/customize-github-copilot-app)
* [Configuración de las opciones de GitHub Copilot en la nube](/es/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings)