제품 개요

실제 워크플로우 하나를 따라가며 플랫폼 전체를 둘러봅니다

Braidrun은 사람의 승인이 포함된 AI 워크플로우를 구성하고 실행하는 데 쓰입니다. 오른쪽의 이 성장 일일 리포트는 매일 운영 환경에서 실행됩니다. cron이 시각에 맞춰 트리거하면 Apple Search Ads와 Google Ads의 지출과 구독 수익을 가져오고, AI가 코멘트를 작성하며, xlsx를 생성해 Slack으로 전송합니다. 이를 따라가다 보면 플랫폼의 각 부분이 한 번씩 등장합니다.

무료로 시작하기 실제 사례 보기 →

운영 템플릿 v2.0.74예약 트리거, 무인 실행단계별 로그와 비용을 보관

daily-growth-reportcron 0 8 * * *

fetch_ads_spend

Apple Search Ads와 Google Ads의 전일 지출을 가져오기

fetch_revenue

구독 수익을 가져와 지출과 같은 날짜로 맞추기

ai_commentary

AI가 당일 코멘트를 작성: 전기 대비, 전주 동기 대비, 전월 동기 대비

build_xlsx

xlsx 리포트 첨부 파일 생성

deliver_slack

표와 코멘트를 팀 Slack 채널로 전송

template v2.0.74무인 실행

01워크플로우 구성

캔버스와 YAML은 동일한 정의입니다

이 일일 리포트는 처음에 에디터에서 구성했습니다. 왼쪽은 캔버스, 오른쪽은 YAML이며, 어느 한쪽을 수정하면 다른 쪽이 즉시 동기화됩니다. 어떻게 수정할지 명확히 설명하기 어려울 때는 요구 사항을 AI 어시스턴트에게 직접 알려주면 됩니다.

캔버스 ⇄ YAML 양방향 동기화: 운영 담당자는 캔버스를 보고 엔지니어는 YAML을 검토하지만, 동일한 정의입니다
기본 진단: 변수 참조 오류, 설정 누락을 저장 전에 표시합니다
버전 이력에 diff가 함께 제공되어, 잘못 수정했을 때 이전에 정상 실행되던 버전으로 롤백할 수 있습니다
AI 어시스턴트와 대화하며 구성하고, 변경 사항은 예외 없이 여러분이 저장을 클릭해야 적용됩니다

에디터와 AI 어시스턴트 보기 →

Braidrun 워크플로 편집기 스크린샷 — 비주얼 에디터: 캔버스와 YAML을 한 화면에서 편집

02단계 편성

8가지 단계 유형으로 더 복잡한 프로세스를 조립합니다

일일 리포트에 쓰이는 것은 코드 단계와 단일 Agent 코멘트뿐입니다. 단계 유형은 모두 8가지입니다. 여러 Agent가 서로 오류를 지적하게 하거나, 상태에 따라 진행하거나, 워크플로우 전체를 하나의 단계로 재사용하려면 type만 바꾸면 됩니다.

싱글하나의 Agent가 지시에 따라 한 단계를 완료하며, 일일 리포트의 AI 코멘트가 바로 이것입니다
코드샌드박스에서 스크립트 실행: 데이터 가져오기, 정제, 파일 생성
분류자입력 내용에 따라 실행을 서로 다른 분기로 분류합니다
group_chat여러 Agent가 하나의 문제를 놓고 여러 차례 토론해 결론을 도출합니다
agent_based코디네이터 Agent가 어떤 도구와 하위 작업을 호출할지 동적으로 결정합니다
state_machine명시적 상태와 전이로 여러 단계의 프로세스를 기술합니다
sub_workflow다른 워크플로우를 하나의 단계로 호출합니다
workflow_output_read다른 워크플로우의 실행 결과를 읽어 이어서 처리합니다

daily-growth-report.yamlyaml

steps:
  - name: pull_spend
    type: sub_workflow      # 다른 데이터 수집 워크플로우를 재사용
    workflow: ads-spend-fetcher

  - name: review_numbers
    type: group_chat        # 여러 Agent가 데이터를 두고 서로 오류를 지적
    agents: [analyst, skeptic]
    rounds: 2

  - name: plan_actions
    type: agent_based       # 코디네이터 Agent가 필요에 따라 도구를 호출

  - name: apply_changes
    type: code
    manual_approval: true   # 사람이 승인해야 실행

03트리거와 실행

cron이 시각에 맞춰 실행되고, 스크립트는 샌드박스에서 실행됩니다

이 일일 리포트는 5필드 cron 표현식으로 트리거되며, 시간대를 설정할 수 있고, 다중 인스턴스 배포 시 분산 락이 한 번만 트리거되도록 보장합니다. 데이터를 가져오고 표를 생성하는 스크립트는 운영 환경에서 Docker 샌드박스에서 실행되며, 변수는 WF_VAR_* 환경 변수로 주입됩니다.

예약: 5필드 cron + 시간대, 분산 락으로 다중 인스턴스의 중복 트리거를 방지
Webhook: 여러분의 시스템에서 POST를 한 번 보내면 JSON 최상위 필드가 자동으로 변수에 매핑됩니다
수동과 API: 페이지에서 실행을 클릭하거나, 외부 시스템에서 v1 API를 호출해 트리거합니다
체인: 하나의 워크플로우가 완료된 후 N초 뒤에 다음 워크플로우를 자동으로 트리거합니다
코드 단계는 python, javascript, typescript, bash, ruby, lua, cli 일곱 가지 언어를 지원하며, 기본 30초 타임아웃이 적용됩니다

트리거와 연동 보기 →

triggerscron · webhook · api · chain

# 예약: 매일 아침 8시, 시간대 설정 가능
schedule: "0 8 * * *"

# 또는 여러분의 시스템에서 POST를 한 번 보내 트리거
curl -X POST \
  https://braidrun.com/api/webhooks/{id}/trigger \
  -H "X-API-Key: <your-key>" \
  -d '{"channel": "#growth-daily"}'

04관찰과 문제 해결