AI Agents · درس

عمليات النشر Blue-Green وCanary للوكلاء

انشر المطالبات والنماذج الجديدة إلى 5% من حركة المرور، وراقب المقاييس، ثم وسّع النطاق — ولا تطلقها دفعة واحدة.

عمليات النشر Blue-Green وCanary للوكلاء درس مجاني في AI Agents على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

يختلف نشر الوكلاء

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

استخدموا استراتيجيات نشر مصممة لاكتشاف التراجعات مبكرًا.

عمليات نشر Blue-Green

بيئتان متطابقتان:

Blue — بيئة الإنتاج الحالية
Green — الإصدار الجديد

حوّلوا نسبة الحركة من 0% إلى 100% في خطوة واحدة بعد اختبار Green.

عمليات نشر Canary

حوّلوا الحركة تدريجيًا إلى الإصدار الجديد:

5% ← راقبوا المقاييس
20% ← راقبوا
50%
100%

تراجعوا عن النشر في أي خطوة إذا تدهورت المقاييس.

ما الذي يجب مراقبته

معدل الأخطاء
زمن الاستجابة p95
التكلفة لكل طلب
إشارات ملاحظات المستخدمين (نسبة الإعجاب إلى عدم الإعجاب)
معدل اجتياز التقييمات على مجموعة ظل من الحركة الفعلية

Routing With a Feature Flag

import random

def pick_agent_version(user_id):
    if launchdarkly.variation('use-v2', user_id, default=False):
        return v2
    if random.random() < canary_pct:
        return v2
    return v1

# Roll canary_pct from 0 to 1.0 gradually.

الإطلاق لكل مستأجر

أطلقوا الإصدار لكل مستأجر في SaaS الموجهة للشركات — ابدؤوا بالمستخدمين الداخليين، ثم العملاء المتعاونين، ثم الجميع:

if user.org_id in EARLY_ACCESS_ORGS:
    return v2
return v1

وضع الظل

شغّلوا الإصدار الجديد بالتوازي، لكن لا تقدموا مخرجاته للمستخدم:

v1_result = run_v1(query)
async def shadow():
    v2_result = await run_v2(query)
    log_compare(v1_result, v2_result)
asyncio.create_task(shadow())
return v1_result

إعادة تشغيل حركة الإنتاج

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

اختبارات A/B

لتجارب الجودة طويلة الأجل، قسّموا الحركة عشوائيًا وقارنوا المقاييس إحصائيًا على مدى أسابيع.

إصدارات المطالبات

تعاملوا مع المطالبات مثل التعليمات البرمجية — ثبّتوا إصدارًا، وشغّلوه جنبًا إلى جنب مع النموذج، وأطلقوه عبر علامة:

PROMPTS = {
    'qa-v3': '...',
    'qa-v4': '...'
}
active = 'qa-v4' if feature_flag_on() else 'qa-v3'

تثبيت إصدار النموذج

ثبّتوا إصدار النموذج (gpt-4o-2024-08-06) حتى لا يؤدي تحديث المزوّدين لنماذجهم الافتراضية إلى تغيير السلوك بصمت بين ليلة وضحاها.

التراجع التلقائي

إذا تجاوز أحد المقاييس حدًا معينًا، فأعيدوا تلقائيًا نسبة Canary إلى 0% وأطلقوا تنبيهًا:

if p95_latency_now > 1.5 * p95_latency_baseline:
    flag.set('canary_pct', 0)
    alert('Auto-rollback triggered')

وثّقوا كل إصدار

تتضمن ملاحظات كل إصدار:

ما الذي تغيّر (المطالبة أو النموذج أو الاسترجاع)
نتائج التقييم قبل التغيير وبعده
الجدول الزمني لـ Canary
ما إذا تم التراجع عن الإصدار

لماذا Canary؟

لماذا نستخدم عمليات نشر Canary للوكلاء بدلًا من الإصدارات التي تُنشر في خطوة واحدة؟

مراجعة

وجّهوا الحركة عبر علامة ميزة، وارفعوا النسبة من 5% إلى 100%، وراقبوا الأخطاء وزمن الاستجابة والتكلفة والملاحظات، وتراجعوا سريعًا عند الحاجة. أضيفوا وضع الظل وإعادة التشغيل لزيادة الثقة.

الأسئلة الشائعة

هل درس «عمليات النشر Blue-Green وCanary للوكلاء» مجاني؟

نعم — نص درس «عمليات النشر Blue-Green وCanary للوكلاء» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents 4 دروس في المجموع.

ماذا ستتعلم في «عمليات النشر Blue-Green وCanary للوكلاء»؟

انشر المطالبات والنماذج الجديدة إلى 5% من حركة المرور، وراقب المقاييس، ثم وسّع النطاق — ولا تطلقها دفعة واحدة. تتمرن على AI Agents مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ AI Agents؟

لا تُشترط خبرة سابقة. AI Agents على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «عمليات النشر Blue-Green وCanary للوكلاء»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس AI Agents هذا؟

نعم. كل درس في AI Agents يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى AI Agents