Usando automações no GitHub aplicativo Copilot

Sobre o automations

Automations permite salvar tarefas de agente recorrentes e executá-las em um agendamento ou sob demanda. Por exemplo, você pode criar uma automation que faça a triagem de novos problemas diariamente ou verifique o status de revisão das suas solicitações de pull abertas todas as manhãs.

Você também pode configurar tarefas recorrentes em um projeto para dar suporte a uma meta contínua. Consulte Trabalhando com projetos no GitHub aplicativo Copilot.

Você pode criar e gerenciar automations a partir de:

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

Para obter uma visão geral de automations, incluindo gatilhos, ferramentas, visibilidade e segurança, consulte Automações do Copilot.

O GitHub Copilot app suporta dois tipos de automations:

• Local automations, que é executado em seu ambiente local.
• Nuvem automations, que é executada em um ambiente de nuvem.

Abra Automações na barra lateral para ver o seu automations salvo. Cada automation um mostra seu nome, agendamento, repositório associado e status de última execução.

Pré-requisitos para usar a nuvem automations

Para usar a nuvem automations, verifique se as configurações a seguir estão habilitadas.

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

Criar uma automation

As sessões de nuvem automation, incluindo prompts e logs de sessão, são visíveis para todos com acesso de leitura ao repositório, mesmo para automations pessoais. Não inclua segredos ou outras informações confidenciais em seus prompts.

1. Na barra lateral, clique em Automações.
2. Clique em Criar automação no canto superior direito.

Criando uma nuvem automation com Copilot

Você pode trabalhar com Copilot para projetar sua nuvem automation, configurando os gatilhos, as ferramentas e o prompt.

Copilot pode até mesmo ajudá-lo a criar grupos autoaperfeiçoáveis de automations que aprendem com os resultados e sugerem melhorias para si mesmos.

1. Na lista suspensa abaixo da caixa de prompt, escolha o repositório no qual você deseja criar seu automation.

2. Na caixa de prompt, descreva o que você quer automatizar em seu repositório com a ajuda de Copilot.

3. Em Tipo, escolha o tipo de automation que você deseja criar:

   • Pessoal: somente você pode ver o automation. AI credits são cobrados a você, e as ações executadas em GitHub usam sua identidade.
   • Compartilhado: Todos com acesso ao repositório podem ver o automation. AI credits são cobrados para a organização ou o usuário que possui o repositório, e as ações executadas em GitHub usam a identidade de Copilot.

   Você não pode alterar o tipo depois de criar o automation. Consulte Automações do Copilot.

4. Clique em Iniciar sessão.

Copilot fará perguntas e ajudará a configurar seu automation.

Criando um automation manualmente

1. Clique em Criar manualmente.

2. Insira um nome para o automation.

3. Opcionalmente, habilite Executar na nuvem para permitir a automation execução em um ambiente de nuvem, permitindo que ele automation seja executado mesmo quando o computador estiver desativado. Os gatilhos disponíveis serão diferentes de acordo com a execução local ou na nuvem.

4. Selecione um Trigger na lista suspensa. Selecionar um gatilho revelará campos adicionais para você preencher.

   Para automations acionados por issues ou pull requests e em execução na nuvem, você pode escolher:

   • Quais recursos GitHub podem ser atualizados durante a execução. Na lista suspensa Quando disparado, essa automação pode alterar, escolha Qualquer coisa neste repositório para permitir que as ferramentas GitHub criem e atualizem qualquer recurso no repositório. Escolha Somente a issue que disparou a execução para limitar as gravações dessas ferramentas à issue ou pull request que disparou a execução e a quaisquer recursos criados durante a execução. Essa configuração não limita as ferramentas de servidores MCP, que podem acessar recursos permitidos por suas configurações e credenciais de servidor. Dependendo da configuração do repositório, a opção Anything in this repository pode não estar disponível.
   • Se a atividade de Copilot na nuvem pode acionar isso automation: No menu suspenso Pode ser acionado por, escolha somente as pessoas para ignorar os eventos acionados por Copilot, incluindo automations. Escolha People and Copilot para escutar todos os eventos, incluindo eventos disparados por Copilot.
   • Se os usuários com acesso de leitura somente ao repositório podem disparar isso automation: por padrão, ignore a automations atividade de usuários que não têm acesso de gravação ao repositório. Desmarque a caixa Exigir acesso de gravação ao trigger para escutar esses eventos. Dependendo da configuração do repositório, a opção Exigir acesso de gravação para acionar pode estar bloqueada em um estado habilitado.

   Para configurar mais de um gatilho, clique em Adicionar outro gatilho. O automation é executado quando qualquer um dos seus gatilhos é acionado.

5. Para uma nuvem automation, em Tipo, escolha a quem automation pertence:

   • Pessoal: somente você pode ver o automation. AI credits são cobrados a você, e as ações realizadas em GitHub usam sua identidade.
   • Compartilhado: Todos com acesso ao repositório podem ver o automation. AI credits são cobrados da organização ou do usuário que possui o repositório, e as ações executadas em GitHub usam a identidade de Copilot.

   Você não pode alterar o tipo depois de criar o automation. Consulte Automações do Copilot.

6. Para uma nuvem automation, use a lista suspensa Ferramentas para selecionar as ferramentas que podem ser usadas Copilot , como enviar alterações por push, atualizar rótulos de problemas ou criar uma solicitação de pull. Você também pode selecionar ferramentas dos servidores MCP configurados nas configurações de MCP do repositório. Um administrador de repositório deve configurar esses servidores primeiro. Consulte Configurar servidores MCP para seu repositório. Selecione apenas as ferramentas necessárias para a tarefa.

7. No campo de prompt, descreva a tarefa que você deseja que Copilot execute sempre que automation for executado. Você pode digitar / para usar uma habilidade disponível.

8. Opcionalmente, para uma implantação na nuvem automation, expanda os limites de crédito de IA diretamente abaixo da caixa de prompt para definir limites de quantos AI credits o automation pode consumir. Consulte como definir AI credits limites para a nuvem automations.

9. Use os controles abaixo da caixa do prompt para selecionar o modelo, o esforço de raciocínio e o agente para o automation.

10. Escolha o repositório ou a pasta local em que automation será executado.

11. Clique em Criar para salvar o automation. Para salvá-lo e testá-lo imediatamente, abra o menu suspenso ao lado de Criar e clique em Criar e executar.

Definindo AI credits limites para Cloud automations

Para controlar os custos, você pode limitar quantos AI credits um recurso de nuvem automation pode consumir. Os limites não estão disponíveis para a configuração local automations.

Ao criar ou editar uma nuvem automation, expanda a seção limites de crédito da IA diretamente abaixo da caixa de prompt. Quando a seção é recolhida, ela mostra se os limites estão definidos.

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.

Para remover um limite, edite o automation e limpe o valor.

Executar uma automation sob demanda

Você pode acionar manualmente qualquer automation salva clicando no botão de reprodução em seu cartão na página "Automações", sem precisar esperar pela próxima execução agendada.

Você também pode abrir automations 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.