# Tarefas agendadas

> Agende um prompt para executar diariamente, semanalmente, mensalmente ou uma única vez, e leia o resultado após cada execução.

Source: https://endless.app/pt/docs/automate/scheduled-tasks

**Agendados*&#x2A; é onde os prompts rodam sem você. A página se descreve com clareza —
&#x2A;"Prompts que rodam automaticamente em uma agenda — cada execução começa um chat novo com o
resultado."* — e essa última parte é o modelo inteiro: um agendamento não é uma tarefa em
segundo plano com uma saída misteriosa, é uma conversa que começa sozinha.

<img alt="A página Agendados: uma aba Agendamentos ao lado de uma aba Atividade e, abaixo, uma lista de agendamentos — &#x22;Conceito de teaser diário&#x22;, &#x22;Radar de tendências matinal&#x22;, &#x22;Resumo semanal de conteúdo&#x22; e um &#x22;Relatório mensal de uso&#x22; pausado — cada linha mostrando a cadência, o horário e o modelo, quando roda em seguida e um interruptor para pausá-lo" src="__img0" />

<Callout type="info">
  Tarefas agendadas é uma das áreas que um espaço de trabalho pode desligar.
  Onde está desligada, **Agendados** não aparece na barra lateral e a URL leva
  você de volta para o início. Quem gerencia a disponibilidade de recursos do
  espaço de trabalho pode ligá-la de novo.
</Callout>

## Como criar um

Você precisa de permissão para criar conteúdo, que membros e admins têm por padrão e
visualizadores não. Há três portas de entrada.

<Cards>
  <Card icon="<CalendarClock />" title="Novo agendamento">
    O botão no cabeçalho de **Agendados**. Abre um novo chat em que o Endless
    pergunta o que ele deve fazer e quando — veja abaixo.
  </Card>

  <Card icon="<Repeat />" title="Um modelo inicial">
    Uma página vazia oferece quatro: &#x2A;*"Resumo diário"*&#x2A; — &#x2A;"Um resumo pela
    manhã, todo dia útil"&#x2A;, &#x2A;*"Relatório semanal"*&#x2A; — &#x2A;"Uma retrospectiva toda
    segunda-feira"&#x2A;, &#x2A;*"Resumo mensal"*&#x2A; — &#x2A;"Um fechamento no dia 1º"&#x2A; e
    &#x2A;*"Começar do zero"**. Os três primeiros abrem esse mesmo chat com as
    instruções e a cadência já sugeridas.
  </Card>

  <Card icon="<ChatBot />" title="A partir de uma mensagem que você já enviou" href="/pt/docs/chat">
    Em um chat, o menu de uma das suas próprias mensagens traz &#x2A;*"Criar
    agendamento"*&#x2A; — &#x2A;"Rode este prompt em uma agenda recorrente"*. Ele abre o
    mesmo formulário com aquela mensagem como instruções.
  </Card>
</Cards>

### Em uma conversa

Um agendamento é criado conversando. O Endless explica em poucas linhas como os agendamentos
funcionam e depois pergunta o que ainda não sabe — o que ele deve fazer, com que frequência e a
que horas, e quem recebe o resultado: só nesta página, por e-mail para você, ou para você e
outras pessoas (membros do seu espaço de trabalho pelo nome, ou qualquer endereço externo que
você digitar) — uma pergunta por vez, com opções para escolher ou uma resposta que você digita.
Nem precisa do botão: em qualquer chat, &#x2A;"me mande isto toda segunda às 9"* começa a mesma
coisa.

Nada é salvo até você dizer. Quando tem o suficiente, o Endless mostra um cartão com o título
&#x2A;*"Criar este agendamento?"** com tudo o que está prestes a salvar: o **Nome**, quando ele
**Executa** (e em qual fuso horário), o **Prompt** completo que ele escreveu para as execuções,
o **Acesso geral*&#x2A; e quem recebe o resultado por e-mail. Leia o prompt — cada execução parte só
dele, sem memória desta conversa. Depois, &#x2A;*"Criar agendamento"*&#x2A;, ou &#x2A;*"Descartar"** e diga o
que mudar.

Depois de criado, o agendamento aparece como um cartão no chat que abre a página dele. Ali,
quem pode editá-lo encontra &#x2A;*"Pausar"*&#x2A;, &#x2A;*"Editar"*&#x2A; e &#x2A;*"Testar"*&#x2A; ao lado do nome, e o menu
da página acrescenta &#x2A;*"Compartilhar"*&#x2A; e &#x2A;*"Excluir"**. Volte ao chat mais tarde e o cartão
continua lá para reabri-lo.

