# Tarefas agendadas

> Rode um prompt diário, semanal, mensal ou uma vez em um período do dia, envie o resultado por e-mail e leia cada execução no chat dela.

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

Uma tarefa agendada roda um prompt em uma cadência, sem você. Cada execução inicia um chat novo
com o resultado. Abra-as em **Agendados** na barra lateral. Se o espaço de trabalho desativou o
recurso, **Agendados** não aparece na barra lateral.

<ImageZoom src="https://static.endless.software/docs/screenshots/scheduled-2ef43a9d.webp" alt="A página Agendados: um botão Novo agendamento, Adicionar filtro e busca, e uma lista de agendamentos (Conceito de teaser diário, Radar de tendências matinal, Resumo semanal de conteúdo e um Relatório mensal de uso pausado), cada um com a cadência, o período do dia, o modelo e quando roda de novo" width="980" height="465" />

## Criar um agendamento

Você precisa de permissão para criar conteúdo (membros e admins têm por padrão, visualizadores
não). Comece por qualquer um destes:

* **Novo agendamento** no cabeçalho de **Agendados*&#x2A;. A seta dele também oferece &#x2A;*"Criar com o
  agente"**, que configura o agendamento em um chat.
* Um modelo inicial em uma página vazia: &#x2A;*"Resumo diário"*&#x2A;, &#x2A;*"Relatório semanal"*&#x2A;, &#x2A;*"Resumo
  mensal"*&#x2A; ou &#x2A;*"Começar do zero"**.
* **"Criar agendamento"** no menu de uma das suas próprias mensagens no chat. Usa essa mensagem
  como instruções, para rodar todo dia de manhã.
* Qualquer chat: peça ao Endless, por exemplo &#x2A;"me mande isto toda segunda de manhã"*.

### O formulário

**Novo agendamento*&#x2A;, os modelos, &#x2A;*"Criar agendamento"*&#x2A; e &#x2A;*"Editar"** abrem o mesmo
formulário.

<ImageZoom src="https://static.endless.software/docs/screenshots/schedule-form-abdf9b62.webp" alt="O formulário de um agendamento: o nome, as Instruções com os seletores de conectores e skills e de modelo, uma seção de agendamento em Dias úteis com Período do dia em Manhã, uma seção Entrega com acesso e envio por e-mail, e um botão Revisão" width="820" height="1010" />

