الاضطرابات

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

المتعلقة بالتنفيذ

يظل التنفيذ معلقًا ويظل قيد التشغيل.

تحقق أولا:

1. تحقق من قمة تاريخ التنفيذ لإشعار متوافق الحر هو واحد متزامن، برو 5، فريق 15 - هَلْ عددَكَ متزامنِ يَضْربُ الحدّ؟?
2. تحقق مما إذا كانت خطوة الموافقة اليدوية لسير العمل هذا عالقة في المقدمة.
3. دعها تنتظر لمدة 30 ثانية أخرى - لحظة عرضية. أمر العمل معلق بعد أكثر من دقيقتين.

فشل التنفيذ: credential_not_found

كيفية الإصلاح:

1. انظر إلى اسم بيانات الاعتماد المطلوب في error_message.
2. فتح مركز بيانات الاعتماد - هل توجد بيانات اعتماد بهذا الاسم بالفعل؟ يجب أن تكون الكتابة بالأحرف الكبيرة والشرطات السفلية/الشرطات متسقة.
3. هل قمت بإنشاء بيانات اعتماد في "مساحة اسم الفريق" ولكنك حاليًا في دور العارض؟ لا يمكن للعارض الرجوع إلى بيانات الاعتماد.
4. يوجد شيء ما في القائمة ولكن لم يتم تحليله - قم بتسجيل الخروج ثم تسجيل الدخول مرة أخرى لتحديث الأذونات.

فشل التنفيذ: Rate_limit_exceeded

سبب:يتم تفعيل الحد الحالي لموفر LLM الخاص بك أو بالمنصة.

كيفية الإصلاح:

1. أضف استراتيجية إعادة المحاولة إلى الخطوة الفاشلة:

- id: call_llm
  type: single
  agent: writer
  retry:
    max_attempts: 3
    backoff: exponential
    initial_delay_ms: 2000
    retry_on: [rate_limit, http_5xx]

2. إذا كنت تقوم بتقييم الحد الأقصى في كثير من الأحيان، فإن ترقية مستوى حساب المزود بواسطة BYOK هو الحل الأساسي.
3. عند تشغيل العديد من المهام دفعة واحدة، استخدم sub_workflow + max_parallel للتحكم في التزامن.

فشل التنفيذ: المهلة

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

كيفية الإصلاح:

• الخطوة الرمزية: إضافة حقل زمني واضح على الخطوة (في ثوان، التقصير 30).
• خطوة LLM: قد يكون إنشاء النموذج طويلًا جدًا؛ قم بتقليل max_tokens أو استخدم نموذجًا أسرع.
• سير العمل بأكمله بطيء: أضف حقل المهلة في الأعلى (بالثواني، الافتراضي 3600).

مخرجات الوكيل فارغة/غير معقولة

تحقق أولا:

1. تفاصيل التنفيذ → انقر فوق هذه الخطوة → انظر إلى "سجل استدعاء أداة الوكيل" لمعرفة ما إذا تم توجيهك إلى الأداة الخاطئة.
2. تحقق مما إذا كان متغير الإدخال فارغًا - هل تم تخطي الخطوة الأولية بالشرط؟
3. ضبط درجة الحرارة: 0–0.3 لمهام التفكير/التصنيف؛ 0.6-0.9 للإبداع.
4. وصف المهمة بالإضافة إلى أمثلة قليلة أكثر تحديدًا.
5. حاول التغيير إلى نموذج أقوى (claude-opus-4-7 / gpt-5).

تقارير خطوة التعليمات البرمجية تم رفض الإذن أو خطأ في الشبكة

The code step runs in an isolation Sandbox, with restrictions:

• نظام الملفات للقراءة فقط - فقط /tmp قابل للكتابة؛
• يمكن للشبكة الخروج فقط وليس الدخول (لا يمكنها مراقبة المنفذ)؛
• يتم تحديد سقف لوحدة المعالجة المركزية/الذاكرة/وقت التشغيل.

كيفية الإصلاح:يعني رفض الإذن عادةً أنك تحاول الكتابة إلى مسار آخر غير /tmp - /tmp/something بدلاً من ذلك. تحدث معظم أخطاء الشبكة بسبب حظر وضع الحماية للمضيف المستهدف (يحتوي النظام الأساسي على قائمة بيضاء للخروج). يمكنك إرسال أمر عمل لإضافة القائمة البيضاء.

الحفظ والتحرير ذات الصلة

المطالبة "YAML غير متوافق مع DAG" عند الحفظ

هذا يعني أن قاعدة الذهاب والإياب غير راضية بعد أن قمت بتغيير YAML يدويًا. الأسباب الشائعة:

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

سيؤدي النقر فوق الزر "تحقق" إلى منحك رقم السطر الدقيق - قم بإصلاحه وفقًا لموقع الخطأ.

لا يمكن فتح المحرر / يستمر في الدوران في دوائر

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

فشل التحقق من الفرق الذي قدمه مساعد الذكاء الاصطناعي بعد التطبيق.

