🌐 Эта страница еще не переведена на русский. Показана португальская (BR) версия. Помочь с переводом.
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.
- HTTP — um passo determinístico (sem IA): faz uma requisição HTTP a qualquer API (método, URL 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.
- 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.
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). 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.
Os fluxos também têm os mesmos gatilhos das Automações: manual, agendado e webhook.
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.
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.