إثبات تدفق العمل من نموذج

في Braidrun، يعد "إنشاء مثيل من القالب" هو الأسلوب الأكثر شيوعًا لإنشاء سير العمل: أكثر من 90% من المستخدمين لا يكتبون سير العمل الأول من السبورة البيضاء، ولكنهم يستنسخون سير العمل من القالب ثم يعدلونه وفقًا لأعمالهم الخاصة. تقسم هذه المقالة العملية إلى كل زر.

نظرة عامة على العملية الكاملة

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

الخطوة 1 · تصفح معرض النماذج

1.1 فتح المدخل

التنقل الرئيسي على اليسار هو "مكتبة النماذج". هيكل الصفحة:

• شريط التصفية العلوي - 10 فئات صناعية + علامات + بحث بالكلمات الرئيسية
• شبكة بطاقة القالب - تعرض الاسم والوصف والعلامات والمدة المقدرة والتعقيد
• "مجموعتي" في الزاوية اليمنى العليا - يمكن جمع القوالب طويلة المدى وإدخالها مباشرة في المرة القادمة

1.2 استراتيجيات الاختيار المشتركة

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

الخطوة 2 · اقرأ تفاصيل القالب

انقر على بطاقة القالب للدخول إلى صفحة التفاصيل، مع التركيز على أربعة أجزاء:

2.1 قسم "الوصف".

في فقرتين أو ثلاث فقرات، أخبرك: ما هي المشكلات التي يحلها، وما هي السيناريوهات الأكثر ملاءمة لها، وما هي السيناريوهات التي لا تناسبها، وما هي الاستعدادات المطلوبة قبل الاستخدام.

2.2 قائمة "أوراق الاعتماد المطلوبة"

قم بإدراج بيانات الاعتماد المطلوبة لتشغيل سير العمل هذا بوضوح، على سبيل المثال:

• openai_api_key — مفتاح OpenAI API (مطلوب)
• slack_webhook_url — عنوان URL الوارد لـ Webhook الوارد من Slack (للتسليم، اختياري)
• apple_appstoreconnect — App Store Connect JWT (مطلوب فقط للقوالب ذات الصلة بـ Apple)

إذا كانت إحدى بيانات الاعتماد "المطلوبة" مفقودة، فسيفشل سير العمل عند الوصول إلى الخطوة المقابلة. عندما تكون كلمة "اختياري" مفقودة، سيتم تخطي الخطوة ذات الصلة حسب الشرط.

2.3 "الوقت والتكلفة المقدرة"

تنفيذ كامل:

• الوقت المستغرق - دقيقتين / 15 دقيقة / ساعة واحدة، اعتمادًا على مدى تعقيد سير العمل وسرعة استجابة التبعية الخارجية
• استخدام الرمز المميز - متوسط إدخال xxx / إخراج xxx
• $ المقدرة - القيمة التقريبية المحسوبة بناءً على الإعداد المسبق الافتراضي للنظام الأساسي وسعر وحدة OpenAI

2.4 "مثال للمدخلات ومثال للمخرجات"

نموذج إدخال محدد (يمكنك فقط نسخه وتشغيله مرة واحدة) + نموذج الإخراج المقابل (حتى يكون لديك فكرة عن "ربما ما يمكنك الحصول عليه").

الخطوة 3 · استنساخ مساحة العمل

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

الخطوة 4 · تخصيص معلمات العمل

قسم المتغيرات 4.1 هو المكان الوحيد الذي تحتاج إلى النظر فيه بعناية

عندما يفتح المحرر، قم أولاً بالتمرير عبر YAML إلى قسم المتغيرات في الأعلى. جميع "الأشياء التي تحتاج إلى تعديل في سير العمل هذا وفقًا لحالة عملك" موجودة هنا، وقد تم التعليق عليها بالفعل:

variables:
  target_date:
    type: string
    default: yesterday    # ← 改成你要跑哪一天的数据
    description: |
      支持 yesterday / last_7_days / last_30_days /
      或具体日期 2026-04-17

  top_n:
    type: number
    default: 10           # ← 要拉多少条新闻
    description: 抓取的新闻数量上限

  target_channel:
    type: string
    default: "#my_daily_digest"  # ← 改成你的 Slack 频道名或保留默认 webhook 目标
    description: Slack 目标频道或 Incoming Webhook 默认目标

4.2 قم بتغيير القيمة الافتراضية وفقًا للتعليق

القيمة الافتراضية هي مجرد "مثال"، يرجى استبدالها بالقيمة الحقيقية في عملك. لن يؤدي تغيير المتغيرات إلى تدمير البنية، لذا لا تتردد في تغييرها.

4.3 من العادات الجيدة عدم التحرك بخطوات

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

الخطوة 5 · أكمل مركز الاعتماد

1. افتح مركز الاعتماد.
2. قم بإنشاء بيانات اعتماد مقابلة لكل بيانات اعتماد "مطلوبة" مدرجة في صفحة تفاصيل القالب. يجب أن يكون الاسم مطابقًا تمامًا للاسم المقتبس في YAML.
3. يمكن ترك بيانات الاعتماد "الاختيارية" بدون إنشاء في الوقت الحالي - سيتم تخطي الخطوات ذات الصلة.

