Trabalhando com sessões de agente no GitHub aplicativo Copilot

Você pode iniciar uma sessão a partir de um repositório para realizar o trabalho nesse repositório ou iniciar um projeto para dar Copilot uma meta e deixá-lo coordenar o trabalho. Os projetos podem abranger um ou mais repositórios ou se concentrar em tarefas que não exigem um repositório. Consulte Trabalhando com projetos no GitHub aplicativo Copilot.

Iniciando uma sessão

Você pode executar sessões em worktrees separadas para progredir em várias tarefas em paralelo ou trabalhar em um checkout existente.

1. Na barra lateral, ao lado de Sessões, clique em .
2. Em "Iniciar sessão em", selecione um repositório ou pasta conectados. Para conectar um repositório primeiro, escolha Adicionar GitHub repositório, Clonar repositório ou Abrir pasta local.
3. Abaixo da caixa de prompt, abra o menu suspenso "Ambiente" e selecione Este computador ou Nuvem. As sessões de nuvem são executadas em sandboxes isolados hospedados por GitHub. Consulte Usando sandboxes locais e na nuvem.
4. Abaixo da caixa de prompt, abra o menu suspenso "Workspace" e selecione New worktree para usar uma cópia de trabalho separada do repositório ou o check-out atual para trabalhar no check-out existente. Você também pode escolher o branch base.
5. Selecione um modo de sessão, um modelo e um esforço de raciocínio nas listas suspensas abaixo do campo do prompt. Se você escolher Copilot Fusion e um nível de esforço, Copilot analisará cada tarefa e selecionará um modelo para concluí-la, orquestrando vários modelos por meio dos padrões de execução disponíveis quando necessário.
6. Descreva a tarefa no campo do prompt. Você pode referenciar problemas com #, adicionar arquivos com @ou usar / para comandos.

O agente começa a trabalhar. Suas sessões ativas aparecem na barra lateral, agrupadas por repositório—clique em qualquer sessão para alternar para essa sessão.

Para obter uma lista de comandos que você pode usar na caixa de prompt, consulte Comandos de barra para o GitHub aplicativo Copilot.

Escolhendo um modo de sessão

O modo de sessão controla como o agente funciona com você. Ele é separado das permissões de ferramenta, que controlam quando o agente pergunta antes de executar uma ferramenta. Você pode definir o modo na lista suspensa abaixo do campo de prompt e alterá-lo a qualquer momento.

• Interativo: você e o agente trabalham juntos. O agente sugere alterações e aguarda sua entrada antes de continuar.
• Plano: O agente cria um plano primeiro. Examine e aprove o plano antes que o agente o execute.
• Piloto automático: o agente funciona de forma totalmente autônoma, escrevendo código, executando testes e iterando sem aguardar a entrada.

Seleção de permissões da ferramenta

Em uma sessão de aplicativo, Copilot usa ferramentas para concluir tarefas, como executar comandos de terminal, ler e editar arquivos, pesquisar sua base de código, buscar conteúdo da Web e delegar trabalho a agentes especializados. Algumas ferramentas podem modificar seu sistema ou acessar recursos externos, portanto, as permissões de ferramenta controlam quando Copilot solicita sua aprovação antes de usá-las.

Você pode escolher entre três opções que determinam o quanto deseja estar envolvido na aprovação das ferramentas que Copilot usa.

• Aprovação manual (pergunte todas as vezes): solicite sua aprovação antes de executar as ferramentas. Isso oferece o maior nível de supervisão, mas exige que você responda ao maior número de prompts.
• Assistido: use um modelo para avaliar cada solicitação, aprovando automaticamente solicitações que ele avalia como seguras e solicitando que você aprove solicitações potencialmente inseguras. Assisted permissions reduz os prompts, mantendo a supervisão de ações potencialmente arriscadas.
• Aprovação incondicional (aprovar tudo): execute ferramentas sem solicitar sua aprovação. Essa é a opção mais conveniente, mas remove sua supervisão de ações individuais.

Para obter mais informações sobre como usar assisted permissions, consulte Permitindo a execução de comandos seguros sem aprovação manual.

Para escolher o nível de permissão de uma sessão individual:

1. Na sessão, clique no modo abaixo do campo de prompt.
2. Passe o cursor sobre Permissões da ferramenta.
3. Selecione Perguntar todas as vezes, Assistido ou Aprovar tudo.

Para definir o nível de permissão padrão para sessões locais futuras:

1. Abra as configurações do aplicativo.
2. Clique em Sessões.
3. Em permissões da Ferramenta, selecione Perguntar todas as vezes, Assistido ou Aprovar tudo.

Escolhendo um modelo

Você pode selecionar um modelo e um esforço de raciocínio nas listas suspensas abaixo do campo do prompt. Maior esforço de raciocínio dá ao agente mais tempo para pensar em problemas complexos, mas pode levar mais tempo. Você pode alterar ambas as configurações a qualquer momento durante uma sessão.

Se você escolher Fusion no seletor de modelo e, em seguida, um nível de esforço, o aplicativo selecionará automaticamente os modelos e padrões de execução para sua tarefa. Enquanto Copilot Fusion funciona, você pode acompanhar o progresso de cada etapa e o modelo que está sendo usado. Quando a resposta for fornecida, você poderá passar o mouse sobre o nome do nível de esforço abaixo da resposta para ver uma lista de modelos usados. Para obter mais informações, consulte Sobre GitHub Copilot Fusion.

Se você configurou seu próprio provedor de modelos no aplicativo, esses modelos também aparecerão no seletor. Para obter as etapas de instalação, consulte Adicionar modelos LLM ao aplicativo GitHub Copilot.

Passe o mouse sobre o ícone no seletor de modelos para ver os detalhes do modelo.

Usando o chat

A seção Chats na barra lateral abre um modo de conversa sem criar um branch dedicado ou uma árvore de trabalho. Use-o para discutir, fazer perguntas ou explorar ideias antes de iniciar uma sessão. Seu histórico de chat é salvo e listado pelo nome da conversa.

Para arquivar um chat sem perder seu histórico, clique com o botão direito do mouse no chat na barra lateral para abrir seu menu e clique em Arquivar chat.

Gerenciando sessões e chats

Use Gerenciar sessões para exibir, pesquisar e filtrar sessões e chats, incluindo chats arquivados. Você pode selecionar vários itens para arquivar ou excluir e restaurar chats arquivados anteriormente. O modo de exibição também mostra colunas separadas e classificáveis para o espaço em disco usado por arquivos de trabalho e histórico de chat.

1. Abra as configurações do aplicativo e selecione Sessões.
2. Clique em Gerenciar sessões.
3. Pesquise ou filtre para localizar as sessões ou chats que você deseja gerenciar.
4. Selecione uma ou mais sessões ou chats e, em seguida, arquive ou exclua-as. Para restaurar um chat arquivado, localize o chat e restaure-o.

Uso de áreas restritas locais e na nuvem

As áreas restritas locais e de nuvem protegem as sessões de diferentes maneiras:

• Área restrita da nuvem: executa a sessão inteira em um ambiente isolado hospedado por GitHub. Use uma área restrita de nuvem quando quiser manter a sessão fora do computador ou executar várias tarefas com uso intensivo de recursos em paralelo. Selecione Nuvem no menu suspenso Ambiente ao iniciar uma sessão. Em seguida, você pode acompanhar e controlar a sessão de qualquer cliente Copilot.
• Área restrita local: executa a sessão em seu computador, mas restringe o sistema de arquivos, a rede e o acesso à credencial disponíveis para ferramentas de execução de agente. Use o sandboxing local quando o agente precisar de suas ferramentas locais ou serviços de desenvolvimento, mas você deseja limitar seu acesso ao restante do computador. Configure o padrão das novas sessões de repositório local e de árvore de trabalho nas configurações do projeto ou use /sandbox on ou /sandbox off para alterar uma sessão local ativa.

O sandboxing local não se aplica a sessões de área restrita de nuvem ou sessões executadas em um host remoto. Para obter mais informações sobre como funcionam os dois tipos de área restrita, consulte Sobre o sandboxing local para GitHub Copilot e Sobre sandboxes na nuvem para GitHub Copilot. Para habilitar o sandboxing local, consulte Usando o sandbox local.

Executando sessões no WSL

Em Windows, você pode usar o aplicativo para executar sessões de agente em uma distribuição do Subsistema do Windows para Linux (WSL) 2. Antes de começar, entre no aplicativo com sua GitHub conta e verifique se o WSL 2 está instalado com um repositório ou pasta disponível na distribuição.

