문서참조하다문제 해결

문제 해결

워크플로 실행 실패, 저장할 수 없음, 타이밍이 트리거되지 않음, 승인 알림이 수신되지 않음 - 일반적인 증상 목록입니다.

"당신이 보는 증상"에 의해 정리되었습니다. 가장 가까운 수리점을 빠르게 찾아 "수리 방법"을 따르십시오. 수정할 수 없는 경우 "FAQ"로 이동하거나 작업 주문을 제출하세요.

실행관련

실행은 PENDING 상태를 유지하고 RUNNING 상태를 유지합니다.

먼저 확인하세요:

'실행 기록' 상단에 '동시 실행 한도 도달' 안내가 있는지 확인하세요. 동시 실행은 Free 1 / Pro 5 / Team 15입니다 — 동시에 실행 중인 수가 한도에 도달했나요?
이 워크플로의 manual_approval 단계가 앞쪽에 붙어 있는지 확인하세요.
30초 정도 더 기다리십시오. 가끔은 잠시 기다리기도 합니다. 2분 이상 후에 작업 주문이 PENDING(보류) 상태가 됩니다.

실행 실패: credential_not_found

해결 방법:

error_message에 표시된 자격 증명 이름을 확인하세요.
Open Credential Center - 이 이름의 자격 증명이 실제로 존재합니까? 대문자, 밑줄/대시는 일관되어야 합니다.
"팀 네임스페이스"에 자격 증명을 만들었지만 현재 뷰어 역할을 맡고 있습니까? 뷰어는 자격 증명을 참조할 수 없습니다.
목록에 항목이 있지만 구문 분석되지 않았습니다. 로그아웃한 후 다시 로그인하여 권한을 새로 고치세요.

실행 실패: rate_limit_exceeded

이유:귀하 또는 플랫폼의 LLM 제공자 현재 제한이 트리거됩니다.

해결 방법:

실패한 단계에 재시도 전략을 추가합니다.

yaml

- id: call_llm
  type: single
  agent: writer
  retry:
    max_attempts: 3
    backoff: exponential
    initial_delay_ms: 2000
    retry_on: [rate_limit, http_5xx]

rate_limit를 자주 사용하는 경우 BYOK에서 공급자 계정 계층을 업그레이드하는 것이 기본적인 솔루션입니다.
많은 작업을 일괄적으로 실행하는 경우 sub_workflow + max_parallel을 사용하여 동시성을 제어합니다.

실행 실패: 시간 초과

이유:단일 단계가 시간 초과 값을 초과하거나 전체 실행이 워크플로 수준 시간 초과를 초과합니다.

해결 방법:

code step: step에 timeout 필드를 명시적으로 추가합니다(단위는 초, 기본값 30).
LLM 단계: 모델 생성이 너무 길 수 있습니다. max_tokens를 줄이거나 더 빠른 모델을 사용하세요.
전체 작업 흐름이 느립니다. 상단에 시간 초과 필드를 추가합니다(초 단위, 기본값 3600).

에이전트 출력이 비어 있거나 비합리적입니다.

먼저 확인하세요:

실행 세부정보 → 이 단계를 클릭하세요. → "에이전트 도구_호출 내역"을 확인하여 잘못된 도구로 연결되었는지 확인하세요.
입력 변수가 비어 있는지 확인하십시오. 조건에 따라 업스트림 단계를 건너뛰었나요?
온도 조정: 추론/분류 작업의 경우 0–0.3; 창의성은 0.6~0.9입니다.
작업 설명과 보다 구체적인 몇 가지 예시를 제공합니다.
더 강력한 모델(claude-opus-4-7 / gpt-5)로 변경해 보세요.

코드 단계에서는 권한 거부 또는 네트워크 오류를 보고합니다.

코드 단계는 격리 샌드박스에서 실행되며 다음과 같은 제한 사항이 있습니다.

파일 시스템은 읽기 전용입니다. /tmp만 쓰기 가능합니다.
네트워크는 나갈 수만 있고 들어갈 수는 없습니다(포트를 모니터링할 수 없음).
CPU/메모리/런타임이 제한됩니다.

해결 방법:권한 거부는 일반적으로 /tmp - /tmp/something 이외의 경로에 쓰려고 한다는 의미입니다. 대부분의 네트워크 오류는 대상 호스트를 차단하는 샌드박스로 인해 발생합니다(플랫폼에 송신 허용 목록이 있음). 작업 주문을 제출하여 화이트리스트를 추가할 수 있습니다.

저장 및 편집 관련

저장 시 "YAML이 DAG와 일치하지 않습니다"라는 메시지가 나타납니다.

이는 YAML을 수동으로 변경한 후 왕복 규칙이 충족되지 않음을 의미합니다. 일반적인 이유:

사용된 camelCase 필드 이름(snake_case여야 함)
삭제된 사전 설정 또는 에이전트를 참조합니다.
종속_온이 존재하지 않는 단계 ID를 가리킵니다.

"확인" 버튼을 클릭하면 정확한 줄 번호가 제공됩니다. 오류 위치에 따라 수정하세요.

편집기를 열 수 없습니다/계속 원을 그리며 회전합니다

새로고침하세요. 일반적으로 일시적입니다.
"xxx가 편집 중입니다"라고 표시된 상태 표시줄을 살펴보세요. 다른 사람이 편집 잠금을 보유하고 있습니다. 5분 동안 아무런 조작이 없으면 자동으로 해제되거나 상대방에게 연락됩니다.
관리자는 팀 설정에서 "강제 잠금 해제"할 수 있습니다.
브라우저 캐시를 지우고 브라우저를 변경하여 테스트하세요.

AI비서가 준 차이는 적용 후 검증에 실패했습니다.

Ctrl / Cmd + Z로 되돌리기 — 편집기는 여러 단계 실행 취소를 지원합니다. 그런 다음 오류 메시지와 원본 YAML을 어시스턴트에 다시 붙여 넣으면 수정해 줍니다.

스케줄링/웹훅 관련

cron 해당 시점에는 실행되지 않았습니다.

일정 세부정보 페이지의 '다음 트리거 시간'이 예상과 일치하나요? 시간대 불일치가 가장 일반적인 원인입니다.
"최근 10개의 트리거 내역"에 대한 기록이 있습니까? 그렇지 않은 경우 워크플로가 보관되었거나 삭제되었을 수 있습니다.
워크플로 상태를 살펴보세요. 일시 중지되었나요? 일시 중지 일정은 계속 계산되지만 실제로 실행되지는 않습니다.
"지금 한 번 트리거" 버튼을 사용하여 워크플로 자체를 수동으로 확인하는 것은 괜찮습니다.

Webhook 트리거는 401/403을 반환합니다.

API Key 방식: Authorization: Bearer 또는 X-API-Key 헤더에 담긴 key가 맞나요? key가 만료되었거나 WEBHOOK_TRIGGER 범위가 없지는 않나요?
HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
URL path의 webhook ID를 올바르게 작성했나요? 해당 workflow가 삭제되지는 않았나요?

Webhook 200을 트리거했지만 실행이 시작되지 않습니다.

200은 "요청 수락"만을 의미하며 실행이 거부될 수 있습니다.

워크플로가 일시 중지되었는지 여부
이 패키지가 동시성/예약 할당량에 도달하는지 여부.
본문이 변수에 매핑되었을 때 확인에 실패했습니다(필수 필드가 누락되었거나 유형이 잘못됨).

웹훅 트리거 로그 - 일정 세부정보 페이지의 '내역' 탭에서 요청 수신 후 플랫폼 분석 세부정보를 확인할 수 있습니다.

승인 관련

manual_approval은 알림을 푸시하지 않습니다.

"알림 구성" 페이지는 Slack/Feishu/Email의 모든 채널에 바인딩되어 있나요?
감사 로그 → 필터 승인_notify_failed - 알림을 보낼 수 없는 이유를 확인하세요(웹훅 URL이 잘못되었나요? 이메일이 반송되나요?).
승인자 목록이 비어 있으면 기본적으로 "모든 관리자 이상"에게 알림이 전송됩니다. 귀하의 계정이 그 중 하나입니까?

승인했지만 워크플로가 계속되지 않았습니다.

승인 후 워크플로는 10초 이내에 계속되어야 합니다. 1분 이상 계속되지 않았습니다.

실행 세부정보 페이지를 새로 고칩니다. 이미 실행 중인가요?
시스템이 사용 중이어서 30초 동안 대기할 수 있습니다.
5분 이상 경과 후 작업지시를 올립니다.

팀/권한 관련

팀을 전환한 후 워크플로를 볼 수 없습니다

워크플로는 팀별로 격리되며 팀 전체에 표시되지 않습니다. 올바른 팀을 선택했는지 확인하세요(오른쪽 상단 모서리를 아래로 내리세요). "개인"에서 "팀"으로 전환하는 경우 팀에서 워크플로를 다시 생성하거나 개인에서 이동해야 합니다.

동료들이 특정 워크플로를 변경할 권한이 없다고 말합니다.

그 사람이 이 팀의 뷰어인가요? 뷰어는 읽기 전용입니다. 그를 관리자에서 편집자로 업그레이드하면 됩니다.

소유자는 아니지만 내가 만든 워크플로를 이전하고 싶습니다.

"팀으로 이동"을 위해서는 대상 팀의 편집자 이상이어야 합니다. 그냥 목표 팀에 직접 합류하세요.

지불/청구

신용카드 청구 실패

결제 페이지 → '인출 재시도'. 3번 실패하면 패키지가 일시적으로 무료로 다운그레이드됩니다. 14일 이내에 금액을 성공적으로 공제하면 자동으로 복원됩니다.
중국 카드는 Stripe에 의해 위험 통제될 수 있습니다. Alipay/WeChat Pay를 사용하십시오.

청구서 제목이 잘못되었습니다.

다음 달 청구서 발행 전에 청구 페이지에서 상호를 변경할 수 있습니다. 이미 발행된 인보이스는 billing@braidrun.com으로 이메일을 보내 취소 후 재발행을 신청해야 합니다.

모든 것을 시도했지만 여전히 작동하지 않습니다

오른쪽 하단의 "도움말" → 작업 주문서를 제출하세요. 브라우저 컨텍스트 + 최신 실행 ID를 자동으로 첨부합니다.
Enterprise Plan → 전담 CSM에 직접 문의하세요.