الخطوة 6 · التشغيل الجاف أولاً، ثم التشغيل

6.1 معنى الجفاف

يتم تشغيل التشغيل الجاف عبر DAG بدون تكلفة، متخطيًا جميع تأثيرات LLM والآثار الجانبية. يساعدك على التأكد قبل إنفاق المال:

• هل تم ملء جميع المتغيرات بشكل صحيح؟
• تتدفق المتغيرات بين الخطوات
• تم تحديد فرع الشرط/المصنف بشكل صحيح.
• يمكن حل اسم بيانات الاعتماد التابعة ل

6.2 المدى الحقيقي

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

6.3 ما يجب مشاهدته بعد الجري

• "عرض تفاصيل التنفيذ" - مخطط جانت + الإدخال/الإخراج لكل خطوة
• "عمود المنتج" - يمكن تنزيل Markdown / Excel / الصورة التي تم إنشاؤها مباشرة
• "الرموز / التكلفة" —— كم أنفقت هذه المرة؟

الخطوة 7 · ربط المشغلات حسب الحاجة

بعد التشغيل اليدوي، يصبح سير العمل جاهزًا للاتصال بالإنترنت. ثلاث طرق تشغيل شائعة:

• تشغيلات مجدولة — يومي/أسبوعي/شهري، أو كرر على فترات
• مشغل Webhook — نظام خارجي معتمد لتفعيله، مصدق عليه بمفتاح نظام المعلومات المسبقة عن علم (تم أيضاً دعم توقيعات المركز)
• نظامك الداخلي يستخدم مفتاحاً لإستدعاء (آرتي إي إي إي إي إي إي) وبدء تنفيذ

تحديث النموذج: مواكبة النسخ النموذجية الجديدة

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

أين تجده

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

استعراض ما قبل الترقية

ويقسم العرض المسبق الاختلافات المتغيرة إلى ثلاث فئات، ويدرجها بواحدة:

• الاحتياطي — المتغيرات التي تغيرت بالفعل والتي لا تزال موجودة في النموذج الجديد قيمك تبقى بعد التحديث
• جديدة — المتغيرات التي أضيفت حديثاً في النموذج الجديد المملوءة بتخلف النماذج، للتكيف حسب الحاجة بعد رفع المستوى
• تحذف — )أ( التغيرات التي لم تعد موجودة في النموذج الجديد بعد الترقية. التحقق من هذا البند من القائمة حسب البنود قبل تأكيد

ماذا يحدث خلال التحديث

• سير العمل الحالي هو أول من يرتقي بنسخة سريعة لذا يمكنك العودة من قائمة الفيرزيون إذا غيرت رأيك
• تشكيلة هيكلية - خطوة DAG، وكيل عجلات، رمز، توقيتات، وما شابه -
• النماذج التي اخترتها محميّة من أجل عملاء نفس الاسم، اختيار نموذجك وإشارة اختراع نموذجيّة
• إقامة تنتمي لك - اسم تدفق العمل، البطاقات، التطابق، وهكذا في اليسار غير ممسوح

تدفق العمل الأكبر سناً مع عدم تسجيل نموذج المصدر؟?

وقد لا يكون لتدفقات العمل المستنسخة في وقت مبكر أي مصدر مسجل، وفي هذه الحالة يبدو البند نفسه في قائمة التحرير كما هو الحال بالنسبة لمخطط لينك. السجل الذي يُستدل منه (والعلامة الاختيارية التي يطابقها حالياً)، ويعمل التدفق المحسن عادة من حين لآخر.

متقدم: اسمح لمساعد الذكاء الاصطناعي بتغييره وفقًا لوصفك

بعد الاستنساخ، إذا كانت متطلبات العمل غير متوافقة تمامًا مع القالب، فيمكنك أن تطلب من مساعد الذكاء الاصطناعي مساعدتك في إصلاحه:

1. يفتح FAB الموجود في الزاوية اليمنى السفلية درج مساعد الذكاء الاصطناعي
2. قم بوصف احتياجاتك - على سبيل المثال "تغيير خطوة التسليم من Telegram إلى Feishu"
3. سيعطيك المساعد معاينة مختلفة ويمكنك قبولها أو رفضها.
4. انقر فوق "تطبيق" عندما تكون راضيًا - مكدس التراجع ذو 10 مستويات يحميك من التراجع في أي وقت

متى يجب عليك التبديل إلى مساعد الذكاء الاصطناعي أو الكتابة اليدوية؟

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

• Category details and Representative Templates — سيخبرك ممثلون مختارون من كل فئة صناعية بما يمكن أن تفعله كل فئة
• المحرر البصري — ما هي الأزرار التي يجب عليك النقر عليها بعد الاستنساخ؟
• مساعد مساعد — استخدم اللغة الطبيعية لتعديل/إنشاء سير العمل