<Steps>
  <Step>
    ### Nome e instruções

    A caixa de instruções funciona como o compositor do chat: `@` adiciona um projeto, `/` chama uma
    skill. Não dá para anexar arquivos. Abaixo, escolha o **modelo** e os **Conectores e skills** que
    a execução pode usar. O limite é de 32.000 caracteres.
  </Step>

  <Step>
    ### Agendamento

    **Repetição**: **Diariamente**, **Dias úteis**, **Semanalmente**, **Mensalmente** ou **Uma
    vez**. **Período do dia**: **Manhã**, **Meio-dia**, **Tarde** ou **Noite**.
  </Step>

  <Step>
    ### Entrega

    Quem pode abrir o agendamento (veja [acesso](#quem-pode-ver-um-agendamento&#x29;) e &#x2A;*"Envio por
    e-mail"**.
  </Step>

  <Step>
    ### Resumo

    **"Ver resumo"*&#x2A; mostra um resumo e as &#x2A;*"Próximas 3 execuções"*&#x2A; no seu fuso horário. &#x2A;*"Criar
    agendamento"*&#x2A; (ou &#x2A;*"Salvar alterações"*&#x2A;) salva. **⌘Enter** (**Ctrl+Enter**) aciona o botão
    principal.
  </Step>
</Steps>

### Em um chat

O Endless pergunta uma coisa por vez: o que a tarefa faz, com que frequência, em que período do
dia e quem recebe o resultado por e-mail. Nada é salvo até você aprovar o cartão &#x2A;*"Criar este
agendamento?"*&#x2A;, que mostra o nome, a cadência, o prompt completo, o acesso e os destinatários.
Leia o prompt: cada execução parte só dele, sem memória do chat. Mudanças que você pedir depois
(&#x2A;"passe para a noite"&#x2A;, &#x2A;"pause"&#x2A;) mostram um cartão &#x2A;*"Salvar as alterações em …?"** do mesmo
jeito.

## Cadência e fuso horário

| Opção        | Comportamento                                                                                                                |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| Horário      | Você escolhe um período do dia, não uma hora. A execução começa no início desse período para o resultado chegar dentro dele. |
| Fuso horário | O **Fuso horário** do seu perfil quando você salvou. Não muda depois até você editar e salvar.                               |
| Semanal      | Escolha um ou mais dias da semana em um único agendamento.                                                                   |
| Mensal       | Um dia que o mês não tem roda no último dia (o dia 31 roda no dia 30, ou no 28/29 em fevereiro).                             |
| Uma vez      | Precisa de uma data futura. Depois de rodar, o agendamento fica como &#x2A;*"Concluído"**.                                   |

## O que uma execução pode fazer

Uma execução é um turno de chat normal, com as mesmas ferramentas:

* **[Skills](/pt/docs/automate/skills)**: todas as skills ligadas para você, a menos que você desligue
  alguma em **Conectores e skills** para este agendamento.
* **[Conectores](/pt/docs/automate/connectors)**: só os que você conectou.
* **[Projetos](/pt/docs/concepts/projects)**: projetos mencionados com `@` carregam o conhecimento e as
  skills deles.
* **Geração**: imagens, vídeo, documentos e páginas web, salvos como ativos.

Uma ferramenta que você ativar depois entra nos agendamentos existentes automaticamente.

<Callout type="warn">
  Uma execução não pode fazer perguntas nem confirmar um custo antes de gastar
  créditos. Criar o agendamento é a aprovação. Uma execução não começa quando o
  espaço de trabalho está sem créditos ou o proprietário atingiu o limite de
  gastos, e uma geração que o saldo não cobre falha em vez de deixar o saldo
  negativo. Veja [créditos e gastos](/pt/docs/concepts/credits-and-spending).
</Callout>

Uma execução age como o proprietário do agendamento: vê o que ele vê, usa os conectores dele e
gasta dentro dos limites dele, mesmo quando outras pessoas podem editá-lo. Se o proprietário sai
do espaço de trabalho, um agendamento compartilhado passa para outra pessoa com acesso e chega
pausado; um privado fica com quem saiu e é pausado.

## Onde a saída aparece

* **Aba Execuções**: a página de cada agendamento tem **Informações** e **Execuções**. Cada
  execução mostra o status (**Sucesso**, **Falhou**, **Em execução**, **Cancelada**), quando
  começou, quanto durou, os créditos usados e para quem rodou. Abrir uma abre o chat dela.
* **O chat da execução**: leva o nome do agendamento e o horário. Você pode continuar conversando
  ali. Esses chats não aparecem em **Chats**.
* **Ativos**: tudo o que uma execução gera. Veja [onde a saída
  fica](/pt/docs/create/where-output-lands).
* **E-mail*&#x2A;: com &#x2A;*"Envio por e-mail"** ligado, cada resultado vai para até 50 destinatários,
  membros ou qualquer endereço. O assunto é o nome do agendamento.

## Testar e cancelar

**"Testar"** roda o agendamento agora. É uma execução real e gasta créditos. Não muda a próxima
execução agendada, funciona em um agendamento pausado e envia o e-mail só para você.

**"Cancelar execução"** na aba **Execuções** interrompe uma execução em andamento e não envia
resultado. Créditos já usados não são reembolsados. Uma execução cancelada não conta como falha.

## Quem pode ver um agendamento

Um agendamento novo começa como **Privado*&#x2A;. O proprietário muda o acesso em &#x2A;*"Compartilhar"*&#x2A;
ou em &#x2A;*"Editar"**: **Privado**, **Todos no espaço de trabalho** ou **Pessoas específicas**, cada
um 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.

Quem pode abrir um agendamento pode ler os chats das execuções. O chat de uma execução não é
compartilhado sozinho. Quem tem &#x2A;*"Ler/Editar/Excluir conteúdo criado por outras pessoas"** (os
admins, por padrão) alcança agendamentos privados. Veja [funções e
permissões](/pt/docs/governance/roles-and-permissions).

## Pausar, editar, excluir

Cada linha e a página de cada agendamento têm &#x2A;*"Ver execuções"*&#x2A;, &#x2A;*"Pausar"*&#x2A;, &#x2A;*"Editar"*&#x2A;,
&#x2A;*"Testar"*&#x2A;, &#x2A;*"Compartilhar"*&#x2A; e &#x2A;*"Excluir"*&#x2A;. Pausar interrompe as próximas execuções;
&#x2A;*"Retomar"** as reativa.

| Ação                                       | Quem                                                                              |
| ------------------------------------------ | --------------------------------------------------------------------------------- |
| Pausar, editar, testar, cancelar execuções | **Pode editar** mais a permissão para criar e editar conteúdo                     |
| Mudar o acesso                             | O proprietário. Os demais só podem sair de um agendamento compartilhado.          |
| Excluir                                    | O proprietário, ou quem tem &#x2A;*"Excluir conteúdo criado por outras pessoas"** |

Excluir é permanente e interrompe as próximas execuções. Os chats de execuções passadas são
mantidos.

## Quando as execuções falham

Uma execução que falhou mostra o motivo na aba **Execuções*&#x2A;, e a linha mostra &#x2A;*"A última
execução falhou"**. Execuções que falharam são reembolsadas. Uma execução que para de responder
é encerrada como falha.

Depois de três falhas seguidas, o agendamento se pausa sozinho (&#x2A;*"Pausado após falhas"**).
Corrija a causa, muitas vezes um conector desconectado ou uma skill desligada, e retome-o.

O registro de todo o espaço de trabalho, incluindo movimentações de créditos, fica em
**Configurações → Governança → Atividade**.
