Distribuindo o aplicativo Copilot do GitHub para sua equipe

O GitHub Copilot app é um aplicativo para desktop para orientar agentes, revisar alterações e gerenciar pull requests em fluxos de trabalho em paralelo.

Cada desenvolvedor instala o aplicativo e entra individualmente. Você controla o acesso deles por meio Copilot de licenças e políticas corporativas ou de organização.

Use este tutorial para configurar um piloto, orientar os desenvolvedores por meio de sua primeira tarefa e validar o fluxo de trabalho do aplicativo antes de uma distribuição mais ampla.

Pré-requisitos

Antes de começar:

• Verifique se cada desenvolvedor piloto tem uma Copilot Business ou Copilot Enterprise licença da empresa ou organização que controlará seu acesso.
• Escolha um repositório piloto em que os desenvolvedores possam fazer alterações e abrir solicitações de pull.
• Crie uma tarefa bem delimitada para uma atividade pequena e de baixo risco, como adicionar testes para um comportamento já existente.

Para obter informações sobre como as licenças e as políticas interagem, consulte GitHub Copilot políticas para empresas e organizações.

1. Configurar o acesso e as políticas

Se suas organizações pertencerem a uma empresa, primeiro estabeleça linhas de base de nível empresarial para políticas e disponibilidade de modelo. Em seguida, configure cada organização. As políticas empresariais podem impor uma configuração ou, para a maioria das políticas, permitir que as organizações decidam.

1. Confirme se a GitHub Copilot app política está habilitada para a empresa ou organização que fornece licenças para os desenvolvedores piloto.

   A política é habilitada por padrão para Copilot Business e Copilot Enterprise. Ele é independente da Copilot CLI política, portanto, habilitar um não habilita o outro.

   Para obter instruções, consulte Gerenciando políticas e recursos para GitHub Copilot em sua empresa ou Gerenciando políticas e recursos para GitHub Copilot em sua organização.

2. Configure os modelos que os desenvolvedores piloto podem usar.

   As políticas de disponibilidade do modelo se aplicam ao GitHub Copilot app. Estabeleça uma linha de base que atenda aos requisitos de segurança, conformidade e custo antes do início do piloto.

   Para obter instruções, consulte Gerenciando a disponibilidade de modelos em sua empresa ou Gerenciando a disponibilidade de modelos em uma organização.

3. Se os desenvolvedores piloto precisarem de servidores MCP (Model Context Protocol), identifique os servidores necessários para o piloto e habilite os servidores MCP na Copilot política.

   No arquivo da sua empresa managed-settings.json, use allowedMcpServers para permitir apenas os servidores aprovados. Se necessário, use deniedMcpServers para bloquear configurações de servidor específicas. Essas configurações controlam quais servidores podem ser executados, mas não instalam os servidores para desenvolvedores.

   Para obter instruções, consulte Configurando uma lista de permissões do servidor MCP para sua empresa.

2. Peça aos desenvolvedores para instalar e fazer login

Depois de configurar o acesso e as políticas, peça a cada desenvolvedor para:

1. Visite a página de download do GitHub Copilot app.
2. Baixe e instale o aplicativo para seu sistema operacional.
3. abra o aplicativo.
4. Clique em Entrar em GitHub e siga as instruções para se autenticar.
5. Selecione o repositório piloto quando solicitado. Os participantes também podem adicionar um repositório local existente ou clonar o repositório posteriormente.
6. Se a tarefa piloto exigir um servidor MCP, na barra lateral do aplicativo, clique em Personalizar e, em seguida, MCP. Instale um servidor aprovado necessário para a tarefa.

Para o procedimento de instalação completo do aplicativo, consulte Introdução ao GitHub aplicativo Copilot. Para obter mais informações sobre como instalar servidores MCP, consulte Personalizando a aplicativo Copilot do GitHub.

3. Concluir uma primeira tarefa útil

Comece com uma tarefa que demonstra o contexto do repositório, alterações de código, execução de teste e revisão humana sem alterar o comportamento de produção.

Peça a cada desenvolvedor para:

1. Na barra lateral, abra Meu trabalho.

2. Localize e abra o problema para a tarefa piloto.

3. Clique em Nova sessão. O aplicativo cria uma sessão com o contexto de problema já carregado.

4. Selecione o modo interativo e um modelo aprovado.

5. Na caixa de comando, cole o prompt a seguir:

   Copilot prompt

   Implement this issue without changing unrelated behavior.
   Run the relevant tests, then summarize the diff and results.
   

6. Responda às solicitações do agente por informações.

7. Depois que o agente fizer alterações, clique em Alterações e examine a diferença.

8. Peça ao agente para corrigir quaisquer problemas.

9. Para manter as alterações, clique em Criar PR e siga o processo de revisão normal.

Essa tarefa valida que cada desenvolvedor pode acessar o repositório, usar um modelo aprovado e, se aplicável, um servidor MCP aprovado, executar ferramentas de projeto e examinar as alterações geradas pelo agente.

Para mais informações sobre como iniciar sessões a partir de problemas, consulte Gerenciando problemas e solicitações de pull com o GitHub aplicativo Copilot.

4. Executar fluxos de trabalho independentes em paralelo

As sessões iniciadas em novas árvores de trabalho usam espaços de trabalho isolados. Os desenvolvedores podem progredir em tarefas independentes sem que uma sessão altere os arquivos de trabalho de outra sessão.

Peça aos desenvolvedores para experimentar este fluxo de trabalho:

1. Mantenha a primeira sessão aberta.
2. Clique + ao lado de Sessões e inicie outra sessão no mesmo repositório.
3. Escolha executar a sessão em uma nova árvore de trabalho.
4. Dê à segunda sessão uma tarefa independente.
5. Alterne entre as sessões na barra lateral para monitorar o progresso e fornecer comentários.
6. Examine cada sessão de forma independente e crie solicitações de pull separadas para as alterações que você deseja manter.

Para obter mais informações sobre espaços de trabalho isolados, modos de sessão e seleção de modelo, consulte Trabalhando com sessões de agente no GitHub aplicativo Copilot.

Depois que os desenvolvedores concluirem o piloto, reúna comentários sobre instalação, restrições de política, seleção de tarefas e qualidade de revisão. Use seus comentários para resolver barreiras comuns e melhorar suas diretrizes internas antes de distribuir o aplicativo mais amplamente.