Você também pode pedir mudanças com palavras — &#x2A;"mude para 8:30"&#x2A;, &#x2A;"pause"&#x2A;, &#x2A;"mande para mim
por e-mail também"&#x2A;. Cada uma mostra um cartão &#x2A;*"Salvar as alterações em …?"** listando só o
que mudaria, e espera por você do mesmo jeito.

### O formulário

O formulário abre a partir de &#x2A;*"Criar agendamento"*&#x2A; em uma mensagem e de &#x2A;*"Editar"**. Tem
três etapas — **Prompt**, **Entrega** e
**Revisão** — e você não consegue avançar deixando um campo obrigatório vazio; ele mostra o que
está faltando em vez de recusar em silêncio.

<Steps>
  <Step>
    ### Prompt

    Um **Nome*&#x2A; (o exemplo mostrado é &#x2A;"ex.: Resumo semanal de analytics"*) e as **Instruções*&#x2A; —
    &#x2A;"O que deve rodar nesta agenda?"*

    A caixa de instruções é o compositor do chat, então tudo que você faz em uma mensagem de chat
    dá para fazer aqui: `@` para trazer um projeto, `/` para chamar uma skill pelo nome. O
    que você não pode fazer é anexar um arquivo — um agendamento não tem anexos, só texto.

    Mais dois controles ficam abaixo da caixa: o **modelo** em que este agendamento roda e
    **Ferramentas**.
  </Step>

  <Step>
    ### Entrega

    **Repete** — **Diariamente**, **Dias úteis**, **Semanalmente**, **Mensalmente** ou **Uma
    vez** — mais os seletores de dia que cada opção precisa, e **Às**, o horário do dia.

    Depois, **Acesso*&#x2A; — &#x2A;"Quem pode abrir este agendamento e o que pode fazer."&#x2A; — e um
    interruptor &#x2A;*"Envio por e-mail"**.
  </Step>

  <Step>
    ### Revisão

    Uma releitura de tudo e uma prévia ao vivo com o título &#x2A;*"Próximas 3 execuções"**, junto do
    fuso horário em que esses horários estão. Este é o momento de conferir se "Mensalmente no dia
    31" significa o que você acha que significa.
  </Step>
</Steps>

<Callout type="info">
  Instruções longas não são problema. O limite fica em torno de trinta e dois
  mil caracteres — algumas páginas de regras, fontes e formato de saída — e um
  contador só aparece quando você chega perto dele. Se passar, o formulário diz
  por quanto passou, para você cortar em vez de adivinhar. Se um salvamento for
  recusado por outro motivo, a mensagem nomeia o campo com problema.
</Callout>

## Como funcionam a cadência e o fuso horário

O horário que você digita é lido no **fuso horário do seu navegador no momento em que você
cria o agendamento*&#x2A;, e a etapa de revisão diz esse fuso em voz alta (&#x2A;*"Horário de Buenos
Aires"**, por exemplo) para não haver ambiguidade. Daí em diante o agendamento continua
disparando naquele horário de relógio, naquele fuso — ele não acompanha você se você viajar.

<Cards>
  <Card icon="<Repeat />" title="Semanalmente pode significar vários dias">
    "Toda segunda e sexta" é um agendamento, não dois — escolha quantos dias da
    semana quiser. Você não consegue desmarcar o último.
  </Card>

  <Card icon="<Clock />" title="Mensalmente se ajusta a meses curtos">
    O dia 31 dispara no dia 30, e no dia 28 ou 29 em fevereiro. Ele nunca pula
    um mês.
  </Card>

  <Card icon="<CalendarClock />" title="Uma vez precisa de uma data futura">
    Escolha uma data que já passou e o formulário avisa: &#x2A;"Essa data já passou —
    escolha uma data futura."* Depois de disparar, ele para.
  </Card>
</Cards>

<Callout type="warn" icon="<Clock />">
  Os agendamentos vencidos são recolhidos em varreduras separadas por alguns
  minutos, então uma execução das 09:00 começa **às 09:00 ou pouco depois** —
  não no segundo exato. Não construa nada que dependa de precisão de minuto.
</Callout>

## O que uma execução agendada pode fazer

Uma execução é um turno de chat de verdade, com as mesmas capacidades e os mesmos limites.

