Integrando o agente de nuvem Copilot com o Teams

Observação

Esse recurso está atualmente em 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.

A integração GitHub no Microsoft Teams permite que você interaja com Copilot cloud agent, tudo isso diretamente nas suas conversas do Teams. No Teams, 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 @mentionGitHub no Teams, considere que Copilot cloud agent capturará toda a conversa como contexto para sua solicitação, entendendo a discussão e implementando soluções com base nela. Esse contexto é armazenado nos artefatos gerados pelo agente. Se você quiser limitar o contexto, você pode enviar uma mensagem direta ao aplicativo GitHub para o Teams.

Noções básicas sobre sessões colaborativas, permissões 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 um 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 workspace e colaboradores externos de repositórios não podem iniciar nem conduzir uma sessão com Copilot no Teams.

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.

Quando você solicitar Copilot a execução de uma tarefa, ela exibirá detalhes sobre a sessão, como o repositório de trabalho, o link de solicitação de emissão ou pull, o modelo usado e um status ou resumo da tarefa.

Sandboxes seguras na nuvem

Quando Copilot cloud agent inicia o trabalho em uma tarefa do Teams, Copilot continua trabalhando de forma assíncrona em uma área restrita de nuvem segura e posta o resultado quando estiver pronto.

Você pode continuar controlando no Teams ou continuar o trabalho nos artefatos gerados pelo agente no GitHub, no terminal ou no editor de código de sua preferência.

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 Teams.
Você deve ter a Visualização Pública para Desenvolvedores da Microsoft habilitada no cliente do Microsoft Teams; consulte Visualização pública para desenvolvedores do Teams na documentação do Microsoft Learn.
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, podem precisar que o proprietário habilite sandboxes na nuvem e Copilot cloud agent antes que possam usar Copilot no Teams. Consulte Habilitar ou desabilitar áreas restritas de nuvem para sua organização ou empresa.

Instalando o GitHub aplicativo no Teams

O GitHub aplicativo só precisa ser instalado uma vez em uma equipe. Depois que o aplicativo é instalado, qualquer membro da equipe pode conectar sua GitHub conta ao aplicativo e começar a usá-lo.

Abra o link de integração para instalaçãoGitHub no navegador da web para abrir o Teams e a caixa de diálogo de instalação.
Clique em Add para adicionar o aplicativo à sua equipe.
Siga os prompts na tela para autenticar e autorizar o aplicativo.

Conectando o GitHub aplicativo à sua GitHub conta

Na primeira vez que usar o GitHub aplicativo no Teams, você precisará conectá-lo à 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 a prompts, e é nele também que issues e pull requests criados por sessões do Copilot cloud agent serão abertos, a menos que você especifique um repositório no prompt.

Para começar:

No Teams, @mention mencione o aplicativo em uma mensagem digitando @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.

Iniciando uma GitHub Copilot sessão da sua conversa de equipe

@Mention Abra o aplicativo em qualquer chat do Teams digitando @GitHub seguido pela sua tarefa. Você pode chamar o agente para qualquer repositório ao qual você tenha acesso write. O agente responde com um resumo das alterações planejadas e um link para os artefatos que ele cria.

Por exemplo, para pedir que o agente crie um pull request em uma branch específica de um repositório, você pode digitar:

@GitHub Create a pull request to...YOUR_PROMPT repo=OWNER/REPO_NAME branch=BRANCH_NAME

O repo parâmetro informa Copilot qual repositório usar e o branch parâmetro especifica um branch existente a ser usado como o branch base para uma solicitação de pull.

Refinando o trabalho no tópico

Para refinar a solicitação de pull, @mention@GitHub no mesmo thread com as alterações solicitadas. Copilot incorpora todas as mensagens desde o @mention anterior para iterar o trabalho, mantendo a discussão e a implementação alinhadas.

Criando problemas com Copilot

Você pode pedir Copilot para criar GitHub problemas diretamente do Teams, transformando conversas em tarefas acionáveis. 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.

Personalizando Copilot cloud agent no Teams

Você pode personalizar como Copilot cloud agent funciona em seus canais e threads usando o settings parâmetro. Por exemplo, você pode definir um repositório padrão para um canal.

Para ver e alterar as configurações do canal, mencione o aplicativo em uma mensagem digitando:
```
@GitHub settings
```
Em seguida, siga os prompts para fazer suas alterações.

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.

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.

No canal, digite @GitHub settings e envie a mensagem.
Siga os prompts para selecionar um repositório padrão para o canal.

Comentários e suporte

Você pode exibir e compartilhar comentários em nosso fórum de discussão.