Instantificar um workflow a partir de um modelo

No Braidrun, "instanciação do modelo" é o método de geração de workflow mais comum: mais de 90% dos usuários não escrevem seu primeiro workflow no quadro branco, mas clonam um do modelo e depois ajustam-no de acordo com seu próprio negócio.

Visão geral completa do processo

1. Navegue na biblioteca de modelos e selecione um por categoria/tag/pesquisa
2. Leia o cartão de detalhes do modelo para confirmar os pré-requisitos e os custos estimados
3. Clique em "Usar este modelo" para cloná-lo em seu espaço de trabalho
4. Altere os parâmetros de negócio de acordo com a descrição da variável no editor
5. Preencha a chave no centro de credenciais
6. Primeiro faça um teste para verificar a estrutura e depois execute novamente
7. Agendamento de vinculação/gatilhos de Webhook sob demanda

Passo 1 · Navegue pela galeria de modelos

1.1 Abra a entrada

A navegação principal à esquerda é "Biblioteca de modelos".

• Barra de filtro superior - 10 categorias do setor + tags + pesquisa por palavra-chave
• Grade de cartão modelo - mostrando nome, descrição, tags, duração estimada, complexidade
• "Minha coleção" no canto superior direito - modelos de longo prazo podem ser coletados e inseridos diretamente na próxima vez

1.2 Estratégias comuns de seleção

• As necessidades são muito específicas — Pesquise palavras-chave diretamente.
• A demanda é ampla — Convergência baseada na indústria em primeiro lugar.
• Quer "ver o que outras pessoas do setor fazem" — Classifique por “complexidade” e escolha as mais complexas – elas geralmente representam práticas maduras de ponta a ponta.

Passo 2 · Leia os detalhes do modelo

Clique em um cartão modelo para entrar na página de detalhes, com foco em quatro partes:

2.1 Seção "Descrição"

Em dois ou três parágrafos, diga: quais problemas ele resolve, para quais cenários é mais adequado, para quais cenários não é adequado e quais preparativos são necessários antes do uso.

2.2 Lista de "Credenciais Necessárias"

Liste claramente as credenciais necessárias para executar este workflow, por exemplo:

• openai_api_key — Chave de API OpenAI (obrigatória)
• slack_webhook_url — URL do Webhook de entrada do Slack (para entrega, opcional)
• apple_appstoreconnect — App Store Connect JWT (necessário apenas para modelos relacionados à Apple)

Se uma das credenciais "obrigatórias" estiver faltando, o workflow falhará ao atingir a etapa correspondente.

2.3 "Tempo e custo estimados"

Uma execução completa:

• Tempo gasto - 2 minutos/15 minutos/1 hora, dependendo da complexidade do workflow e da velocidade de resposta da dependência externa
• Uso de token - média de entrada xxx/saída xxx
• $ Estimado - o valor aproximado calculado com base na predefinição padrão da plataforma e no preço unitário OpenAI

2.4 "Exemplo de entrada e exemplo de saída"

Uma amostra de entrada específica (você pode simplesmente copiá-la e executá-la uma vez) + a amostra de saída correspondente (para ter uma ideia de "provavelmente o que você pode obter").

Etapa 3 · Clonar no espaço de trabalho

1. ponto do canto superior direito "Use este modelo".
2. Dê um nome à sua cópia na janela pop-up (o padrão é nome do modelo + carimbo de data / hora, você pode alterá-lo para algo mais comercial).
3. Selecione sua equipe alvo (se você estiver em várias equipes).
4. Clique em OK. cópia independente, suas alterações não são enviadas de volta para o modelo, e as atualizações posteriores do modelo não alterarão automaticamente sua cópia.

Passo 4 · Personalizar os parâmetros de negócios

A seção de variáveis 4.1 é o único lugar onde você precisa olhar com atenção

Quando o editor abrir, primeiro role pelo YAML até a seção de variáveis na parte superior.

variables:
  target_date:
    type: string
    default: yesterday    # ← 改成你要跑哪一天的数据
    description: |
      支持 yesterday / last_7_days / last_30_days /
      或具体日期 2026-04-17

  top_n:
    type: number
    default: 10           # ← 要拉多少条新闻
    description: 抓取的新闻数量上限

  target_channel:
    type: string
    default: "#my_daily_digest"  # ← 改成你的 Slack 频道名或保留默认 webhook 目标
    description: Slack 目标频道或 Incoming Webhook 默认目标

4.2 Altere o valor padrão de acordo com o comentário

O valor padrão é apenas um “exemplo”, substitua-o pelo valor real do seu negócio.

4.3 É um bom hábito não seguir passos

