منسّق Gemini 4 Hydrogen: كيف يخطط Carbon وينفّذ Hydrogen

يُعد Gemini 4 Hydrogen Orchestrator أحد خيارات النماذج في Google Antigravity، ويجمع بين مُخطِّط (Gemini 4 Carbon أو Argon) وGemini 4 Hydrogen داخل مهمة واحدة. يتولى المُخطِّط الاستكشاف وكتابة الخطة، بينما يقوم Hydrogen بتعديل الكود وتشغيل الاختبارات، وتعود العملية إلى المُخطِّط كلما واجه Hydrogen عقبة. تقول Google إنه يصل إلى معدل نجاح قريب من Carbon مع استهلاك أقل للحصة بنسبة 24%.

في الأسفل: كيف تعمل حلقة تسليم التحكم، وماذا تعني رقما 24% و19%، وأي الخطط تحصل عليه، وكيف تبني التقسيم نفسه باستخدام Gemini API. وللاطلاع على أساسيات النموذج، اقرأ ما هو Gemini 4 Hydrogen.

ما هو Gemini 4 Hydrogen Orchestrator؟

Orchestrator هو عنصر في قائمة اختيار النماذج في Antigravity، وليس نموذجًا منفصلًا. اختر Orchestrator (Carbon) فيخطط Gemini 4 Carbon بينما ينفذ Gemini 4 Hydrogen. واختر Orchestrator (Argon) فيتولى التخطيط Gemini 4 Argon بدلًا منه. تحدث التبديلات تلقائيًا داخل كل استجابة، وفي محادثة واحدة.

أطلقت Google هذه الميزة في 12 نوفمبر 2026. وتشير إعلانات Antigravity إلى المشكلة: تشغيل نموذج استدلال رائد في «كل خطوة من كل مهمة روتينية يبطئ دورة عملك ويستهلك حصة النماذج الرائدة».

ثلاث حقائق يجب أن تكون واضحًا فيها:

متاح في Antigravity فقط. لا توجد نقطة نهاية Orchestrator في Gemini API.
له إعداد ثابت. لا يمكنك ضبط مستوى التفكير فيه.
هو وكيل واحد، وليس سربًا. للوكلاء المتوازيين، يوجهك Antigravity إلى subagents أو /swarm أو Boost أو Teamwork.

كيف يعمل تسليم التحكم بين Carbon وHydrogen في Orchestrator؟

تصف وثائق نماذج Antigravity أربع خطوات تتكرر داخل كل دورة:

المُخطِّط يخطط. تبدأ كل رسالة ترسلها بمرحلة قراءة فقط. يستكشف المُخطِّط قاعدة الكود، ويحل الغموض، ويكتب خطة تنفيذ ملموسة، بما في ذلك الشروط التي يجب أن تؤدي إلى إعادة التخطيط. أما الأسئلة العادية فيُجاب عنها مباشرة.
Hydrogen ينفذ العمل. يطبق تعديلات الملفات، ويكتب الكود، ويشغيل عمليات البناء والاختبارات، ويتحقق من النتائج مقابل الخطة.
يعود التحكم عند ظهور العقبات. إذا فشلت خطوة تحقق مرتين، أو تصرفت واجهة برمجية بشكل مختلف عما هو متوقع، أو لم تحسم الخطة خيارًا تصميميًا، يعيد Hydrogen التحكم إلى المُخطِّط. يفحص المُخطِّط حالة المحادثة، ويصلح الخطة، ويعيد التسليم للتنفيذ.
المُخطِّط يراجع التقدم. في المهام الأطول، وكلما أرسلت رسالة أثناء التشغيل، يقدم Hydrogen تقريرًا عن التقدم. يتحقق المُخطِّط منه مقابل الخطة، ثم يختم العمل أو يتابعه أو يحدّث الخطة.

الخيار التصميمي الذي يستحق المحاكاة موجود في الخطوة 1: المُخطِّط يكتب بنفسه محفزات إعادة التخطيط. يتسلم Hydrogen قائمة مكتوبة بالشروط التي تعني «توقف واسأل».

لماذا تقول Google إن موجّهات النماذج الثابتة تنهار في عمليات الوكلاء الطويلة؟

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

