> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tarefas agendadas

> Execute verificações recorrentes e retome uma conversa local depois.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

Agende uma verificação de testes ou peça ao agente que retome uma conversa local depois. Inclua no prompt o comando, o projeto e o que informar para que cada execução tenha o contexto necessário.

## Crie uma tarefa agendada

Use **Tarefas agendadas** para trabalhos únicos ou recorrentes, como executar os testes de um projeto toda manhã e resumir as falhas:

1. Abra **Tarefas agendadas** e crie uma tarefa.
2. Informe prompt, pasta do projeto, modelo e modo de permissão.
3. Escolha quando executar: uma vez, em um intervalo, a cada hora, diariamente ou semanalmente.
4. Confira **Próximas execuções**, incluindo o fuso horário, e salve. Use **Executar agora** para conferir o comportamento antes da primeira execução agendada.

Cada execução agendada independente inicia uma conversa separada. Inclua no prompt salvo o comando e o resultado esperado:

> Execute npm test. Informe os nomes dos testes que falharam e os erros relevantes. Não altere arquivos.

Escolha a pasta do projeto para executar o comando no repositório correto. Depois, abra **Histórico de execuções** e selecione a sessão para examinar a saída. Use o filtro **Problemas** para encontrar execuções que precisam de investigação. Se a tarefa mostrar **Precisa de atenção**, abra-a e responda à pergunta ou solicitação de aprovação. **Pausar** afeta os próximos inícios; **Parar** cancela uma execução ativa.

### Escolha frequência e limite

| Agendamento | Configuração | Exemplo |
| - | - | - |
| Uma vez | Data e hora. | Conferir um teste nesta tarde. |
| Intervalo | Início, intervalo em minutos e limite obrigatório. | Repetir a cada cinco minutos, três vezes. |
| A cada hora | Minuto dentro da hora. | Examinar um log no minuto 15. |
| Diário | Horário. | Executar testes toda manhã. |
| Semanal | Dia e horário. | Resumir mudanças na sexta-feira. |

Nas opções horária, diária e semanal, deixe **Limite de execuções** vazio para continuar sem limite. O horário segue o fuso do computador, salvo se escolher outro em **Avançado → Fuso horário**. Confira **Próximas execuções**, principalmente ao seguir o horário de outra região.

### Escreva um prompt independente

Cada execução independente começa uma conversa nova. Informe entrada, ação, saída e restrições:

> Execute npm test neste projeto. Informe o comando, se passou e cada teste que falhou com seu erro. Se faltarem dependências, informe o problema de preparação. Não instale pacotes nem altere arquivos.

Selecione a pasta real. Com **Sem projeto**, cada execução recebe uma pasta nova sem seu repositório. Use **Executar agora** para conferir prompt, ambiente e aprovações antes de depender do agendamento.

### Gerencie um agendamento

Clique no nome para editar. **Executar agora** inicia manualmente sem mudar o próximo horário nem consumir uma execução automática. **Pausar** impede novos inícios; **Parar** cancela a execução atual. Excluir impede execuções futuras, conserva sessões e histórico e não para uma execução ativa.

Abra **Histórico de execuções**, filtre pela tarefa e use **Problemas** para encontrar falhas ou solicitações pendentes. Leia a sessão associada para conferir a saída real. **Concluído** indica que as execuções automáticas acabaram; crie outro agendamento se precisar de mais.

<Frame caption="Uma revisão diária de testes com prompt explícito, projeto, modo de permissão e horário de execução.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/schedules.jpg" alt="Formulário de revisão diária de testes às 9 da manhã" width={2720} height={1660} x={1025} y={70} cropWidth={1110} cropHeight={1240} maxWidth="100%" />
</Frame>

## Agende um acompanhamento

Durante uma sessão local de **Código** no aplicativo desktop, você também pode pedir ao agente que retome o trabalho depois. Esses acompanhamentos não estão disponíveis na CLI, na extensão do VS Code ou nas sessões na nuvem. Eles retomam a conversa original com seu histórico e ambiente. Por exemplo:

> Daqui a dez minutos, execute npm test novamente e informe se os testes do checkout passaram. Não altere arquivos.

## Quando o trabalho agendado é executado

O trabalho agendado usa o modo de permissão salvo e pode pausar para pedir aprovação. O aplicativo desktop precisa estar em execução no horário previsto. Encerrar o aplicativo interrompe os agendamentos; reabri-lo não repete ocorrências perdidas. Fechar apenas a janela principal pode manter o aplicativo aberto quando há agendamentos ativados. O histórico mostra execuções ignoradas, falhas e solicitações que precisam da sua atenção.

### Entenda as execuções ignoradas

Execuções do mesmo agendamento ou projeto não se sobrepõem. Se a anterior estiver ativa, uma nova ocorrência pode ser ignorada. Ocorrências perdidas, com falha, canceladas ou ignoradas consomem o limite automático; tempo pausado não. Uma execução única perdida termina sem ser repetida ao reabrir o aplicativo.

Se precisar de aprovação, abra a sessão e responda. Mudar permissões para evitar perguntas deve ser uma escolha deliberada, não uma forma de ocultar um erro pendente no ambiente ou comando.

Continue com [Consumo e solução de problemas](/pt/docs/mka1-code/troubleshooting).