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

# Tarefas agendadas

> Faça o agente executar automaticamente no servidor na nuvem conforme um agendamento, ou continuar trabalhando em uma sessão em um horário definido.

Uma **tarefa agendada** é uma instrução que pertence a um projeto. Quando chega a hora, o agente a executa automaticamente no servidor na nuvem nesse projeto, e cada execução cria uma sessão. As tarefas agendadas continuam em execução quando o cliente ou a página web está fechado ou quando o seu computador está desligado. Executar tarefas agendadas requer o [Plus](https://docs.aihubmix.com/pt/cloud/account/plus.md).

## Criar uma tarefa agendada

**1. Abrir as tarefas agendadas**

No aplicativo para desktop, clique em **Scheduled** na barra de ícones à esquerda. No aplicativo web, clique em **Scheduled** na parte inferior da barra lateral. Depois clique em **New task**.

**2. Escrever o que deve ser feito**

Escreva uma instrução clara na caixa de texto, por exemplo "Verifique se há atualizações de dependências e resuma os pacotes que podem ser atualizados com segurança." As instruções podem ter até 16 KiB.

**3. Escolher um projeto**

O padrão é o projeto que você usou mais recentemente. Se você ainda não tiver projetos, crie um primeiro. Consulte [Projetos e configuração do ambiente](https://docs.aihubmix.com/pt/cloud/environments/projects.md).

**4. Definir a repetição e o horário**

Escolha **Once** (dentro de 7 dias a partir de hoje), **Daily**, **Weekdays** (de segunda a sexta), **Weekly** ou **Fixed interval** (15 minutos, 20 minutos, 30 minutos ou 1 hora). Os horários são em intervalos de meia hora, no seu horário local.

**5. (Opcional) Ajustar as configurações avançadas**

Expanda **Advanced** para definir:

* **Notifications**: notificar na conclusão e na falha, notificar apenas na falha (padrão) ou desativado.
* **New chat for each run**: ativado por padrão. Quando desativado, todas as execuções continuam na mesma sessão.
* **Harness, model, and reasoning effort**: por padrão, seguem as escolhas da sua última nova sessão.

**6. Criar**

Clique em **Create**. O app mostra o horário da próxima execução.

> [!NOTE]
>
> Sem o Plus, você pode navegar pelas tarefas agendadas. Clicar em **New task** primeiro leva você a assinar e depois retorna automaticamente à página de criação.

![Lista de tarefas agendadas](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/scheduled.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=d8a41dbe4a8d9c78c2f29010a1e76b6d)

Tarefas agendadas: agrupadas à esquerda em próximas e pausadas

Você também pode dizer o que precisa diretamente em qualquer sessão, por exemplo "Verifique se há atualizações de dependências todo dia útil às 9h." O agente cria o rascunho de uma tarefa agendada e pede sua confirmação na sessão: clique em **Create** para que ela entre em vigor, em **Edit** para alterá-la antes ou em **Not now** para descartá-la. Um rascunho expira se ficar parado por algum tempo.

## Ver os resultados das execuções

A lista de tarefas agendadas é agrupada em Upcoming, Paused e Ended. Cada linha mostra o horário da próxima execução e o agendamento. Clique em uma linha para abrir os detalhes, incluindo o agendamento, o projeto, o modelo, a instrução e o histórico de execuções.

* **Runs**: uma linha por execução, mostrando o horário e o resultado (em andamento, concluída, com falha, ignorada ou interrompida). Execuções com falha e ignoradas mostram o motivo. Clique em uma execução para abrir a sessão dela.
* **Run now**: executa uma vez imediatamente.
* **Pause** / **Resume**: quando pausada, a tarefa deixa de ser executada conforme o agendamento.
* **Edit** (ícone de lápis): os campos são os mesmos da criação. Você pode mover a tarefa para outro dos seus projetos. Tarefas criadas a partir de uma sessão não podem mudar de projeto.
* **Delete** (ícone de lixeira): depois que você confirma, a tarefa agendada e o histórico de execuções são excluídos. As sessões já criadas são mantidas.

Cada execução consome uso de modelos (modelos Plus, ou a assinatura ou API key que você escolheu).

## Regras de execução

* **Executa com acesso total**: as tarefas agendadas não têm configuração de permissões e sempre são executadas no servidor na nuvem com acesso total. Para entender o que significam as permissões, consulte [Iniciar uma sessão](https://docs.aihubmix.com/pt/cloud/sessions/start-a-session.md).
* **Sem execução imediata enquanto a anterior estiver em andamento**: enquanto a execução anterior não terminar, **Run now** fica indisponível, e a execução agendada que vencer é ignorada.
* **Até 1 hora por execução**: execuções que ultrapassam esse tempo são registradas como expiradas.
* **Pausa automática após 3 falhas consecutivas**: uma única falha registra o motivo e notifica você de acordo com as suas configurações de notificação, e a próxima execução acontece normalmente. Após 3 falhas seguidas, a tarefa é pausada automaticamente e você é notificado. Verifique o motivo no histórico de execuções, corrija o problema e clique em **Resume**.
* **Requer o Plus e um servidor na nuvem em execução**: sem um plano Plus ativo, não é possível executar imediatamente nem retomar. Quando o servidor na nuvem não está em execução, não é possível executar imediatamente.
* Tarefas únicas passam para Ended depois de executadas.

## Fazer o agente continuar em uma sessão conforme um agendamento

Um **temporizador de sessão** está vinculado a uma sessão. Quando chega a hora, ele envia uma mensagem de disparo nessa sessão, e o agente continua trabalhando ali. É indicado para tarefas que precisam do contexto da sessão atual, como "Verifique a implantação de novo em 30 minutos" ou "Verifique a fila a cada hora." Para trabalhos de longo prazo executados de forma independente em um projeto conforme um agendamento, use uma tarefa agendada.

* **O agente pode criá-los diretamente**: o agente pode criar, alterar e excluir temporizadores de sessão na sessão atual sem a sua confirmação. Cada alteração deixa uma linha no histórico da sessão.
* **Gerencie-os você mesmo**: quando uma sessão tem um temporizador, um ícone de temporizador aparece ao lado do título na barra superior. Se não tiver, escolha **Session timers** no menu **…** da barra superior. Ali você pode executar um temporizador imediatamente, desativá-lo, ativá-lo, renová-lo ou excluí-lo. Você também pode clicar em **New timer** e escolher "In N minutes" (até 7 dias) ou um agendamento recorrente (uma expressão cron, com intervalo mínimo de 5 minutos).
* **Quando a sessão está ocupada**: dependendo da configuração do temporizador, essa execução é ignorada ou colocada na fila.
* **Expira após 7 dias**: um temporizador de sessão recorrente é válido por 7 dias após a criação. Você recebe um lembrete antes que ele expire. Clique em **Renew** para estendê-lo por mais 7 dias. Temporizadores expirados são desativados e precisam ser renovados antes de serem ativados novamente.

Parar uma sessão interrompe apenas a tarefa atual do agente. Os temporizadores de sessão continuam ativos. Os temporizadores de sessão também aparecem na lista de tarefas agendadas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.