<Cards>
  <Card icon="<Book />" title="Skills" href="/pt/docs/automate/skills">
    Toda skill ligada para você está ligada para os seus agendamentos. O
    controle **Ferramentas*&#x2A; da etapa Prompt deixa você desligar skills
    específicas só neste agendamento — o resumo mostra &#x2A;*"Todas as
    ferramentas"** até você fazer isso.
  </Card>

  <Card icon="<Plug />" title="Conectores" href="/pt/docs/automate/connectors">
    Só os conectores que você realmente **conectou** são oferecidos. Um que está
    habilitado mas sem login não resultaria em nada na hora da execução, então
    não é listado.
  </Card>

  <Card icon="<Folder />" title="Projetos" href="/pt/docs/concepts/projects">
    Mencione um projeto com `@` nas instruções e toda execução carrega o
    conhecimento e as skills dele, exatamente como um chat faria.
  </Card>

  <Card icon="<Photo />" title="Geração" href="/pt/docs/create">
    Uma execução pode gerar imagens e vídeos, escrever documentos e montar
    páginas web — tudo isso vira ativo.
  </Card>
</Cards>

Uma ferramenta que você habilitar no espaço de trabalho depois entra automaticamente nos seus
agendamentos existentes. Você não precisa reabri-los.

## O que ela não pode fazer

<Callout type="warn" icon="<TriangleWarning />">
  **Não tem ninguém do outro lado para responder.** Uma execução agendada não
  pode fazer uma pergunta de acompanhamento, não pode esperar por uma decisão e
  — esta é a parte importante — **não pode pausar para confirmar um custo antes
  de gastar créditos**. Criar o agendamento é a autorização. Se você não quer um
  agendamento gerando vídeo toda manhã, não peça isso a ele.
</Callout>

O gasto continua limitado ao que o espaço de trabalho pode de fato pagar: uma geração que o
saldo restante não cobre é recusada, e a execução registra isso como falha em vez de ficar
negativa.

<Cards>
  <Card icon="<Users />" title="Ele roda como o proprietário" href="/pt/docs/concepts/credits-and-spending">
    Uma execução enxerga o que o proprietário do agendamento enxerga, usa os
    conectores dele e gasta contra os limites dele, não importa quem mais possa
    editá-lo. Se o proprietário sair do espaço de trabalho, um agendamento
    compartilhado com outras pessoas passa para uma delas e chega pausado, para
    ela religar; um privado fica com quem saiu e é pausado em vez de continuar
    disparando execuções que só podem falhar.
  </Card>
</Cards>

## Onde a saída aparece

<Steps>
  <Step>
    ### A aba Atividade

    A segunda aba de **Agendados*&#x2A;. Vazia, ela diz &#x2A;"Quando seus agendamentos rodarem, os
    resultados aparecem aqui — abra um para ler ou continuar a conversa."* Cada entrada traz o
    status — **Sucesso**, **Falhou** ou **Rodando** — e abrir uma mostra a saída da execução,
    inclusive o que ela produziu como **Documento**, **Página web** ou **PDF**.

    Você pode filtrar o feed por um agendamento. O menu do próprio agendamento também tem &#x2A;*"Ver
    execuções"**, que abre o histórico de execuções desse agendamento.
  </Step>

  <Step>
    ### O chat da execução

    Cada execução começa a própria conversa, com o nome do agendamento e o horário em que rodou no
    título. &#x2A;*"Ver chat"** abre a conversa, e você pode continuar conversando a partir dali.

    Essas conversas ficam de propósito fora do **Histórico de chats** — um agendamento diário
    soterraria todo o resto. A Atividade é o caminho de entrada.
  </Step>

  <Step>
    ### Ativos

    Tudo que uma execução gera vira um ativo como qualquer outro, pesquisável e filtrável junto
    com o restante.
  </Step>

  <Step>
    ### Sua caixa de entrada, se você pedir

    **"Envio por e-mail"*&#x2A; — &#x2A;"Envie o resultado de cada execução por e-mail para membros do
    espaço de trabalho ou para qualquer endereço externo. Os resultados continuam aparecendo no app."*
    Os destinatários podem ser pessoas do espaço de trabalho ou qualquer endereço que você
    digitar; o assunto é o nome do agendamento, e o card da execução depois registra para quem ela
    foi.
  </Step>
</Steps>

<Cards>
  <Card icon="<Photo />" title="Onde a saída gerada fica" href="/pt/docs/create/where-output-lands">
    Como encontrar algo que uma execução criou, e quem mais pode ver.
  </Card>
</Cards>

## Quem pode ver um agendamento

O acesso é definido na seção **Acesso** da etapa Entrega, e um agendamento novo começa
**Privado*&#x2A;. Depois, o proprietário muda isso em &#x2A;*"Compartilhar"*&#x2A; no menu do agendamento, ou
na mesma seção de &#x2A;*"Editar"**.

