문서템플릿템플릿에서 인스턴스화

권장 경로 · 5분

템플릿에서 워크플로 인스턴스화

사용자의 첫 번째 워크플로우 중 90%가 템플릿에서 복제됩니다. 이 글에서는 "복제 → 업무에 따른 커스터마이징 → 온라인화"의 전 과정을 명확하게 설명하고 있습니다.

Braidrun에서는 "템플릿에서 인스턴스화"가 가장 주류인 워크플로 생성 방법입니다. 90% 이상의 사용자가 화이트보드에서 첫 번째 워크플로를 작성하지 않고 템플릿에서 하나를 복제한 다음 자신의 비즈니스에 따라 조정합니다. 이 문서에서는 프로세스를 모든 버튼으로 분류합니다.

워크플로를 생성하는 세 가지 방법 비교

템플릿에서 인스턴스화(이 페이지) — ⭐ 추천합니다. 5분 안에 달리기를 시작할 수 있으며, 전문가들이 당신을 위해 모든 함정을 채워주었습니다.
AI 비서 자연어 생성 — 적합한 템플릿을 찾을 수 없는 경우 AI가 귀하의 설명에 따라 첫 번째 초안을 제공한 다음 이를 구체화할 수 있습니다.
처음부터 손으로 쓴 — 위의 어느 것도 해당되지 않는 경우에만 선택하세요. 플랫폼에 매우 익숙해지면 고려해 보세요.

전체 프로세스 개요

템플릿 라이브러리를 탐색하고 카테고리/태그/검색별로 하나를 선택하세요.
전제 조건과 예상 비용을 확인하려면 템플릿 세부정보 카드를 읽어보세요.
"이 템플릿 사용"을 클릭하여 작업공간에 복제하세요.
에디터의 변수 설명에 따라 비즈니스 매개변수를 변경합니다.
자격증명 센터에서 키를 작성하세요.
먼저 테스트를 통해 구조를 확인한 후 다시 실행합니다.
요청 시 바인딩 예약/웹후크 트리거

1단계 · 템플릿 갤러리 탐색

1.1 입구를 열어라

왼쪽의 기본 탐색은 "템플릿 라이브러리"입니다. 페이지 구조:

상단 필터 표시줄 - 10개 산업 카테고리 + 태그 + 키워드 검색
템플릿 카드 그리드 - 이름, 설명, 태그, 예상 기간, 복잡성 표시
오른쪽 상단의 "내 컬렉션" - 장기 템플릿을 수집하여 다음 번에 직접 입력할 수 있습니다.

1.2 일반적인 선택 전략

요구 사항은 매우 구체적입니다. — 키워드를 직접 검색해보세요. 예를 들어 "TestFlight 인증서 만료 알림"을 수행하려는 경우 인증서 만료를 검색하면 즉시 잠깁니다.
수요가 광범위하다 — 업계 최초 기반의 융합. 가장 친숙한 산업 카테고리를 선택하고 두세 페이지를 넘기면 우리가 어떤 유형의 프로세스를 보유하고 있는지 대략적으로 알아볼 수 있습니다.
"업계의 다른 사람들이 무엇을 하는지 보고 싶습니다" — "복잡성"을 기준으로 정렬하고 가장 복잡한 것을 선택합니다. 이는 일반적으로 엔드투엔드 성숙한 관행을 나타냅니다.

2단계 · 템플릿 세부정보 읽기

템플릿 카드를 클릭하여 다음 네 부분에 초점을 맞춘 세부정보 페이지로 들어갑니다.

2.1 "설명" 섹션

두세 단락으로 해결되는 문제, 가장 적합한 시나리오, 적합하지 않은 시나리오, 사용 전에 필요한 준비 사항을 설명합니다.

2.2 "필수 자격 증명" 목록

이 워크플로를 실행하는 데 필요한 자격 증명을 명확하게 나열합니다. 예를 들면 다음과 같습니다.

openai_api_key — OpenAI API 키(필수)
slack_webhook_url — 텔레그램 봇 토큰(배송용, 선택사항)
apple_appstoreconnect — App Store Connect JWT(Apple 관련 템플릿에만 필요)

"필수" 자격 증명 중 하나가 누락된 경우 해당 단계에 도달하면 워크플로가 실패합니다. "선택사항"이 누락된 경우 조건에 따라 해당 단계를 건너뜁니다.

2.3 "예상 시간과 비용"

완전한 실행:

소요 시간 - 2분 / 15분 / 1시간(워크플로 복잡성 및 외부 종속성 응답 속도에 따라 다름)
토큰 사용량 - 평균 xxx 입력/xxx 출력
$ 추정 - 플랫폼의 기본 사전 설정 및 OpenAI 단가를 기준으로 계산된 대략적인 값

2.4 "입력 예 및 출력 예"

특정 입력 샘플(복사하여 한 번만 실행할 수 있음) + 해당 출력 샘플(따라서 "아마 무엇을 얻을 수 있는지"에 대한 아이디어를 얻을 수 있음)

3단계 · 작업공간에 복제

오른쪽 상단 모서리 지점 "이 템플릿을 사용하세요".
팝업 창에서 복사본에 이름을 지정합니다(기본값은 템플릿 이름 + 타임스탬프이며 비즈니스에 더 의미 있는 이름으로 변경할 수 있음).
대상 팀을 선택하세요(여러 팀에 속해 있는 경우). 이 워크플로를 보거나 편집할 수 있는 사람이 결정됩니다.
확인을 클릭하세요. 플랫폼이 귀하를 위해 사본을 생성합니다. 독립 사본, 사용자의 수정 사항은 템플릿에 반영되지 않으며, 이후 템플릿 업데이트도 사용자의 복사본을 자동으로 변경하지 않습니다.

템플릿 버전과 사본 버전

복제하는 순간 '어떤 템플릿의 어떤 버전에서 복제했는지'가 기록됩니다. 이후 템플릿에 새 버전이 배포되면 편집기에서 먼저 변경 사항을 미리 보고 원클릭으로 업그레이드할 수 있습니다. 이 페이지 하단의 '템플릿 업그레이드' 절을 참고하세요.

4단계 · 비즈니스 매개변수 사용자 정의

4.1 변수 섹션은 주의 깊게 살펴봐야 할 유일한 곳입니다.

편집기가 열리면 먼저 YAML을 통해 상단의 변수 섹션으로 스크롤합니다. "비즈니스 상황에 따라 이 워크플로에서 조정해야 하는 모든 사항"이 여기에 있으며 이미 설명되어 있습니다.

yaml

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 설명에 따라 기본값 변경

기본값은 단지 "예"일 뿐이므로 귀하의 비즈니스에서 실제 값으로 바꾸십시오. 변수를 변경해도 구조가 파괴되지 않으므로 자유롭게 변경하십시오.

4.3 무리하게 움직이지 않는 것이 좋은 습관이다

템플릿을 처음 실행할 때 단계 섹션의 구조를 변경하는 것은 권장되지 않습니다. 먼저 기본 프로세스로 한 번 실행하고 데이터 흐름을 확인한 후 변경 여부를 결정합니다.

5단계 · 자격 증명 센터 완료

자격 증명 센터를 엽니다.
템플릿 세부정보 페이지에 나열된 각 "필수" 자격 증명에 해당하는 자격 증명을 만듭니다. 이름은 YAML에 인용된 이름과 정확히 동일해야 합니다.
지금은 "선택적" 자격 증명을 생성하지 않은 상태로 둘 수 있습니다. 관련 단계는 건너뜁니다.

일반적인 함정: 자격 증명 이름을 기반으로 한 철자법

YAML에 인용된 이름은 자격증명 센터의 이름과 정확히 동일해야 합니다(대소문자 구분, 밑줄/대시 구분). "credential_not_found" 오류의 절반 이상이 철자 문제입니다.

6단계 · 먼저 테스트 실행 후 실행

6.1 드라이런의 의미

테스트 실행은 모든 LLM 및 부작용을 건너뛰고 비용 없이 DAG를 통해 실행됩니다. 돈을 쓰기 전에 확인하는 데 도움이 됩니다.

모든 변수가 올바르게 입력되었나요?
단계 간 변수 흐름
조건/분류자의 분기가 올바르게 선택되었습니다.
종속 자격 증명 이름은 다음으로 확인될 수 있습니다.

6.2 실제 실행

테스트 실행을 통과한 후 테스트 실행을 선택 취소하고 다시 "실행"을 클릭하세요. 이번에는 실제로 LLM을 조정하고 실제 부작용이 발생하게 됩니다. 페이지 오른쪽의 실시간 이벤트 스트림을 통해 각 단계의 진행 상황을 확인할 수 있습니다.

6.3 달리기 후 지켜봐야 할 것

"실행내역 보기" - 간트차트 + 각 단계의 입출력
"제품 열" - 생성된 마크다운/엑셀/이미지를 직접 다운로드할 수 있습니다.
"토큰/비용"---이번에는 얼마를 쓰셨나요?

7단계 · 필요에 따라 트리거 바인딩

수동 실행 후 워크플로를 온라인으로 전환할 수 있습니다. 세 가지 일반적인 트리거 방법:

예약 실행 — 매일/주간/월간 또는 간격으로 반복
Webhook 트리거 — 외부 시스템이 POST로 보내 트리거하며, API Key로 인증합니다(HMAC 서명도 호환됩니다)
API 트리거 — 내부 시스템이 API Key로 REST API를 호출하여 실행을 시작합니다

템플릿 업그레이드: 템플릿의 새 버전 반영

복제한 복사본은 템플릿 업데이트로 자동 변경되지 않습니다. 원본 템플릿에 새 버전이 배포되고 이를 반영하려면 '템플릿에서 업그레이드' 절차를 사용하세요. 먼저 미리 보기를 확인한 뒤 원클릭으로 업그레이드합니다.

진입 위치

두 곳에서 진입할 수 있습니다. 편집기 도구 모음 메뉴의 '템플릿에서 업그레이드', 또는 워크플로 설정 패널 변수 영역 위쪽의 '업그레이드 확인' 안내입니다. 열리는 대화 상자에는 현재 버전과 대상 버전이 표시됩니다.

업그레이드 전에 미리 보기 확인

미리 보기는 변수 차이를 세 가지로 나누어 하나씩 나열합니다:

예약 — 이미 수정했고 새 템플릿에도 여전히 존재하는 변수는 업그레이드 후 사용자의 값을 유지합니다
새로운 — 새 템플릿에 추가된 변수는 템플릿 기본값이 채워지며, 업그레이드 후 필요에 따라 조정합니다
삭제 — 새 템플릿에 더 이상 존재하지 않는 변수는 업그레이드 후 삭제됩니다. 확인 전에 이 목록을 항목별로 점검하세요

업그레이드 시 일어나는 일

먼저 현재 워크플로를 버전 스냅샷으로 자동 저장하며, 취소하고 싶으면 '버전' 메뉴에서 되돌릴 수 있습니다
단계 DAG, Agent prompt, 코드, 타임아웃 등 구조적 설정은 새 템플릿으로 덮어씁니다
직접 선택한 모델은 유지됩니다. 같은 이름 Agent의 모델 선택과 해당 모델 자격 증명 참조는 새 템플릿으로 덮어쓰지 않습니다
워크플로 이름, 태그, 동시 실행처럼 사용자에게 속한 설정은 변경되지 않습니다

다음 경우에는 업그레이드가 차단됩니다

아직 종료되지 않은 실행이 있는 경우 — 완료되거나 취소된 뒤에 업그레이드하세요
이미 최신 템플릿 버전인 경우 — 할 작업이 없습니다
원본 템플릿이 제거된 경우 — 사용자의 복사본은 영향을 받지 않으며 그대로 실행하면 됩니다

오래된 워크플로에 출처 템플릿이 기록되지 않았나요?

초기에 복제한 워크플로에는 출처가 등록되지 않았을 수 있으며, 이때 편집기 메뉴의 같은 항목이 '템플릿 연결…'로 표시됩니다. 어떤 템플릿에서 왔는지 등록하면(현재 어느 버전에 해당하는지도 함께 표시할 수 있습니다) 이후 정상적으로 업그레이드 절차를 진행할 수 있습니다.

고급: AI 도우미가 설명에 따라 변경하도록 합니다.

복제 후 비즈니스 요구 사항이 템플릿과 완전히 일치하지 않는 경우 AI 도우미에게 문제 해결을 요청할 수 있습니다.

오른쪽 하단의 FAB는 AI 보조 서랍을 엽니다.
요구 사항을 설명하세요. 예를 들어 "Telegram에서 Feishu로 step.deliver 변경"을 설명하세요.
어시스턴트가 차이점 미리보기를 제공하며 이를 수락하거나 거부할 수 있습니다.
만족스러우면 "적용"을 클릭하세요. 10레벨 실행 취소 스택은 언제든지 롤백되지 않도록 보호합니다.

언제 AI 비서나 필기로 전환해야 할까요?

장면	제안된 방법	이유
비즈니스 시나리오는 일반적이며 해당 템플릿이 있습니다.	템플릿에서 인스턴스화	전문가가 설계한 5분 만에 실행
장면에 템플릿이 있지만 큰 변경이 필요합니다.	템플릿 + AI 비서	구조가 복사되고 세부 사항이 AI에 의해 조정됩니다.
장면이 독특하고 적합한 템플릿이 없습니다.	AI 비서 자연어 생성	요구 사항 설명 → 첫 번째 초안 얻기 → 구체화
귀하는 이미 플랫폼에 대해 완전히 알고 있습니다.	필기 YAML	모든 분야에 대한 정밀한 제어

다음 단계

분류 세부정보 및 일반적인 템플릿 — 각 산업 카테고리에서 선정된 대표자들이 각 카테고리가 무엇을 할 수 있는지 알려드립니다.
비주얼 편집기 — 복제 후 어떤 버튼을 클릭해야 합니까?
AI 어시스턴트 — 자연어를 사용하여 워크플로 수정/생성