المحرر البصري

محرر سير العمل هو الصفحة التي تقضي فيها معظم الوقت كل يوم. تتحدث هذه المقالة عن كل منطقة وكل زر، حتى تعرف أين تنقر إذا كنت تريد إجراء X.

التخطيط العام

المحرر عبارة عن تخطيط نموذجي مكون من ثلاثة أعمدة:

• شريط الأدوات العلوي — العمليات الأساسية مثل الحفظ/التحقق/التنفيذ/الاستيراد/التصدير/سجل الإصدارات وما إلى ذلك.
• قماش العمود الأيسر — تصور DAG، مع عقد السحب والإفلات، والاتصالات، والتكبير/التصغير، والخرائط المصغرة
• العمود الأيمن YAML — يقوم محرر Monaco بتحرير مصادر YAML مباشرةً من خلال تمييز بناء الجملة/الإكمال التلقائي/مطالبات الخطأ
• شريط الحالة السفلي — حفظ الحالة، وتحرير حامل القفل، وموضع مؤشر المتعاون، وآخر وقت للتحقق
• الدرج الصحيح — مساعد الذكاء الاصطناعي، لوحة التوقف، لقطة متغيرة (مفتوحة عند الطلب)

Canvas vs YAML: مزامنة ثنائية الاتجاه على مستوى البايت

هذا هو الفرق الأكثر وضوحًا بين Braidrun والعلامات التجارية الأخرى. الرسم البياني DAG وYAML مكافئان على مستوى البايت:

• يمكنك تغيير خط في YAML، ويتم تحديث العقدة المقابلة على اللوحة القماشية على الفور؛
• تقوم بسحب خط اتصال على اللوحة القماشية، ويظهر الحقل المطابق في YAML في وقت واحد؛
• لا يتم فقدان التعليقات/الأسطر الفارغة/ترتيب الحقول - YAML المُصدَّر هو تمامًا نفس ما تراه في المحرر.

شريط الأدوات العلوي

أنقذ

افتراضيًا، سيتم الحفظ تلقائيًا مرة واحدة بعد التوقف عن الكتابة لمدة 5 ثوانٍ؛ يمكن أيضًا تشغيله يدويًا بالضغط على Ctrl / Cmd + S. سيؤدي كل حفظ إلى إنشاء ملف لقطة الإصدار(ليس تجاوزًا بسيطًا).

Undo / redo

The toolbar has Undo and Redo blues, with shortcuts Ctrl / Cmd + Z and Ctrl / Cmd + Shift + Z. هذا كتلة تاريخ على مستوى المحرّر: جرّ الشموع، مبيدات YAML، وكل خطوة يبنّيها مساعد آي يَدْخلُ كُلّ شيءَ إلى نفس التاريخِ - طباعة المواصفات المستمرة في سجل واحد، ومصابيح الزمن التي كتبت من قبل الأوتوماتايف لا تخلق تاريخاً إضافياً، حتى آخر 50 طلقة تم حفظها،.

التصديق

اتصلوا بجهاز الرصيف للقيام بجولة

1. YAML → كائن WorkflowDefinition (طبقة بناء الجملة)
2. تعريف سير العمل → التحقق الدلالي (ما إذا كان يمكن تحليل مرجع المتغير، وما إذا كان يمكن العثور على الإعداد المسبق، وما إذا كانت هناك حلقات في التبعيات)
3. تعريف سير العمل → YAML ذهابًا وإيابًا (سيتم الإبلاغ عن خطأ في حالة وجود أي انحرافات)

وتتميز الأشرار بنكهة حمراء على مستوى خط YAML؛ ونقر واحدة للقفز إلى الخط. كما تدمج نتائج التوثيق العميق في فريق التشخيص الوارد وصفه أدناه. نظف كل شيء قبل حفظ والعيش.

اعدام

سيؤدي النقر على هذا الزر إلى ظهور مربع حوار يسمح لك بما يلي:

• املأ متغيرات سير العمل (سيتم تعبئة القيم الافتراضية مسبقًا)
• تحقق / إلغاء dry-run (يتم تحديده افتراضيًا - يوصى به بشدة للتشغيل لأول مرة)
• حدد مصدر التشغيل (يدويًا/محاكاة الجدول الزمني)

بعد النقر على "بدء التنفيذ"، سيفتح المحرر تلقائيًا الدرج الموجود على اليمين لعرض تدفق الأحداث في الوقت الفعلي، وفي نفس الوقت يفتح تفاصيل التنفيذ في علامة التبويب الحالية.

استيراد/تصدير

• استيراد YAML - يقوم بتحميل YAML من ملف/لوحة لصق/عنوان URL للكتابة فوق المحتوى الحالي.
• تصدير YAML - قم بتنزيل YAML الحالي إلى ملف محلي. مناسبة للتحكم في إصدار git.
• قم باستيراد التنسيقات الخارجية مثل Dify/Langflow - Pro أو الحزمة الأعلى المطلوبة، ويتحول النظام الأساسي تلقائيًا إلى Braidrun YAML.

تاريخ الفصل

تنشئ كل عملية حفظ لقطة وتحتفظ بـ 100 إصدار افتراضيًا (لا يوجد حد للمؤسسات). أنت تستطيع:

• قم بإدراج جميع اللقطات (بما في ذلك الوقت والتوفير وعدد الأسطر التي تم تغييرها)
• مقارنة مع فرق الإصدار الحالي
• التراجع إلى أي إصدار تاريخي (التراجع سيؤدي إلى إنشاء لقطة جديدة ولن يؤدي فعليًا إلى استبدال السجل)

Promote to module / Demote from module

حدد عدة خطوات متتالية على اللوحة القماشية وانقر على "الترقية إلى الوحدة النمطية" لاستخراج هذه الخطوات إلى وحدة سير عمل فرعية مستقلة، ويصبح الموضع الأصلي بمثابة استدعاء وحدة. تخفيض العملية العكسية. انظر التفاصيل التحديث وإعادة الاستخدام.

عمليات قماش العمود الأيسر

إضافة عقدة جديدة

• يفتح الزر "+" الموجود في الزاوية اليسرى السفلية محدد نوع الخطوة ويحدد الوضع الرئيسي.
• ويمكن أيضًا إضافتها عن طريق سحب "جزء قالب الخطوة" من العمود الأيمن إلى اللوحة القماشية.

الروابط

اسحب نقطة نهاية الإخراج لعقدة واحدة إلى نقطة نهاية الإدخال لعقدة أخرى لإضافة العلاقة التابعة تلقائيًا في YAML. لا تسمح لك المنصة برسم حواف تشكل حلقات - سوف ترتد وتحمص إذا حاولت رسم حلقة.

عقدة انقر بزر الماوس الأيمن على القائمة

• تحرير - افتح مقتطف YAML لهذه الخطوة للتحرير الجزئي.
• نسخ - استنساخ نسخة من الخطوة الحالية (يتم إضافة المعرف تلقائيًا).
• حذف - سيتم إعطاء تحذير إذا كانت هناك مراجع في اتجاه مجرى النهر عند الحذف.
• تعيين كبداية/نهاية - قم بوضع علامة على الإدخال/الخروج الصريح لسير العمل (مطلوب فقط لـstate_machine).

التكبير والخريطة المصغرة

توجد خريطة صغيرة في الزاوية اليمنى السفلية، والتي تتيح لك القفز بسرعة عندما يتجاوز سير العمل المعقد حجم اللوحة القماشية. Ctrl / Cmd + عجلة التمرير للتكبير؛ مسافة + اسحب إلى المقلاة.

العمود الأيمن YAML

الإكمال التلقائي

استنادًا إلى مخطط JSON، يمكن إكمال أسماء الحقول الشائعة والأسماء المحددة مسبقًا ومعرفات الخطوات الموجودة. Ctrl / Cmd + صحوة قوة الفضاء.

أضعاف / تتكشف

انقر فوق السهم الموجود بجوار رقم السطر الموجود على اليسار لطي الخطوة بأكملها. مفتاح الاختصار Ctrl / Cmd + Shift + [ / ].

بحث واستبدال

Ctrl / Cmd + F بحث، Ctrl / Cmd + H استبدال. دعم الانتظام. سيؤثر هذا فقط على سير العمل الحالي، ولن يؤثر على سير العمل الآخر.

فريق التشخيص والقضايا

ولرئيس التحرير طبقة من الطول تتقاسم مجموعة واحدة من رموز القواعد:

• تشخيصات فورية جانب العملاء — Recomputed locally after every edit (structural rules like dependency cycles, dangling references, and suggestions for near-misspelled step ids), driving the issues panel, node signals, and toolbar card with zero latency.
• التحقق من صحة السيرفر — "اتصلت عندما تضغط على "التاريخ" في مخزن الأدوات POST /api/workflows/lintإعادة جميع القضايا في وقت واحد (يتوقف التصديق على الوقت المسبق عند الخطأ الأول، الإنحناء لا) وإضافة قواعد تحتاج إلى بيانات جانب الخادم، مثل رؤساء العملاء وعقود الوحدات.

وتظهر شارة الأدابار الخطأ/عد التحذير في الوقت الحقيقي (الضريبة عندما تكون هناك أخطاء، صفراء عندما تحذر فقط)؛ وتضغط عليها وتفتح فريق القضايا. وكل قضية تحمل رقاقة على درجة أعلى (انقر للقفز إلى العقد) ومعالجة مقترحة؛ ويمكنك أيضاً " التعايش مع منظمة العفو الدولية " من أجل قضية واحدة أو كلها - يجمّع المحرّر القضايا في عجل منظم ويرسلها إلى مساعد شؤون الإعلام.

الدرج الصحيح

AI مساعد

انقر على أيقونة "مساعد الذكاء الاصطناعي" في منتصف العمود الأيمن للتوسيع. يدعم:

• استخدم اللغة الطبيعية لوصف جزء من المنطق المطلوب تغييره، وسيقدم لك المساعد معاينة للفرق؛
• (أ) أوامر الاصطدام: /مصادرة/مصادرة/جديدة/غير مقدّمة/مساعدة؛;
• /undo reverts the Assistant's changes (up to 10 steps); the editor's own Ctrl / Cmd + Z can also undo the AI's changes one at a time.

رؤية القدرات الكاملة Orchestrate using AI Assistants.

لوحة نقاط التوقف

تضيء هذه اللوحة عند تنفيذ التنفيذ في وضع التصحيح. يمكنك إضافة/حذف نقاط التوقف وعرض سجل النتائج وتحرير المتغيرات أثناء الإيقاف المؤقت. انظر التفاصيل نقطة الانطلاق.

لقطة متغيرة

عند النقر على خطوة، تكون جميع المتغيرات متاحة قبل تنفيذ الخطوة - بما في ذلك var:* / Steps.*.data / classifier.* / credentials.* (سيتم عرض قيم بيانات الاعتماد بدون حساسية).

قفل التحرير التعاوني

يمكن لشخص واحد فقط تحرير نفس سير العمل في المرة الواحدة - من يدخل أولاً يحصل على القفل. عندما يصل إليه أشخاص آخرون، يكون في وضع القراءة فقط، وسيعرض شريط الحالة "xxx قيد التحرير". يتم تحرير القفل تلقائيًا بعد 5 دقائق من عدم النشاط، أو يتم إجباره على إلغاء القفل بواسطة المسؤول.

مفاتيح الاختصار شائعة الاستخدام

بعض العناصر الأكثر استخدامًا في المحرر - راجع القائمة الكاملة مختصرات لوحة المفاتيح.

• Ctrl / Cmd + S — أنقذ
• Ctrl / Cmd + E — تنفيذ (مربع حوار مفتوح)
• Ctrl / Cmd + Shift + V — التصديق
• Ctrl / Cmd + Z — تراجع (ينطبق على كل من محرر YAML + مساعد الذكاء الاصطناعي)
• Ctrl / Cmd + Shift + Z — Redo
• Alt + A — تبديل درج مساعد الذكاء الاصطناعي
• Alt + B — تبديل لوحة نقطة التوقف

الخطوة التالية

• 8 أنواع — المرجع الرسمي لكيفية كتابة كل خطوة
• YAML Syntax reference — مرجع ميداني أكثر تعمقا
• مساعد مساعد — استخدم اللغة الطبيعية لتغيير سير العمل