Bộ Sửa trực quan

Trình soạn thảo workflow là trang bạn ở lâu nhất mỗi ngày. Bài này đi qua từng khu vực, từng nút bấm, để bạn biết "muốn làm X thì bấm đâu".

Bố cục tổng thể

Trình chỉnh sửa có bố cục ba cột điển hình:

• Thanh công cụ trên cùng — Các hoạt động cốt lõi như lưu/xác minh/thực thi/nhập/xuất/lịch sử phiên bản, v.v.
• canvas cột bên trái — Trực quan hóa DAG, với các nút kéo và thả, kết nối, thu phóng và bản đồ thu nhỏ
• Cột bên phải YAML — Biên tập viên Monaco trực tiếp chỉnh sửa các nguồn YAML với các lời nhắc đánh dấu/tự động hoàn thành/lỗi cú pháp
• thanh trạng thái phía dưới — Lưu trạng thái, chỉnh sửa ngăn khóa, vị trí con trỏ cộng tác viên, thời gian xác minh lần cuối
• Ngăn kéo bên phải — Trợ lý AI, bảng điểm dừng, ảnh chụp nhanh có thể thay đổi (mở theo yêu cầu)

Canvas vs YAML: Đồng bộ hóa cấp byte hai chiều

Đây là điểm khác biệt rõ ràng nhất giữa Braidrun và các thương hiệu khác. Biểu đồ DAG và YAML tương đương với cấp độ byte:

• Bạn thay đổi một dòng trong YAML và nút tương ứng trên khung vẽ sẽ được cập nhật ngay lập tức;
• Bạn kéo một đường kết nối trên khung vẽ và trường phụ thuộc tương ứng trong YAML xuất hiện đồng thời;
• Nhận xét/dòng trống/thứ tự trường không bị mất - YAML được xuất hoàn toàn giống với những gì bạn thấy trong trình chỉnh sửa.

Thanh công cụ trên cùng

Lưu

Theo mặc định, nó sẽ tự động lưu một lần sau khi bạn ngừng gõ trong 5 giây; nó cũng có thể được kích hoạt thủ công bằng cách nhấn Ctrl / Cmd + S. Mỗi lần lưu sẽ tạo một ảnh chụp nhanh phiên bản(Không phải là ghi đè đơn giản).

Hủy bước/ Làm lại

Thanh công cụ có nút Hồi và Redo, với phím tắt Ctrl / Cmd + Z và Ctrl / Cmd + Shift + Z. Đây là một chồng lịch sử trình soạn thảo: kéo vải, chỉnh sửa YAML, và mỗi bước mà trợ lý AI xây dựng đều đi vào cùng một lịch sử - vì vậy "AI đã thực hiện một bước" cũng dễ dàng để xóa bỏ. Việc đánh máy than đá liên tục thành một kỷ lục, và nhãn thời gian được viết lại bởi xe hơi không tạo ra thêm lịch sử; tới 50 bức ảnh gần đây nhất được lưu giữ, và chuyển sang một workflow khác tái tạo lại lịch sử.

Thẩm tra

Gọi bộ phân tích nền tảng để làm một vòng-trip:

1. YAML → Đối tượng WorkflowDefinition (lớp cú pháp)
2. Định nghĩa quy trình làm việc → Xác minh ngữ nghĩa (liệu tham chiếu biến có thể được phân tích cú pháp hay không, liệu có thể tìm thấy giá trị đặt trước hay không, liệu có vòng lặp trong phần phụ thuộc hay không)
3. WorkflowDefinition → YAML khứ hồi (lỗi sẽ được báo cáo nếu có bất kỳ sai lệch nào)

Các lỗi được đánh dấu bằng một squiggle màu đỏ ở mức đường YML; nhấn một để nhảy đến dòng. Kết quả kích thích sâu cũng được nhập vào bảng chẩn đoán dưới đây. Dọn sạch mọi thứ trước khi tiết kiệm và đi sống.

Thực hiện

Nhấp vào nút này sẽ bật lên một hộp thoại, cho phép bạn:

