🌐 Diese Seite wurde noch nicht ins Deutsche übersetzt. Portugiesische (BR) Referenz wird angezeigt. Hilf bei der Übersetzung.
Fluxos Server Mode
O Fluxos é um construtor visual para orquestrar vários agentes de IA num pipeline. Você arrasta blocos para um canvas, conecta a saída de um na entrada do outro, e o RoqueOS executa a cadeia no servidor, passando o resultado de cada passo para o próximo, até entregar o resultado final.
Por que isso é útil
Alguns trabalhos são grandes demais para um agente só. Com Fluxos você divide: um agente resume, outro traduz, um validador confere, e um bloco de saída entrega, cada passo focado numa coisa. É um "time de agentes" montado por arrastar e soltar.
Requer Server Mode
Os Fluxos rodam no seu RoqueOS Server (onde ficam salvos e onde o executor roda). Veja Primeiros Passos para conectar um servidor, ou use o servidor DEMO. O construtor visual funciona melhor no desktop; no celular você lista e executa os fluxos.
O construtor
Na barra lateral Blocos, toque (ou arraste) para adicionar ao canvas. Conecte os blocos ligando a saída de um à entrada do próximo. Clique em um bloco para abrir o painel Editar bloco. A barra de topo tem nome do fluxo, Configurações (provedor/gatilho/credenciais), Executar, Salvar e Voltar.
Tipos de bloco
- Início, onde o fluxo começa (o gatilho). Todo fluxo tem um.
- Agente, um passo de IA. Tem um rótulo e uma tarefa (o que fazer); a saída dele é passada para o próximo bloco. Pode usar um agente salvo do app Agentes (herda modelo, instruções e ferramentas) ou um modelo próprio do bloco. E o caminho inverso também: se você configurou o agente aqui mesmo no bloco, o botão Salvar como agente cria um agente reutilizável no catálogo com este modelo e estas instruções. Ele passa a rodar sozinho e a ser usado em qualquer lugar, e o bloco passa a apontar para ele.
- HTTP, um passo determinístico (sem IA): faz uma requisição HTTP a qualquer API (método, URL, cabeçalhos e corpo) e passa a resposta para o próximo bloco. Ótimo para buscar dados, chamar um serviço ou disparar uma ação no meio do pipeline. O editor tem uma seção Cabeçalhos (adicionar/editar/remover) para autenticação (ex.:
Authorization: Bearer SEU_TOKEN) e modelos de um clique (GitHub, Jira, API) que já preenchem método, URL e os cabeçalhos que a chamada precisa, prontos para você colar o seu token. - Validador, um agente que julga a saída anterior e responde Aprovado ou Rejeitado, roteando o fluxo pela saída verde (aprovado) ou vermelha (rejeitado). Use para ramificar ou para tentar de novo até passar.
- Saída, o que fazer com o resultado: enviar para um webhook (POST em qualquer URL, Discord, Slack, Zapier, n8n ou sua API) ou salvar em um arquivo nos seus arquivos do RoqueOS.
Usando dados dos blocos anteriores (expressões)
Na tarefa de um agente, e na URL/corpo de um bloco HTTP ou de saída, você pode inserir dados dos passos anteriores com expressões entre chaves duplas:
{{input}} a entrada de teste ou o corpo do webhook
{{last}} a saída do bloco imediatamente anterior
{{steps.Rótulo}} a saída de um bloco específico, pelo seu rótuloAssim você monta um pipeline real: um bloco HTTP busca dados usando a expressão de entrada na URL, e o agente seguinte recebe a saída do bloco anterior para processar.
Repetir se falhar (retentativas)
Blocos de agente e HTTP podem tentar de novo automaticamente quando falham por um motivo passageiro (rede instável, limite de taxa da API). No editor do bloco, escolha em "Repetir se falhar" quantas vezes tentar novamente (1×, 2× ou 3×), o RoqueOS espera um instante entre as tentativas e só marca o passo como erro depois de esgotar todas.
Gerar com IA
Não sabe por onde começar? Clique em Gerar com IA e descreva o fluxo em português ("recebe um texto, resume em tópicos, traduz para inglês e posta num webhook"). O RoqueOS rascunha um fluxo válido e pronto para rodar e abre no construtor para você revisar, ajustar e salvar. Nada é salvo até você clicar em Salvar.
Executando e o histórico
Clique em Executar para rodar o fluxo. Você pode informar uma entrada de teste opcional (um texto que entra no fluxo como contexto do primeiro bloco). O fluxo roda ao vivo no canvas: cada bloco acende enquanto executa (anel pulsante), fica verde quando conclui e vermelho se falha, então você vê exatamente qual bloco está rodando e onde parou. O painel de resultado também vai se preenchendo passo a passo. Cada execução guarda um histórico com o resultado de cada passo (status, saída, e o veredito dos validadores), assim você vê exatamente o que cada bloco produziu.
Cada execução também mostra os tokens usados e um custo estimado (aproximado), no total da execução e por bloco de IA, para você acompanhar o consumo. O custo é uma estimativa a partir do modelo; modelos locais ou desconhecidos aparecem sem valor de custo (nunca um custo falso).
Os fluxos também têm os mesmos gatilhos das Automações: manual, agendado e webhook. Quando o fluxo é disparado por webhook, o corpo que você envia (um JSON ou um texto) entra no fluxo como a entrada (), então o fluxo pode agir sobre o evento que o disparou (o corpo de um webhook do GitHub/Jira/n8n, o JSON da sua API, etc.).
Segurança
Todos os segredos, chave de IA e credenciais de servidor, são criptografados em repouso e nunca retornados pela API. Os gatilhos por webhook usam um token secreto verificado em tempo constante.
Os blocos HTTP e Saída (webhook) rodam no servidor, então têm uma proteção contra SSRF: uma URL que aponta para o próprio servidor (localhost/127.0.0.1), para endereços de metadados de nuvem (169.254.169.254) ou link-local é bloqueada (o bloco falha com um aviso, sem fazer a requisição). URLs públicas e da sua rede local continuam funcionando normalmente.
Fluxos, Agentes e Automações
Um Agente é a definição reutilizável; uma Automação roda um agente sozinho num gatilho; um Fluxo encadeia vários agentes num pipeline visual com validação e saída. Defina o agente uma vez e use nas três superfícies.
Perguntas frequentes
Qual a diferença entre um Fluxo e uma Automação?
Uma Automação roda um agente numa tarefa. Um Fluxo encadeia vários blocos (agentes, validadores, saída) num pipeline visual, bom quando o trabalho tem etapas.
O resultado de um bloco vai para o próximo?
Sim. A saída de cada bloco é passada como contexto para o bloco seguinte, formando a cadeia.
Consigo montar no celular?
O construtor visual é feito para o desktop; no celular você lista, executa e vê o histórico dos fluxos. Monte o desenho num computador.