Automações do Copilot

Overview

Com automations, você pode configurar Copilot cloud agent para ser executado automaticamente, em um agendamento, em resposta a um evento em um repositório ou disparado por meio da API. Automations pode executar uma ação dentro do repositório em que eles estão configurados, como abrir uma solicitação de pull ou rotular um problema.

Você define o prompt uma vez, seleciona os gatilhos e decide quais ferramentas Copilot pode usar. Copilot executa sua automação automaticamente sempre que o gatilho de automation é acionado.

Por exemplo, você pode usar automations para:

• Reproduzir bugs: tente reproduzir um bug relatado quando um problema é aberto.
• Capture capturas de tela para revisão: capture capturas de tela de alterações e anexe-as a uma pull request quando ela estiver marcada como pronta para revisão.
• Investigar incidentes de produção: comece a investigar um incidente quando sua ferramenta de monitoramento detectá-lo.

Você também pode criar e gerenciar automations a partir de:

• A guia Agentes de um repositório em GitHub
• Automations guia na GitHub Copilot app
• A janela Agentes em VS Code
• A API REST

Ao criar um automation, você define:

• Um nome para identificar o automation.
• Um tipo, pessoal ou compartilhado, que determina quem pode ver e editar o automation, quem é cobrado e de quem ele usa a identidade. Consulte Pessoal e compartilhados automations.
• Um prompt que descreve a tarefa que você deseja Copilot executar.
• Gatilhos que determinam quando o automation é executado.
• As ferramentas podem ser usadasCopilot , que controlam quais ações podem ser executadas em seu repositório.
• Opcionalmente, o uso do modelo e do nívelCopilot de raciocínio.
• Opcionalmente, AI credits os limites que controlam quantos AI credits o automation pode consumir.

Você pode adicionar automations a automation groups, que compartilham contexto e podem sugerir melhorias a si mesmos com base nos resultados.

Para obter instruções sobre como criar e gerenciar automations, consulte Criando automações com Copilot agente de nuvem.

Disponibilidade e permissões

Para automations estar disponível em um repositório, todos os seguintes devem ser verdadeiros:

• O repositório deve ser privado ou interno. Automations não estão disponíveis em repositórios públicos.
• Copilot cloud agent deve ser habilitado para o repositório. Se você tiver Copilot Business ou Copilot Enterprise, um administrador deverá habilitar a Copilot cloud agent política. Consulte Gerenciando GitHub Copilot na nuvem para sua empresa ou organização.
• A organização deve permitir tanto Copilot cloud agentautomations no repositório (ambos estão habilitados por padrão). Consulte Gerenciando GitHub Copilot na nuvem para sua organização.

Automations estão disponíveis nos planos GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Max, GitHub Copilot Business e GitHub Copilot Enterprise.

Qualquer usuário com acesso de gravação a um repositório pode criar automations nesse repositório.

Você pode criar e gerenciar automations a partir de:

• A aba Agentes em um repositório no GitHub, no painel Automations.
• A guia Automations em GitHub Copilot app.
• A guia Automations na janela Agentes em VS Code.

Nuvem automations em VS Code requer a versão 1.144 ou posterior e com a configuração chat.automations.cloud.enabled habilitada.

Pessoal e compartilhado automations

Ao criar um automation, você escolhe seu tipo, que não pode ser alterado mais tarde.

• Automações pessoais automations são úteis para automatizar o trabalho por conta própria, como preparar suas atualizações para um standup.
• Itens compartilhados automations permitem que sua equipe crie e mantenha automations em conjunto, para automatizar fluxos de trabalho para toda a equipe.

Como um automation compartilhado pertence ao repositório em vez da pessoa que o criou, ele continua funcionando se essa pessoa deixa a equipe ou perde o acesso ao repositório.

Para que um automation compartilhado seja executado em um repositório de propriedade da organização, a organização deve permitir o uso de Copilot cloud agent faturado para a organização. Um administrador pode habilitá-lo com a política "Permitir o uso de Copilot cloud agent cobrado da organização".

Gatilhos

Uma automation é executada quando um de seus gatilhos é acionado. Uma ampla gama de gatilhos está disponível, incluindo:

• Em uma programação: o automation é executado em intervalos recorrentes — de hora em hora, diariamente ou semanalmente.
• Quando um problema é criado: o automation é executado cada vez que um problema é aberto no repositório.
• Quando um pull request é aberto: o automation é executado sempre que um pull request é aberto no repositório.
• Quando um pull request é sincronizado: o automation é executado sempre que novos commits são enviados para um pull request no repositório.

Opcionalmente, você pode configurar filtros para gatilhos baseados em evento, por exemplo:

• Quando uma ocorrência for criada, adicione um filtro de pesquisa.
• Para quando uma solicitação de pull é aberta e quando uma solicitação de pull é sincronizada, adicione um filtro de consulta de pesquisa e um filtro para arquivos alterados na solicitação de pull.

Para reduzir o risco de injeção de prompt, automations ignore GitHub os eventos disparados por usuários que não têm acesso de gravação ao repositório por padrão. Isso ajuda a impedir que usuários não confiáveis façam com que Copilot execute uma ação, por exemplo, quando um colaborador externo abre um problema. Você pode optar por permitir esses eventos se necessário. Para obter mais informações, consulte Segurança e segurança.

Todos automations podem ser disparados por meio da API, permitindo que você conecte automations a sistemas e ferramentas externos. Ao iniciar automation por meio da API, você pode incluir um contexto adicional que é passado para o prompt.

Ferramentas e ações

As ferramentas que você seleciona quando cria um(a) automation determinam o que Copilot pode fazer quando automation é executado(a).

Por exemplo, você pode permitir que Copilot envie alterações, atualize rótulos de problemas ou crie uma pull request.

Você pode escolher entre dois tipos de ferramentas:

• GitHub ferramentas, que permitem Copilot trabalhar com seu repositório em GitHub. Por exemplo, as GitHub ferramentas permitem Copilot:

  • Enviar anexos
  • Ocultar e mostrar novamente comentários e revisões
  • Adicionar e remover reações
  • Ler discussões e seus comentários, e comentar sobre discussões

• Ferramentas dos servidores MCP, que permitem Copilot trabalhar com sistemas externos. Um automation pode usar ferramentas dos servidores MCP configurados nas configurações de MCP do repositório. Você escolhe quais das ferramentas de cada servidor o automation pode usar. Consulte Configurar servidores MCP para seu repositório.

Selecionar ferramentas é a principal forma de controlar o escopo de um automation. Conceda apenas as ferramentas de que a tarefa precisa, para que Copilot não possa executar ações que você não pretendia permitir.

Você pode selecionar manualmente as ferramentas que deseja habilitar ou usar o botão GitHub em **** para que Copilot sugira ferramentas com base no seu prompt.

GitHub as ferramentas só podem tomar medidas no único repositório ao qual o automation está vinculado. As ferramentas dos servidores MCP não se limitam a esse repositório: elas podem acessar tudo o que a configuração e as credenciais do servidor permitirem, o que pode incluir outros repositórios e sistemas externos. Examine o que cada servidor MCP pode acessar antes de selecionar suas ferramentas.

Configuração herdada do repositório

Automations usam a configuração Copilot cloud agent para o repositório ao qual se aplicam, incluindo:

• Instruções personalizadas. Consulte Adicionando instruções personalizadas do repositório para GitHub Copilot.
• Habilidades de agente. Consulte Adicionando habilidades de agente para GitHub Copilot.
• Regras de firewall. Consulte Personalizando ou desabilitando o firewall para GitHub Copilot.
• Segredos e variáveis. Consulte Configurar segredos e variáveis para Copilot agente de nuvem.

Automations são armazenados separadamente do conteúdo do repositório. Eles não são incluídos no Git, portanto não são versionados junto com seu código nem gerenciados por meio de pull requests.

Billing

Cada vez que automation é executado, ele inicia uma sessão Copilot cloud agent que usa GitHub AI Credits e GitHub Actions minutos.

Para uma conta pessoal automation, o uso de AI credits é cobrado do usuário que criou o automation.

Para um automation compartilhado, o uso de AI credits é cobrado da organização que possui o repositório ou da assinatura Copilot do proprietário do repositório, se uma conta pessoal possuir o repositório. Para obter mais informações, consulte As licenças do GitHub Copilot e Cobrança do GitHub Actions.

