Skip to content

🌐 Diese Seite wurde noch nicht ins Deutsche übersetzt. Portugiesische (BR) Referenz wird angezeigt. Hilf bei der Übersetzung.

Automações Server Mode

O Automações deixa um agente de IA trabalhar por você em segundo plano: você define uma tarefa e um gatilho, e o RoqueOS executa a tarefa sozinho — na hora, num horário, ou quando um sistema externo chamar. Cada execução roda no servidor (não precisa de janela aberta) e fica registrada no histórico.

Automações

Por que isso é útil

É a forma mais simples de colocar a IA para trabalhar sem você. "Todo dia às 8h, resuma minhas notas mais recentes e escreva num arquivo." "Quando este webhook for chamado, classifique o texto recebido." Você configura uma vez e esquece.

Requer Server Mode

As Automações rodam no seu RoqueOS Server (é onde ficam salvas, com os segredos criptografados, e onde o executor roda no horário certo). Veja Primeiros Passos para conectar um servidor — ou use o servidor DEMO para experimentar.


Criando uma automação

Clique em + Nova e preencha:

  • Nome — como a automação aparece na lista (ex.: "Resumo diário de e-mails").
  • Agente — quem executa a tarefa. Você pode usar um agente salvo do app Agentes (com toda a persona, skills, conhecimento e ferramentas dele) ou configurar um agente inline (provedor + modelo + chave) só para esta automação.
  • Tarefa — a instrução em linguagem natural do que fazer a cada execução (ex.: "Resuma em tópicos as notas criadas hoje e salve em /Resumos/hoje.txt").
  • Gatilho — quando a automação roda (veja abaixo).

Nada é executado até você salvar — e você pode rodar na hora com Executar agora para testar.


Gatilhos

  • Manual — roda só quando você clica em Executar agora. Bom para tarefas sob demanda.
  • Agendado — roda automaticamente num intervalo (a cada N minutos) ou diariamente num horário fixo (HH:mm). O servidor dispara sozinho.
  • Webhook (disparo externo) — gera uma URL secreta; qualquer sistema que fizer um POST para ela dispara a automação. Útil para conectar com Zapier, n8n, GitHub Actions, ou seu próprio código. A URL só aparece depois de salvar (ela contém o token de segurança — trate-a como um segredo).

Histórico de execuções

Cada automação guarda um histórico das últimas execuções: status (Sucesso / Erro), o resultado em texto que o agente produziu, e as ferramentas que ele acionou. Expanda uma automação na lista para ver as execuções — assim você acompanha o que ela fez e depura se algo falhar.


Segurança

Todos os segredos — a chave de IA e as credenciais de servidor que a automação usa — são criptografados em repouso e nunca retornados pela API. O token do webhook é comparado em tempo constante e a rota é limitada por taxa, para evitar abuso.


Automações, Agentes e Fluxos

As três superfícies trabalham juntas: um Agente é a definição reutilizável (persona + skills + ferramentas); uma Automação roda um agente num gatilho, sozinho; um Fluxo encadeia vários agentes num pipeline visual. Defina o agente uma vez, use nas três.


Perguntas frequentes

A automação roda mesmo com o RoqueOS fechado?
Sim. Ela roda no seu servidor, não no navegador — então gatilhos agendados e webhooks funcionam mesmo sem nenhuma aba aberta.

Posso usar um agente que já criei?
Sim — escolha usar um agente salvo e a automação herda o modelo, as instruções, o conhecimento e a lista de ferramentas daquele agente.

Como conecto um sistema externo?
Use o gatilho Webhook: copie a URL secreta gerada e faça um POST para ela a partir do outro sistema.