Kết nối

Mọi tính năng trong Braidrun — canvas, YAML, lập lịch, phê duyệt, giám sát — đều xoay quanh một bộ khái niệm cốt lõi rất tiết chế. Trang này đặt các khái niệm đó vào một bức tranh, để "đọc bài nào sau này bạn cũng biết tọa độ".

Workflow · Workflow

Workflow là đối tượng cao nhất của nền tảng. Có thể hiểu nó là "một sơ đồ quy trình nghiệp vụ có phiên bản", gồm:

• A YAML document (defining the structure)
• A set of metadata (triggers, parameter presets, permissions, tags)
• Nhiều bản ghi Execution trước đây để kiểm toán và gỡ lỗi

Cùng luồng công việc được hiển thị như một bức tranh DAG trong web UI; vải bạt và YML là hai hình ảnh của một định nghĩa. Người khác biệt ở Git là những người bình thường, không phải là một bãi rác JSON bừa bộn.

Một luồng công việc có thể được kích hoạt theo năm cách:

1. Manual — Bấm "Chạy" trong trình soạn thảo, hoặc khởi chạy hàng loạt từ danh sách.
2. Đã lên lịch — Một biểu thức cron, một khoảng thời gian cố định, một lịch trình một lần, hoặc một kích hoạt N giây sau khi workflow hoàn tất.
3. Webhook — Được kích hoạt bởi một hệ thống PST bên ngoài, xác thực với một phím API (HMAC hỗ trợ để tương thích).
4. API — Bắt đầu thực hiện một cuộc hành hình từ hệ thống của riêng bạn bằng cách sử dụng kết thúc kích hoạt của v1 API.
5. Embedded by parent workflow — Called as a black box by another workflow through sub_workflow step.

Step · Step

Step là đơn vị thực thi nhỏ nhất trong workflow. Mỗi step bắt buộc và chỉ được chọn một "chế độ chính":

• single — A single Agent performs one task description. The most lightweight LLM calling primitive.
• group_chat — Nhiều Agent thảo luận theo lượt và tham chiếu ngữ cảnh của nhau. Phù hợp cho brainstorming và review phản biện.
• agent_based — An orchestrator agent reads the task and dynamically dispatches the subtasks to the worker agent.
• code — 代码脚本（Python / JavaScript / TypeScript / Bash / Ruby / Lua / CLI 共 7 种），在隔离沙箱中执行。确定性 > LLM 的场景首选。
• classifier — LLM chỉ định một nhãn phân loại cho dữ liệu nhập; kết quả được viết cho biến được đặt tên trong đầu ra "có thể thay đổi", vì thế các bước sau có thể phân loại nó với điều kiện.
• state_machine — Multiple states + state transition conditions. Suitable for multiple iterations or workflows containing small processes.
• sub_workflow — Gọi một quy trình làm việc khác dưới dạng hộp đen, có xác minh hợp đồng, phát hiện vòng lặp và cách ly biến.
• workflow_output_read — Đọc kết xuất được xuất bản bởi một công việc khác được thực hiện (Publish outputs) và lưu trữ chúng trong các biến cục bộ.

On top of the main mode, almost any step can overlay the following common enhancement fields:

• depends_on / condition — Các quan hệ phụ thuộc sẵn sàng + bỏ qua điều kiện (điều kiện điều chỉnh hỗ trợ cấp cao & & và vội)
• manual_approval — Cổng chấp thuận thủ công: dừng thực hiện và tiếp tục sau khi được chấp thuận
• parallel / timeout_seconds — Tự động gỡ lỗi
• retry — Backoff retry strategy for transient errors
• repeat_until / iterate_over — Loop cho đến khi một điều kiện được đáp ứng / lặp lại trên một mục thu thập theo mục
• extract / aggregate — Select fields from output / merge multiple inputs
• publish_outputs — Xuất bản đồ tạo tác của một bước như tên đầu ra cho workflow
• idempotent — Phát hành "cùng một kết quả nhập, không có tác dụng phụ", trên tự động giả sau khi dịch vụ khởi động lại, nó quyết định xem bước bị ngắt có thể chạy lại hay không
• on_success / on_failure — Supplementary actions after success/failure (sending notifications, writing audits, etc.)

Agent·Agent

Agent là phần đóng gói của "một phiên LLM + các công cụ có thể dùng + chiến lược chạy". Trong Braidrun, bạn gần như không cần tự viết system prompt; chỉ cần chọn một preset tích hợp trong 19 preset (universal / coder / researcher / data_analyst / web_scraper / writer...) rồi override vài trường theo nhu cầu.

agents:
  planner:
    preset: universal              # 选一个基线模板
  analyst:
    preset: data_analyst
    overrides:                     # 按需覆盖
      llm_config:
        temperature: 0.2
      tool_set: [file_system, csv, database]

An Agent can be referenced by multiple steps; each step execution will open a new session instance (no string memory). See details Hướng dẫn cấu hình Agent.

