Integrando o agente de nuvem do Copilot ao Slack

Introdução

A integração Copilot cloud agent no Slack permite que você interaja com Copilot cloud agent a partir do seu workspace do Slack e está incluída no aplicativo GitHub para Slack. Em uma mensagem, thread ou mensagem direta do Slack, você pode iniciar cloud agent sessões para investigar, planejar, escrever código e criar problemas e solicitações de pull, usando o contexto da conversa. Você também pode escolher o modelo, conectar servidores MCP (Model Context Protocol), trabalhar em vários repositórios e utilizar Copilot Memory. As decisões colaborativas da sua equipe permanecem conectadas ao seu código, fazendo a ponte entre onde as discussões ocorrem e onde a implementação reside.

Para obter informações sobre integrações adicionais Copilot , consulte Integrações do Copilot.

Considerações de segurança

Antes de você usar @mentionGitHub no Slack, considere que Copilot cloud agent capturará toda a conversa como contexto para a sua solicitação, entendendo e implementando soluções com base na discussão. Esse contexto é armazenado nos artefatos gerados pelo agente. Se você quiser limitar o contexto, pode enviar uma mensagem direta para o aplicativo GitHub do Slack.

Noções básicas sobre sessões colaborativas, permissões, canais de código e ambientes isolados

O uso da identidade Copilot depende se você interage com ela em uma mensagem direta ou em um contexto compartilhado.

• Quando você usa Copilot em uma mensagem direta, ela pode executar ações para você, como criar solicitações ou problemas de pull, bem como responder a perguntas. Ele usa as permissões de sua conta pessoal vinculada GitHub para executar essas ações.

• Quando você usa Copilot em um contexto compartilhado, como uma conversa em grupo ou canal, Copilot cria artefatos, como pull requests, usando a identidade do aplicativo em vez da sua conta pessoal.

  Observação

  Pull requests criados por Copilot em um contexto compartilhado usam a identidade do aplicativo. Se você usar conjuntos de regras de repositório, como essas solicitações de pull não são atribuídas a uma pessoa, mais uma aprovação será necessária antes da mesclagem, desde que o repositório já exija pelo menos uma aprovação. Isso é habilitado por padrão. Consulte Regras disponíveis para conjuntos de regras.

Somente usuários com acesso de escrita a cada repositório selecionado para uma sessão podem disparar Copilot para fazer alterações ou orientar essa sessão, mas qualquer participante da conversa pode fornecer entrada. Membros convidados de um espaço de trabalho e colaboradores externos de repositórios não podem iniciar ou conduzir uma sessão com Copilot no Slack.

Copilot usa todas as mensagens da conversa para orientar o trabalho. A thread inteira torna-se o contexto de tomada de decisão para o artefato.

Código do Slack

Quando você solicitar Copilot a execução de uma tarefa, Copilot cloud agent criará um canal de código dedicado, chamado Slack Code. É aqui que você e, opcionalmente, seus colegas de equipe podem colaborar com Copilot em uma tarefa. Depois que um canal de código for estabelecido, guie a sessão exclusivamente por esse canal.

Copilot gerencia o canal de código e exibe detalhes sobre a sessão, como repositórios de trabalho, branches, links de issue ou pull request, status e modelo em uso. Os canais de código são destinados a uma sessão por vez: um canal por tarefa. Quando a sessão for concluída, você será questionado se deseja arquivar o canal. Após o arquivamento, o canal e seu histórico permanecem acessível e pesquisáveis, e você pode reabrir o canal, se necessário.

Sandboxes seguras na nuvem

Quando Copilot cloud agent inicia o trabalho em uma tarefa do Slack, Copilot continua trabalhando de forma assíncrona em uma área restrita de nuvem segura e posta o resultado quando estiver pronto. Você pode continuar coordenando pelo Slack ou continuar o trabalho nos artefatos gerados pelo agente no GitHub, no terminal ou no seu editor de código preferido.

Pré-requisitos

• Você deve ter uma conta GitHub com acesso ao Copilot por meio de um plano pago Copilot.
• Você deve ter uma conta do Slack e ser membro de um workspace.
• Você deve ter a GitHub integração do Slack instalada. Consulte Integrando GitHub ao Slack.
• Se você obtiver Copilot por meio de uma organização ou empresa, incluindo uma empresa com usuários gerenciados, a política Copilot in the cloud será habilitada por padrão, mas um proprietário poderá desativá-la. Copilot executa suas sessões do Slack em uma sandbox na nuvem, que não precisa de uma configuração separada. Consulte Gerenciando sandboxes na nuvem para sua organização ou empresa.