1. Abra um terminal na distribuição do WSL e execute gh auth login para autenticar com GitHub. A autenticação dentro do WSL é separada do login no aplicativo no Windows.
2. Abra as configurações do aplicativo e selecione Ambientes na barra lateral. O aplicativo descobre automaticamente as distribuições WSL instaladas.
3. Clique em Conectar para sua distribuição WSL.
4. Abra os detalhes da distribuição. Em Repositórios e pastas, clique em Adicionar repositório ou pasta.
5. Selecione ou digite o caminho do Linux para seu repositório ou pasta e clique em Adicionar repositório ou adicionar pasta.
6. Inicie uma sessão para o repositório ou pasta. No menu suspenso Ambiente, abaixo da caixa de prompt, selecione sua distribuição em Ambientes.

Se Environments não estiver visível, selecione Experimental nas configurações do aplicativo e verifique se os hosts WSL estão habilitados.

Como usar /security-review em sessões de aplicativo

Você pode executar o comando de barra /security-review em uma sessão ativa do agente para revisar as alterações atuais no fluxo de trabalho em busca de vulnerabilidades identificadas com alto grau de confiança. O comando retorna descobertas priorizadas com pontuações de severidade e confiança, além de correções sugeridas que você pode aplicar e verificar na mesma sessão.

1. Abra uma sessão ativa que tenha alterações de código em andamento.
2. Na caixa de prompt, digite /security-review e pressione Enter.
3. Examine as descobertas e atualize as alterações de código conforme necessário.

Essa revisão leve, sob demanda, complementa GitHubcode scanning, Dependabot e secret scanning ao oferecer uma verificação inicial das suas alterações locais antes de abrir um pull request.

Para trabalhar com descobertas de revisão local e alertas existentes code scanning junto com sua sessão, instale a GitHub extensão de segurança. Consulte Exibindo e corrigindo alertas de segurança no GitHub aplicativo Copilot.

Uso do agente do pato de borracha

O pato de borracha é um agente integrado que funciona como um crítico construtivo, examinando o plano, a implementação ou os testes atuais e retornando feedback concreto. O agente funciona com base em um modelo diferente daquele que comanda a sessão atual.

Quando o pato de borracha estiver habilitado, Copilot poderá consultá-lo automaticamente em momentos importantes enquanto estiver funcionando. O agente da sessão principal passa o trabalho para o agente do pato de borracha, recebe a análise crítica e, em seguida, decide como aplicar esse feedback antes de continuar.

Você também pode solicitar manualmente Copilot para obter uma avaliação do agente do pato de borracha.

1. Abra uma sessão ativa.
2. Na caixa de prompt, digite /rubber-duck e solicite uma crítica ao seu plano, implementação ou testes atuais.

Para obter mais informações sobre o agente do pato de borracha, consulte Obtendo uma segunda opinião com o agente Rubber Duck.

Uso de /chronicle com sessões de aplicativo

Como o GitHub Copilot app é baseado no GitHub Copilot CLI, você pode usar os recursos de histórico de sessão do Copilot CLI, como /chronicle, para obter insights sobre o trabalho que você fez no aplicativo e em outras sessões do Copilot CLI.

Por exemplo, você pode usar /chronicle standup para resumir o trabalho recente. Para obter mais informações, consulte Usando GitHub Copilot CLI dados de sessão.

Usando ditado de voz

Você pode usar o ditado por voz para ditar prompts durante uma sessão em vez de digitá-los.

Antes de usar o ditado de voz, você precisa defini-lo nas configurações do aplicativo.

1. Abra as configurações do aplicativo e, em seguida, selecione a guia Ditado de Voz .
2. Escolha um atalho de teclado.
3. Permitir o acesso ao microfone nas configurações do sistema operacional.
4. Baixe um modelo de transcrição local.

Após a instalação, use o atalho para iniciar e interromper a transcrição de voz. O aplicativo insere texto transcrito na caixa de prompt para que você possa revisá-lo ou editá-lo antes de enviá-lo.

Atalhos do teclado

O GitHub Copilot app oferece suporte a atalhos de teclado para ajudar você a navegar pelas sessões, alternar entre espaços de trabalho e executar ações comuns. Para ver os atalhos disponíveis, abra o aplicativo, vá para a Ajuda e, em seguida, atalhos de teclado.

Você também pode iniciar uma sessão diretamente no aplicativo usando links profundos de arquivos markdown, ferramentas de terceiros ou scripts. Para obter mais informações, consulte Usando links profundos para abrir o GitHub aplicativo Copilot.