البداية السريعة

تنقلك هذه المقالة من "مجرد فتح موقع الويب" إلى "التشغيل خلال سير عمل حقيقي" دون كتابة تعليمات برمجية أو تثبيت أي شيء في المنتصف. تابع معنا وسوف تتعرف تقريبًا على جميع المفاهيم الأكثر استخدامًا في Braidrun Workflow.

معاينة البانوراما: ما يمكن توقعه في هذه المعاينة

وفيما يلي المسار الذي سنتخذه بالترتيب. ستشرح كل خطوة "لماذا تفعل هذا"، وليس دليل التشغيل الجاف:

1. تسجيل حساب → تسجيل الدخول
2. انتقل إلى صفحة "سير العمل" للتعرف على وحدة التحكم الرئيسية
3. استنساخ سير عمل جاهز من مكتبة النماذج
4. تحقق من هيكلها بالتشغيل الجاف
5. ربط مفتاح LLM الخاص بك (BYOK)
6. قم بتشغيله مرة واحدة وافهم تدفق الأحداث في الوقت الفعلي
7. قم بتعليق cron واتركه يعمل تلقائيًا كل يوم

الخطوة 1 · تسجيل حساب

1.1 افتح صفحة التسجيل

انقر على "تسجيل الدخول" في الزاوية اليمنى العليا من الصفحة الرئيسية، أو انقر على "إنشاء حساب" في أسفل صفحة تسجيل الدخول، أو قم بزيارة الموقع مباشرة /register.

1.2 رمز الدعوة أو التسجيل المفتوح

Braidrun حاليًا في المرحلة التجريبية المغلقة للمدعوين فقط، مما يعني:

• أنت بحاجة إلى رمز الدعوة لإكمال التسجيل؛
• إذا لم يكن لديك رمز الدعوة، فيرجى ترك عنوان بريدك الإلكتروني في نموذج "التقدم للحصول على رمز الدعوة" الموجود على الصفحة الرئيسية. سوف نتصل بك أولاً عند فتح الحصة.

بعد الحصول على رمز الدعوة، ما عليك سوى ملء البريد الإلكتروني + كلمة المرور + رمز الدعوة. يمكنك أيضًا استخدام Google/GitHub OAuth لتسجيل الدخول بنقرة واحدة (لا تتطلب هذه الطريقة رمز دعوة ولكنها لا تزال بحاجة إلى انتظار موافقة المسؤول). للحصول على إجراءات مفصلة، راجع التسجيل والتسجيل.

1.3 التحقق من البريد الإلكتروني وتفعيله

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

الخطوة 2 · أدخل وحدة تحكم سير العمل

2.1 التنقل الرئيسي الأيسر

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

• تدفقات العمل — ساحة المعركة الرئيسية الخاصة بك. يتم سرد جميع سير العمل هنا.
• النماذج — 240+ سير العمل المسبق والمستنسخة والذهاب.
• Modules — 120+ وحدات قابلة لإعادة الاستخدام، بالإضافة إلى الوحدات التي تروجين لها.
• التاريخ — قائمة بكل عمليات execution الأخيرة.
• الجداول — إدخالات تشغيل التوقيت/خطاف الويب.
• الموافقة — عندما يكون سير العمل في خطوة "الموافقة اليدوية"، يوافق المعتمد من هنا.
• بيانات الاعتماد — يتم وضع جميع مفاتيح API هنا وتخزينها مشفرة.

2.2 ثلاثة مداخل سريعة للصفحة الرئيسية

الصفحة الرئيسية ليست مساحة فارغة. ويوفر ثلاث نقاط انطلاق:

1. إنشاء سير عمل فارغ جديد — ابدأ بقماش فارغ. يوصى باختيار هذا بعد أن تكون على دراية بالمنصة بالفعل.
2. استنساخ من القالب — يتبع هذا الدليل هذا المسار. ابدأ بسرعة.
3. دع مساعد الذكاء الاصطناعي ينشئ — يفتح FAB الموجود في الزاوية اليمنى السفلية مساعد الذكاء الاصطناعي الجانبي. استخدم اللغة الطبيعية لوصف ما تريد القيام به، وسوف تعطيك المسودة الأولى.

الخطوة 3 · الاستنساخ من مكتبة النماذج