Module · Module

Module là "workflow đã khai báo WorkflowModuleContract" — tức một workflow tái sử dụng được, công khai hợp đồng inputs / outputs, có thể được workflow khác gọi qua sub_workflow.

The value brought by the module:

• Kiểm tra hợp đồng có kiểu + theo từng trường, không xảy ra "đổi một trường là downstream sập hết"
• Thực thi hộp đen: bên gọi không thấy step nội bộ, logic bên trong có thể phát triển độc lập
• Phát hiện vòng lặp kép lúc chạy + lúc phát hành, tránh "A tham chiếu B, B lại tham chiếu A"
• One-click Promote (extract a step into a module)/Demote (restore the module to an inline step) in the module library

Các tàu thư viện mô-đun có 120+ đã được xây dựng sẵn (các mô- đun đăng nhập nền, tính toán thời gian, các báo cáo ASA, cơ sở báo cáo, Slack giao hàng, và nhiều hơn nữa); thấy chưa Thư viện mô- đun có sẵn;Create your own module see Dùng lại và thu nhỏ.

Execution·Execution

Execution is a specific running instance of a workflow. Its life cycle is a state machine:

PENDING → RUNNING → COMPLETED / FAILED / CANCELLED / INTERRUPTED

Khi nó tới cổng phê chuẩn, thực thi dừng lại ở trạng thái chờ đợi và tiếp tục máy chính phủ sau khi quyết định.

Each execution has:

• Trigger source (manual/schedule/webhook/api/sub_workflow)
• Thời gian bắt đầu, thời gian kết thúc, tổng thời lượng, thời lượng từng bước
• All step input/output/intermediate events (SSE event stream)
• Accumulated token/cost
• list of generated artifacts

Khi dịch vụ bắt đầu đột ngột, việc thực hiện xâm nhập được đánh dấu bằng cách thẩm vấn. Với việc phục hồi.autoResume OnRe Restart được bật, họ có thể tự động giả sử từ bước bị ngắt quãng; xem Tự động tiếp tục sau khi dịch vụ khởi động lại.

Credential · Thông tin xác thực

Thông tin xác thực là kho lưu thống nhất cho dữ liệu nhạy cảm như "API Key, Webhook Secret, OAuth Token". Mọi giá trị được mã hóa AES-256-GCM phía máy chủ khi lưu, đã ghi là không đọc lại được (chỉ ghi đè hoặc xóa).

The parsing links are searched in order, and the first hit takes effect:

1. Tênspace cá nhân của người dùng hiện tại
2. The namespace of the user's team
3. System namespace (public key configured by administrator)

Agent / code steps are parsed on demand at runtime, never written to logs, do not appear in YAML exports, and are not visible to other steps from the caller.

Skill / Tool · Skills and Tools

"Đôi tay" của Agent — các hàm LLM gọi được trong quá trình suy luận. Chia ba loại:

• Built-in toolset — file_system / shell / web / browser / code_execution Wait, it will be tied by default with the preset.
• MCP Extension tools — Any tool exposed by the MCP server can be registered.
• Thị trường kỹ năng — Select a published skill in the "Skill Market" and activate it with one click.

Biến

All dynamic values are passed through double curly braces {{ ... }} giới thiệu. Ba mẫu:

• {{var:name}} — Tên
• {{steps.plan.output}} — Tên
• {{plan}} — Hình thức chính: tìm kiếm kết xuất theo tên bước trước, sau đó giá trị theo tên biến

Kết quả của classifier được viết cho biến được đặt tên theo đầu ra của nó veriable, và các bước xuôi dòng sử dụng điều kiện để quyết định cần làm gì. Chứng nhận không đi qua các biến mẫu: tại thời điểm chạy chúng được giải quyết bởi các nhà cung cấp từ trung tâm phân cấp và tiêm; các biến số được đưa vào một bước mã được tiêm vào như biến môi trường WF VAR.

For complete syntax (JSONPath, filter, condition expressions) see Biến.

Put them together in a picture

       ┌──────────── Workflow ────────────┐
       │                                  │
Trigger→─────►  Step 1 (single, agent=A) ◄─── Credential (解析给 A)
       │         │                        │
       │         ▼                        │
       │      Step 2 (classifier)         │
       │         │                        │
       │   ┌─────┴─────┐                  │
       │   ▼           ▼                  │
       │ Step 3       Step 4 (sub_workflow ──► Module)
       │ (code)       │                   │
       │              ▼                   │
       │      manual_approval 门控        │
       │              │                   │
       └──────────────┴──► Execution (记录状态 / 产物 / token / cost)

You already know where to look

• Thực hành: workflow đầu tiên — Kết nối các khái niệm trên thành một workflow thực tế
• 8 Bước — An authoritative reference dedicated to the main mode
• Biến — Concatenate data between steps
• Bản chú giải — When reading other documents and encountering new words, come back and look them up