• Điền các biến của quy trình làm việc (giá trị mặc định sẽ được điền trước)
• Kiểm tra/Hủy dry-run (được kiểm tra theo mặc định - rất khuyến khích khi chạy lần đầu)
• Chọn nguồn kích hoạt (thủ công/mô phỏng theo lịch trình)

Sau khi nhấp vào "Bắt đầu thực thi", trình chỉnh sửa sẽ tự động mở ngăn bên phải để hiển thị luồng sự kiện theo thời gian thực, đồng thời mở chi tiết thực thi trong tab hiện tại.

Nhập/Xuất

• Nhập YAML - Tải YAML từ tệp/bảng dán/URL ghi đè nội dung hiện tại.
• Xuất YAML - Tải YAML hiện tại xuống tệp cục bộ. Thích hợp để kiểm soát phiên bản git.
• Nhập các định dạng bên ngoài như Dify/Langflow - Yêu cầu gói Pro trở lên, nền tảng sẽ tự động chuyển đổi sang Braidrun YAML.

Lịch sử phiên bản

Mỗi lần lưu sẽ tạo một ảnh chụp nhanh và giữ lại 100 phiên bản theo mặc định (không giới hạn đối với Doanh nghiệp). Bạn có thể:

• Liệt kê tất cả các ảnh chụp nhanh (bao gồm thời gian, trình tiết kiệm, số dòng đã thay đổi)
• So sánh với phiên bản hiện tại khác biệt
• Quay lại bất kỳ phiên bản lịch sử nào (quay lại sẽ tạo ảnh chụp nhanh mới và sẽ không thực sự ghi đè lên lịch sử)

Promote to module / Demote from module

Chọn một số bước liên tiếp trên canvas và nhấp vào "Thăng cấp lên mô-đun" để trích xuất các bước này thành mô-đun sub_workflow độc lập và vị trí ban đầu sẽ trở thành lệnh gọi mô-đun. Giảm hạng hoạt động ngược lại. Xem chi tiết Dùng lại và thu nhỏ.

Thao tác canvas cột bên trái

Thêm nút mới

• Nút "+" góc dưới trái mở bộ chọn loại step, chọn một chế độ chính.
• Kéo "đoạn mẫu step" từ cột phải vào canvas cũng thêm được.

Liên kết

Kéo điểm cuối đầu ra của một nút vào điểm cuối đầu vào của nút khác để tự động thêm mối quan hệ phụ thuộc vào YAML. Nền tảng này không cho phép bạn vẽ các cạnh tạo thành các vòng - bạn sẽ bị trả lại và bị nướng nếu cố vẽ một vòng.

Menu chuột phải của nút

• Chỉnh sửa - Mở đoạn mã YAML của bước này để chỉnh sửa một phần.
• Sao chép - sao chép một bản sao của bước hiện tại (id được tự động thêm hậu tố).
• Xóa - một cảnh báo sẽ được đưa ra nếu có các tham chiếu xuôi dòng khi xóa.
• Đặt làm điểm bắt đầu/kết thúc - Đánh dấu mục nhập/thoát rõ ràng của quy trình làm việc (chỉ bắt buộc đối với state_machine).

Thu phóng và bản đồ thu nhỏ

Có một bản đồ nhỏ ở góc dưới bên phải, cho phép bạn nhanh chóng nhảy khi quy trình làm việc phức tạp vượt quá kích thước canvas. Ctrl/Cmd + bánh xe cuộn để phóng to; Space + kéo để xoay.

Cột bên phải YAML

Tự động hoàn thành

Dựa trên Lược đồ JSON, có thể hoàn thành tên trường chung, tên đặt trước và id bước hiện có. Ctrl/Cmd + Thức tỉnh lực lượng không gian.

Gấp / Mở ra

Bấm vào mũi tên cạnh số dòng bên trái để thu gọn toàn bộ bước. Phím tắt Ctrl / Cmd + Shift + [ / ].

Tìm kiếm và thay thế

Ctrl/Cmd + F Tìm kiếm, Ctrl/Cmd + H Thay thế. Hỗ trợ đều đặn. Nó sẽ chỉ ảnh hưởng đến workflow hiện tại - nó sẽ không ảnh hưởng đến các workflow khác.

Đã Cập nhật

