빠른 시작

이 기사에서는 코드를 작성하거나 중간에 아무것도 설치하지 않고 "단순히 웹 사이트를 여는 것"에서 "실제 작업 흐름을 통해 실행하는 것"까지 안내합니다. 따라하시면 Braidrun Workflow에서 가장 일반적으로 사용되는 거의 모든 개념을 인식하게 될 것입니다.

파노라마 미리보기: 여기서 기대할 수 있는 것

아래는 우리가 순서대로 취할 경로입니다. 각 단계에서는 단순한 작동 매뉴얼이 아닌 "이 작업을 수행하는 이유"를 설명합니다.

1. 계정등록 → 로그인
2. 기본 콘솔에 대해 알아보려면 "워크플로" 페이지로 이동하세요.
3. Clone a ready-made workflow from the template library
4. 테스트 실행으로 구조를 확인하세요.
5. LLM 키 바인딩(BYOK)
6. 한 번 실행하고 실시간 이벤트 스트림을 이해하세요.
7. 크론을 끊고 매일 자동으로 실행되도록 하세요.

1단계 · 계정 등록

1.1 등록 페이지 열기

홈페이지 우측 상단의 '로그인'을 클릭하거나, 로그인 페이지 하단의 '계정 만들기'를 클릭하거나, 직접 방문하세요. /register.

1.2 초대코드 또는 공개등록

Braidrun는 현재 초대 전용 비공개 베타 단계에 있습니다. 이는 다음을 의미합니다.

• 등록을 완료하려면 초대 코드가 필요합니다.
• 초대코드가 없으신 경우, 홈페이지 '초대코드 신청' 양식에 이메일 주소를 남겨주세요. 쿼터가 오픈되면 먼저 연락드리겠습니다.

초대코드를 받으신 후, 이메일+비밀번호+초대코드를 입력하시면 됩니다. Google/GitHub OAuth를 사용하여 한 번의 클릭으로 로그인할 수도 있습니다(이 방법은 초대 코드가 필요하지 않지만 여전히 관리자 승인을 기다려야 합니다). 자세한 절차는 다음을 참조하세요. 등록 및 로그인.

1.3 이메일 확인 및 활성화

양식을 제출하면 확인 이메일을 받게 됩니다. 계정을 활성화하려면 내부 링크를 클릭하세요. 활성화하기 전에는 페이지를 탐색할 수 있지만 워크플로를 생성/저장/실행할 수는 없습니다. 상단에 주황색 알림 배너가 표시됩니다.

2단계 · 워크플로 콘솔에 들어가기

2.1 왼쪽 기본 탐색

로그인 후 홈페이지로 이동합니다. 왼쪽에는 반드시 사용할 고정 탐색 모음이 있습니다.

• 워크플로 — 당신의 주요 전장. 모든 워크플로가 여기에 나열됩니다.
• 템플릿 — 240개 이상의 사전 구성 워크플로로, 복제 즉시 사용.
• 모듈 — 120개 이상의 재사용 가능한 모듈 + 귀하가 직접 Promote한 모듈.
• 실행 내역 — 모든 최근 실행 목록입니다.
• 일정 — 타이밍/웹후크 트리거 항목.
• 승인 — 워크플로우가 "수동 승인" 단계인 경우 승인자는 여기에서 승인합니다.
• 자격 증명 — 모든 API 키는 여기에 저장되며 암호화되어 저장됩니다.

2.2 홈 페이지로 빠르게 들어가는 세 가지 방법

홈페이지는 빈 공간이 아닙니다. 세 가지 시작점을 제공합니다.

1. 새 빈 워크플로 만들기 — 빈 캔버스로 시작하세요. 플랫폼에 이미 익숙해진 후에 선택하는 것이 좋습니다.
2. 템플릿에서 복제 — 이 가이드는 이 경로를 따릅니다. 빨리 시작하세요.
3. AI 어시스턴트가 생성하도록 하세요 — 오른쪽 하단에 있는 FAB는 측면 AI 도우미를 엽니다. 자연어를 사용하여 원하는 작업을 설명하면 첫 번째 초안이 제공됩니다.