<Cards>
  <Card icon="<Lock />" title="Privado">
    *"Só você, e os chats das execuções"* — mais quem você adicionar pelo nome.
  </Card>

  <Card icon="<Globe />" title="Todos no espaço de trabalho">
    Qualquer membro pode abri-lo, com **Pode ver** ou **Pode editar**.
  </Card>

  <Card icon="<Users />" title="Pessoas específicas">
    Adicione pessoas uma a uma, cada uma com **Pode ver** ou **Pode editar**. A
    configuração própria de uma pessoa vale mais que a do espaço de trabalho,
    mesmo quando é menor.
  </Card>
</Cards>

<Callout type="info" icon="<Eye />">
  O acesso vale também para as conversas das execuções, não só para o
  agendamento — quem pode abrir o agendamento pode ler o que ele produziu. O
  chat de uma execução não é compartilhado sozinho: para mostrar os resultados
  a alguém, compartilhe o agendamento.

  Diferente dos ativos, os agendamentos têm uma exceção de supervisão:
  &#x2A;*"Privado" quer dizer privado em relação aos seus colegas, não em relação à
  supervisão do espaço de trabalho.*&#x2A; Três permissões separadas, que os admins
  têm por padrão, vão além disso: &#x2A;*"Ler conteúdo criado por outras pessoas"*&#x2A;
  abre qualquer agendamento e as execuções dele; &#x2A;*"Editar conteúdo criado por
  outras pessoas"*&#x2A; altera qualquer agendamento que quem a tem consiga abrir;
  &#x2A;*"Excluir conteúdo criado por outras pessoas"** os exclui. Veja [funções e
  permissões](/pt/docs/governance/roles-and-permissions).
</Callout>

## Pausar, editar, excluir

Cada linha tem um menu — &#x2A;*"Ver execuções"*&#x2A;, &#x2A;*"Pausar"*&#x2A;, &#x2A;*"Editar"*&#x2A;, &#x2A;*"Testar"*&#x2A;,
&#x2A;*"Compartilhar"*&#x2A;, &#x2A;*"Excluir"*&#x2A; — e a página de cada agendamento tem as mesmas ações; um
criado em um chat também pode ser pausado ou editado pedindo. Pausar interrompe as execuções
futuras e mantém todo o resto; a linha fica marcada como &#x2A;*"Pausado"**.

Quem vê cada ação depende do acesso ao agendamento. Quem tem **Pode editar*&#x2A; — e também a
permissão do espaço de trabalho para criar e editar conteúdo — pode pausar, editar e testar.
Só o proprietário adiciona pessoas ou muda o acesso geral; os demais só podem sair de um
agendamento compartilhado com eles. Excluir cabe ao proprietário, ou a quem tem &#x2A;*"Excluir
conteúdo criado por outras pessoas"** e consegue abri-lo.

<Callout type="warn" icon="<Trash />">
  Excluir é a ação permanente: &#x2A;"Isso exclui permanentemente o agendamento e
  interrompe as execuções futuras. Os chats das execuções anteriores são
  mantidos. Não é possível desfazer."*
</Callout>

## Quando as execuções falham

Uma execução que falhou é marcada no feed, e a linha do agendamento mostra &#x2A;*"Última execução
falhou"**.

<Callout type="warn" icon="<TriangleWarning />">
  Depois de três falhas seguidas, um agendamento se pausa sozinho e avisa:
  &#x2A;"Pausado automaticamente após falhas repetidas. Corrija o prompt ou as
  ferramentas e retome."* Um aviso no topo da lista conta quantos estão nesse
  estado. Corrija o que quebrou — um conector desconectado costuma ser o culpado
  — e ligue o agendamento de novo.
</Callout>

Uma execução que para de responder por completo é marcada como falha depois de um tempo, em
vez de ficar girando — é por isso que uma falha ocasional pode aparecer sem causa evidente.

<Cards>
  <Card icon="<History />" title="O que rodou, em todo o espaço de trabalho">
    As execuções individuais ficam em **Atividade**, nesta página. O registro de
    tudo que aconteceu no espaço de trabalho inteiro — inclusive as
    movimentações de créditos — está em **Configurações → Governança →
    Atividade**, que exige a permissão de leitura de governança para abrir.
  </Card>

  <Card icon="<Bolt />" title="Quanto custa uma execução" href="/pt/docs/concepts/credits-and-spending">
    As execuções gastam créditos como qualquer outro trabalho. O chat é barato;
    a geração não é.
  </Card>

  <Card icon="<Wrench />" title="Limite o que um agendamento alcança" href="/pt/docs/automate/connectors">
    Conectores, e a diferença entre conectar e habilitar.
  </Card>

  <Card icon="<Toggle />" title="Ensine um fluxo de trabalho antes" href="/pt/docs/automate/skills">
    Um agendamento que chama uma skill fica curto e consistente.
  </Card>
</Cards>