3.1 اختر القالب الأقرب إلى عملك

فتح اليسار النماذج. توجد مرشحات تصنيف في الزاوية اليسرى العليا (أتمتة العمليات، تسليم الإعلانات، تحليل البيانات، تطوير iOS، إنشاء المحتوى، مراجعة الامتثال ...)؛ توجد مربعات بحث ومرشحات للعلامات في الزاوية اليمنى العليا.

يوصى باختيار إحدى هاتين الفئتين لأول مرة:

• "ملخص الأخبار اليومية" — المنطق بسيط، والخطوات قليلة، ويمكن رؤية تدفق البيانات بالكامل.
• "تقرير آسا الأسبوعي" — السيناريو الحقيقي للأعمال التجارية، باستخدام الجدول الزمني + تدفق العمل الفرعي + التسليم السريع.

3.2 قراءة بطاقات القالب

انقر لرؤية:

• "الوصف" - ماذا يفعل
• "بيانات الاعتماد المطلوبة" - ما هي المفاتيح التي يجب ملؤها عند التشغيل؟
• "مثال للمدخلات/المخرجات" - ممثل للنتائج النموذجية
• "المدة/التكلفة المقدرة" - ما هو عدد الدقائق تقريبًا وكم عدد الدولارات التي ستكلفها عملية التشغيل؟

3.3 استنساخ لمساحة العمل

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

الخطوة 4 · استخدم التشغيل الجاف لإلقاء نظرة أولية على الهيكل

4.1 لماذا من الضروري التجفيف؟

القيمة الأساسية للتشغيل التجريبي هي "التكلفة صفر": ستتم عبر DAG الكاملة، ولكن سيتم استبدال جميع مكالمات LLM والآثار الجانبية الخارجية (إرسال الرسائل، وكتابة قواعد البيانات، وخصم المدفوعات، وما إلى ذلك) بـ no-ops الآمنة. يمكنك أن ترى:

• أين يتدفق المتغير إلى - مقتبس {{...}} هل هناك أي خطأ إملائي؟
• الخطوات التي يتم تخطيها حسب الشرط
• ما هي بيانات الاعتماد التي يعتمد عليها القالب - تعرف مسبقًا على ما يجب تكوينه في مركز بيانات الاعتماد

4.2 ابدأ التشغيل الجاف في المحرر

1. في الجزء العلوي من محرر سير العمل، انقر فوق "تنفيذ".
2. حدد "التشغيل الجاف (لا تقم بضبط LLM/لا تولد آثارًا جانبية)" في مربع الحوار.
3. املأ بعض المعلمات الضرورية وفقًا لمطالبات القالب، واترك الباقي كإعداد افتراضي.
4. انقر فوق "بدء التنفيذ". سيتحول المحرر تلقائيًا إلى عرض تفاصيل التنفيذ.

الخطوة 5 · تكوين مفتاح LLM (BYOK)

5.1 ما هو BYOK

"أحضر مفتاحك الخاص". يمكنك الحصول على مفتاح API من موفر مثل OpenAI / Anthropic وإضافته إلى Braidrun بحيث يمكن استدعاؤه نيابةً عنك. فوائد:

• يتم تسجيل استهلاك الرمز مباشرة في حساب LLM الخاص بك، ولا يزيد النظام الأساسي من السعر.
• يمكنك استخدام النماذج المتقدمة لحسابك الخاص - مثل Claude Opus، وGPT-5 - دون الضمان الموحد للمنصة.
• إن تدوير/إلغاء المفاتيح أمر متروك لك تمامًا.

5.2 احصل على المفتاح

الأكثر شيوعا:

• OpenAI — platform.openai.com/api-keys
• Anthropic — console.anthropic.com
• DeepSeek — platform.deepseek.com
• Kimi — platform.moonshot.cn

5.3 قم بتخزينه في بيانات الاعتماد

1. مفتوح بيانات الاعتماد.
2. انقر فوق "بيانات اعتماد جديدة".
3. حدد api_key كنوع؛ اختر اسمًا مميزًا، مثل openai_main、anthropic_personal؛ تلصق القيمة المفتاح الذي حصلت عليه من الموفر.
4. يحفظ. ستستخدم المنصة على الفور AES-256-GCM لتشفير قاعدة البيانات - بعد ذلك، لا يمكن الكتابة فوق هذا الحقل إلا ولا يمكن قراءته مرة أخرى.

