# Complementos para GitHub Copilot

Los complementos agrupan personalizaciones relacionadas para que puedas instalarlas juntas en las superficies admitidas Copilot.

Los plugins empaquetan personalizaciones relacionadas para que pueda instalarlos y administrarlos juntos en lugar de configurar cada uno por separado. Por ejemplo, un complemento de prueba podría combinar una habilidad para ejecutar pruebas, un agente para la revisión de código y un servidor MCP para un servicio test-reporting.

## Dónde puede usar complementos

Los complementos están disponibles en estos Copilot entornos:

* Visual Studio Code. Explora e instala complementos desde **Personalizar** en el panel lateral de Chat o en la ventana Agentes. Para obtener detalles sobre el formato del complemento de VS Code, consulte la [referencia de creación y edición de complementos del agente](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference).
* GitHub Copilot CLI. Examine e instale complementos desde un marketplace registrado.
* El GitHub Copilot app. Explore e instale complementos desde **Personalice**.
* Copilot in the cloud. Configure los complementos a través de la configuración del repositorio.

Un complemento puede contener componentes que solo funcionan en una surface determinada. Compruebe que el complemento admite la superficie que usa. Por ejemplo, la configuración del servidor LSP descrita en esta categoría es para Copilot CLI. Para obtener más información, vea [Referencia sobre complementos y la tienda](/es/enterprise-cloud@latest/copilot/reference/plugin-and-marketplace-reference).

## Qué complementos contienen

Un complemento puede empaquetar algunos o todos estos componentes. Los componentes disponibles y sus ubicaciones dependen del formato y la superficie del complemento:

* **Agentes personalizados** : asistentes especializados de IA (`*.agent.md` archivos en `agents/`)
* **Skills** — instrucciones, scripts y recursos específicos de la tarea (subdirectorios de Skills en `skills/`, que contienen un archivo `SKILL.md`)
* **Hooks** — controladores de eventos que responden a acciones del agente (un `hooks.json` archivo en la raíz del complemento o en `hooks/`)
* **Extensiones**: código específico de Surface que agrega funcionalidades como herramientas y comandos de barra diagonal
* **Configuraciones del servidor MCP: integraciones** del protocolo de contexto de modelo (raíz `mcp.json` en los complementos del agente 1.0)
* **Configuraciones de servidor LSP: integraciones** del protocolo de servidor de lenguaje en plataformas compatibles

## Formatos de complementos

Agent Plugins es un formato para compartir manifiestos de complemento, aptitudes y configuraciones de servidor MCP en plataformas compatibles. Los Agent Plugins 1.0 declaran el esquema canónico en `plugin.json`; sus ubicaciones de esquema y componente no son compatibles con todas las interfaces de la misma manera.
Copilot CLI también admite un formato de complemento heredado Copilot . En la CLI, un manifiesto sin el esquema de complementos del agente usa este formato heredado.

Elija Plugins de agente cuando quiera compartir aptitudes y servidores MCP en interfaces compatibles. Utilice el formato heredado de la CLI cuando necesite rutas de acceso de componente configurables o mantenga un complemento específico de Copilot existente.

Para un nuevo complemento, use Agent Plugins 1.0, a menos que necesite rutas de componentes configurables. Use el formato heredado principalmente para complementos heredados existentes.

## Cómo se estructuran los complementos

Un complemento es un directorio con una estructura específica y un `plugin.json` archivo de manifiesto. Agent Plugins 1.0 requiere el manifiesto en la raíz del complemento. Los complementos heredados admiten ubicaciones de manifiesto adicionales. El manifiesto proporciona al complemento un nombre y metadatos. Según el formato, también puede apuntar a componentes. Junto con el manifiesto, el directorio puede contener agentes, aptitudes, enlaces, configuraciones de servidor MCP y configuraciones de servidor LSP.

### Estructura de complementos de agente 1.0

Los complementos de agente 1.0 almacenan aptitudes y servidores MCP en ubicaciones estándar para que los clientes compatibles puedan detectarlos. Otros componentes, incluidos agentes, enlaces, comandos y servidores LSP, son específicos del cliente.
Copilot lee estos componentes desde el `com.github.copilot` directorio . Otros clientes omiten este directorio, por lo que el mismo complemento puede combinar aptitudes compartidas y servidores MCP con Copilotcomponentes específicos.

Un directorio de Complementos de agente 1.0 puede tener este aspecto:

```text
my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json
```

