Braidrun đã mã nguồn mở công cụ thực thi workflow và SDK
Tự vận hành công cụ thực thi workflow theo giấy phép Apache-2.0 trong môi trường của bạn, đồng thời kết nối các ứng dụng hiện có với nền tảng đám mây Braidrun qua 13 SDK client chính thức. Cả hai lựa chọn đều có mã nguồn mở trên GitHub và cùng truy cập một tập tính năng workflow.
Braidrun-workflow: thời gian chạy quy trình làm việc mở
Một công cụ chạy các quy trình làm việc AI được xác định trong YAML, từ dòng lệnh hoặc từ mã Kotlin — cùng thời gian chạy mà nền tảng đám mây chạy ngầm.
Kho lưu trữ nguồn mở chứa công cụ dòng lệnh và thời gian chạy quy trình làm việc hoàn chỉnh. Nó chạy các bước được xác định trong YAML của bạn theo thứ tự — tác nhân, mã, lệnh gọi công cụ và quy trình công việc phụ — và tách biệt chúng với các quy trình con Docker trong quá trình sản xuất.
- Quy trình công việc được xác định trong YAML, có thể chạy được từ mã CLI hoặc Kotlin
- Các bước tác nhân, các bước mã, song song, điều kiện, lặp lại, thử lại, máy trạng thái và quy trình công việc phụ
- Các cài đặt trước tác nhân tích hợp sẵn để mã hóa, nghiên cứu, viết, phân tích dữ liệu, tài liệu, tự động hóa trình duyệt và hơn thế nữa
- Nhóm công cụ dành cho tệp, shell, Git, HTTP, trình duyệt, tài liệu, cơ sở dữ liệu, RAG, email và hơn thế nữa
- Ủy quyền cho các tác nhân mã hóa bên ngoài thông qua các quy trình con Claude Code và OpenAI Codex
- Các quy trình con gốc để phát triển cục bộ, các quy trình con Docker để tách biệt sản xuất
- Tích hợp các mô hình Anthropic, OpenAI, DeepSeek, OpenRouter, Z.ai và NVIDIA thông qua Koog
- Có thể chạy như một máy chủ MCP, hiển thị các nhóm công cụ cho các máy khách khác
# Xây dựng công cụ dòng lệnh
./gradlew installDist
# Xác thực và chạy ví dụ được gói trong thư mục ví dụ
./build/install/braidrun-workflow/bin/braidrun-workflow run \
examples/workflows/research-summary.yamlname: research-summary
version: 1.0.0
description: Simple LLM-backed workflow using the researcher preset.
agents:
researcher:
preset: researcher
overrides:
max_iterations: 32
workflow:
- step: summarize
agent: researcher
input: "Explain what Braidrun Workflow is and list three use cases."braidrun-sdk: Kết nối với Braidrun bằng ngôn ngữ bạn quen dùng
Mười ba client an toàn kiểu cho 12 ngôn ngữ biến API nền tảng mở thành các phương thức, mô hình và kiểu lỗi quen thuộc với stack công nghệ của bạn.
Dùng SDK từ một ứng dụng hiện có để gọi nền tảng đám mây Braidrun: khởi chạy workflow, kiểm tra kết quả thực thi, đọc artifact, xử lý phê duyệt thủ công và tích hợp webhook. Tất cả client đều được tạo từ cùng một đặc tả OpenAPI, nhờ đó giao diện và mô hình dữ liệu luôn đồng nhất.
- Tìm workflow và khởi chạy lượt thực thi bất đồng bộ
- Đọc trạng thái thực thi, kết quả cuối cùng và artifact; hủy các lượt thực thi đang chạy
- Xem xét, phê duyệt hoặc từ chối yêu cầu phê duyệt thủ công; quản lý và kích hoạt webhook
- API và mô hình dữ liệu có kiểu, hỗ trợ Bearer, X-API-Key và scope quyền
- Mỗi thư mục ngôn ngữ đều có tài liệu về cài đặt, cấu hình, endpoint và mô hình
Là một công cụ dòng lệnh hoặc được nhúng trong dự án của riêng bạn
Trình phân tích cú pháp và trình thực thi giống nhau: chạy trực tiếp trong thiết bị đầu cuối hoặc phụ thuộc vào nó dưới dạng thư viện Kotlin/JVM.
Sau khi xây dựng, bạn sẽ nhận được lệnh Braidrun-workflow để xác thực, chạy khô và thực thi các quy trình công việc — đồng thời có thể chạy một tác nhân đặt trước duy nhất mà không cần tệp quy trình làm việc. Lý tưởng cho các quy trình viết kịch bản và tự động hóa.
braidrun-workflow agent \
--preset researcher \
--prompt "Tóm tắt kho lưu trữ này và liệt kê ba trường hợp sử dụng"- chạy / xác thực / thực hiện và kiểm tra bìa chạy khô
- danh sách đặt trước và công cụ danh sách hiển thị các khả năng tích hợp
- mcp-server hiển thị các nhóm công cụ dưới dạng máy chủ MCP
Các phiên bản đã phát hành được phân phối thông qua JitPack. Một dòng phụ thuộc cho phép bạn gọi WorkflowParser và WorkflowExecutor trong ứng dụng JVM của riêng bạn — cách triển khai chính xác mà CLI sử dụng.
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser và WorkflowExecutor đã sẵn sàng để sử dụng
- Các quy trình con gốc để phát triển, các quy trình con Docker để sản xuất
- Yêu cầu JDK 21 hoặc mới hơn; Chế độ cách ly Docker cần Docker
Phiên bản nguồn mở cung cấp cho bạn công cụ; nền tảng đám mây cung cấp cho bạn toàn bộ bàn làm việc
Cả hai bên chia sẻ thời gian chạy giống nhau. Từng hàng một, đây là những gì phiên bản nguồn mở bao gồm và những gì nền tảng đám mây bổ sung thêm ở trên cùng.
| Năng lực | Phiên bản mã nguồn mởbraidrun-workflow | Nền tảng đám mâybraidrun.com |
|---|---|---|
| Công cụ thời gian chạy quy trình làm việc (YAML) | ✓Tự triển khai và chạy nó | ✓Cùng một công cụ, được lưu trữ cho bạn |
| Tích hợp CLI và thư viện | ✓CLI cộng với thư viện Kotlin/JVM | ✓Kết nối qua SDK chính thức hoặc REST API |
| Trình chỉnh sửa trực quan (canvas ⇄ YAML) | —Không có giao diện người dùng - chỉnh sửa YAML | ✓Canvas và YAML luôn đồng bộ theo cả hai cách |
| Trợ lý AI đàm thoại để xây dựng quy trình làm việc | —Không được cung cấp | ✓Tạo và chỉnh sửa quy trình công việc bằng cách trò chuyện |
| Gỡ lỗi điểm dừng và chạy lại bước không thành công | —Tự mình gỡ lỗi | ✓Thay đổi giá trị tại điểm dừng và tiếp tục; các bước đã hoàn thành sẽ không được lập hóa đơn nữa |
| Tự động tiếp tục sau khi dịch vụ khởi động lại | —Hãy tự mình thực hiện nó | ✓Tự động phục hồi sau khi xác minh hàm băm định nghĩa |
| Chạy lịch sử và giám sát | △Xây dựng nhật ký của riêng bạn | ✓Lịch sử thực hiện, kế toán chi phí và cảnh báo |
| Mẫu và Mô-đun | △Một vài ví dụ được gói trong repo | ✓Hơn 240 mẫu, hơn 120 mô-đun và thị trường |
| Cổng phê duyệt thủ công | △Được hỗ trợ khi chạy; thông báo là của riêng bạn | ✓Thông báo trong ứng dụng/email/API |
| Trình kích hoạt lịch trình/webhook/API | △Hãy tự mình lên lịch | ✓Trình kích hoạt tích hợp và lập lịch theo chuỗi |
| Hợp tác và quyền của nhóm | —Không được cung cấp | ✓Nhóm, vai trò và chia sẻ |
| Sandboxing và quản lý bí mật | ✓Cách ly Docker, do bạn quản lý | ✓Hộp cát được lưu trữ cộng với mã hóa bí mật |
| Hỗ trợ kỹ thuật | —Chỉ cộng đồng, không có hỗ trợ chính thức | ✓Hỗ trợ kỹ thuật chuyên nghiệp |
| Triển khai riêng / self-hosted | ✓Tự lưu trữ theo định nghĩa | ✓Triển khai riêng tư trên gói Doanh nghiệp |
Nếu bạn muốn quản lý ít cơ sở hạ tầng hơn và xây dựng nhiều quy trình công việc hơn
Phiên bản nguồn mở trao cho bạn động cơ để tự chạy; nền tảng đám mây bổ sung giao diện, cộng tác, lưu trữ và hỗ trợ, do đó quy trình công việc được thực hiện nhanh hơn và dễ bảo trì hơn.
Khi phiên bản nguồn mở là tất cả những gì bạn cần
Chúng tôi không nghĩ mọi người nên chuyển sang đám mây. Trong ba trường hợp dưới đây, phiên bản nguồn mở tự nó là lựa chọn đúng đắn.
Về công cụ thực thi, SDK và nền tảng đám mây
Phiên bản nguồn mở và nền tảng đám mây có phải là cùng một công cụ không?
Đúng. Nền tảng đám mây được xây dựng trên cùng một thời gian chạy nguồn mở, bổ sung tính năng chỉnh sửa trực quan, cộng tác, lịch sử chạy, giám sát và thực thi được lưu trữ trên máy chủ. YAML bạn làm việc ở phiên bản nguồn mở có thể chuyển sang đám mây gần như không thay đổi.
braidrun-workflow sử dụng giấy phép nào? Tôi có thể dùng cho mục đích thương mại không?
Nó theo giấy phép Apache-2.0, cho phép sử dụng và sửa đổi vì mục đích thương mại miễn là bạn giữ giấy phép và thông báo bản quyền. Xem tệp LICENSE trong kho lưu trữ.
SDK khác gì với công cụ thực thi workflow mã nguồn mở?
SDK cho phép ứng dụng của bạn gọi API nền tảng đám mây Braidrun và được thiết kế để tích hợp hệ thống đa ngôn ngữ. braidrun-workflow là công cụ thực thi workflow kèm công cụ dòng lệnh, chạy cục bộ hoặc trên máy chủ của riêng bạn.
Tôi có thể cài SDK trực tiếp từ trình quản lý gói của từng ngôn ngữ không?
SDK hiện được phân phối qua kho mã nguồn GitHub; mức độ hỗ trợ trên trình quản lý gói của từng ngôn ngữ có thể khác nhau. Hãy chọn một client và làm theo hướng dẫn cài đặt trong tệp README của thư mục tương ứng.
Phiên bản nguồn mở có hỗ trợ kỹ thuật không?
Dự án nguồn mở không cung cấp hỗ trợ kỹ thuật chính thức và dựa vào cộng đồng và tài liệu. Nếu bạn cần phản hồi của nhân viên và cam kết ở cấp độ dịch vụ, hãy sử dụng nền tảng đám mây hoặc gói Doanh nghiệp.
Tôi có thể bắt đầu với phiên bản nguồn mở và chuyển sang nền tảng đám mây sau không?
Đúng. Nhiều nhóm xác thực quy trình làm việc từ dòng lệnh trước, sau đó chuyển nó sang nền tảng đám mây để có giao diện trực quan, cộng tác và lưu trữ. Quy trình công việc được xác định trong YAML tiêu chuẩn, do đó việc di chuyển tốn ít chi phí.
Việc sử dụng nền tảng đám mây có khóa tôi không?
Công cụ cốt lõi là nguồn mở và quy trình công việc được xác định trong YAML tiêu chuẩn. Bạn có thể xuất quy trình làm việc và tự chạy nó trong phiên bản nguồn mở bất cứ lúc nào — không cần khóa.