للحصول على شرح أكثر اكتمالا (مساحة الاسم من المستوى الثالث، ربط الموفر، عملية التناوب)، راجع بيانات الاعتماد و BYOK · استخدم مفتاح LLM الخاص بك.

الخطوة 6 · قم بجولة حقيقية

6.1 بدء التنفيذ

1. ارجع إلى محرر سير العمل وانقر على "تنفيذ" في الأعلى.
2. هذه المرة في مربع الحوار إلغاء تحقق من التشغيل الجاف.
3. املأ المعلمات الضرورية مرة أخرى - عادةً ما تكون هي نفسها المستخدمة في التشغيل الجاف في المرة الأولى.
4. انقر فوق "بدء التنفيذ".

6.2 فهم تدفق الأحداث في الوقت الفعلي على اليمين

على يمين الصفحة هو مجرى الأحداث في الوقت الحقيقي على شبكة ويب سوكيت كل صف هو حدث ويمكنك التصفية حسب الفئة

• Agent (أوترنس) ناتج Agent الوسيط الأكثر شيوعاً في سلاسل;
• (ب) دعوة الإدارة المحلية - موجز لكل نداء نموذجي، مع تحديد المدخلات/الناتج؛;
• (أ) نداء عن بعد - أي أداة دعاها الوكيل؛ وتوسيع نطاقه لرؤية الحجج وقيمة العودة؛;
• رسالة خارجية - سجل للرسائل التي أرسلها تدفق العمل إلى قنوات مثل سلاك أو تلغرام.

للمزيد من فئات الأحداث، انظر رصد التنفيذ وقطع الأشجار.

6.3 انظر إلى النتائج والمنتجات

بعد انتهاء التشغيل، انقر فوق "عرض تفاصيل التنفيذ" في الأعلى:

• يعد كل شريط أخضر في مخطط جانت خطوة ناجحة؛ حرك الماوس لمعرفة المدة التي استغرقها.
• انقر فوق خطوة لرؤية لقطة الإدخال/الإخراج/السجل/المتغير الخاصة بها.
• يمكنك معاينة أو تنزيل Markdown / Excel / لقطات الشاشة وما إلى ذلك في عمود المنتج.

الخطوة 7 · قم بتعليق cron واتركه يعمل تلقائيًا

7.1 إنشاء جدول جديد

1. "إدارة الجدولة" على اليسار → "جدول جديد".
2. باعتباره سير العمل المستهدف، حدد المسار الذي قمت بتشغيله للتو.
3. حدد كرون كنوع؛ املأ التعبير 0 8 * * *(8:00 صباحًا كل يوم)؛ حدد آسيا/شنغهاي كمنطقة زمنية.
4. إذا كان سير العمل يحتوي على متغيرات، فقم بملء القيم الافتراضية لمجموعة الجداول هذه في "المعلمة الافتراضية" (سيبدأ كل مشغل مجدول بهذه القيم).
5. يحفظ. يوجد عنصر آخر في القائمة، ويتم حساب "وقت التشغيل التالي" وعرضه في الوقت الفعلي.

7.2 كيفية ضمان عدم الازدواجية في الجدولة

يقوم النظام الأساسي تلقائيًا بتنفيذ الأقفال الموزعة في ظل النشر متعدد المثيلات: سيتم تشغيل نفس الجدول الزمني فقط على جهاز واحد في نفس الدقيقة. لا داعي للقلق بشأن تكرار عمليات التشغيل.

يمكن أيضًا تكوين جدولة التوقيت في الوضع الفاصل / لمرة واحدة. لمزيد من التفاصيل، انظر تشغيلات مجدولة.

بعد القيام بذلك، أنت تعرف بالفعل كيفية القيام بذلك

• استكمال عملية التسجيل/تسجيل الدخول/التحقق من البريد الإلكتروني
• استنساخ مكتبة القوالب → تشغيل المحرر الجاف → الحلقة الأساسية للتشغيل الحقيقي
• دور مركز الاعتماد وأهمية BYOK
• The ability to read the realtime event stream and the execution details page
• قم بتعليق سير العمل على مدخل التشغيل التلقائي cron

ماذا تشاهد بعد ذلك

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