3단계 · 템플릿 라이브러리에서 복제

3.1 귀하의 비즈니스에 가장 가까운 템플릿을 선택하세요

왼쪽으로 열다 템플릿. 왼쪽 상단에는 분류 필터가 있습니다(운영 자동화, 광고 전달, 데이터 분석, iOS 개발, 콘텐츠 생성, 규정 준수 검토...). 오른쪽 상단에 검색창과 태그 필터가 있습니다.

처음으로 다음 두 범주 중 하나를 선택하는 것이 좋습니다.

• "데일리 뉴스 다이제스트" — 논리가 간단하고 단계가 적으며 전체 데이터 흐름을 볼 수 있습니다.
• "ASA 주간 보고서" — 일정 관리 + 하위 워크플로 + Slack 제공을 사용한 실제 비즈니스 시나리오입니다.

3.2 템플릿 카드 읽기

보려면 클릭하세요:

• "설명" - 기능
• "필수 자격 증명" - 실행 시 어떤 키를 입력해야 합니까?
• "입력/출력 예" - 일반적인 결과를 나타냅니다.
• "예상 기간/비용" - 실행 비용은 대략 몇 분 정도이며 비용은 얼마입니까?

3.3 작업공간에 복제

오른쪽 상단을 클릭하세요. "이 템플릿을 사용하세요". 확인 후 플랫폼은 /workflows 아래에 독립적인 복사본이 생성됩니다. 나중에 어떻게 변경하더라도 원본 템플릿에는 영향을 주지 않습니다.

4단계 · 먼저 드라이런을 사용하여 구조를 살펴봅니다.

4.1 드라이런이 필요한 이유는 무엇입니까?

테스트 실행의 핵심 가치는 "비용 없음"입니다. 전체 DAG를 거치지만 모든 LLM 호출과 외부 부작용(메시지 전송, 데이터베이스 작성, 결제 공제 등)을 안전한 무작동으로 대체합니다. 다음을 볼 수 있습니다.

• 변수는 어디로 흘러가나요? - 인용됨 {{...}} 틀린 철자가 있나요?
• 조건에 따라 건너뛰는 단계
• 템플릿이 의존하는 자격 증명 - 자격 증명 센터에서 무엇을 구성할지 미리 알아두세요

4.2 편집기에서 테스트 실행 시작

1. 워크플로 편집기 상단에서 "실행".
2. 대화 상자에서 "모의 실행(LLM 조정 안 함/부작용 생성 안 함)"을 선택합니다.
3. 템플릿 프롬프트에 따라 일부 필수 매개변수를 입력하고 나머지는 기본값으로 둡니다.
4. "실행 시작"을 클릭하십시오. 편집기는 자동으로 실행 세부정보 보기로 전환됩니다.

5단계 · LLM 키 구성(BYOK)

5.1 BYOK란 무엇인가

"자신만의 키를 가져오세요". OpenAI/Anthropic과 같은 공급자로부터 API 키를 받아 Braidrun에 추가하면 사용자를 대신하여 호출할 수 있습니다. 혜택:

• 토큰 소비는 귀하의 LLM 계정에 직접 기록되며 플랫폼은 가격을 인상하지 않습니다.
• 플랫폼의 통합 보증 없이 Claude Opus, GPT-5와 같은 자신의 계정의 고급 모델을 사용할 수 있습니다.
• 키 순환/취소는 전적으로 귀하에게 달려 있습니다.

5.2 키 받기

가장 일반적인 것:

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

5.3 자격 증명에 저장

1. 열기 자격 증명.
2. "새 자격 증명"을 클릭합니다.
3. 유형으로 api_key를 선택하십시오. 다음과 같이 인식할 수 있는 이름을 선택하세요. openai_main、anthropic_personal;값은 공급자로부터 받은 키를 붙여넣습니다.
4. 저장합니다. 플랫폼은 즉시 AES-256-GCM을 사용하여 데이터베이스를 암호화합니다. 그 후에는 이 필드를 덮어쓸 수만 있고 다시 읽을 수는 없습니다.

