# Referência de plug-in e marketplace

Encontre os termos do plug-in compartilhado e do marketplace, os formatos de arquivo e os links para a documentação específica da superfície.

Os plug-ins empacotam personalizações para superfícies compatíveis Copilot. Formatos de plug-in, componentes e locais com suporte variam de acordo com a plataforma. Use a documentação da plataforma em que você planeja instalar o plug-in.

## Arquivos de manifesto do plug-in

Um plug-in é descrito por um `plugin.json` manifest. Agent Plugins define um formato de plug-in portátil para superfícies compatíveis. O manifest está na raiz do diretório do plug-in e declara o esquema Agent Plugins. Para plug-ins de agente 1.0, use `https://agent-plugins.org/schemas/1.0.0/plugin.schema.json`.
Copilot CLI também reconhece o esquema 1.1.0.

O formato compartilhado de plug-ins do agente define locais padrão para alguns componentes. O suporte para esses componentes pode ser diferente por superfície:

| Component                            | Localização dos plug-ins do agente                                                  | Notes                                                                  |
| ------------------------------------ | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Habilidades                          | `skills/NAME/SKILL.md`                                                              | Dispositivos Surface compatíveis podem detectar recursos neste local.  |
| Servidores MCP                       |                                                                                     |                                                                        |
| `mcp.json` na raiz do plug-in        | Superfícies compatíveis podem descobrir a configuração do servidor MCP neste local. |                                                                        |
| componentes específicos para Surface | Um diretório com namespace, como `com.github.copilot/`                              | A disponibilidade e os componentes com suporte dependem da plataforma. |

Um diretório do Agent Plug-ins 1.0 pode usar esta estrutura:

```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
```

O `plugin.json` manifest declara o esquema de plug-ins do agente. Os locais `skills/` e os locais raiz `mcp.json` são definidos pelos Plug-ins do Agente. O `com.github.copilot/` diretório contém componentes específicos Copilot, não componentes de plug-ins de agente portáteis. Os componentes que uma superfície carrega deste diretório dependem dessa superfície. Para o Copilot CLI, consulte [referência de plugin da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference#components).

Copilot CLI também dá suporte a um formato de plug-in herdado Copilot . Ele usa diferentes comportamentos de descoberta de componentes e caminhos de componente configuráveis. Para campos de manifesto, validação, locais de arquivo e comportamento específico da CLI, consulte [referência de plugin da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference).

Visual Studio Code documenta o formato de criação do plug-in e os comportamentos compatíveis na [Agent Plugins authoring reference](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference). Não suponha que um componente ou comportamento do manifesto com suporte em uma superfície tenha suporte em outra.

## Catálogo do Marketplace

Um `marketplace.json` catálogo fornece metadados sobre um marketplace e lista plug-ins em seu array `plugins` de nível superior. Cada entrada de plug-in pode incluir seu nome, descrição, versão e origem. A fonte identifica onde os arquivos de plug-in estão localizados. Para Copilot CLI, `marketplace.json` é o único componente do marketplace necessário. Outras superfícies podem ter requisitos adicionais.

O nome do marketplace vem do campo `name`, não do nome do repositório. Um identificador de plug-in combina o nome do plug-in com o nome do marketplace:

```text
PLUGIN-NAME@MARKETPLACE-NAME
```

Mantenha os nomes do marketplace e do plug-in estáveis quando as configurações se referem a eles. Alterar um nome do marketplace altera os identificadores de plug-in usados por essas configurações.

Os campos de catálogo e os locais de arquivo com suporte podem variar de acordo com a plataforma. Para obter os campos e locais completos do catálogo do marketplace de Copilot CLI, consulte [referência de plugin da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference#marketplacejson). Para obter etapas para publicar um catálogo em um GitHub repositório, consulte [Criando e compartilhando um marketplace de plug-in no GitHub](/pt/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces).

## Usar plugins

Adicionar um marketplace disponibiliza seus plug-ins para serem explorados. Ao instalar um plug-in, ele é adicionado a uma superfície. Habilitar um plug-in disponibiliza seus componentes em sessões nessa área. Para obter instruções específicas da superfície, consulte:

* [Usando plug-ins em Visual Studio Code](/pt/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [Localizando e instalando plug-ins para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [Personalizando a aplicativo Copilot do GitHub](/pt/copilot/how-tos/github-copilot-app/customize-github-copilot-app)
* [Configurando configurações para GitHub Copilot na nuvem](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings)