Bỏ qua nội dung chính
DocsTham chiếuTên

Tên

Một hướng dẫn cho các triệu chứng thông thường: chạy công việc thất bại, tiết kiệm lỗi, bỏ lỡ lịch trình và thông báo thiếu thông báo.

Tổ chức theo "triệu chứng bạn thấy". Nhanh chóng định vị mục gần nhất, làm theo phần "cách sửa". Không sửa được thì sang "Câu hỏi thường gặp" hoặc gửi ticket.

Liên quan đến thực thi

Việc thực thi tiếp tục ĐANG CHỜ và vẫn CHẠY.

Kiểm tra đầu tiên:

  1. Kiểm tra đỉnh của Lịch sử Tử hình cho một thông báo có giới hạn nhất trí. Tự do là 1 đồng thời, Pro 5, nhóm 15 có số của bạn chạy đồng thời đến giới hạn?
  2. Kiểm tra xem bước phê duyệt thủ công của workflow này có bị kẹt ở phía trước hay không.
  3. Hãy để nó đợi thêm 30 giây nữa - thỉnh thoảng là ngay lập tức. Lệnh sản xuất đang ĐANG XỬ LÝ sau hơn 2 phút.

Thực thi không thành công: credential_not_found

Cách khắc phục:

  1. Xem tên thông tin xác thực được nhắc trong error_message.
  2. Trung tâm thông tin xác thực mở - Thông tin xác thực có tên này có thực sự tồn tại không? Cách viết hoa, dấu gạch dưới/dấu gạch ngang phải nhất quán.
  3. Có phải bạn tạo thông tin xác thực trong "không gian tên team" nhưng hiện là vai trò Viewer? Viewer không tham chiếu được thông tin xác thực.
  4. Có nội dung nào đó trong danh sách nhưng chưa được phân tích cú pháp - hãy đăng xuất và đăng nhập lại để làm mới quyền.

Thực thi không thành công: rate_limit_exceeded

Lý do:Giới hạn hiện tại của Nhà cung cấp LLM của nền tảng hoặc của bạn được kích hoạt.

Cách khắc phục:

  1. Thêm chiến lược thử lại vào bước thất bại:
yaml
- id: call_llm
  type: single
  agent: writer
  retry:
    max_attempts: 3
    backoff: exponential
    initial_delay_ms: 2000
    retry_on: [rate_limit, http_5xx]
  1. Nếu bạn thường đánh giá_limit, BYOK nâng cấp Cấp tài khoản Nhà cung cấp là giải pháp cơ bản.
  2. Khi chạy nhiều tác vụ theo đợt, hãy sử dụng sub_workflow + max_parallel để kiểm soát đồng thời.

Thực thi không thành công: hết thời gian chờ

Lý do:Một bước vượt quá giá trị thời gian chờ của nó hoặc toàn bộ quá trình thực thi vượt quá thời gian chờ ở cấp độ quy trình làm việc.

Cách khắc phục:

  • bước mã: thêm một trường thời hạn rõ ràng trên bước (theo giây, mặc định 30).
  • Bước LLM: Có thể do quá trình tạo mô hình quá dài; giảm max_tokens hoặc sử dụng mô hình nhanh hơn.
  • Toàn bộ quy trình làm việc chậm: thêm trường thời gian chờ ở trên cùng (tính bằng giây, mặc định là 3600).

Đầu ra Agent trống/không hợp lý

Kiểm tra đầu tiên:

  1. Chi tiết thực thi → bấm step này → xem "lịch sử tool_call của Agent", có bị dẫn sang công cụ sai không.
  2. Kiểm tra xem biến đầu vào có trống không - bước ngược dòng có bị điều kiện bỏ qua không?
  3. Điều chỉnh nhiệt độ: 0–0,3 cho các nhiệm vụ suy luận/phân loại; 0,6–0,9 cho khả năng sáng tạo.
  4. mô tả nhiệm vụ cộng với các ví dụ cụ thể hơn về một số cảnh quay.
  5. Hãy thử thay đổi sang mô hình mạnh hơn (claude-opus-4-7/gpt-5).

Bước mã báo cáo quyền bị từ chối hoặc lỗi mạng

Bước mã chạy trong một hộp cát biệt lập, với hạn chế:

  • Hệ thống tập tin ở chế độ chỉ đọc - chỉ /tmp mới có thể ghi;
  • Mạng chỉ ra được chứ không vào được (không giám sát được cổng);
  • CPU/bộ nhớ/thời gian chạy bị giới hạn.

Cách khắc phục:quyền bị từ chối thường có nghĩa là thay vào đó bạn đang cố gắng ghi vào một đường dẫn khác /tmp - /tmp/something. Hầu hết các lỗi mạng là do hộp cát chặn máy chủ mục tiêu của bạn (nền tảng có danh sách trắng đầu ra). Bạn có thể gửi lệnh sản xuất để thêm danh sách trắng.

Lưu và chỉnh sửa liên quan

Khi lưu báo "YAML và DAG không nhất quán"

Điều đó có nghĩa là quy tắc khứ hồi không được đáp ứng sau khi bạn thay đổi YAML theo cách thủ công. Những lý do phổ biến:

  • Tên trường CamelCase đã sử dụng (phải là Snake_case)
  • Tham chiếu giá trị đặt trước hoặc Agent đã bị xóa
  • phụ thuộc_on trỏ đến id bước không tồn tại

Bấm nút "Kiểm tra" sẽ cho số dòng chính xác — sửa theo vị trí lỗi.

Không thể mở trình soạn thảo/tiếp tục quay vòng tròn

  1. Làm mới nó. Thường thoáng qua.
  2. Thanh trạng thái hiển thị "xxx đang chỉnh sửa" — người khác đang giữ khóa. Đợi 5 phút không thao tác để tự nhả, hoặc liên hệ họ.
  3. Admin có thể "mở khóa cưỡng bức" trong cài đặt team.
  4. Xóa bộ nhớ cache của trình duyệt/thay đổi trình duyệt để kiểm tra.

Sự Khác biệt do trợ lý AI đưa ra không thể xác minh được sau khi áp dụng.

Ctrl / Cmd + Z để hoàn tác--người soạn thảo hỗ trợ khả năng hoàn tác đa cấp. Sau đó dán các thông điệp lỗi cộng với YML gốc trở lại các trợ lý và nó sẽ sửa chữa nó.

Lập lịch/Webhook liên quan

cron Nó Không kích hoạt vào thời điểm đó

  1. "Thời gian kích hoạt tiếp theo" trên trang chi tiết lịch trình có phù hợp với mong đợi không? Múi giờ không khớp là nguyên nhân phổ biến nhất.
  2. Có bản ghi nào về "Lịch sử kích hoạt 10 lần cuối" không? Nếu không, có thể quy trình làm việc đã được lưu trữ hoặc bị xóa.
  3. Xem trạng thái của quy trình làm việc - nó có bị tạm dừng không? Lịch tạm dừng vẫn được tính nhưng sẽ không thực sự kích hoạt.
  4. Dùng nút "Kích hoạt ngay một lần" để tự kiểm chứng bản thân workflow không có vấn đề.

Webhook Trình kích hoạt trả về 401/403

  1. Phương pháp khóa API: có phải là chìa khóa trong các quyền hạn: mang hoặc X-API-Key đầu trang đúng? Đã hết chìa khóa chưa, và nó có ống ngắm WRIGGER không?
  2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
  3. Danh tính của web trong đường dẫn URL có đúng không? Workflow tương ứng đã bị xóa?

Webhook Kích hoạt 200 nhưng việc thực thi không bắt đầu

200 chỉ nghĩa là "yêu cầu được nhận", việc thực thi vẫn có thể bị từ chối:

  • Liệu quy trình làm việc có bị tạm dừng hay không;
  • Liệu gói này có đạt đến hạn ngạch đồng thời/lập lịch hay không;
  • Xác minh không thành công khi nội dung được ánh xạ tới các biến (thiếu trường bắt buộc/loại sai).

Nhật ký kích hoạt Webhook - Trong tab "Lịch sử" của trang chi tiết lập lịch, bạn có thể xem chi tiết phân tích của nền tảng sau khi nhận được yêu cầu.

Phê duyệt liên quan

manual_approval không bao giờ đẩy thông báo

  1. Trang "Cấu hình thông báo" có bị ràng buộc với bất kỳ kênh nào của Slack/Feishu/Email không?
  2. Nhật ký kiểm tra → Lọc phê duyệt_notify_failed - Xem lý do tại sao không thể gửi thông báo (url webhook không hợp lệ? Email bị trả lại?).
  3. Khi danh sách approvers rỗng, mặc định thông báo cho "mọi Admin trở lên" — tài khoản bạn có nằm trong đó không?

Tôi đã chấp thuận nhưng quy trình làm việc không tiếp tục

Quy trình làm việc sau phê duyệt sẽ tiếp tục trong vòng 10 giây. Không tiếp tục quá 1 phút:

  1. Làm mới trang chi tiết thực hiện. Nó đã CHẠY chưa?
  2. Hệ thống đang bận và có thể phải xếp hàng đợi trong 30 giây - v.v.
  3. Đưa ra lệnh sản xuất sau hơn 5 phút.

Liên quan đến nhóm/quyền

Không thể xem quy trình làm việc sau khi chuyển nhóm

Workflow cách ly theo team — không hiển thị chéo team. Hãy chắc bạn đã chuyển đúng team (menu góc trên phải). Nếu từ "cá nhân" chuyển sang "team", bạn cần tạo lại workflow trong team hoặc chuyển từ cá nhân sang.

Đồng nghiệp nói rằng họ không được phép thay đổi quy trình làm việc nhất định

Anh ấy có phải là Người xem trong nhóm này không? Trình xem chỉ được đọc. Chỉ cần nâng cấp anh ấy từ Quản trị viên lên Biên tập viên.

Tôi không phải là Chủ sở hữu nhưng tôi muốn chuyển giao quy trình làm việc mà tôi đã tạo

"Chuyển vào team" yêu cầu bạn có vai trò Editor trở lên ở team đích. Tự tham gia team đích là được.

Thanh toán/Hóa đơn

Phí thẻ tín dụng không thành công

  1. Trang thanh toán → "Thử ghi nợ lại". Sau 3 lần thất bại, gói sẽ tạm thời bị hạ cấp xuống Free - sẽ tự động được khôi phục miễn là bạn trừ tiền thành công trong vòng 14 ngày.
  2. Thẻ Trung Quốc có thể được Stripe kiểm soát rủi ro, vui lòng sử dụng Alipay/WeChat Pay.

Tiêu đề hóa đơn sai

Bạn có thể thay đổi chi tiết hóa đơn trên trang Billing trước khi hóa đơn tháng tới được phát hành. Hóa đơn đã ban hành cần thiết email để Bill error@braidrun.com để hủy bỏ và gửi lại.

Đã Thử mọi cách nhưng vẫn không được

  1. "Trợ giúp" góc dưới phải → gửi ticket. Tự đính kèm môi trường trình duyệt + execution ID gần nhất.
  2. Kế hoạch doanh nghiệp → Liên hệ trực tiếp với CSM chuyên dụng.