# Integrando o agente de nuvem Copilot com o Teams

Você pode usar a integração do GitHub no Teams para fornecer contexto e abrir pull requests diretamente nos canais do Teams.

> \[!NOTE]
>
> * 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](/pt/enterprise-cloud@latest/copilot/responsible-use/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](/pt/enterprise-cloud@latest/copilot/concepts/tools/about-copilot-integrations).

## Considerações de segurança

Antes de você usar @mentionGitHub no Teams, 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, poderá enviar uma mensagem direta para o 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.

  > \[!NOTE]
  > 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](/pt/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#additional-approval-for-unattributed-copilot-pull-requests).

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. A thread inteira torna-se o contexto de tomada de decisão para o artefato.

Quando você solicitar que o Copilot execute uma tarefa, ele exibirá detalhes sobre a sessão, como o repositório de trabalho, o problemas ou o link da pull request, 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 coordenando pelo Teams 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 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](https://learn.microsoft.com/en-us/microsoftteams/platform/resources/dev-preview/developer-preview-intro) 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 [Isolamento em área restrita na nuvem para GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/about-cloud-and-local-sandboxes#cloud-sandboxing).

  > \[!NOTE]
  > As políticas de sandbox na nuvem têm a mesma configuração das políticas Copilot cloud agent. Os membros de uma organização ou empresa, incluindo um empresa com usuários gerenciados, podem precisar que o proprietário habilite as áreas restritas na nuvem e o Copilot cloud agent antes que possam usar o Copilot no Teams. Consulte [Habilitar ou desabilitar áreas restritas de nuvem para sua organização ou empresa](/pt/enterprise-cloud@latest/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-sandboxes-for-your-organization).

## 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.

1. Abra o [link de integração para instalaçãoGitHub](https://teams.microsoft.com/l/app/836ecc9e-6dca-4696-a2e9-15e252cd3f31) no navegador da web para abrir o Teams e a caixa de diálogo de instalação.
2. Clique em **Add** para adicionar o aplicativo à sua equipe.
3. 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 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.

Para começar:

1. No Teams, use @mention no aplicativo em uma mensagem digitando `@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`.

## Iniciar uma sessão do GitHub Copilot direto de sua conversa com a equipe

Use @Mention no aplicativo em qualquer chat do Teams digitando `@GitHub` seguido pela sua tarefa. Você pode chamar o agente de 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:

```text
@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.

## Iterar o trabalho na thread

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

## Criar problemas com Copilot

Você pode pedir ao 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 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.

## 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.

1. Para ver e alterar as configurações do canal, mencione o aplicativo em uma mensagem digitando:

   ```text
   @GitHub settings
   ```

2. 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.

1. No canal, digite `@GitHub settings` e envie a mensagem.
2. 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](https://github.com/orgs/community/discussions/205453).

## Leitura adicional

* [Sobre o agente de nuvem do GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/about-cloud-agent)
* [Gerenciando o acesso ao agente de nuvem GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/access-management)