Criando automações com Copilot agente de nuvem

Introdução

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ê pode criar e gerenciar automations na guia Agentes de um repositório em GitHub.

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

• Automations guia na GitHub Copilot app
• A janela Agentes em VS Code
• A API REST

Para obter uma visão geral de automations, incluindo gatilhos, ferramentas, visibilidade e segurança, consulte Automações do 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.
• 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.

Habilitando a cloud automations em VS Code

Para usar a nuvem automations da VS Code, conclua os pré-requisitos do repositório acima e:

1. Atualize para VS Code 1.144 ou posterior.
2. No editor de Configurações, habilite chat.automations.cloud.enabled.
3. Abra a janela Agentes e selecione a Automations guia.

Para obter instruções de criação e gerenciamento, consulte Criar e gerenciar automações de agente na VS Code documentação.

Criando um automation

1. Em GitHub, acesse a página principal do repositório.
2. Abaixo do nome do repositório, clique em Agentes.
3. Na barra lateral, clique em Automations.
4. Clique em Criar automation.
5. Clique em Criar com o agente para trabalhar com Copilot para criar seu automations, ou Criar manualmente para configurar automations com um formulário.

Criando um automation com Copilot

Depois de clicar em Criar com o agente, uma janela de chat será exibida e Copilot perguntará o que você deseja automatizar.

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

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

Criando um automation manualmente

1. Insira um nome para o automation.

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

   • Pessoal: somente você pode ver o automation. AI credits são cobrados de 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 da organização ou do usuário que possui o repositório, e as ações realizadas em GitHub usam a identidade de Copilot.

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

3. Selecione um ou mais gatilhos que determinam quando a automation é executada. Opcionalmente, você pode configurar filtros para controlar quando os gatilhos são acionados.

   Para issues e gatilhos de pull request, você pode escolher:

   • Quais recursos GitHub podem ser atualizados durante a execução. Na lista suspensa As ferramentas configuradas podem alterar, escolha Qualquer item neste repositório para permitir que as GitHub ferramentas criem e atualizem qualquer recurso no repositório. Escolha Somente esta issue 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 pela configuração e credenciais de seus servidores. 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 disparar issoautomation: No menu suspenso Pode ser disparado, escolha Qualquer pessoa, exceto Copilot na nuvem, para ignorar os eventos disparados por Copilot, incluindo automations. Escolha Qualquer um 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 Ignorar eventos disparados por usuários sem acesso de gravação a este repositório para escutar esses eventos. Dependendo da configuração do seu repositório, a opção Ignorar eventos acionados por usuários sem acesso de gravação a este repositório pode estar bloqueada em um estado habilitado.

4. No campo prompt, descreva a tarefa que você deseja que Copilot execute sempre que automation for executado.

   Por exemplo, Label this issue as a bug, an enhancement, or other, based on its content.

5. Opcionalmente, selecione o modelo e o nível de raciocínio que deseja que Copilot use. Consulte Alterando o modelo de IA para GitHub Copilot agente de nuvem.

6. Selecione as ferramentasCopilot que pode usar quando automation for executado, como enviar alterações, atualizar rótulos de issues ou criar uma pull request.

   Você pode selecionar GitHub ferramentas e ferramentas de quaisquer servidores MCP configurados nas configurações de MCP do repositório. Para disponibilizar as ferramentas de um sistema externo, um administrador de repositório deve primeiro configurar o servidor MCP desse sistema externo para o repositório. Consulte Configurar servidores MCP para seu repositório.

   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 Automações do Copilot.

7. Opcionalmente, nos limites de crédito de IA, defina limites sobre quantos AI credits o automation pode consumir. Consulte os limites de configuraçãoAI credits.

8. Salve o automation clicando em Criar automação.

Definindo AI credits limites

Sempre que um automation é executado, ele consome AI credits, que são cobrados de você para uma conta pessoal automation ou do proprietário do repositório para um automation compartilhado. Para controlar os custos, você pode definir limites na seção limites de crédito de IA ao criar ou editar um automationitem.

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.

Testando um automation

Você pode executar um automation imediatamente, sem esperar que o gatilho seja acionado, para verificar se ele se comporta conforme o esperado.

1. Abra o teste automation que você deseja testar no Automations painel.

2. Clique no botão Executar.

3. Na lista suspensa Gatilho , escolha o gatilho que você deseja simular.

4. Se você escolheu o gatilho Manual , opcionalmente insira Contexto que será incluído no prompt do agente. Você pode usar isso para simular o acionamento de automation por meio da API.

   Se você escolheu outro gatilho, preencha a URL de Recurso com o recurso relevante, por exemplo, a URL do problema que foi aberto ou o comentário da solicitação de pull que foi criado.

5. Clique em Executar agora.

Copilot inicia uma sessão Copilot cloud agent e executa o prompt do automation 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 dados pessoais automations são privados para você. Os itens compartilhados automations são visíveis para todos com acesso de leitura ao repositório, e qualquer pessoa com acesso de gravação pode editá-los.

As sessões iniciadas a partir de qualquer automation são visíveis para todos com acesso de leitura ao repositório.

No painel Automations de um repositório, você pode:

• Ver o automations pessoal e o automations compartilhado do repositório, as sessões iniciadas e as AI credits consumidas.
• Edite um automation para alterar seu nome, prompt, gatilhos, ferramentas, modelo, esforço de raciocínio ou AI credits limites e acompanhe o automation histórico de revisão.
• Analise as melhorias propostas nas ferramentas, nos gatilhos ou no prompt de um automation, propostas pelo próprio automation ou por outro automations.
• Desative um automation para interromper sua execução ou ative-o novamente mais tarde.
• Exclua um automation 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.

Leitura adicional

• Automações do Copilot
• Iniciando sessões do GitHub Copilot
• Riscos e mitigações para GitHub Copilot agente de nuvem