Diagram comparing a static router, which guesses difficulty once from the first prompt and sends the whole task to one model, with Orchestrator, where Gemini 4 Carbon planning segments and Gemini 4 Hydrogen edit, build and test segments alternate along one task timeline with hand-offs in both directions

بعبارة Google: الموجّهات «تبدأ بالانهيار كلما أصبح الوكلاء أطول تشغيلًا، إذ تتطلب مستويات مختلفة من التعقيد في مراحل مختلفة، وكثيرًا ما يُكتشف ذلك أثناء تطور المهمة». قد تبدو ترقية تبعيات ما أمرًا تافهًا حتى تظهر تغييرات جذرية في واجهة برمجية في الخطوة 7. الموجّه الذي اختار النموذج الرخيص لا سبيل له إلى الرجوع؛ والذي اختار النموذج الرائد يدفع أسعار النماذج الرائدة عند كل إعادة تشغيل للاختبارات. أما Orchestrator فيتخذ القرار لكل مرحلة، وفي الاتجاهين.

ماذا تعني أرقام الحصة 24% والسرعة 19%؟

تذكر Google أنه على Terminal-Bench وصل Orchestrator إلى «معدلات نجاح قريبة من Carbon مع استهلاك أقل للحصة بنسبة 24% في المتوسط وإنجاز أسرع بنسبة 19%». اقرأ هذه الأرقام مع أربعة تحفظات:

الادعاء	ما يقوله	ما لا يقوله
نجاح قريب من Carbon	قريب من Carbon عند تشغيله منفردًا	لم يُنشر معدل نجاح دقيق في أي من المنشورين
حصة أقل بنسبة 24%	حصة خطة Antigravity، في المتوسط	ليس عددًا من التوكنات ولا مبلغًا بالدولار
أسرع بنسبة 19%	متوسط زمن إنجاز المهمة	ليس زمن الاستجابة لكل طلب
إصدار المعيار القياسي	Terminal-Bench 4.0 في منشور الإطلاق من Google، و4.1 في منشور Antigravity	أي إصدار هو الصحيح

هذه أرقام Google من عملياتها، وهي إشارة وليست تنبؤًا لمستودعك أنت. المهام كثيفة التخطيط توفر القليل؛ أما كثيفة التنفيذ (ترقية 40 حزمة وإصلاح الاختبارات) فينبغي أن توفر أكثر.

المنطق المالي أوضح على مستوى الـ API. يكلف Gemini 4 Hydrogen 1.50 دولارًا لكل مليون توكن إدخال و7.50 دولارًا لكل مليون توكن إخراج. أما Carbon فيكلف 2.00/10.00 دولارات حتى 30 نوفمبر، ثم 4.00/20.00 دولارات اعتبارًا من 1 ديسمبر، وفقًا لـ دليل أسعار Gemini 4 Carbon. تُحتسب توكنات التفكير ضمن الإخراج، لذا كل دورة تنفيذ تنقلها من Carbon إلى Hydrogen تخفض معدل إخراج تلك الدورة بنسبة 62.5% بأسعار ديسمبر.

من يمكنه استخدام Orchestrator، وعلى أي الخطط؟

يتوفر Orchestrator في Antigravity فقط، ويعتمد المُخطِّط الذي تحصل عليه على خطة Google AI الخاصة بك. من وثائق Antigravity، بتاريخ 13 نوفمبر 2026:

الخيار	المُخطِّط	المنفذ	الخطط
Orchestrator (Carbon)	Gemini 4 Carbon	Gemini 4 Hydrogen	Google AI Ultra
Orchestrator (Argon)	Gemini 4 Argon	Gemini 4 Hydrogen	Google AI Ultra؛ وGoogle AI Pro المدفوع (أو تجارب على أجهزة مميزة مؤهلة)

مستخدمو الخطة المجانية وGoogle AI Plus يحصلون على Hydrogen منفردًا لكن دون Orchestrator. وفيما يخص Enterprise، يوجد تعارض بين جدول الوثائق وإعلان Antigravity، لذا تحقق من قائمة اختيار النماذج لديك.

في واجهة Antigravity CLI، مرر اسم الخيار بين علامتي اقتباس:

