Início Rápido

Este artigo leva você de "apenas abrir o site" até "executar um workflow real" sem escrever código ou instalar nada no meio.

Pré-visualização do panorama: o que esperar deste

Abaixo está o caminho que seguiremos em ordem.

1. Registre uma conta → Faça login
2. Acesse a página "Workflow" para conhecer o console principal
3. Clone um workflow pronto da biblioteca de modelos
4. Verifique sua estrutura com simulação
5. Vincule sua chave LLM (BYOK)
6. Execute-o uma vez e entenda o fluxo de eventos em tempo real
7. Desligue um cron e deixe-o rodar automaticamente todos os dias

Passo 1 · Registre uma conta

1.1 Abra a página de registro

Clique em “Login” no canto superior direito da página inicial, clique em “Criar conta” na parte inferior da página de login ou visite diretamente /register.

1.2 Código convite ou inscrição aberta

Braidrun está atualmente em fase beta fechada apenas para convidados, o que significa:

• Você precisa de um código de convite para concluir o registro;
• Se você não tiver um código de convite, deixe seu endereço de e-mail no formulário "Solicitar código de convite" na página inicial.

Após obter o código de convite, basta preencher o e-mail + senha + código de convite. Registo e login.

1.3 Verificação e ativação de e-mail

Após enviar o formulário, você receberá um e-mail de verificação.

Passo 2 · Entre no console do workflow

2.1 Navegação principal esquerda

Depois de fazer login, você acessa a página inicial.

• workflows — Seu principal campo de batalha.
• Modelos — 240+ workflows pré-construídos, clonar e ir.
• Módulos — 120+ módulos reutilizáveis, além dos que você promove.
• Histórico de Execução — Lista de todas as execuções recentes.
• Agendamentos — Entradas de gatilho de tempo/webhook.
• Homologação — Quando o workflow está na etapa "Aprovação Manual", o aprovador aprova a partir daqui.
• Credenciais — Todas as chaves de API são colocadas aqui e armazenadas criptografadas.

2.2 Três entradas rápidas para a página inicial

A página inicial não é um espaço vazio.

1. Crie um novo workflow em branco — Comece com uma tela em branco.
2. Clonar do modelo — Este guia segue esse caminho.
3. Deixe o assistente de IA gerar — A FAB no canto inferior direito abre o assistente lateral de IA.

Passo 3 · Clonar da Biblioteca de Modelos

3.1 Escolha um modelo que mais se aproxime do seu negócio

aberto à esquerda Modelos.

Recomenda-se escolher uma destas duas categorias pela primeira vez:

• "Resumo diário de notícias" — A lógica é simples, as etapas são poucas e o fluxo de dados completo pode ser visto.
• "Relatório Semanal ASA" — Cenário de negócios real, usando agendamento + sub-workflow + entrega Slack.

3.2 Lendo cartões modelo

Clique para ver:

• "Descrição" - o que faz
• "Credenciais necessárias" - Quais chaves precisam ser preenchidas durante a execução?
• "Exemplo de entrada/saída" - representativo de resultados típicos
• "Duração/custo estimado" - Aproximadamente quantos minutos e quantos dólares custará uma corrida?

3.3 Clonar para espaço de trabalho

Clique no canto superior direito "Use este modelo". /workflows Uma cópia independente será gerada para você abaixo - não importa como você a altere posteriormente, isso não afetará o modelo original.

Etapa 4 · Use o teste para primeiro observar a estrutura

4.1 Por que é necessário executar o funcionamento a seco?

O valor central do teste é o “custo zero”: ele passará por todo o DAG, mas substituirá todas as chamadas LLM e efeitos colaterais externos (envio de mensagens, gravação de bancos de dados, dedução de pagamentos, etc.) por operações autônomas seguras.

• Para onde a variável flui - entre aspas {{...}} Existe algum erro ortográfico?
• Quais etapas são ignoradas por condição
• De quais credenciais o modelo depende - saiba com antecedência o que configurar na Central de Credenciais

4.2 Iniciar simulação no editor

1. Na parte superior do editor de workflow, clique em "Execução".
2. Marque "teste (não ajuste LLM/não gere efeitos colaterais)" na caixa de diálogo.
3. Preencha alguns parâmetros necessários de acordo com as instruções do modelo e deixe o restante como padrão.
4. Clique em “Iniciar Execução”.

