المفاهيم الأساسية

جميع الوظائف في Braidrun - اللوحة القماشية، وYAML، والجدولة، والموافقة، والمراقبة - تدور حول مجموعة مقيدة للغاية من المفاهيم الأساسية. تضع هذه الصفحة هذه المفاهيم في صورة حتى يتسنى لك "معرفة الإحداثيات بغض النظر عن المقالة التي ستقرأها لاحقًا."

سير العمل · سير العمل

سير العمل هو كائن المستوى الأعلى لهذا النظام الأساسي. يمكنك اعتباره "مخططًا عمليًا تجاريًا قابلاً للإصدار"، ويتكون من:

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

ويظهر نفس تدفق العمل على أنه كانفاة من طراز DAG في الموقع الشبكي " UI " ؛ و " Canvas " و " YAML " هما رأيان في تعريف واحد. (الدم في (غيت) هم من ينشرون الـ(يام إل) العاديين، وليس تفريغ فوضوي لـ(جيون).

A work flow can be triggered in five ways:

1. يدوي — انقر فوق "تنفيذ" في المحرر، أو ابدأ دفعات من القائمة.
2. الجدول — تعابير قرونية، فترة ثابتة، جدول زمني لمرة واحدة، أو زناد مُقيد يُطلق بعد ثوانٍ من اكتمال سير العمل في أعلى المجرى.
3. Webhook — (أ) مصدقاً عليه من قبل نظام خارجي " أوبست " ، مصدقاً عليه بمفتاح " API " (توقيعات " HMAC " المدعومة بالتوافق).
4. API — ابدأوا تنفيذاً من نظامكم الخاص باستخدام نقطة النهاية.
5. جزءا لا يتجزأ من سير العمل الأصل — يتم استدعاؤه كمربع أسود بواسطة سير عمل آخر من خلال خطوة سير العمل الفرعي.

خطوة · خطوة

الخطوة هي أصغر وحدة تنفيذ في سير العمل. يجب أن تحدد كل خطوة "وضعًا رئيسيًا" واحدًا فقط ويمكنها تحديد ذلك:

• single — يقوم وكيل واحد بتنفيذ وصف مهمة واحدة. أكثر برامج LLM خفيفة الوزن التي تدعو إلى البدائية.
• group_chat — يناقش العديد من الوكلاء بالتناوب ويشيرون إلى سياق بعضهم البعض. مناسبة للعصف الذهني والمراجعة النقدية.
• agent_based — يقرأ وكيل منسق المهمة ويرسل المهام الفرعية ديناميكيًا إلى الوكيل العامل.
• code — 代码脚本（Python / JavaScript / TypeScript / Bash / Ruby / Lua / CLI 共 7 种），在隔离沙箱中执行。确定性 > LLM 的场景首选。
• classifier — The LLM assigns a category label to the input; the result is written to the variable named in output variable, so later steps can branch on it via condition.
• state_machine — ولايات متعددة + شروط انتقال الدولة. مناسب للتكرارات المتعددة أو سير العمل الذي يحتوي على عمليات صغيرة.
• sub_workflow — استدعاء سير عمل آخر كمربع أسود، مع التحقق من العقد، والكشف عن الحلقات، وعزل المتغيرات.
• workflow_output_read — اقرأ المخرجات التي نشرها تنفيذ سير العمل (نشر) وخزنها في المتغيرات المحلية.

علاوة على الوضع الرئيسي، يمكن لأي خطوة تقريبًا أن تغطي مجالات التحسين الشائعة التالية:

• depends_on / condition — المعالين قبل الاستحقاق + تخطي الظروف (تأييد التسليم على المستوى الأعلى)
• manual_approval — بوابة الموافقة اليدوية: وقف التنفيذ والاستمرار بعد الموافقة
• parallel / timeout_seconds — Config / step timeout
• retry — استراتيجية إعادة المحاولة للتراجع عن الأخطاء العابرة
• repeat_until / iterate_over — مطروحاً إلى أن يتم استيفاء شرط ما/يكرر على بند من بنود المجموعة
• extract / aggregate — حدد الحقول من الإخراج/دمج مدخلات متعددة
• publish_outputs — ننشر قطعة أثرية خطوة على أنها نواتج لسير العمل
• idempotent — تنازل عن نفس الناتج، لا آثار جانبية، على العد الآلي بعد إعادة تشغيل الخدمة، يقرر ما إذا كان يمكن إعادة ترتيب الخطوة المقطعة
• on_success / on_failure — الإجراءات التكميلية بعد النجاح/الفشل (إرسال الإخطارات، وكتابة عمليات التدقيق، وما إلى ذلك)

وكيل·وكيل

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

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

يمكن الرجوع إلى الوكيل من خلال خطوات متعددة؛ سيؤدي تنفيذ كل خطوة إلى فتح نسخة جلسة جديدة (بدون ذاكرة سلسلة). انظر التفاصيل دليل المفاوضة.

الوحدة النمطية · الوحدة النمطية

الوحدة النمطية هي "سير عمل يعلن WorkflowModuleContract" - أي سير عمل قابل لإعادة الاستخدام يكشف عن عقد المدخلات/المخرجات ويمكن استدعاؤه بواسطة مسارات عمل أخرى من خلال sub_workflow.

القيمة التي جلبتها الوحدة:

• مكتوب + التحقق من العقد على المستوى الميداني، لن يكون هناك "جميع المشاكل النهائية إذا تم تغيير الحقل"
• تنفيذ الصندوق الأسود - لا يستطيع المتصل رؤية الخطوات الداخلية ويمكن أن يتطور المنطق الداخلي بشكل مستقل
• الكشف عن الحلقة المزدوجة في وقت التشغيل + وقت الإصدار لتجنب "المراجع A B، والمراجع B A"
• نقرة واحدة للترويج (استخراج خطوة إلى وحدة نمطية)/تخفيض (استعادة الوحدة النمطية إلى خطوة مضمنة) في مكتبة الوحدة النمطية

(ب) سفن مكتبة الوحدات التي تحتوي على 120 وحدة مدمجة (اللوغاريت، وحساب الريح الزمنية، وسحب تقرير وكالة الفضاء الأسترالية، وتقارير الإكسل، وإيصال سلاك، وأكثر)؛ انظر وحدة بناء مكتبة؛ قم بإنشاء الوحدة النمطية الخاصة بك انظر التحديث وإعادة الاستخدام.

التنفيذ·التنفيذ

التنفيذ هو مثيل تشغيل محدد لسير العمل. دورة حياتها هي آلة الحالة:

PENDING → RUNNING → COMPLETED / FAILED / CANCELLED / INTERRUPTED

عندما يضرب باب الموافقة، يتوقّف تنفيذ في حالة انتظار وتستأنف آلة الولاية بعد قرار.

كل تنفيذ لديه:

• مصدر التشغيل (يدوي/جدول زمني/خطاف الويب/واجهة برمجة التطبيقات/sub_workflow)
• وقت البدء، وقت الانتهاء، الوقت الإجمالي المستغرق، الوقت المستغرق لكل خطوة
• جميع أحداث الإدخال/الإخراج/الأحداث المتوسطة (تدفق أحداث SSE)
• الرمز المميز/التكلفة المتراكمة
• قائمة التحف التي تم إنشاؤها

When the service restarts expectedly, in-progress executions are marked INTERRUPTED. With recovery.autoResumeOnRestart enabled, they can auto-resume from the interrupted step; see استئناف تلقائي بعد إعادة تشغيل الخدمة.

أوراق الاعتماد · أوراق الاعتماد

بيانات الاعتماد هي التخزين الموحد للمعلومات الحساسة مثل "API Key وWebhook Secret وOAuth Token". جميع القيم مشفرة بمعيار AES-256-GCM ومخزنة على جانب الخادم. بمجرد كتابتها، لا يمكن قراءتها مرة أخرى (يمكن فقط الكتابة فوقها أو حذفها).

يتم البحث في روابط التحليل بالترتيب، وتصبح النتيجة الأولى سارية المفعول:

1. مساحة الاسم الشخصية للمستخدم الحالي
2. مساحة الاسم لفريق المستخدم
3. مساحة اسم النظام (المفتاح العام الذي تم تكوينه بواسطة المسؤول)

يتم تحليل خطوات الوكيل/الكود عند الطلب في وقت التشغيل، ولا تتم كتابتها مطلقًا في السجلات، ولا تظهر في عمليات تصدير YAML، ولا تكون مرئية للخطوات الأخرى من المتصل.

المهارة / الأداة · المهارات والأدوات

"أيدي" الوكيل - الوظائف التي يمكن استدعاؤها أثناء استدلال LLM. مقسمة إلى ثلاث فئات:

• مجموعة أدوات مدمجة — file_system / shell / web / browser / code_execution انتظر، سيتم ربطه افتراضيًا بالإعداد المسبق.
• MCP أدوات التمديد — يمكن تسجيل أي أداة مكشوفة بواسطة خادم MCP.
• سوق المهارات — اختر مهارة منشورة في "سوق المهارات" وقم بتنشيطها بنقرة واحدة.

الاختلافات والتعبيرات

يتم تمرير كافة القيم الديناميكية من خلال الأقواس المتعرجة المزدوجة {{ ... }} مرجع ثلاثة أشكال:

• {{var:name}} — متغير أعلى مستوى لتدفق العمل
• {{steps.plan.output}} — ناتج الخطوة الأولى
• {{plan}} — الاستمارة: النظر في الناتج بإسم الخطوة أولا، ثم القيمة بالاسم المتغير

نتيجة المصنف مكتوبة إلى المتغير المسمى في ناتجه... متوافرة، ولا تعبر بيانات الاعتماد عن متغيرات النموذج: في الوقت الذي يتم فيه حلها بواسطة مقدم من مركز الإبداع والحقن؛ والمتغيرات المسلمة إلى خطوة رمزية تُحقن كمتغيرات البيئة WF VAR.

للحصول على بناء الجملة الكامل (JSONPath، عامل التصفية، تعبيرات الشرط) راجع الاختلافات والتعبيرات.

اجمعهم معًا في صورة

       ┌──────────── 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)

أنت تعرف بالفعل أين تبحث

• يدك الأولى — قم بربط المفاهيم المذكورة أعلاه في سير عمل حقيقي
• 8 أنواع — مرجع رسمي مخصص للوضع الرئيسي
• الاختلافات والتعبيرات — تسلسل البيانات بين الخطوات
• مسرد — عند قراءة مستندات أخرى ومواجهة كلمات جديدة، عد وابحث عنها