أصبح محرك سير العمل وحزمة SDK من Braidrun مفتوحي المصدر الآن
شغّل محرك سير العمل المرخّص بـ Apache-2.0 في بيئتك، واربط التطبيقات الحالية بمنصة Braidrun السحابية عبر 13 عميلاً رسميًا ضمن حزمة SDK. كلا المسارين مفتوح المصدر على GitHub ويتصلان بإمكانات سير العمل نفسها.
Braidrun-Workflow: وقت تشغيل سير العمل المفتوح
محرك يقوم بتشغيل مسارات عمل الذكاء الاصطناعي المحددة في YAML، من سطر الأوامر أو من كود Kotlin - وهو نفس وقت التشغيل الذي يعمل عليه النظام الأساسي السحابي خلف الكواليس.
يحتوي المستودع مفتوح المصدر على وقت التشغيل الكامل لسير العمل وأداة سطر الأوامر. فهو يقوم بتشغيل الخطوات المحددة في YAML بالترتيب - الوكلاء، والتعليمات البرمجية، واستدعاءات الأدوات، ومسارات العمل الفرعية - ويعزلهم مع عمليات Docker الفرعية في الإنتاج.
- مسارات العمل المحددة في YAML، والتي يمكن تشغيلها من خلال CLI أو كود Kotlin
- خطوات الوكيل، وخطوات التعليمات البرمجية، والتوازي، والشروط، والتكرار، وإعادة المحاولة، وأجهزة الحالة ومسارات العمل الفرعية
- الإعدادات المسبقة للوكيل المضمنة للبرمجة والبحث والكتابة وتحليل البيانات والمستندات وأتمتة المتصفح والمزيد
- مجموعات الأدوات للملفات وshell وGit وHTTP والمتصفح والمستندات وقواعد البيانات وRAG والبريد الإلكتروني والمزيد
- تفويض وكلاء الترميز الخارجيين من خلال العمليات الفرعية لـ Claude Code وOpenAI Codex
- العمليات الفرعية الأصلية للتطوير المحلي، وعمليات Docker الفرعية لعزل الإنتاج
- يدمج نماذج Anthropic وOpenAI وDeepSeek وOpenRouter وZ.ai وNVIDIA عبر Koog
- يمكن تشغيله كخادم MCP، مما يعرض مجموعات الأدوات لعملاء آخرين
# إنشاء أداة سطر الأوامر
./gradlew installDist
# التحقق من صحة المثال الموجود في دليل الأمثلة وتشغيله
./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: اتصل بـ Braidrun باللغة التي تعرفها
يحوّل 13 عميلاً آمنًا من حيث الأنواع، موزعًا على 12 لغة، واجهة API للمنصة المفتوحة إلى أساليب ونماذج وأنواع أخطاء مألوفة لحزمة تقنياتك.
استخدم حزمة SDK من تطبيق حالي لاستدعاء منصة Braidrun السحابية: ابدأ مسارات العمل، وتحقق من نتائج التنفيذ، واقرأ ملفات المخرجات، وتعامل مع الموافقات البشرية، وادمج خطافات الويب. يُنشأ جميع العملاء من مواصفة OpenAPI نفسها، ما يحافظ على اتساق واجهاتهم ونماذج بياناتهم.
- العثور على مسارات العمل وبدء عمليات التنفيذ بشكل غير متزامن
- قراءة حالة التنفيذ والنتائج النهائية وملفات المخرجات، وإلغاء عمليات التنفيذ النشطة
- مراجعة الموافقات البشرية وقبولها أو رفضها، وإدارة خطافات الويب وتشغيلها
- واجهات API ونماذج بيانات محددة الأنواع مع دعم Bearer وX-API-Key ونطاقات الأذونات
- يتضمن دليل كل لغة وثائق التثبيت والإعداد ونقاط النهاية والنماذج
كأداة سطر أوامر، أو مضمنة في مشروعك الخاص
نفس المحلل اللغوي والمنفذ: قم بتشغيله مباشرة في الوحدة الطرفية، أو اعتمد عليه كمكتبة Kotlin/JVM.
بعد الإنشاء، تحصل على أمر Braidrun-workflow الذي يتحقق من صحة عمليات سير العمل، ويجري تشغيلها، وينفذها - ويمكنه تشغيل وكيل واحد محدد مسبقًا بدون ملف سير عمل. مثالية للبرمجة وخطوط الأنابيب الأتمتة.
braidrun-workflow agent \
--preset researcher \
--prompt "قم بتلخيص هذا المستودع وقم بإدراج ثلاث حالات استخدام"- تشغيل / التحقق من صحة / تنفيذ غطاء التشغيل الجاف والتحقق منه
- تعرض إعدادات القائمة المسبقة وأدوات القائمة الإمكانات المضمنة
- يعرض mcp-server مجموعات الأدوات كخادم MCP
يتم توزيع الإصدارات التي تم إصدارها من خلال JitPack. يتيح لك خط تبعية واحد استدعاء WorkflowParser وWorkflowExecutor في تطبيق JVM الخاص بك - وهو نفس التنفيذ الذي تستخدمه واجهة سطر الأوامر (CLI).
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser وWorkflowExecutor جاهزان للاستخدام
- العمليات الفرعية الأصلية للتطوير وعمليات Docker الفرعية للإنتاج
- يتطلب JDK 21 أو أحدث؛ يحتاج وضع عزل Docker إلى Docker
الإصدار مفتوح المصدر يمنحك المحرك؛ تمنحك المنصة السحابية طاولة العمل بأكملها
كلا الجانبين يشتركان في نفس وقت التشغيل. صفًا تلو الآخر، إليك ما يتضمنه الإصدار مفتوح المصدر وما تضيفه المنصة السحابية في الأعلى.
| القدرة | طبعة مفتوحة المصدرbraidrun-workflow | منصة سحابيةbraidrun.com |
|---|---|---|
| محرك وقت تشغيل سير العمل (YAML) | ✓قم بنشره وتشغيله بنفسك | ✓نفس المحرك، مستضاف لك |
| تكامل سطر الأوامر والمكتبة | ✓مكتبة CLI بالإضافة إلى مكتبة Kotlin/JVM | ✓اتصل عبر حزم SDK الرسمية أو REST API |
| محرر مرئي (قماش ⇄ YAML) | —لا توجد واجهة مستخدم - قم بتحرير YAML | ✓يظل Canvas وYAML متزامنين في كلا الاتجاهين |
| مساعد الذكاء الاصطناعي للمحادثة لبناء سير العمل | —غير متوفر | ✓إنشاء وتحرير سير العمل عن طريق الدردشة |
| تصحيح أخطاء نقاط التوقف وعمليات إعادة التشغيل الفاشلة | —تصحيح ذلك بنفسك | ✓تغيير القيم عند نقطة توقف واستئنافها؛ لا تتم محاسبه الخطوات المكتملة مرة أخرى |
| استئناف تلقائي بعد إعادة تشغيل الخدمة | —قم بتنفيذها بنفسك | ✓يتم الاسترداد التلقائي بعد التحقق من تجزئة التعريف |
| تشغيل التاريخ والرصد | △بناء التسجيل الخاص بك | ✓تاريخ التنفيذ ومحاسبة التكاليف والتنبيهات |
| القوالب والوحدات | △بعض الأمثلة المجمعة في الريبو | ✓أكثر من 240 قالبًا، وأكثر من 120 وحدة نمطية وسوقًا |
| بوابات موافقة بشرية | △مدعومة في وقت التشغيل؛ الإخطارات هي الخاصة بك | ✓إشعارات داخل التطبيق/البريد الإلكتروني/واجهة برمجة التطبيقات |
| مشغلات الجدول الزمني / webhook / API | △جدولة ذلك بنفسك | ✓مشغلات مدمجة وجدولة متسلسلة |
| تعاون الفريق والأذونات | —غير متوفر | ✓الفرق والأدوار والمشاركة |
| وضع الحماية والإدارة السرية | ✓عزل عامل الإرساء، تتم إدارته بواسطتك | ✓وضع الحماية المستضاف بالإضافة إلى التشفير السري |
| الدعم الفني | —المجتمع فقط، لا يوجد دعم رسمي | ✓الدعم الفني المهني |
| نشر خاص / ذاتي | ✓استضافة ذاتية حسب التعريف | ✓النشر الخاص على خطة المؤسسة |
إذا كنت تفضل إدارة بنية تحتية أقل وإنشاء المزيد من مسارات العمل
الإصدار مفتوح المصدر يمنحك المحرك لتشغيل نفسك؛ تضيف المنصة السحابية الواجهة والتعاون والاستضافة والدعم، بحيث يتم شحن سير العمل بشكل أسرع وأسهل في الصيانة.
عندما يكون الإصدار مفتوح المصدر هو كل ما تحتاجه
لا نعتقد أنه يجب على الجميع الانتقال إلى السحابة. في الحالات الثلاث أدناه، يعد الإصدار مفتوح المصدر هو الخيار الصحيح بحد ذاته.
حول المحرك وحزمة SDK والمنصة السحابية
هل الإصدار مفتوح المصدر والمنصة السحابية هما نفس المحرك؟
نعم. تم إنشاء النظام الأساسي السحابي على نفس وقت التشغيل مفتوح المصدر، مع إضافة التحرير المرئي والتعاون وسجل التشغيل والمراقبة والتنفيذ المستضاف. YAML الذي تعمل به في الإصدار مفتوح المصدر يمكن أن ينتقل إلى السحابة دون تغيير تقريبًا.
ما الترخيص الذي يستخدمه braidrun-workflow؟ وهل يمكنني استخدامه تجاريًا؟
إنه خاضع لترخيص Apache-2.0، الذي يسمح بالاستخدام التجاري والتعديل طالما أنك تحتفظ بإشعارات الترخيص وحقوق النشر. راجع ملف الترخيص في المستودع.
ما الفرق بين حزمة SDK ومحرك سير العمل مفتوح المصدر؟
تتيح حزمة SDK لتطبيقك استدعاء واجهة API لمنصة Braidrun السحابية، وهي مصممة لدمج الأنظمة بلغات متعددة. أما braidrun-workflow فهو محرك سير عمل وأداة سطر أوامر تعمل محليًا أو على خوادمك.
هل يمكنني تثبيت حزمة SDK مباشرة من مدير الحزم الخاص بكل لغة؟
تُوزّع حزمة SDK حاليًا عبر مستودع شفرتها المصدرية على GitHub، وقد يختلف توفرها في مديري الحزم الخاصين بكل لغة. اختر عميلاً واتبع تعليمات التثبيت الواردة في ملف README داخل دليله.
هل تأتي النسخة مفتوحة المصدر مع دعم فني؟
لا يوفر المشروع مفتوح المصدر أي دعم فني رسمي ويعتمد على المجتمع والوثائق. إذا كنت بحاجة إلى استجابات طاقم عمل والتزام بمستوى الخدمة، فاستخدم النظام الأساسي السحابي أو خطة المؤسسة.
هل يمكنني البدء بالإصدار مفتوح المصدر والانتقال إلى النظام الأساسي السحابي لاحقًا؟
نعم. تتحقق العديد من الفرق من صحة سير العمل من سطر الأوامر أولاً، ثم تنقله إلى النظام الأساسي السحابي للواجهة المرئية والتعاون والاستضافة. يتم تعريف سير العمل في YAML القياسي، وبالتالي فإن تكاليف الترحيل قليلة.
هل استخدام النظام الأساسي السحابي يمنعني من الدخول؟
المحرك الأساسي مفتوح المصدر ويتم تحديد سير العمل في YAML القياسي. يمكنك تصدير سير عمل وتشغيله بنفسك في الإصدار مفتوح المصدر في أي وقت — لا يوجد أي قفل.