Conectando o GitHub aplicativo à sua GitHub conta

Na primeira vez que você usar a GitHub integração no Slack, o aplicativo solicitará que você a conecte à sua GitHub conta. Em seguida, se solicitado, defina um repositório padrão.

O repositório padrão fornece o contexto que o Copilot usa ao responder a prompts, e é nele também que as pull requests e os problemas criados por sessões do Copilot cloud agent serão abertos, a menos que você especifique um repositório no prompt. Não é possível definir repositórios padrão para mensagens diretas, portanto, em uma mensagem direta, nomeie os repositórios em seu prompt.

Para começar:

1. No Slack, abra uma mensagem direta com o aplicativo GitHub ou @mention o aplicativo GitHub em um tópico ao digitar @GitHub.
2. Siga os prompts para conectar sua GitHub conta e, se solicitado, defina opcionalmente um repositório padrão.
3. Para ver o que mais você pode fazer, na thread, use @mention no aplicativo digitando @GitHub help.

Como usar o aplicativo GitHub no Slack

Você pode enviar mensagens diretas para o aplicativo GitHub ou usar @mention em uma conversa. O bot responderá às suas mensagens e executará tarefas com base em suas solicitações.

Você deve ter acesso de gravação a cada repositório padrão ou a cada repositório especificado em seu prompt para fazer com que Copilot cloud agent funcione. Se você não tiver acesso de escrita aos repositórios relevantes, ainda poderá ajudar a orientar Copilot fornecendo comentários na conversa no Slack, que serão usados como contexto quando Copilot cloud agent fizer alterações no pull request.

Os usuários podem invocar Copilot cloud agent em qualquer repositório onde tiverem acesso write. Para repositórios corporativos, os administradores devem instalar e configurar o aplicativo Slack GitHub e especificar quais repositórios o aplicativo Slack pode acessar. Para obter mais informações sobre como configurar GitHub Apps, consulte Instalando um Aplicativo GitHub por meio do GitHub Marketplace em suas organizações.

1. No Slack, abra uma mensagem direta com o aplicativo GitHub ou use a @mention ao aplicativo em uma conversa digitando @GitHub.

2. Digite o prompt e envie-o. Você pode descrever o repositório e o branch em linguagem natural como parte de sua solicitação. Por exemplo:

   @GitHub Add "Hello World" to the README in octo-org/octo-repo on the develop branch

3. Copilot cloud agent iniciará uma sessão do cloud agent e, após a conclusão do cloud agent, responderá com um resumo das alterações que planeja fazer e um link para os artefatos criados no repositório especificado.

Você também pode responder a uma notificação GitHub e mencionar @GitHub em uma tarefa. Por exemplo, peça para investigar um fluxo de trabalho com falha ou explicar as alterações em um pull request. A conversa e os recursos vinculados GitHub fornecem contexto para o trabalho.

Trabalhando em vários repositórios

Uma sessão pode funcionar com até 11 repositórios pertencentes à mesma organização ou conta pessoal. Você deve ter acesso de gravação a cada repositório selecionado. Selecione os repositórios ao iniciar a tarefa ou nomeie-os no prompt. Por exemplo:

@GitHub Update the API in octo-org/service and its client in octo-org/web. Open a pull request in each repository and link the changes.

Examine o conjunto de repositórios antes do início do trabalho. A alteração dos padrões de canal afeta novas conversas, não os históricos de uma sessão em execução.

Criar problemas com Copilot

Você pode pedir ao Copilot que crie GitHub itens diretamente do Slack, transformando conversas em tarefas práticas. Basta descrever o que você precisa em linguagem natural e Copilot cria o problema para você.

Você pode criar um único problema ou vários problemas ao mesmo tempo com relações filho-pai.

Quando você usa @mention no aplicativo, ele usa o histórico completo da thread como contexto para os problemas que ele cria. Para manter o contexto focado, considere iniciar um novo thread ou enviar uma mensagem direta.

1. No Slack, peça Copilot para criar um ou mais problemas, especificando o repositório de destino.

   Para criar um único problema:

   @GitHub In octo-org/octo-repo, create a feature request to add fuzzy matching to search.
   

   Para criar vários problemas ao mesmo tempo:

   @GitHub In octo-org/octo-repo, open separate issues for adding fuzzy matching to search, paginating the results list, and caching search queries.
   

   Para criar problemas com relações filho-pai:

   @GitHub In octo-org/octo-repo, create an epic to redesign search, with child issues for fuzzy matching, pagination, and query caching.
   

   Observação

   Você só pode usar Copilot para criar problemas em repositórios em que já tem permissão para criar problemas. Esse recurso não altera o seu acesso nem ignora as permissões do repositório.