Não é recomendado alterar a estrutura da seção de etapas ao executar o modelo pela primeira vez - execute-o primeiro uma vez com o processo padrão, veja o fluxo de dados e, em seguida, decida se deseja alterá-lo.

Etapa 5 · Central de credenciais completa

1. Centro de credenciais aberto.
2. Crie uma credencial correspondente para cada credencial "obrigatória" listada na página de detalhes do modelo. O nome deve ser exatamente igual ao citado no YAML.
3. As credenciais "opcionais" podem ser deixadas sem criação por enquanto - as etapas relevantes serão ignoradas.

Etapa 6 · Primeiro faça o teste e depois execute

6.1 O significado do teste

o teste é executado no DAG a custo zero, ignorando todos os LLM e efeitos colaterais.

• Todas as variáveis estão preenchidas corretamente?
• Fluxo de variáveis entre etapas
• O ramo da condição/classificador está selecionado corretamente.
• O nome da credencial dependente pode ser resolvido para

6.2 Corrida real

Após a execução do teste, desmarque o teste e clique em "Executar" novamente.

6.3 O que observar depois de correr

• "Ver detalhes da execução" - Gráfico de Gantt + entrada/saída de cada etapa
• "Coluna do produto" - o Markdown/Excel/imagem gerado pode ser baixado diretamente
• "Tokens / custo" – Quanto você gastou neste tempo?

Passo 7 · Vincule gatilhos conforme necessário

Após a execução manual, o workflow está pronto para ficar online.

• Execuções agendadas — Diariamente/semanalmente/mensalmente ou repetir por intervalo
• Acionamento por Webhook — Um sistema externo POSTs para atirá-lo, autenticado com uma chave API (assinaturas HMAC também são suportadas)
• Gatilho API—seu sistema interno usa uma chave API para chamar a API REST e iniciar uma execução

Actualização do modelo: acompanhar as novas versões do modelo

Uma cópia clonada não é automaticamente alterada por atualizações de modelo. Quando o modelo de origem enviar uma nova versão e você quiser segui-la, use o Upgrade from Template flow: review a preview, em seguida, atualize com um clique.

Onde encontrá-lo

Você pode alcançá-lo em dois lugares: Atualização do Modelo no menu da barra de ferramentas do editor, ou o prompt Verificar atualização acima da seção de variáveis no painel de configurações de workflow. A janela que se abre mostra as versões actual e alvo.

Rever a antevisão antes de actualizar

A pré-visualização divide as diferenças variáveis em três categorias e as lista uma a uma:

• Reserva — Variáveis que você já alterou que ainda existem no novo modelo – seus valores são mantidos após a atualização
• Novo — Variáveis recentemente adicionadas no novo modelo – cheias com os padrões do modelo, para ajustar conforme necessário após atualização
• Apagar — Variáveis que não existem mais no novo template—descartado após a atualização. Assinale esta lista item por item antes de confirmar

O que acontece durante a atualização

• O workflow atual é primeiramente gravado automaticamente como um instantâneo de versão, para que você possa voltar do menu Versões se você mudar de ideia
• Configuração estrutural — o passo DAG, prompts do Agente, código, timeouts e afins — é substituído pelo novo modelo
• Os modelos que você escolheu são preservados: para Agentes com o mesmo nome, sua seleção de modelos e sua referência credencial de modelo não são substituídos pelo novo modelo
• Configurações que pertencem a você - nome do workflow, tags, concorrência, e assim por diante - ficam intocadas

Workflow antigo sem nenhum modelo de fonte gravado?

Os workflows clonados no início podem não ter nenhuma fonte gravada, neste caso o mesmo item no menu editor aparece como Modelo de Ligação. Registre de que modelo veio (e opcionalmente marque qual versão corresponde atualmente), e o fluxo de atualização funciona normalmente a partir de então.

Avançado: deixe o assistente de IA alterá-lo de acordo com sua descrição

Após a clonagem, se os requisitos de negócios não forem totalmente consistentes com o modelo, você pode pedir ajuda ao assistente de IA para corrigi-lo:

1. FAB no canto inferior direito abre a gaveta do assistente AI
2. Descreva suas necessidades - por exemplo "alterar step.deliver de Telegram para Feishu"
3. O assistente fornecerá uma visualização das diferenças e você poderá aceitá-la ou rejeitá-la.
4. Clique em "Aplicar" quando estiver satisfeito - a pilha de desfazer de 10 níveis protege você de reverter a qualquer momento

Quando você deve mudar para um assistente de IA ou caligrafia?

Próximo passo

• Detalhes da categoria e modelos representativos — Representantes selecionados de cada categoria da indústria dirão o que cada categoria pode fazer
• Editor Visual — Em quais botões você deve clicar após a clonagem?
• Assistente de IA — Use linguagem natural para modificar/gerar workflows