Skip to main content
Skip to content

Agendamento de prompts em GitHub Copilot CLI

Use os comandos de barra /every e /after para enviar um prompt para Copilot em uma programação recorrente ou após um atraso especificado.

Observação

Os comandos /every e /after atualmente são recursos experimentais e só estão disponíveis se você tiver usado o comando slash /experimental on ou a opção de linha de comando ‑‑experimental.

Em uma sessão interativa Copilot CLI , você pode agendar um prompt para ser enviado automaticamente. Isso é útil quando você deseja Copilot repetir uma tarefa em uma cadência regular ou executar uma tarefa única após um atraso, sem precisar se lembrar de enviar o prompt manualmente.

Há dois comandos de barra para isso:

  • /every — agende um prompt a ser enviado repetidamente em um intervalo fixo.
  • /after — agende um prompt a ser enviado uma vez, após um período de tempo especificado.

Ambos os comandos só estão disponíveis dentro de uma sessão interativa Copilot CLI : os agendamentos são acionados somente enquanto a sessão na qual eles foram criados está em execução. Para obter maneiras de executar Copilot CLI em um agendamento quando nenhuma sessão estiver aberta, consulte Executar um prompt de um agendador externo no final deste artigo.

Agendando um prompt recorrente com /every

Em uma sessão interativa de Copilot CLI, digite /every seguido de um intervalo de tempo e do prompt que você deseja enviar.

/every INTERVAL PROMPT

O prompt será enviado após o intervalo especificado ter decorrido e, em seguida, novamente na mesma cadência até que você exclua a entrada de agendamento ou encerre a sessão interativa da CLI.

Exemplos

/every 1h run the test suite and summarize any new failures
/every 30m check for new comments on my open pull requests

Observação

/loop é um alias de /every. Portanto, você pode inserir /loop em vez de /every, se preferir, e o efeito é o mesmo.

Agendando um prompt para ser executado uma única vez com /after

Digite /after seguido de um intervalo e do prompt que você deseja enviar:

/after DELAY PROMPT

O prompt é executado uma única vez, após o término do intervalo, e então é removido da lista de agendamentos.

Exemplos

/after 30m Give me details of changes to README.md made in the last 30 minutes
/after 10m Check that the address finder is visible on example.com/register

Agendando uma habilidade

Você pode usar /every e /after para agendar uma habilidade. Para fazer isso, você pode referenciar a habilidade explicitamente usando seu comando de barra ou usar linguagem natural para informar Copilot para executar a habilidade.

Observação

Somente habilidades invocadas pelo usuário e um subconjunto de comandos de barra internos podem ser agendados. Os comandos que iniciam um trabalho autocontido, como /plan, /review, /research ou /security-review, são passíveis de agendamento. Comandos que alteram sua sessão ou configuração (por exemplo, /model, /clear, /compact, /permissionsou /sandbox), que exibem apenas informações (como /usage ou /context), ou que gerenciam o agendamento em si (/every e /after) não podem ser agendados e Copilot as rejeitam quando você tenta.

Exemplos

/after 2h Use the docx skill to create a new file summarizing recent changes to this repo
/every 1d /refactor-plan Adjust the architecture of this project to improve the responsiveness of the client UI

Sintaxe de intervalo e atraso

SufixoUnidadeExemplo
sSegundos30s
mminutes5m
hhours2h
ddias1d

Quando você especificar uma duração numérica, inclua sempre o sufixo. Um número nu, por exemplo, /every 30 remind me to check for Slack messagesnão é reconhecido como um intervalo.

Para um intervalo fixo, o mínimo é de 10 segundos e o máximo é de 1 dia (24 horas).

Você também pode descrever o tempo em linguagem simples em vez de usar uma duração, por exemplo, /after at 3pm push the releaseou /every day at 9am post the standup. Copilot usa um modelo para interpretar a frase e, em seguida, cria o agendamento a partir dela.

Identificando prompts agendados na sessão

Quando um prompt agendado é acionado, Copilot adiciona ao prompt um texto como [Scheduled prompt #4] para distingui-lo de um prompt que você mesmo digitou.

Você pode usar a ID para cancelar a agenda. Por exemplo, inserindo stop prompt 4.

Gerenciamento de prompts agendados

Para listar os agendamentos ativos da sessão atual, digite /every ou /after sem argumentos.

Para excluir um agendamento, use as teclas de direção no teclado para percorrer a lista e selecionar a agenda que você deseja excluir e pressione x.

Pressione Esc para sair da lista de agendamentos.

O que acontece quando você fecha e reabre uma sessão

Os prompts agendados têm como escopo a sessão em que foram criados e são disparados apenas enquanto a sessão está em execução.

Ao reabrir a sessão (usando as opções de linha de comando --continue ou --resume), os agendamentos são restaurados. Para um agendamento recorrente criado com um intervalo fixo, a espera antes da próxima execução é medida a partir do momento em que você reabre a sessão.

Um /after agendamento que não havia sido acionado antes de você fechar a sessão mantém seu horário original programado, em vez de reiniciar o atraso. Se esse tempo tiver passado enquanto a sessão estava fechada, o prompt será enviado assim que você reabrir a sessão.

Executando um prompt de um agendador externo

Os /every comandos e os /after comandos são executados somente enquanto uma sessão interativa Copilot CLI está aberta. Se você quiser executar um prompt em um agendamento mesmo quando nenhuma sessão estiver ativa, poderá executar Copilot CLI de um agendador externo, como cron no macOS ou Linux, ou Task Scheduler no Windows.

Para executar Copilot CLI programaticamente, use a sintaxe copilot -p "YOUR PROMPT". A CLI processa seu prompt sem exibir a interface interativa e, em seguida, sai.

Isso é útil para tarefas como:

  • Manutenção noturna – por exemplo, executando seu conjunto de testes em relação às alterações mais recentes em uma ramificação todas as noites e publicar um resumo para um problema de acompanhamento.
  • Verificações periódicas de dependência – por exemplo, abrir uma solicitação de pull semanal que atualiza as dependências e executa o conjunto de testes em relação ao resultado.
  • Relatórios agendados — por exemplo, gerando um resumo diário de novos problemas ou solicitações de pull atribuídas a você e enviando emails ou postando-os em um canal de chat.

Para obter mais informações, consulte Executando GitHub Copilot CLI programaticamente.

Leitura adicional