Người biên tập có hai lớp bản thảo chia sẻ một tập hợp các quy tắc:

• Tên — Được đăng nhập tại địa phương sau mỗi chỉnh sửa (các quy tắc cấu trúc như chu kỳ phụ thuộc, tham chiếu mơ hồ, và các gợi ý cho ID bước gần sai), lái bảng điều khiển các vấn đề, phù hiệu nút, và huy hiệu thanh công cụ không có hoạt động.
• Bên máy phục vụ chứng nhận sâu — Tên POST /api/workflows/lint, trả về tất cả các vấn đề cùng một lúc (sự hợp lệ hóa thời gian chính xác dừng lại tại lỗi đầu tiên; liting không) và thêm các quy tắc mà cần bên máy chủ dữ liệu, như Agent tiền định và hợp đồng mô- đun.

Bảng điều khiển thanh công cụ hiển thị số đếm lỗi/ cảnh báo trong thời gian thực (đã có lỗi, vàng khi chỉ cảnh báo); nhấn nó chạy một giá trị sâu và mở bảng điều khiển. Mỗi vấn đề mang theo một chip chuyển động bước (click to the node) và một sự sửa chữa được gợi ý; bạn cũng có thể "Fix with Al" cho một vấn đề duy nhất hoặc tất cả họ — trình biên tập tập tập tập tập hợp các vấn đề thành một dấu nhắc có cấu trúc và gửi nó đến trợ lý AI.

Ngăn kéo bên phải

AI Trợ lý

Bấm biểu tượng "Trợ lý AI" giữa cột phải để mở rộng. Hỗ trợ:

• Sử dụng ngôn ngữ tự nhiên để mô tả phần logic cần thay đổi và trợ lý sẽ đưa ra bản xem trước khác biệt;
• Lệnh slash: //excut, /validate, //port, // mới, /undo, //help;
• /undo trở lại các thay đổi của trợ lý (lên đến 10 bước); Ctrl của chính trình soạn thảo / Cmd + Z cũng có thể đảo ngược các thay đổi AI tại một thời điểm.

Xem khả năng hoàn chỉnh Quản lý bằng hỗ trợ AI.

Bảng điểm dừng

Bảng này sáng lên khi quá trình thực thi đang diễn ra ở chế độ gỡ lỗi. Bạn có thể thêm/xóa điểm dừng, xem lịch sử lần truy cập và chỉnh sửa các biến trong khi tạm dừng. Xem chi tiết @ Info: status.

Ảnh chụp nhanh thay đổi

Khi bạn nhấp vào một bước, tất cả các biến sẽ có sẵn trước khi bước đó được thực thi - bao gồm var:* /steps.*.data / classifier.* /credentials.* (các giá trị thông tin xác thực sẽ được hiển thị không nhạy cảm).

Khóa chỉnh sửa cộng tác

Cùng một workflow tại một thời điểm chỉ một người sửa được — ai vào trước giữ khóa. Người khác truy cập ở chế độ chỉ đọc, thanh trạng thái hiển thị "xxx đang chỉnh sửa". Khóa tự nhả sau 5 phút không thao tác, hoặc bị Admin mở khóa cưỡng bức.

Các phím tắt thường dùng

Một số cái được sử dụng phổ biến nhất trong trình chỉnh sửa - xem danh sách đầy đủ Phím tắt.

• Ctrl / Cmd + S — Lưu
• Ctrl / Cmd + E — Thực thi (hộp thoại mở)
• Ctrl / Cmd + Shift + V — Thẩm tra
• Ctrl / Cmd + Z — Hoàn tác (áp dụng cho cả trình soạn thảo YAML + trợ lý AI)
• Ctrl / Cmd + Shift + Z — Làm lại
• Alt + A — Chuyển ngăn kéo trợ lý AI
• Alt + B — Chuyển đổi bảng điểm dừng

Bước tiếp theo

• 8 Bước — Tài liệu tham khảo có thẩm quyền về cách viết từng bước
• Tham chiếu cú pháp YAML — Tham khảo chuyên sâu hơn
• Trợ lý AI — Sử dụng ngôn ngữ tự nhiên để thay đổi quy trình làm việc