FAQ
초대 코드, 청구, BYOK, 데이터 개인 정보 보호, 가져오기/내보내기에 관해 자주 묻는 질문입니다.
자주 발생하는 질문은 주제별로 그룹화되어 있습니다. If you can't find it, search for keywords first, and if that doesn't work, go to the "Troubleshooting" page to see common symptoms.
계정과 등록
등록에 초대 코드가 필요합니까?
필요 없습니다. 현재 등록이 개방되어 있으며, /register에서 이메일로 바로 등록하거나 아래의 어느 서드파티 로그인이든 사용하십시오.
국내 이메일 주소로 등록할 수 있나요?
그렇습니다. QQ / 163 / Alibaba / Tencent 기업 사서함이 테스트되었습니다. 가끔 활성화 이메일이 스팸 폴더로 이동되는 경우가 있으므로 주의 깊게 확인하시기 바랍니다.
하나의 이메일 주소로 여러 계정을 등록할 수 있나요?
아니요. 하나의 이메일 = 하나의 계정입니다. 두 개의 "개발/프로덕션" 계정 세트가 필요한 경우 + 별칭(+dev@gmail.com)을 사용하세요.
Google / GitHub / Feishu / DingTalk를 사용하여 로그인할 수 있나요?
가능합니다. Braidrun은 총 14가지 서드파티 로그인을 지원합니다: Google · GitHub · GitLab · Microsoft · Apple · Slack · LinkedIn · 위챗 · 알리페이 · 페이슈 · Lark · 딩톡 · Gitee, 그리고 OpenID Connect 표준을 준수하는 모든 기업 SSO(예: Keycloak / Authentik / Okta / Auth0). 로그인 페이지에는 현재 환경에서 활성화된 옵션만 표시됩니다.
구독 및 청구
Free Pro와 가장 큰 차이점은 무엇인가요?
무료에는 3가지 기본 단계 유형(단일/코드/분류자)만 있고 예약/웹훅/중단점 디버거/자동 연속이 없습니다. "경험"에 적합합니다. 실제 제작 시나리오에는 Pro 이상이 필요합니다.
패키지를 월별 결제와 연간 결제 간에 자유롭게 전환할 수 있나요?
그렇습니다. 계정 설정 → 결제에서 결제 주기를 전환하면 다음 결제 주기가 적용됩니다. 월별 결제에서 연간 결제로 전환하면 즉시 할인을 받을 수 있습니다. 연간 결제에서 월별 결제로 전환하는 경우 연간 결제가 이루어집니다.
청구서를 회사로 발행할 수 있나요?
그렇습니다. 중국에서는 일반 VAT 송장/특별 송장을 지원합니다. 청구서 페이지에 헤더와 세금 번호를 입력하면 각 공제가 자동으로 생성됩니다. 기업은 자금과 계약을 대중에게 이체할 수 있습니다.
할당량을 초과하면 어떻게 되나요?
기존 워크플로 및 실행은 계속 실행되며 새 워크플로 및 실행은 거부됩니다(업그레이드를 요청하는 팝업 창이 표시됨). 조기 처리를 위해서는 80% / 95% 경고를 사용하는 것이 좋습니다.
BYOK/LLM 비용
BYOK여야 하나요?
Free/Pro에는 소량의 내장 공유 풀 키 할당량이 있고 충분한 트래픽이 있습니다. 정말로 양을 늘리고 싶다면 BYOK를 권장합니다. 할당량이 더 충분하고 비용도 더 낮습니다(특히 DeepSeek를 대규모로 호출할 때).
Braidrun는 얼마를 청구하나요?
BYOK에서는 가격 인상이 없습니다. 공급자 측에서 실제로 지불하는 금액이 실제 비용입니다. Braidrun의 수익은 구독료에서 발생하며 토큰에서 수수료를 받지 않습니다.
워크플로 실행 비용이 얼마나 되는지 확인할 수 있나요?
수 있습니다. 실행 세부정보 페이지 상단에는 토큰 + 비용(공급자의 공개 가격에 따라 변환됨)이 표시됩니다. 데이터 대시보드는 일/주/월별로 집계됩니다.
공급업체가 갑자기 가격을 인상하면 어떻게 되나요?
공급자 가격표 변경 사항은 플랫폼에 의해 캡처되며 비용 견적이 업데이트됩니다. 실제 청구서는 항상 제공자 측에서 정산됩니다.
데이터 프라이버시
내 데이터가 모델을 훈련하는 데 사용됩니까?
아니요. Braidrun 자체는 어떤 모델도 훈련하지 않습니다. BYOK의 경우 데이터 대상은 선택한 공급자에 의해 결정됩니다. OpenAI/Anthropic의 기본 정책은 "훈련에 사용되지 않음"이며 해당 콘솔에서 추가로 옵트아웃할 수 있습니다.
자격 증명이 손상될 수 있나요?
자격 증명은 AES-256-GCM으로 암호화되어 자격 증명 센터에 저장됩니다. 런타임 암호 해독은 단일 단계 컨텍스트에서만 적용됩니다. 로그가 기록되지 않고, YAML 내보내기가 수행되지 않으며, 다른 단계가 표시되지 않습니다. DB 덤프에서 얻는 것은 암호문입니다.
내 워크플로 YAML은 비공개인가요?
그렇습니다. 개인 작업 흐름은 본인에게만 표시됩니다. 팀 워크플로는 역할별로 팀 구성원에게만 표시됩니다. Braidrun 직원은 생산 환경에서 사용자 작업 흐름을 볼 수 있는 백도어가 없습니다. 기업의 개인화된 배포에서는 이 계층도 클라이언트의 인트라넷에서 관리됩니다.
데이터는 어디에 존재하나요?
SaaS 버전은 홍콩/싱가포르/AWS 도쿄 지역에서 사용할 수 있습니다. Enterprise는 전적으로 고객 측에서 비공개로 배포됩니다. 자세한 내용은 "데이터 처리 계약(DPA)" 문서에서 확인할 수 있습니다.
템플릿과 가져오기 및 내보내기
템플릿이 내 작업 흐름과 어떤 관련이 있나요?
한 부를 귀하의 작업 공간으로 복제하며, 귀하의 수정은 템플릿으로 되돌아가지 않고 템플릿 업데이트도 귀하의 사본을 자동으로 바꾸지 않습니다. 다만 복제 시 "어느 템플릿의 어느 버전에서 왔는지"를 기록합니다: 템플릿이 새 버전을 배포하면 먼저 변수 차이를 미리 보고 원클릭으로 업그레이드할 수 있으며, 업그레이드 전에 버전 스냅샷을 자동 저장하고 귀하가 직접 선택한 모델 설정은 유지됩니다. 단계는 템플릿에서 인스턴스화의 「템플릿 업그레이드」 절을 참고하십시오.
Dify/Langflow/n8n에서 가져올 수 있나요?
Dify 워크플로는 원클릭 가져오기를 지원합니다(자동으로 YAML 형식으로 변환됨). Langflow 및 n8n은 현재 기본 가져오기를 지원하지 않지만 AI 도우미는 JSON 내보내기를 읽고 이를 Braidrun YAML로 "번역"할 수 있습니다.
내 워크플로를 다른 형식으로 내보낼 수 있나요?
YAML 내보내기는 가장 신뢰할 수 있는 형식입니다. 이는 Braidrun의 기본 형식이며 CLI(braidrun-agent)에서 직접 실행할 수도 있습니다. 단방향 전달 기능은 없습니다.
실행 및 스케줄링
집행이 실패하면 돈이 환불됩니까?
Braidrun는 조회당 비용을 청구하지 않으므로 환불이 필요하지 않습니다. 오류 발생 시 발생하는 LLM 토큰 소비는 공급자 계정(BYOK)에 기록됩니다. 플랫폼 문제로 인해 오류가 발생했다고 생각하는 경우 작업 주문을 제출하면 공급자에게 크레딧을 요청하는 데 도움을 드립니다.
cron 트리거가 트리거되지 않는 경우 문제를 해결하는 방법은 무엇입니까?
먼저 일정 세부정보 페이지에서 '다음 트리거 시간'을 살펴보세요. 그렇죠? "최신 트리거 기록"을 다시 살펴보세요. 조절되었는지 여부를 확인하세요. 자세한 단계는 다음을 참조하세요. 문제 해결.
여러 인스턴스를 배포할 때 cron이 두 번 트리거됩니까?
습관. 분산 잠금은 플랫폼 내부에서 사용되어 동일한 일정이 같은 분에 하나의 시스템에서만 트리거되도록 합니다. 두 노드가 동시에 동일한 실행을 부활시키는 것을 방지하기 위해 자동 재개 중에 전용 잠금도 있습니다.
서비스 재시작/OOM 이후 내 워크플로는 어떻게 되나요?
기본적으로 실행 중인 모든 실행은 중단됨으로 표시되며 "단계에서 다시 시작"을 수동으로 클릭해야 합니다. 이는 텔레그램/광고 가격 변경/이메일 전송 등 부작용이 있는 단계가 실수로 반복적으로 실행되는 것을 방지하기 위한 기본 동작입니다.
워크플로가 "순수 데이터 파이프라인"(읽기 전용 API, 순수 계산, 로컬 아티팩트 쓰기)인 경우 자동 복구를 선택할 수 있습니다. 즉, 워크플로 YAML에 Recovery.autoResumeOnRestart: true를 추가하고 재실행 가능한 각 단계에 idempotent: true를 추가합니다. 자세한 내용은 /docs/run/recovery를 참조하세요.
협업 및 마이그레이션
개인 계정을 팀으로 업그레이드하는 방법은 무엇입니까?
먼저 팀 패키지로 업그레이드 → 팀 만들기 → "기존 워크플로를 팀으로 이동"합니다. 기록 실행 기록이 함께 마이그레이션됩니다.
팀에서는 누가 무엇을 변경했는지 확인할 수 있나요?
할 수 있는. 워크플로/자격 증명/일정/승인의 모든 변경 사항은 팀 감사 로그에 기록되며 소유자/관리자 역할을 가진 팀 구성원이 볼 수 있습니다. 동시에 워크플로우 버전 기록을 통해 각 저장의 작성자를 볼 수 있습니다.
직장을 그만뒀는데 자원을 어떻게 넘겨주나요?
- 귀하가 소유자인 팀의 소유권을 후임자에게 이전합니다.
- The credentials of the personal namespace allow the successor to create a new copy under the Team namespace;
- 개인 작업 흐름을 후임자에게 내보냅니다.
- 마지막으로 개인 계정에서 로그아웃하세요.
개발자 문제
REST API가 있나요? 프로그램으로 구동할 수 있나요?
가지다. 세 가지 인증 방법:
- API 키(CI/자동화에 권장) — 계정 설정 생성, dyk_<id>_<secret> 형식, 범위별 승인(WEBHOOK_TRIGGER / WORKFLOW_EXECUTE / EXECUTION_READ 등), 만료 시간 설정 가능
- 비밀번호 로그인 전달자 JWT — 액세스(15분) + 새로 고침(7일) 토큰을 위한 POST /api/auth/login; 디버깅 중에만 사용되며 CI는 API 키를 사용합니다.
- 쿠키(브라우저) — SPA는 HttpOnly 쿠키 + CSRF를 사용합니다. 자세한 내용은 계정 설정 페이지를 참조하세요.
워크플로 내에서 플랫폼 API를 콜백해야 하는 경우(예: 내장 모듈을 통해 공개 링크 생성) 토큰을 수동으로 관리할 필요가 없습니다. 엔진이 자동으로 단기 WF_API_TOKEN 환경 변수를 주입합니다. 자세한 내용은 개발자 설명서를 참조하세요.
CLI가 지원되나요?
지원합니다. braidrun-agent CLI는 YAML을 로컬에서 실행할 수 있습니다. 웹 측의 워크플로 YAML과 100% 호환됩니다. CI 통합에 적합합니다.
로컬로 배포할 수 있나요?
Enterprise 플랜은 전체 프라이빗 배포를 지원합니다. 오픈 소스 버전은 배포자/도구와 함께 제공되며 Vultr/AWS/Aliyun 다중 클라우드 공급자, CLI + GUI 두 가지 모드를 지원하며 프로비저닝/규모/롤링-배포/롤백/규모 컨트롤러 설치를 완료할 수 있습니다. Pro/Team 플랜은 현재 Braidrun SaaS에서만 사용할 수 있습니다.
WebSocket 인증을 수행하는 방법은 무엇입니까?
핸드셰이크에서 ?ticket=<value>를 사용하여 POST /api/auth/ws-ticket을 사용하여 30초 TTL 단일 티켓을 가져옵니다. 이 티켓 프로세스는 2026-05년에 이전 Sec-WebSocket-Protocol: <JWT> 경로를 대체합니다(이전 경로는 다운그레이드 솔루션으로 유지됨). 프런트엔드 컴포저블/useExecutionWebSocket.ts가 캡슐화되었습니다.
내 POST 요청이 항상 403 csrf_token_mismatch를 보고하는 이유는 무엇입니까?
2026년 5월 8일부터 플랫폼은 기본적으로 HttpOnly Cookie + 이중 제출 CSRF 확인을 활성화합니다. 프런트 엔드 SPA는 다음을 수행해야 합니다. (1) GET /api/auth/csrf 처음 로드할 때 dy_csrf 쿠키를 가져옵니다. (2) 모든 POST/PUT/PATCH/DELETE 요청은 X-CSRF-Token 헤더에 쿠키 값을 에코합니다. (3) axios에는 withCredentials: true가 장착되어 있습니다. 시간을 측정하려면 컬을 직접 사용하십시오. 컬 -c /tmp/jar https://host/api/auth/csrf 먼저 쿠키를 가져온 다음 -b /tmp/jar 및 -H X-CSRF-Token을 가져오십시오. ....
제품 피드백
템플릿/단계 유형/통합을 추가하고 싶습니다.
계정 설정 → "제품 피드백"에 제출하시면 월별 우선순위 평가에 들어가게 됩니다. 채택된 기능은 변경 로그에 눈에 띄게 표시됩니다.
버그가 발생했습니다.
오른쪽 하단의 "도움말" 버튼을 누르면 버그 티켓이 발생하고, 브라우저 환경과 최신 실행 ID가 자동으로 첨부됩니다. 우리는 보통 24시간 이내에 응답합니다.