agy --model "Orchestrator (Carbon)"
agy -p "Add input validation to the signup form and run the tests." --model "Orchestrator (Argon)"

تتردد بين المُخطِّطين؟ يغطي مقارنتنا بين Gemini 4 Carbon وArgon مقاييس الاختيار بينهما.

متى تختار Orchestrator بدلًا من نموذج واحد؟

تصف وثائق Google Orchestrator بأنه «الخيار الافتراضي الموصى به» للعمل اليومي:

Orchestrator: تطوير الميزات، وإصلاح الأخطاء، وإعادة الهيكلة، وتصحيح الأخطاء متعددة الملفات.
Carbon أو Argon منفردًا: الأعمال التي تحتاج كل خطوة فيها إلى أقصى عمق، مثل تصميم الأنظمة الموزعة، أو تتبع حالات التزامن (race conditions)، أو الترحيل بين مستودعات متعددة.
Hydrogen منفردًا: ترقيات الحزم، وإزالة الازدواجية، والكود القالب، واختبارات الوحدة للدوال المحددة بوضوح، والتوثيق، والسكربتات السريعة.

قاعدة عملية: إذا كنت ستكتب خطة قبل البدء، استخدم Orchestrator. وإذا كنت ستبدأ الكتابة مباشرة، استخدم Hydrogen.

كيف تبني تقسيم التخطيط/التنفيذ نفسه باستخدام Gemini API؟

خارج Antigravity، عليك بناء حلقة Orchestrator بنفسك. يصف دليل الجديد في Gemini 4 Hydrogen من Google الآلية: «وجّه دورات التخطيط إلى gemini-4-carbon ودورات التنفيذ إلى gemini-4-hydrogen في جلسة واحدة متعددة الأدوار باستخدام previous_interaction_id». ولا حاجة إلى أي تغييرات في مخطط الطلبات بين النموذجين.

Flowchart of a do-it-yourself plan and execute loop on the Gemini API: gemini-4-carbon writes a read-only plan with re-plan triggers, passes it via previous_interaction_id to gemini-4-hydrogen, which executes each step and runs tests; passing checks move to the next step, and a check that fails twice or a plan gap escalates back to Carbon, which reviews and wraps up

نسخة Python مبسطة تحاكي قاعدة «الفشل مرتين يعني إعادة التسليم»:

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY

def ask(model, prompt, prev=None, level="high"):
    return client.interactions.create(
        model=model,
        input=prompt,
        previous_interaction_id=prev,
        generation_config={"thinking_level": level},
    )

# 1. Carbon plans (read-only) and writes its own re-plan triggers
plan = ask("gemini-4-carbon",
    "Plan this task as numbered steps. For each step, list the check "
    "that proves it worked and the conditions that require re-planning. "
    "Do not write code yet. Task: " + task)
last = plan.id

for step in parse_steps(plan.output_text):
    failures = 0
    while True:
        # 2. Hydrogen executes the step
        run = ask("gemini-4-hydrogen", f"Implement step: {step}", prev=last)
        last = run.id
        ok, log = apply_and_test(run.output_text)  # your patch + test runner
        if ok:
            break
        failures += 1
        if failures >= 2:
            # 3. Escalate to Carbon to repair the plan
            fix = ask("gemini-4-carbon",
                f"Step failed twice. Test log:\n{log}\nRepair the plan for this step.",
                prev=last)
            last = fix.id
            step, failures = fix.output_text, 0

# 4. Carbon reviews the finished work
review = ask("gemini-4-carbon", "Review the completed work against the plan.", prev=last)

تحتوي الدالتان parse_steps وapply_and_test على منطق البناء والاختبار الخاص بمستودعك. أربعة أمور يجب إتقانها:

اضبط مستويات التفكير لكل دور. الافتراضي في Carbon هو medium والحد الأقصى high. أما Hydrogen فيبدأ افتراضيًا بـ high ويضيف xhigh.
احتفظ بالحالة على الخادم. يحمل previous_interaction_id السجل بين النماذج، والتخزين المؤقت الضمني يخفض تكلفة الإدخال المتكرر بنسبة 95%. بينما يمنعه store=false.
اجعل التصعيد صريحًا. انسخ محفزات Orchestrator إلى موجه المُخطِّط.
سجّل التوكنات لكل دورة. يذكر كائن usage الحقل total_thought_tokens على حدة، بحيث يمكنك معرفة أي دور يستهلك.

