Pular para o conteúdo

Agentes agendados

Um agente agendado (uma automação) é um prompt de chat que roda por conta própria: todas as manhãs dos dias úteis, a cada hora, toda segunda-feira, ou em uma expressão cron que você escreve. O agente faz exatamente o que faria se você digitasse o prompt, com as mesmas ferramentas do Google Workspace, e o resultado chega onde você pediu.

Agentes agendados fazem parte do plano Standard (até 3 automações ativas) e do plano Pro (até 20). Nos demais planos, a página mostra o que eles fazem e oferece a opção de upgrade. Cada execução usa os créditos do seu plano como uma rodada normal de chat.

  1. Abra Settings ➤ Scheduled agents ou acesse gpt.space/app/settings/automations e clique em New automation.
  2. Dê um nome e escreva o prompt como uma mensagem de chat, por exemplo Resuma meu calendário de hoje e destaque o que precisa de preparação.
  3. Escolha um agendamento: todas as manhãs dos dias úteis às 8:00, a cada hora, todos os dias às 9:00, toda segunda-feira às 9:00, ou uma expressão cron personalizada de cinco campos (0 8 * * 1-5 roda nos dias úteis às 8:00). Os horários seguem o fuso mostrado abaixo do agendamento, que por padrão é o do seu navegador.
  4. Escolha como entregar o resultado:
    • Por email, para o seu endereço ou outro.
    • Como uma nova conversa no seu histórico de chats, para você continuar a conversa.
    • Como uma linha em uma planilha: cole o link ou o ID da planilha e, opcionalmente, um nome de aba. Cada execução adiciona uma linha com a data e o resultado.
  5. Clique em Create. A lista mostra quando a automação roda pela próxima vez.

Qualquer coisa que você pediu uma vez pode virar uma automação. Passe o mouse sobre uma mensagem que você enviou e clique em Schedule this prompt (o ícone de relógio), ou clique no mesmo ícone na caixa de mensagem para agendar o que você está digitando: a caixa de diálogo abre com o prompt preenchido.

Em Settings ➤ Scheduled agents cada automação mostra seu agendamento, entrega, próxima execução, última execução e último status.

  • Pausar ou retomar com o interruptor. Uma automação pausada não conta no limite do seu plano.
  • Run now inicia uma execução imediatamente, independentemente do agendamento; o resultado chega em alguns minutos.
  • Edit altera o prompt, o agendamento ou a entrega; a próxima execução é recalculada.
  • Show runs lista as execuções recentes com seu status, créditos usados e, para entrega em conversa, um link para a conversa.
  • Delete remove a automação e seu histórico de execuções.

Uma execução é ignorada e registrada no histórico, sem usar créditos, quando:

  • você está sem créditos no mês (o status mostra Skipped: out of credits). A automação retoma sozinha assim que os créditos estiverem disponíveis novamente;
  • seu plano não inclui mais agentes agendados (Skipped: not in plan);
  • seu login do Google expirou ou uma permissão do Google que o prompt precisa nunca foi concedida. Abra o GPT Workspace, faça login ou conceda a permissão, e a próxima execução acontece.

Uma execução que falha por outro motivo mostra Failed com o erro, e a automação mantém seu agendamento.

Uma automação também pode rodar no momento em que um email correspondente chega à sua caixa de entrada do Gmail, em vez de (ou além de) seu agendamento. Na caixa de diálogo da automação, ative Run when a new email matches e escreva uma busca do Gmail, por exemplo from:billing@ subject:invoice. Deixe a busca vazia para rodar para cada novo email recebido.

A busca entende os operadores comuns do Gmail: from:, to:, cc:, subject:, label: / in:, has:attachment, is:unread, palavras simples (buscadas no assunto, no texto de pré-visualização e no remetente) e um - no início para excluir um termo. Todos os termos devem corresponder. Operadores sobre datas ou tamanhos (newer_than:, larger:) são ignorados.

Cada email correspondente inicia uma execução. O agente recebe o email primeiro (remetente, destinatários, assunto, data, os IDs da mensagem e da conversa do Gmail e o texto da mensagem, até 8.000 caracteres) seguido do seu prompt, então um prompt como Arquive a fatura anexada na pasta Finance e responda que foi recebida funciona sobre esse email. A execução é registrada no histórico como qualquer outra, com um link para a mensagem que a iniciou.

Para monitorar sua caixa de entrada, o GPT Workspace precisa de Gmail access (a mesma permissão das ferramentas de Gmail do chat). Se ainda não foi concedida, salvar a automação mostra um link Connect Gmail; conceda a permissão e salve novamente. A página mostra o estado do monitoramento ao lado das suas automações: Watching your inbox until (o monitoramento é renovado automaticamente), Gmail watch failed com o motivo (por exemplo uma permissão do Gmail revogada; a automação permanece ativa e o monitoramento é tentado novamente diariamente e sempre que você salva), ou Rate limited quando mais de 60 emails correspondentes chegaram em uma hora: os excedentes são ignorados até a hora terminar.

Execuções disparadas por email usam os mesmos limites de plano, créditos e tempo de execução das execuções agendadas. Uma automação que só tem um gatilho mostra Not scheduled e nunca roda sozinha; uma com gatilho e agendamento roda em ambos.

O Gmail notifica o GPT Workspace por meio do Google Pub/Sub sempre que sua caixa de entrada muda (um “monitoramento” no marcador INBOX, que o Google expira após 7 dias e o GPT Workspace renova todos os dias). O GPT Workspace então lê os IDs das mensagens adicionadas desde a última notificação, busca cada nova mensagem uma vez e verifica-a contra a busca de toda automação disparada por email que você tem. Uma mensagem nunca é executada duas vezes para a mesma automação, mesmo quando o Google envia a notificação mais de uma vez.

Standard Pro
Automações ativas (agendadas ou disparadas) 3 20
Menor intervalo 15 minutos 15 minutos
Execuções disparadas por email 60 por hora 60 por hora
Tempo limite de execução 6 minutos 6 minutos