GitHub Actions os minutos são cobrados separadamente ao proprietário do repositório.

Controlando custos com o recurso AI credits Limites

Você pode definir limites sobre quantos AI credits um automation pode consumir. Isso permite automatizar o trabalho recorrente, mantendo o controle sobre seu uso.

Você pode definir os seguintes limites opcionais em AI credits. Deixe um limite vazio se você não quiser defini-lo.

• Por execução: interrompe uma execução assim que atinge o limite. O mínimo é 30 AI credits.
• Diário: impede que novas execuções sejam iniciadas quando o limite for atingido. Reinicia todos os dias às 00:00 UTC.
• Semanalmente: impede que novas execuções sejam iniciadas depois que o limite for atingido. Reinicia todas as segundas-feiras às 00:00 UTC.
• Mensalmente: impede que novas execuções sejam iniciadas depois que o limite for atingido. É redefinido no primeiro dia de cada mês às 00:00 UTC.

Os limites diários, semanais e mensais não interrompem uma execução que já está em andamento. Para limitar o custo de cada execução individual, defina um limite por execução.

Você pode definir limites ao criar ou atualizar um automation. Consulte Criando automações com Copilot agente de nuvem.

Melhorias propostas

Automations podem propor melhorias para suas próprias ferramentas, gatilhos e prompts, e para as de outros automations.

Automations pode sugerir melhorias ao encontrar problemas durante o trabalho, como ferramentas ausentes.

Quando você cria automations com Copilot, Copilot pode ajudá-lo a criar automation groups autoaperfeiçoáveis nos quais alguns automations realizam o trabalho e outros avaliam os resultados, propondo continuamente melhorias.

Quando um/uma automation tiver uma melhoria proposta, você receberá uma notificação e verá a proposta ao exibir o automation.

Você verá uma descrição da melhoria proposta e das alterações a serem aplicadas ao automation group. Você pode decidir se deseja aplicar a melhoria proposta ou descartá-la.

Segurança e segurança

Automations executar Copilot sem que uma pessoa inicie cada tarefa, portanto apresentam alguns riscos adicionais. GitHub fornece proteções internas para ajudar a atenuar esses riscos.

• Atribuição.
  • As ações executadas em GitHub por um automation compartilhado são atribuídas a Copilot. Se o repositório exigir pelo menos uma aprovação de pull request, uma aprovação adicional será necessária por padrão para pull requests criadas por uma conta compartilhada automation. Os administradores podem desabilitar esse requisito extra em conjuntos de regras, mas não em regras de proteção de branch.
  • As ações executadas por um item pessoal automation são atribuídas ao usuário que criou o automation. Assim como acontece com as solicitações de pull que o usuário cria, ele não pode aprovar essas solicitações de pull, o que preserva os controles de revisão esperados.
• Ferramentas de privilégio mínimo. Você escolhe exatamente quais ferramentas um automation pode usar, para que você possa limitá-la apenas às ações necessárias pela tarefa.
• Entrada não confiável. Por padrão, automations ignore os eventos disparados pelos usuários sem acesso de gravação ao repositório, para reduzir o risco de injeção de prompt de usuários não confiáveis.
• Execuções de fluxo de trabalho. Por padrão, como acontece com todo o trabalho GitHub Actions, os Copilot cloud agent fluxos de trabalho não são executados em um pull request até que um usuário com acesso de escrita os aprove. Isso reduz o risco de que um pull request aberto por um automation acione fluxos de trabalho automaticamente.
• Execuções sem exibição. As Copilot cloud agent sessões iniciadas por qualquer automation, pessoal ou compartilhado, são visíveis para todos com acesso de leitura ao repositório. Qualquer pessoa que possa ver essas sessões pode ver o prompt, os logs de sessão e quaisquer solicitações de pull ou outras alterações que Copilot cria.

Para obter mais informações sobre como GitHub atenua os riscos de Copilot cloud agent, consulte Riscos e mitigações para GitHub Copilot agente de nuvem.

Leitura adicional

• Criando automações com Copilot agente de nuvem
• GitHub Copilot no GitHub.com e no GitHub Mobile
• Para saber como armazenar sua automação como código, examine-a por meio de solicitações de pull ou execute-a com um agente de codificação diferente, consulte Fluxos de trabalho agênticos do GitHub