2. Copilot cria os problemas e respostas com um link para cada um deles. Cada problema inclui um título e uma descrição e, com base no prompt Copilot , também é possível adicionar metadados, como rótulos, atribuições e tipo de problema.

Configurando repositórios padrão para um canal

Você pode definir um ou mais repositórios padrão para cada canal do Slack. Os repositórios padrão fornecem Copilot contexto para seus prompts, portanto, você não precisa especificar um repositório sempre que pedir para ele trabalhar. Os repositórios que você pode selecionar dependem do proprietário padrão do canal. Não é possível definir repositórios padrão para mensagens diretas com Copilot.

Se um canal não tiver repositórios padrão, Copilot define o repositório usado na primeira sessão desse canal como padrão.

1. No canal, execute @GitHub settings.
2. Se necessário, use Selecionar proprietário ou Editar proprietário para escolher a conta ou a organização.
3. Use Selecionar repositórios ou a opção Editar repositórios, para uma seleção existente, para escolher os repositórios.
4. Salve as alterações. O primeiro repositório é marcado como o repositório primário.

Quando você não especifica um repositório ou branch, Copilot usa os repositórios padrão do canal e seus branches padrão. Você pode limpar os repositórios padrão para que novas conversas perguntem quais repositórios usar. Especificar repositórios em uma conversa não altera os padrões do canal nem inscreve o canal em notificações de repositório.

Escolhendo um modelo

Você pode escolher o modelo que Copilot cloud agent usa para sessões iniciadas no Slack. Para alterar o modelo apenas para a conversa atual, peça a Copilot para ajudar você a escolher um modelo. Isso altera o modelo da conversa, incluindo seu canal de código, sem alterar as configurações padrão do canal.

Para definir um modelo padrão para novas conversas em um canal:

1. Execute @github settings no canal.
2. Clique em Editar o modelo.
3. Selecione um modelo e salve as alterações.

Se você limpar a configuração de modelo do canal, novas conversas usarão o modelo padrão padrão. As opções de modelo dependem da disponibilidade e das políticas da sua organização. Para obter mais informações sobre modelos, consulte Comparação de modelos de IA.

Usando servidores MCP

Os servidores MCP configurados para um repositório estão disponíveis para Copilot quando ele é usado nesse repositório, portanto, você os configura da mesma maneira que para Copilot cloud agent no GitHub. Para usar servidores MCP no Slack, configure-os em um dos repositórios padrão em que Copilot é usado.

Tenha o seguinte em mente ao usar servidores MCP:

• Os servidores MCP que você configura em suas próprias configurações são usados apenas para sessões iniciadas.
• Um administrador de repositório configura os servidores, as ferramentas permitidas e as credenciais.
• Examine as ferramentas e o acesso a dados antes de habilitar um servidor.
• Se uma sessão não puder ser iniciada porque a configuração mcp do repositório é inválida ou muito grande, peça a um administrador do repositório para corrigir a configuração e tentar novamente.

Para saber como o MCP funciona Copilot cloud agent, consulte Protocolo MCP (Model Context Protocol). Para configurar servidores MCP para um repositório, incluindo segredos e validação, consulte Configurar servidores MCP para seu repositório.

Usando Copilot Memory

Copilot Memory ajuda a Copilot lembrar informações sobre seus repositórios e suas preferências, para que ele possa funcionar com mais eficiência ao longo do tempo. Copilot Memory é habilitado por padrão para planos individuais Copilot . Para planos corporativos e gerenciados pela organização, um administrador deve habilitar a política primeiro. Se Copilot Memory estiver habilitado para você, Copilot armazenará memórias automaticamente à medida que trabalha nas tarefas que você inicia e as aplicará ao trabalho posterior.

Os fatos do repositório se aplicam apenas ao repositório no qual foram aprendidos e as preferências pessoais se aplicam apenas às suas próprias interações. Você pode examinar e excluir memórias em suas configurações. Para obter mais informações, consulte Sobre a Memória do GitHub Copilot.

Leitura adicional

• GitHub Copilot no GitHub.com e no GitHub Mobile - Saiba mais sobre Copilot cloud agent e como ele pode dar suporte a você.