더 자세한 설명(세 번째 수준 네임스페이스, 공급자 바인딩, 순환 프로세스)은 다음을 참조하세요. 자격 증명 그리고 BYOK · 자체 LLM Key 사용.

6단계 · 실제 달리기를 해보세요

6.1 실행 시작

1. 워크플로 편집기로 돌아가서 상단의 "실행"을 클릭하세요.
2. 이번에는 대화 상자에서 취소 테스트 실행을 확인하세요.
3. 필요한 매개변수를 다시 입력합니다. 일반적으로 처음 테스트 실행과 동일합니다.
4. "실행 시작"을 클릭하십시오.

6.2 오른쪽의 실시간 이벤트 스트림 이해

페이지 오른쪽은 WebSocket으로 실시간 푸시되는 이벤트 스트림입니다. 각 행은 하나의 이벤트이며, 카테고리별로 필터링할 수 있습니다:

• Agent 발언 — Agent의 중간 출력으로, group_chat 단계에서 가장 흔합니다;
• LLM 호출 — 각 모델 호출의 요약으로, 입력 / 출력 token 수를 포함합니다;
• 도구 호출 — Agent가 어느 도구를 호출했는지로, 펼치면 파라미터와 반환값을 볼 수 있습니다;
• 외부 메시지 — 워크플로가 Slack / Telegram 등 채널로 보낸 메시지 기록.

더 많은 이벤트 카테고리 설명은 실행 모니터링 및 로깅.

6.3 결과 및 제품 살펴보기

실행 후 상단의 "실행 세부정보 보기"를 클릭하세요.

• 간트 차트의 각 녹색 막대는 성공적인 단계입니다. 마우스를 올려서 시간이 얼마나 걸렸는지 확인하세요.
• 입력/출력/로그/변수 스냅샷을 보려면 단계를 클릭하세요.
• 제품 컬럼에서는 마크다운/엑셀/스크린샷 등을 미리보거나 다운로드할 수 있습니다.

7단계 ·크론을 끊고 자동으로 실행되도록 합니다.

7.1 새 일정 만들기

1. 왼쪽의 "일정관리" → "새일정".
2. 대상 워크플로로 방금 실행한 워크플로를 선택합니다.
3. 유형으로 cron을 선택하십시오. 표현을 채워주세요 0 8 * * *(매일 오전 8시); 시간대로 아시아/상하이를 선택하세요.
4. 워크플로우에 변수가 있는 경우 "매개변수 기본값"에서 이 일정 배치에 대한 기본값을 입력합니다(각 예약된 트리거는 이 값으로 시작됩니다).
5. 저장합니다. 목록에 항목이 하나 더 있으며, "다음 트리거 시간"이 실시간으로 계산되어 표시됩니다.

7.2 일정 중복을 방지하는 방법

플랫폼은 다중 인스턴스 배포에서 분산 잠금을 자동으로 수행합니다. 동일한 일정은 동일한 시간에 하나의 시스템에서만 트리거됩니다. 반복 실행에 대해 걱정할 필요가 없습니다.

타이밍 스케줄링은 간격/일회성 모드에서도 구성할 수 있습니다. 자세한 내용은 다음을 참조하세요. 예약 실행.

이 작업을 수행한 후에는 이미 방법을 알고 있습니다.

• 회원가입/로그인/이메일 인증 완료
• 템플릿 라이브러리 복제 → 편집기 테스트 실행 → 실제 실행의 기본 루프
• Credential Center의 역할과 BYOK의 중요성
• 실시간 이벤트 스트림 읽기 + 실행 상세 페이지 권한
• cron 자동 실행 입구에 워크플로를 걸어 놓습니다.

다음에 무엇을 볼 것인가

• 핵심 개념 — 워크플로우/단계/에이전트/모듈/실행/자격 증명 간의 관계를 그림으로 명확하게 설명합니다.
• 실제 전투: 첫 번째 작업흐름 — 모든 개념을 하나로 묶어서 실제 비즈니스 작업 흐름을 단계별로 작성해 보세요.
• 비주얼 편집기 — 캔버스/YAML/툴바/협업잠금/버전스냅샷을 하나씩 설명해보세요
• 모범 사례 — 또 밟은 구덩이를 밟지 마세요