صيغ الطلبات والمصادقة موضحة في دليل Gemini 4 Hydrogen API لدينا.

وإذا كنت تفضل عدم بناء الحللة يدويًا، تقول Google إن Antigravity SDK يتيح لك ربط وكلاء Hydrogen وCarbon معًا مع تحكم برمجي في الأدوار. في عرضه التوضيحي، يتولى وكلاء Hydrogen تصنيف المشكلات وكتابة الكود بينما يتولى وكيل Carbon مهام إعادة الهيكلة والفحوصات الأمنية.

اختبر تسليم التحكم من Carbon إلى Hydrogen باستخدام Apidog CLI

ينهار المُنسِّق الذي تبنيه بنفسك عند نقطة التسليم: معرّف نموذج خاطئ، أو ضياع previous_interaction_id، أو مستوى تفكير يرفضه Carbon. دع وكيل البرمجة لديك (Claude Code أو Codex أو Cursor) يبني اختبارًا من خطوتين باستخدام Apidog CLI ثم يشغّله.

نفّذ الإعداد مرة واحدة:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

ثم امنح وكيلك موجهًا واحدًا:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Build a test scenario with two steps against POST /v1beta/interactions,
both sending the x-goog-api-key header:
1. Planner: model "gemini-4-carbon", thinking_level "high", input asks for a
   3-step plan. Assert status 200, status "completed", non-empty output and a
   usage object. Extract $.id into plannerId.
2. Executor: model "gemini-4-hydrogen", thinking_level "medium",
   previous_interaction_id {{plannerId}}, input "Do step 1 of the plan".
   Assert the same checks. Log total_input_tokens, total_thought_tokens and
   total_output_tokens for both steps. Run it and summarize failures.

فيقرأ الوكيل المخطط، ويتحقق من صحة حمولته، ويكتب السيناريو ويشغّله:

apidog environment create gemini --project <projectId> \
  --base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file scenario.json
apidog test-scenario create --project <projectId> --name "carbon-to-hydrogen"
apidog test-scenario update <scenarioId> --project <projectId> --file scenario.json
apidog test-scenario run <scenarioId> --project <projectId> -e <envId> \
  -r cli,json --out-file handoff-{GENERATE_TIME}

يعرض تقرير JSON استهلاك التوكنات لكل دور جنبًا إلى جنب. أضف -r junit فيدخل التشغيل نفسه إلى CI، بحيث يفشل البناء عند أي تغيير في معرّف النموذج أو أي خلل في التسليم؛ ويوضح دليل Apidog CLI لخطوط CI/CD بناء الخط، بينما يغطي Apidog CLI في Claude Code إعداد الوكيل. تغطي الخطة المجانية من Apidog ما يصل إلى 4 مستخدمين.

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

هل يتوفر Gemini 4 Hydrogen Orchestrator في Gemini API؟ لا. إنه خيار في قائمة اختيار النماذج ضمن Google Antigravity. في الـ API، أنت من يبدل بنفسك بين gemini-4-carbon وgemini-4-hydrogen باستخدام previous_interaction_id.

هل يمكنني ضبط مستوى التفكير لـ Orchestrator؟ لا. يعمل بإعداد ثابت. اختر Carbon أو Argon أو Hydrogen مباشرة إذا كنت تحتاج مستوى محددًا.

هل أحتاج Google AI Ultra؟ بالنسبة إلى Orchestrator (Carbon)، نعم. أما مشتركو Google AI Pro المدفوع فيحصلون على Orchestrator (Argon). ويمكن للمستخدمين المجانيين استخدام Hydrogen منفردًا؛ راجع دليلنا لاستخدام Gemini 4 Hydrogen مجانًا.

هل يوفر Orchestrator المال على الـ API؟ التقسيم نفسه يوفر: دورات التنفيذ تُحتسب بسعر Hydrogen البالغ 7.50 دولارات لكل مليون توكن إخراج بدلًا من Carbon. ويحتوي دليل أسعار Gemini 4 Hydrogen على الجدول الكامل.