Etapa 5 · Configurar uma chave LLM (BYOK)

5.1 O que é BYOK

"Traga sua própria chave".

• O consumo de tokens é registrado diretamente em sua própria conta LLM e a plataforma não aumenta o preço.
• Você pode usar os modelos avançados da sua própria conta – como Claude Opus, GPT-5 – sem a garantia unificada da plataforma.
• A rotação/revogação de chaves depende inteiramente de você.

5.2 Obtenha uma chave

Os mais comuns:

• OpenAI — platform.openai.com/api-keys
• Anthropic — console.anthropic.com
• DeepSeek — platform.deepseek.com
• Kimi — platform.moonshot.cn

5.3 Armazene-o em credenciais

1. Abrir Credenciais.
2. Clique em “Novas credenciais”.
3. Selecione api_key como tipo; openai_main、anthropic_personal;Value cola a chave que você obteve do provedor.
4. Salvar.

Para obter uma explicação mais completa (namespace de terceiro nível, vinculação de provedor, processo de rotação), consulte Credenciais e BYOK · traga sua própria chave LLM.

Passo 6 · Faça uma corrida de verdade

6.1 Iniciar execução

1. Retorne ao editor de workflow e clique em “Executar” na parte superior.
2. Desta vez na caixa de diálogo Cancelar Verifique o funcionamento a seco.
3. Preencha os parâmetros necessários novamente - geralmente da mesma forma que para o teste da primeira vez.
4. Clique em “Iniciar Execução”.

6.2 Entenda o fluxo de eventos em tempo real à direita

À direita da página está um fluxo de eventos empurrado em tempo real sobre WebSocket. Cada linha é um evento, e você pode filtrar por categoria:

• Expressão do agente – saída intermediária de um agente, mais comum nas etapas group chat;
• Chamada LLM — um resumo de cada chamada de modelo, com contagem de token de entrada / saída;
• Chamada de ferramenta — qual ferramenta o Agente chamou; expanda para ver os argumentos e o valor de retorno;
• Mensagem externa — um registro de mensagens enviadas para canais como Slack ou Telegram.

Para mais informações sobre as categorias de eventos, consulte Monitoramento e registro de execução.

6.3 Veja os resultados e produtos

Após o término da execução, clique em "Exibir detalhes da execução" na parte superior:

• Cada barra verde no gráfico de Gantt é uma etapa bem-sucedida;
• Clique em uma etapa para ver seu instantâneo de entrada/saída/log/variável.
• Você pode visualizar ou baixar Markdown/Excel/capturas de tela, etc. na coluna do produto.

Passo 7 · Desligue um cron e deixe-o rodar automaticamente

7.1 Crie um novo cronograma

1. "Gerenciamento de agendamento" à esquerda â "Novo agendamento".
2. Como workflow de destino, selecione aquele que você acabou de executar.
3. Selecione cron como o tipo; 0 8 * * *(8h00 todos os dias);
4. Caso o workflow possua variáveis, preencha os valores padrão para este lote de agendamentos em "Parâmetro Padrão" (cada gatilho programado iniciará com estes valores).
5. Salvar.

7.2 Como garantir que não haja duplicação no agendamento

A plataforma executa automaticamente bloqueios distribuídos em implantação de múltiplas instâncias: o mesmo agendamento só será acionado em uma máquina no mesmo minuto.

O agendamento de tempo também pode ser configurado no modo intervalo/uma vez. Execuções agendadas.

Depois de fazer isso, você já sabe como

• Processo completo de registro/login/verificação de e-mail
• Clone da biblioteca de modelos → Teste do editor → Loop básico de execução real
• O papel do Centro de Credenciais e a importância do BYOK
• A capacidade de ler o fluxo de eventos em tempo real e a página de detalhes da execução
• Pendure o workflow na entrada de execução automática do cron

O que assistir a seguir

• Conceitos Principais — A relação entre workflow/etapa/agente/módulo/execução/credencial é claramente explicada em uma imagem.
• Hands-on: Seu Primeiro workflow — Escreva passo a passo um workflow de negócios real, com todos os conceitos interligados
• Editor Visual — Explique a tela/YAML/barra de ferramentas/bloqueio de colaboração/instantâneo da versão um por um
• Melhores Práticas — Não pise nos buracos em que você pisou novamente