El manifiesto debe incluir Agent Plugins 1.0 `$schema`. Para conocer los campos de manifiesto de nivel superior admitidos, los requisitos de nombre y las ubicaciones de los [componentes, consulte Campos de manifiesto de complementos del agente 1.0](/es/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference#agent-plugins-10-manifest-fields).

### Estructura heredada del complemento

Un directorio de complementos heredado Copilot puede tener este aspecto:

```text
my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)
```

Para obtener el conjunto completo de campos que puede incluir en el manifiesto, consulte [Referencia del plugin CLI de GitHub Copilot](/es/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference). Para obtener instrucciones paso a paso sobre cómo crear un complemento, consulte [Creación de un complemento para GitHub Copilot CLI](/es/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).

## ¿Por qué usar complementos?

Los complementos proporcionan las siguientes ventajas:

* Reutilización entre proyectos
* Configuración compartida Copilot entre repositorios
* Comparta conocimientos sobre dominios (por ejemplo, proporcionando las aptitudes de un experto de Rails o un experto de Kubernetes)
* Encapsular configuraciones complejas del servidor MCP

## Dónde proceden los complementos

El marketplace integrado en Visual Studio Code, Copilot CLI y el GitHub Copilot app es [awesome-copilot](https://github.com/github/awesome-copilot?utm_source=customization-plugin-doc-awesome\&utm_medium=docs\&utm_campaign=universe-2026). Se deben agregar otros marketplaces antes de que estén disponibles sus complementos.

Agregar un marketplace hace que sus complementos estén disponibles para examinar. No los instala ni los habilita. El identificador de un complemento combina el nombre del complemento con el nombre de Marketplace como `PLUGIN-NAME@MARKETPLACE-NAME`. El nombre de Marketplace procede del campo `name` de su archivo `marketplace.json`, no del nombre del repositorio.

## ¿Qué decide si un complemento está habilitado?

Los complementos pueden estar disponibles, instalados o habilitados. Agregar un marketplace hace que sus complementos estén disponibles para examinar. Instalar un complemento lo agrega a una superficie, y habilitarlo hace que sus componentes estén disponibles en las sesiones de esa superficie. La configuración compartida puede establecer un valor predeterminado o determinar si un complemento está habilitado:

| Origen de configuración                           | Effect                                                                                                                        | ¿Puede un miembro desactivar el complemento?            |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Configuración administrada por la empresa         | Exigir o bloquear un complemento en superficies admitidas.                                                                    | N. º La política administrada siempre prevalece.        |
| Configuración gestionada por el equipo de empresa | Agregue los complementos necesarios mediante `enabledPlugins` en archivos de equipo empresariales, sobre la base empresarial. | N. º Estas entradas están administradas por directivas. |
| Valores predeterminados del repositorio           | Habilite un complemento para todos los usuarios que trabajan en un repositorio.                                               | Sí, donde la superficie admite una anulación local.     |

Los valores predeterminados del repositorio no hacen que un complemento sea obligatorio. No pueden habilitar un complemento que una directiva administrada bloquea ni usar un marketplace que la directiva no permite. La configuración administrada no puede habilitar un complemento opcional de forma predeterminada. Solo requiere o bloquea complementos.

Los archivos del equipo de Enterprise agregan entradas administradas `enabledPlugins` a la línea base de Enterprise. Los miembros no pueden desactivar los plugins obligatorios. Consulte [Sobrescritura de la configuración administrada por la empresa para equipos empresariales](/es/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/override-settings-for-teams).

Los valores predeterminados del repositorio usan `.github/copilot/settings.json`. Para conocer las anulaciones locales específicas de la configuración y de la superficie, consulte [directorio de configuración de la CLI de GitHub Copilot](/es/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson).

Los administradores de empresa pueden especificar marketplaces y complementos adicionales que son obligatorios o bloqueados. Consulte [Administración de marketplaces de complementos y complementos con la configuración administrada por la empresa](/es/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/manage-plugin-marketplaces-and-plugins).

## Funcionamiento de los marketplaces de complementos

Una tienda de complementos es un catálogo de complementos donde puede explorar e instalar complementos. Un marketplace se puede hospedar en un repositorio en GitHub.com, otro host de Git o un directorio local. Dado que los complementos de marketplace tienen versiones, los marketplaces facilitan la detección, instalación y actualización de complementos.

Un marketplace se define mediante un archivo `marketplace.json`, que proporciona metadatos sobre el marketplace y enumera sus complementos.

Para obtener instrucciones específicas según la plataforma para usar complementos o publicar un marketplace en un repositorio GitHub, consulte [Lectura adicional](#further-reading).

## Plugins en comparación con la configuración manual

Cualquier funcionalidad que pueda agregar con un complemento, también puede agregar mediante la Copilot configuración manual, por ejemplo, agregando perfiles de agente personalizados o servidores MCP. Sin embargo, los complementos proporcionan varias ventajas sobre la configuración manual:

| Feature              | Configuración manual en un repositorio | Plugin                                            |
| -------------------- | -------------------------------------- | ------------------------------------------------- |
| Ámbito               | Repositorio único                      | Cualquier proyecto                                |
| Sharing              | Copiar y pegar manualmente             | Comando de instalación o `enabledPlugins` entrada |
| Control de versiones | Historial de Git                       | Versiones de Marketplace                          |
| Discovery            | Búsqueda de repositorios               | Exploración de Marketplace                        |

## Lectura adicional

* [Uso de complementos en Visual Studio Code](/es/enterprise-cloud@latest/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/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [Personalización del aplicación Copilot de GitHub](/es/enterprise-cloud@latest/copilot/how-tos/github-copilot-app/customize-github-copilot-app#adding-plugins)
* [Configuración de las opciones de GitHub Copilot en la nube](/es/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings#configuring-plugins-for-github-copilot-cloud-agent)
* [Creación y uso compartido de un marketplace de complementos en GitHub](/es/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces)