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

# Agendar um serviço

> Como agendar a execução de um serviço, criar uma recorrência, usar uma expressão cron e ver, alterar ou encerrar o que está agendado.

Use este guia para marcar a execução de um serviço ou para deixá-lo rodando sozinho, numa recorrência. Você pode definir o agendamento durante o formulário ou reaproveitar uma execução concluída. O escopo segue o mesmo: muda só **quando** o serviço roda.

## Pré-requisitos

* Um serviço já preenchido no **Agent Work**, até o passo **Quando rodar**, ou uma execução concluída que você quer repetir. Veja [Executar um serviço](https://docs.ecotrust.io/ecotrust-os/executar-um-servico.md).

## Passos

**1. Reaproveitar uma execução concluída**

Na conversa que mostra uma execução concluída, peça para agendá-la e informe quando ela deve rodar, como "agende isso toda segunda às 09:00". O agente abre o formulário com o mesmo conector, alvos, portas e credencial salva da execução anterior.

**2. Abrir o agendamento**

No passo **Quando rodar**, clique em **Agendar**. O formulário de agendamento abre no fio da conversa.

![Passo Quando rodar, com o botão Agendar, e abaixo o formulário de agendamento: Quando executar, Com que frequência, Horário, Fuso horário, A partir de e Encerrar em.](https://mintcdn.com/eco-trust/dcX8rO5gA5iWRmYd/images/baseline/04-agendamento.png?fit=max\&auto=format\&n=dcX8rO5gA5iWRmYd\&q=85\&s=e1d67eec6b62fd4fc24a0853bacded34)

O passo de agendamento. A linha destacada abaixo dos campos resume a recorrência antes de confirmar.

**3. Preencher os campos**

Escolha quando executar, a frequência, o horário, o fuso e o período, pela tabela abaixo.

**4. Conferir o resumo e aprovar**

Abaixo dos campos, uma linha destacada resume em português o que foi montado, como *Todo dia às 03:00.*, e o plano repete esse resumo na linha **AGENDAMENTO**. Confira as duas frases e clique em **Aprovar**.

**Campos do agendamento**

| Campo | Opções | O que a escolha determina |
| - | - | - |
| **Quando executar**\* | Executar agora, uma vez · Agendar para uma data e hora · Agendar recorrência · Criar recorrência e rodar agora | Uma execução só, uma execução marcada, ou uma rotina que se repete. A última opção cria a rotina e já roda a primeira vez. |
| **Com que frequência**\* | Todos os dias · Toda semana, em dias escolhidos · Todo mês, num dia fixo · Todo mês, num dia da semana · Personalizado (expressão cron) | O ritmo da rotina. As quatro primeiras são guiadas; a última aceita uma expressão escrita à mão. |
| **Horário**\* | Hora e minuto. O formulário abre em 03:00 | A hora do disparo nas frequências guiadas. |
| **Fuso horário**\* | Brasília / São Paulo (GMT-3) · Fortaleza (GMT-3) · Manaus (GMT-4) · Rio Branco (GMT-5) · UTC | O fuso em que o horário acima é lido. |
| **A partir de**\* | Data. O formulário abre no dia de hoje | O primeiro dia em que a rotina passa a valer. |
| **Encerrar em** | Data, opcional | O último dia. Em branco, a rotina segue sem prazo para acabar. |

## Pedir um intervalo ao agente

Ao pedir uma recorrência no chat, você pode informar um intervalo fixo, como "a cada 10 minutos" ou "a cada 2 horas". O agente leva o intervalo direto para o plano, que mostra **a cada 10 minutos, começando agora**, sem pedir horário nem fuso.

Os intervalos aceitos são 5, 6, 10, 12, 15, 20 e 30 minutos, ou 1, 2, 3, 4, 6, 8 e 12 horas. Se você pedir outro intervalo, o agente explica as opções aceitas antes de iniciar o preenchimento. Quando uma frequência não puder ser usada, o formulário abre mostrando o motivo para você corrigir o pedido.

## Frequência personalizada

A opção **Personalizado (expressão cron)** troca a escolha guiada por um campo de expressão, para ritmos que as frequências prontas não cobrem. A expressão tem **seis campos**, nesta ordem: minuto, hora, dia do mês, mês, dia da semana e ano. Um dos dois campos de dia recebe `?`, indicando que quem manda é o outro.

Para repetições em intervalo regular, liste os valores no campo de minuto. A expressão é lida em **UTC**: para chegar a um horário de Brasília, some três horas ao escrever. 6h em Brasília é `9` no campo de hora.

| Expressão | Quando roda |
| - | - |
| `0 6 ? * SUN *` | Todo domingo, às 06:00 UTC, ou 03:00 em Brasília. É o exemplo que o próprio campo mostra. |
| `0,10,20,30,40,50 * * * ? *` | A cada dez minutos, o tempo todo. Útil para acompanhar de perto uma janela curta. |

## Verificar o resultado

O ícone de calendário, no cabeçalho da conversa do **Agent Work**, abre o painel **Agendamentos**. Cada cartão traz a frequência e o fuso, a próxima execução, quem criou e o desfecho da última execução. Ao abrir a ficha de um serviço, você vê somente os agendamentos dele. O selo **ativo** fica no canto superior direito, e **Recorrente** indica execução periódica.

![Painel Agendamentos com o cartão de um agendamento recorrente, a próxima execução, quem criou e os botões Pausar, Editar e Cancelar.](https://mintcdn.com/eco-trust/xoNZgdwqOSpkq4Ok/images/surface/28-agendamentos.png?fit=max\&auto=format\&n=xoNZgdwqOSpkq4Ok\&q=85\&s=a636cb657999e6e34662b0afce684447)

O selo ativo fica no canto superior direito do cartão. Recorrente indica execução periódica.

## Pausar, editar ou encerrar

* No painel **Agendamentos**, cada cartão tem **Pausar**, **Editar** e **Cancelar** no pé.
* Ao editar, confira a recorrência que o formulário mostra antes de salvar. Se outra pessoa a alterou desde que você abriu a edição, a tela avisa, atualiza a lista e mostra a recorrência atual para você revisar.
* Pelo chat, peça ao agente a lista dos agendamentos do painel: ele responde com a frequência, o fuso e o status de cada um. Para alterar quando uma rotina executa, informe a nova frequência, data, horário ou fuso. Para encerrar uma rotina, peça a remoção e responda à pergunta de confirmação que ele faz. A remoção é definitiva.
* Para deixar o fim marcado desde o início, use o campo **Encerrar em** na hora de criar.

## Próximos passos

* [Observabilidade](https://docs.ecotrust.io/ecotrust-os/observabilidade.md): o registro de cada execução agendada


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