Ctrl / Cmd + Z to undo-the editor supports multi-level undo. ثمّ يَعْبرُ رسالةَ الخطأَ بالإضافة إلى يَعُودُ YAML الأصلي إلى المساعدِ وهو سَيُعالجُه.

الجدولة / Webhook ذات الصلة

cron لم يتم تشغيله عند هذه النقطة

1. هل يتوافق "وقت التشغيل التالي" في صفحة تفاصيل الجدول مع التوقعات؟ يعد عدم تطابق المنطقة الزمنية هو السبب الأكثر شيوعًا.
2. هل يوجد أي سجل لـ "آخر 10 تاريخ تشغيل"؟ إذا لم يكن الأمر كذلك، فمن المحتمل أنه تمت أرشفة سير العمل أو حذفه.
3. انظر إلى حالة سير العمل - هل تم إيقافه مؤقتًا؟ لا يزال جدول الإيقاف المؤقت مهمًا، ولكن لن يتم تشغيله فعليًا.
4. يعد التحقق يدويًا من سير العمل نفسه باستخدام الزر "التشغيل مرة واحدة الآن" أمرًا جيدًا.

Webhook إرجاع الزناد 401/403

1. الطريقة الرئيسية للشركة: هل هو المفتاح في الرخصة: (بيرر) أو (إكس بي آي كي) صحيح؟ هل إنتهت المُفتاح، وهل به نطاق (ويبوك)؟?
2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
3. هل هويّة (ويهوك) في طريق (يورل) صحيحة؟ هل تم حذف تدفق العمل المقابل؟?

Webhook Trigger 200 لكن التنفيذ لا يبدأ

200 يعني فقط "قبول الطلب"، وقد يتم رفض التنفيذ:

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

سجل تشغيل Webhook - في علامة التبويب "السجل" في صفحة تفاصيل الجدولة، يمكنك الاطلاع على تفاصيل تحليل النظام الأساسي بعد تلقي الطلب.

المتعلقة بالموافقة

manual_approval لا تدفع الإخطارات أبدًا

1. هل صفحة "تكوين الإشعارات" مرتبطة بأي قناة من قنوات Slack/Feishu/Email؟
2. سجل التدقيق → تصفية الموافقة_notify_failed - تعرف على سبب عدم إمكانية إرسال الإشعار (عنوان url الخاص بالويب هوك غير صالح؟ ارتداد البريد الإلكتروني؟).
3. عندما تكون قائمة المعتمدين فارغة، سيتم إعلام "جميع المسؤولين وما فوق" افتراضيًا - هل حسابك واحد منهم؟

لقد وافقت ولكن سير العمل لم يستمر

يجب أن يستمر سير العمل بعد الموافقة خلال 10 ثوانٍ. لم يستمر لأكثر من دقيقة واحدة:

1. قم بتحديث صفحة تفاصيل التنفيذ. هل هو قيد التشغيل بالفعل؟
2. النظام مشغول وقد يتم وضعه في قائمة الانتظار لمدة 30 ثانية - إلخ.
3. رفع أمر العمل بعد أكثر من 5 دقائق.

الفريق/الإذن ذات الصلة

لا يمكن رؤية سير العمل بعد تبديل الفرق

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

يقول الزملاء أنه ليس لديهم إذن لتغيير سير عمل معين

هل هو عارض في هذا الفريق؟ العارض للقراءة فقط. فقط قم بترقيته من مشرف إلى محرر.

أنا لست المالك، ولكني أريد نقل سير العمل الذي قمت بإنشائه

يتطلب "الانتقال إلى الفريق" أن تكون محررًا أو أعلى في الفريق المستهدف. فقط انضم إلى الفريق المستهدف بنفسك.

الدفع/الفاتورة

فشل تحصيل الرسوم من بطاقة الائتمان

1. صفحة الفوترة → "إعادة محاولة الخصم". بعد 3 حالات فشل، سيتم تخفيض الحزمة مؤقتًا إلى مجانية - وستتم استعادتها تلقائيًا طالما قمت بخصم الأموال بنجاح في غضون 14 يومًا.
2. قد يتم التحكم في مخاطر البطاقات الصينية بواسطة Stripe، يرجى استخدام Alipay/WeChat Pay.

عنوان الفاتورة خاطئ

يمكنك تغيير تفاصيل الفواتير على صفحة بيلينغ قبل إصدار فاتورة الشهر القادم وتحتاج الفواتير التي صدرت بالفعل إلى إرسال بريد إلكتروني إلى فواتير البريد الإلكتروني: billing@braidrun.com لإبطالها وإعادة إصدارها.

حاولت كل شيء ولكن لا يزال لا يعمل

1. "مساعدة" في الزاوية اليمنى السفلى → أرسل أمر عمل. إرفاق سياق المتصفح تلقائيًا + معرف التنفيذ الأحدث.
2. خطة المؤسسة → اتصل مباشرة بـ CSM المخصص.