Integrando o agente de nuvem do Copilot ao Slack

Observação

Esse recurso está dentro prévia pública e sujeito a alterações.

GitHub Copilot usa IA. Verifique se há erros. Consulte Cartão de aplicativo: GitHub Copilot Agents.

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. 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 Sobre integrações de Copilot.

Considerações de segurança

Antes de você @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 áreas restritas

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 um repositório podem acionar Copilot para fazer alterações, mas qualquer participante da conversa pode dar sua contribuição. 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. O thread inteiro 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 o repositório de trabalho, o branch, o link de solicitação de emissão ou pull, o status e o 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.
Para usar Copilot cloud agent, é necessário ter os sandboxes na nuvem habilitados para o seu plano Copilot. Consulte o isolamento em sandbox na nuvem para GitHub Copilot.

Observação

As políticas de sandbox na nuvem têm a mesma configuração das políticas Copilot cloud agent. Membros de uma organização ou empresa, incluindo um empresa com usuários gerenciados, talvez precisem que o proprietário habilite as sandboxes na nuvem e Copilot cloud agent antes de poderem usar Copilot no Slack. Consulte Habilitar ou desabilitar áreas restritas de 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 Copilot usa ao responder aos prompts, e também é onde as issues e pull requests criadas por sessões do Copilot cloud agent serão abertas, a menos que você especifique um repositório no prompt.

Para começar:

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

Como usar o aplicativo GitHub no Slack

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

Você deve ter permissão de gravação no repositório padrão ou no repositório especificado no prompt para que Copilot cloud agent funcione. Se você não tiver acesso de gravação ao repositório relevante, ainda poderá ajudar a orientar Copilot fornecendo entrada no thread do Slack, que será usado como contexto quando Copilot cloud agent fizer alterações na solicitação de pull.

Os usuários podem invocar Copilot cloud agent em qualquer repositório onde tiverem write acesso. 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.

No Slack, abra uma mensagem direta com o app GitHub ou mencione o app @mention em uma conversa digitando @GitHub.
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
Copilot cloud agent iniciará uma sessão de cloud agent e, assim que cloud agent for concluído, responderá com um resumo das alterações que planeja fazer e um link para os artefatos criados no repositório especificado.

Criando 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 criar o problema para você.

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

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

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.
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 um repositório padrão para um canal

Você pode definir um repositório padrão para cada canal público ou privado. Não é possível definir um repositório padrão para mensagens diretas com Copilot.

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

No canal, digite @GitHub settings e envie a mensagem.
Selecione o repositório que você deseja usar como padrão e salve as alterações.

Quando você não especifica um repositório ou branch, Copilot usa o repositório padrão do canal e o branch padrão desse repositório.