Este tutorial rápido orienta você na personalização de GitHub Copilot para um repositório. Ao final, Copilot conhecerá as convenções do projeto, terá um agente especializado para tarefas comuns e terá o contexto do projeto organizado.
**Cenário:** Você trabalha no repositório de aplicativos Web de uma equipe com um conjunto de testes estabelecido, convenções de codificação e problemas ativos. Você quer que Copilot trabalhe efetivamente com a base de código desde o primeiro dia.
Pré-requisitos
- Um Copilot plano que inclui agente de nuvem Copilot (GitHub Copilot Pro+, Copilot Businessou Copilot Enterprise). Para obter mais informações, consulte Planos para GitHub Copilot.
- Agente de nuvem habilitado para sua organização ou conta. Para obter mais informações, consulte Gerenciando o acesso ao agente de nuvem GitHub Copilot.
- Gravar acesso a um GitHub repositório.
Etapa 1: Ensinar Copilot as convenções do seu projeto
As instruções personalizadas do repositório fornecem Copilot contexto persistente sobre seu projeto: sua estrutura, padrões de codificação e como criar e testar código. Cada Copilot interação no repositório usa essas instruções automaticamente.
Peça agente de nuvem Copilot para gerar um copilot-instructions.md arquivo:
-
Vá para github.com/copilot/agents.
-
Selecione seu repositório no menu suspenso no campo de prompt.
-
Insira o seguinte prompt:
Text Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project.
Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project. -
Examine o arquivo gerado e mescle a solicitação de pull.
Copilot agora entende as convenções do projeto em chat, revisão de código e sessões de agente. Consulte [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).
Etapa 2: Criar um agente especializado
Agentes personalizados permite criar assistentes focados para tarefas recorrentes. Neste exemplo, crie um agente que diagnostice e corrija bugs.
-
Vá para github.com/copilot/agents e selecione seu repositório.
-
No campo de prompt, clique em . Em seguida, clique em Criar um agente personalizado.
-
Mude o nome do ficheiro para
bug-fixer.agent.md. -
Substitua o conteúdo do modelo por:
YAML --- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards.
--- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards. -
Confirme o arquivo e mescle-o no branch padrão.
O agente solucionador de bugs agora aparece na lista suspensa de agentes na guia agentes. Selecione-o antes de colar a URL do problema para iniciar uma sessão de depuração específica. Consulte Criando agentes personalizados para agente de nuvem Copilot.
Etapa 3: Organizar o contexto do projeto com um espaço
Espaços do Copilot permite que você faça a curadoria das necessidades exatas de contexto Copilot para uma área específica do seu projeto. As respostas são fundamentadas em arquivos, problemas e documentação relevantes.
-
Vá para github.com/copilot/spaces e clique em Criar espaço.
-
Nomeie o espaço (por exemplo, "Arquitetura de API") e escolha um proprietário.
-
Clique em Adicionar fontes e, em seguida, adicione o contexto relevante ao seu projeto:
<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-file-code" aria-label="file-code" role="img"><path d="M4 1.75C4 .784 4.784 0 5.75 0h5.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v8.586A1.75 1.75 0 0 1 14.25 15h-9a.75.75 0 0 1 0-1.5h9a.25.25 0 0 0 .25-.25V6h-2.75A1.75 1.75 0 0 1 10 4.25V1.5H5.75a.25.25 0 0 0-.25.25v2.5a.75.75 0 0 1-1.5 0Zm1.72 4.97a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734l1.47-1.47-1.47-1.47a.75.75 0 0 1 0-1.06ZM3.28 7.78 1.81 9.25l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042Zm8.22-6.218V4.25c0 .138.112.25.25.25h2.688l-.011-.013-2.914-2.914-.013-.011Z"></path></svg> Adicionar arquivos e repositórios** — adicionar documentos de arquitetura, esquemas de API ou arquivos de configuração de chave.
<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link" aria-label="link" role="img"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> Vincular arquivos, solicitações de pull e problemas** — cole URLs para problemas ativos ou discussões de design. -
No chat do espaço, faça uma pergunta como: "Quais padrões nossa API usa para tratamento de erros?"
Copilot respostas usando apenas o contexto que você coletou. Consulte [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/create-copilot-spaces).
Próximas Etapas
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-personal-instructions)** — Defina preferências pessoais que se aplicam a todos os seus repositórios.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills)** – Adicionar novos recursos aos seus agentes.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/extend-cloud-agent-with-mcp)** – Conectar agentes a ferramentas e serviços externos.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/collaborate-with-others)** — Compartilhe seus espaços com colegas de equipe.