Gemini Decisions API: أسئلة مغلقة تعود بأرقام، وما الفرق بينه وبين Jev

عندما يحتاج برنامجك إلى قرار صغير، مثل «هل هذه الرسالة طلب استرجاع؟»، فالمعتاد أن تسأل نموذج chat، ثم تقرأ النص الذي يكتبه وتحوله إلى قرار. في 11 نوفمبر 2026 أطلقت Google الـ Gemini Decisions API ليختصر ذلك: ترسل السؤال، فيعود رقم يتصرف به برنامجك مباشرة. لم أجربه بعد.

ما هو

ترسل مدخلًا واحدًا، نصًا أو صورة أو صوتًا أو فيديو أو ملف PDF، ومعه حتى 1,000 سؤال. لكل سؤال نوع من ثلاثة:

• نعم أو لا (تسميه Google ‏noul): يعيد احتمال أن الجواب نعم، بين 0.01 و0.99.
• اختيار: يختار من قائمة فيها من خيارين إلى 255، مع احتمال كل خيار.
• درجة: يضع المدخل على سلم مستويات تكتبها أنت، من الأدنى إلى الأعلى.

مع كل جواب درجة ثقة بين 0 و1، فتقرر في الكود متى ينفذ البرنامج وحده، ومتى يرسل الحالة إلى إنسان. تقول Google إن الطلب يستغرق عادة بين 150 و250 جزءًا من الألف من الثانية، عندما يكون المدخل حتى 16 ألف token، والأسئلة من سؤال واحد إلى 100. السعر 0.10 دولار لكل مليون token من المدخلات، والمخرجات مجانية، والمدخل يحسب مرة واحدة مهما كان عدد الأسئلة.

كيف يقارن بـ Jev

Jev نموذج من شركة TypeSafe AI ظهر في 15 سبتمبر 2026، قبل Gemini بنحو شهرين. كتب Simon Willison أن Gemini يكاد يطابقه: الأنواع الثلاثة نفسها، وحتى اسم noul. الفروق:

• ما يقرؤه: Jev يقرأ النص وJSON فقط. Gemini يقرأ أيضًا الصور والصوت والفيديو وملفات PDF.
• السعر: Jev بـ 0.042 دولار لكل مليون token، أي أقل من نصف سعر Gemini. والمخرجات مجانية في الاثنين.
• الوصول: Jev في early access بقائمة انتظار. Gemini متاح للجميع، مع تجربة مجانية في AI Studio.
• احتمال نعم: في اختبار Simon Willison أعطى Jev أسئلة نعم أو لا احتمال 1.0 أو 0.0. Gemini يبقى بين 0.01 و0.99، وأعطى مثلًا 0.92 لسؤال «هل في الفيديو robot؟».

وفي أكتوبر 2026 أطلقت OpenAI أداة مشابهة بالأسئلة الثلاثة نفسها، تقرأ النص والصور، وسعرها مثل Gemini.

إذا كان كل ما عندك نص، فـ Jev أرخص. أما التسجيل الصوتي والفيديو وملف PDF، فلا يقرؤها من الثلاثة إلا Gemini.

كيف تبدأ

تحتاج إلى حساب Google، وPython 3 على جهازك، ونحو 15 دقيقة بتقديري، فلم أجربه بنفسي. التجربة مجانية في AI Studio.

1. افتح aistudio.google.com/api-keys وأنشئ مفتاح API. لا تضعه في أي ملف تشاركه.

2. ثبت المكتبة (الإصدار 3.2 أو أحدث). السطر الثاني ينتظر أن تلصق المفتاح وتضغط Enter، ولن يظهر المفتاح على الشاشة:

   pip install -U google-genai
   read -rs GEMINI_API_KEY && export GEMINI_API_KEY

   Terminalنسخ

3. أنشئ ملف المثال من توثيق Google وشغله:

   cat > decide.py <<'EOF'
   from google import genai
   
   client = genai.Client(http_options={"api_version": "v1beta"})
   
   result = client.decisions.create(
       model="gemini-decision-1",
       input="The blue mug I ordered on Monday arrived cracked on Wednesday.",
       questions={
           "is_damaged": {
               "type": "noul",
               "instructions": "Did the item arrive damaged?",
           },
       },
   )
   
   answer = result.answers["is_damaged"]
   print(f"P(yes)={answer.noul:.2f} confidence={answer.confidence:.2f}")
   EOF
   python3 decide.py

   Terminalنسخ

   تحقق: يجب أن ترى سطرًا مثل P(yes)=0.99 confidence=0.99. إذا ظهر خطأ عن المفتاح، فأعد السطر الثاني من الخطوة 2 في الـ Terminal نفسه الذي تشغل فيه الملف.

4. اطلب من الـ coding agent الذي تستخدمه أن يكيف الملف لبياناتك:

   Read Google's Decisions API docs at https://aistudio.google.com/docs/decisions-api. Adapt decide.py to my case: <what the input is, for example customer emails>. Ask these questions: <your yes/no, choice or score questions, with their options or levels>. Send every case with confidence below <threshold, for example 0.7> to a list for a person to review. Compare numbers and dates in code, not inside the questions. Do not put my API key in the file.
   

   Promptنسخ

   النتيجة الجيدة ملف يطبع لكل مدخل الجواب ودرجة الثقة، ويفصل الحالات غير الواضحة.

إذا لم يعمل كما تتوقع:

• خطأ 400: رسالة الخطأ تذكر القاعدة التي خالفتها. أسماء الأسئلة بأحرف إنجليزية وأرقام و_ و- فقط.
• فاز خيار لا يناسب: الاختيار يوزع الاحتمال على خياراتك دائمًا، حتى إن لم يناسب أي منها. أضف خيار other بوصف واضح، وانظر إلى درجة الثقة.
• أخطاء في الأرقام والتواريخ: توصي Google بمقارنتها في الكود، ثم إرسال النتيجة في المدخل.

الحدود

• يعيد رقمًا ولا يعيد سببًا. نبه Simon Willison، وهو يكتب عن Jev، إلى أن الرقم وحده قد يخفي تحيزًا، وتمنى ألا يستخدمه أحد لترتيب المتقدمين لوظيفة. Gemini يعيد رقمًا مثله.
• أرقام الدقة والسرعة من Google نفسها، وأرقام Jev من TypeSafe نفسها.
• لم تذكر Google العربية، ولم أختبرها.
• متاح الآن عبر Gemini API فقط، ودعم Google Cloud «قريبًا».
• قد يحاول نص يكتبه المستخدم أن يؤثر على الجواب. توصي Google بمعايير واضحة، وبمراجعة إنسان للقرارات المهمة مثل الدفع.