Introdução
Com automations, você pode configurar agente de nuvem Copilot para ser executado automaticamente, em um agendamento ou em resposta a um evento em um repositório. 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ê pode criar e gerenciar automations na guia Agentes de um repositório em GitHub. Você também pode criar e gerenciar automations na guia Automations do aplicativo GitHub Copilot.
Para obter uma visão geral de automations, incluindo gatilhos, ferramentas, visibilidade e segurança, consulte Sobre automações de Copilot.
Pré-requisitos
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.
- agente de nuvem Copilot deve ser habilitado para o repositório. Se você tiver Copilot Business ou Copilot Enterprise, um administrador deverá habilitar a agente de nuvem Copilot política. Consulte Gerenciando o acesso ao agente de nuvem GitHub Copilot.
- A organização deve permitir tanto agente de nuvem Copilotautomations no repositório (ambos estão habilitados por padrão). Consulte Adicionando GitHub Copilot agente de nuvem à sua organização.
Automations estão disponíveis nos planos Copilot Pro do GitHub, GitHub Copilot Pro+, GitHub Copilot Max, GitHub Copilot Business e GitHub Copilot Enterprise.
Criando um Automação
-
Em GitHub, acesse a página principal do repositório.
-
Abaixo do nome do repositório, clique em Agentes.
-
Na barra lateral, clique em Automations.
-
Clique em Criar novo.
-
Insira um nome para o Automação.
-
Selecione um ou mais gatilhos que determinam quando o Automação é executado:
- Em uma programação: escolha um intervalo recorrente: de hora em hora, diariamente ou semanalmente.
- Quando um problema é criado: o Automação é executado cada vez que um problema é aberto no repositório.
- Quando um pull request é aberto: o Automação é executado sempre que um pull request é aberto no repositório.
- Quando um pull request é sincronizado: o Automação é executado sempre que novos commits são enviados para um pull request no repositório.
Opcionalmente, você pode configurar filtros para problemas e gatilhos de solicitação de pull:
- 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.
-
No campo prompt, descreva a tarefa que você deseja que Copilot execute sempre que Automação for executado.
Por exemplo,
Label this issue as a bug, an enhancement, or other, based on its content.Aviso
As agente de nuvem Copilot sessões iniciadas por um Automação são visíveis para outras pessoas com acesso ao repositório. Não inclua segredos ou outras informações confidenciais em seu prompt. Para dar Copilot acesso a valores confidenciais, use segredos do repositório. Consulte Configurar segredos e variáveis para Copilot agente de nuvem.
-
Opcionalmente, selecione o modelo que você deseja Copilot usar. Consulte Alterando o modelo de IA para GitHub Copilot agente de nuvem.
-
Selecione as ferramentasCopilot que pode usar quando Automação for executado, como enviar alterações, atualizar rótulos de issues ou criar uma pull request.
Selecione apenas as ferramentas necessárias para a tarefa. As ferramentas selecionadas controlam quais ações Copilot podem ser executadas em seu repositório. Opcionalmente, você pode usar o botão Sugerir ferramentas para pedir Copilot para sugerir ferramentas com base em seu prompt. Consulte Sobre automações de Copilot.
-
Salve o Automação clicando em Criar automação.
Testando um Automação
Você pode executar um Automação imediatamente, sem esperar que o gatilho seja acionado, para verificar se ele se comporta conforme o esperado.
- Abra o teste Automação que você deseja testar no Automations painel.
- Clique no botão Executar agora .
Copilot inicia uma sessão agente de nuvem Copilot e executa o prompt do Automação com as ferramentas que você selecionou. Você pode abrir a sessão para acompanhar seu progresso e examinar as alterações feitas por ela.
Gerenciando seu Automations
Seus automations são privados para você, mas as sessões iniciadas pelas suas automações ficarão visíveis para qualquer pessoa com acesso de leitura ao repositório.
No painel Automations de um repositório, você pode:
- Exiba seu automations repositório e as sessões que eles iniciaram.
- Edite um Automação para alterar seu nome, prompt, gatilhos, ferramentas ou modelo.
- Desative um Automação para interromper sua execução ou ative-o novamente mais tarde.
- Exclua um Automação que você não precisa mais.
Para ver todos os seus automations em todos os repositórios e acessar o gerenciamento de cada um, use a visualização Automations no nível do usuário.