خيارات الإعداد للتجارب المختلطة في تطبيقات الويب

توضّح هذه الصفحة خيارات الإعداد التالية:

• ضبط وضع الاستدلال

• إلغاء نموذج الاحتياطي التلقائي المستضاف على السحابة الإلكترونية

• استخدام إعدادات النموذج للتحكّم في الردود، مثل درجة الحرارة

يمكنك أيضًا إنشاء ناتج منظَّم، بما في ذلك JSON وenums.

قبل البدء

تأكَّد من إكمال دليل البدء لإنشاء تجارب مختلطة.

ضبط وضع الاستنتاج

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

• PREFER_ON_DEVICE: استخدِم النموذج المتوفّر على الجهاز فقط إذا كان متاحًا، وإلا استخدِم النموذج المستضاف على السحابة الإلكترونية.

  const model = getGenerativeModel(ai, { mode: InferenceMode.PREFER_ON_DEVICE });
  

• ONLY_ON_DEVICE: استخدام النموذج على الجهاز فقط إذا كان متاحًا، وإلا طرح استثناء.

  const model = getGenerativeModel(ai, { mode: InferenceMode.ONLY_ON_DEVICE });
  

• ‫PREFER_IN_CLOUD: استخدِم النموذج المستضاف على السحابة الإلكترونية إذا كان متاحًا، وإلا استخدِم النموذج المتوفّر على الجهاز.

  const model = getGenerativeModel(ai, { mode: InferenceMode.PREFER_IN_CLOUD });
  

• ONLY_IN_CLOUD: استخدِم النموذج المستضاف على السحابة الإلكترونية إذا كان متاحًا، وإلا اطرح استثناءً.

  const model = getGenerativeModel(ai, { mode: InferenceMode.ONLY_IN_CLOUD });
  

تحديد ما إذا تم استخدام الاستدلال على الجهاز فقط أو في السحابة

إذا كنت تستخدم وضعَي الاستنتاج PREFER_ON_DEVICE أو PREFER_IN_CLOUD، قد يكون من المفيد معرفة الوضع الذي تم استخدامه لطلبات معيّنة. يتم توفير هذه المعلومات من خلال السمة inferenceSource لكل استجابة (تتوفّر بدءًا من الإصدار 12.5.0 من حزمة تطوير البرامج (SDK) المستندة إلى JavaScript).

عند الوصول إلى هذه السمة، ستكون القيمة المعروضة إما ON_DEVICE أو IN_CLOUD.

// ...

console.log('You used: ' + result.response.inferenceSource);

console.log(result.response.text());

تجاوز النموذج الاحتياطي التلقائي

النموذج التلقائي المستضاف على السحابة الإلكترونية هو gemini-2.5-flash-lite (بدءًا من الإصدار 12.8.0 من حزمة تطوير البرامج (SDK) في JavaScript).

هذا النموذج هو النموذج الاحتياطي المستضاف على السحابة الإلكترونية عند استخدام وضع PREFER_ON_DEVICE. وهو أيضًا النموذج التلقائي عند استخدام الوضع ONLY_IN_CLOUD أو الوضع PREFER_IN_CLOUD.

يمكنك استخدام خيار الإعداد inCloudParams لتحديد نموذج بديل تلقائي مستضاف على السحابة الإلكترونية.

const model = getGenerativeModel(ai, {
  mode: InferenceMode.INFERENCE_MODE,
  inCloudParams: {
    model: "GEMINI_MODEL_NAME"
  }
});

يمكنك الاطّلاع على أسماء النماذج لجميع نماذج Gemini المتوافقة.

استخدام إعدادات النموذج للتحكّم في الردود

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

يتم الاحتفاظ بالإعدادات طوال مدة تشغيل الجهاز الافتراضي. إذا أردت استخدام إعداد مختلف، أنشئ مثيلاً جديدًا من GenerativeModel باستخدام هذا الإعداد.

ضبط النموذج المستضاف على السحابة الإلكترونية

استخدِم الخيار inCloudParams لضبط نموذج Gemini مستضاف على السحابة الإلكترونية. مزيد من المعلومات عن المَعلمات المتاحة

const model = getGenerativeModel(ai, {
  mode: InferenceMode.INFERENCE_MODE,
  inCloudParams: {
    model: "GEMINI_MODEL_NAME"
    temperature: 0.8,
    topK: 10
  }
});

ضبط نموذج "على الجهاز فقط"

يُرجى العِلم أنّ الاستنتاج باستخدام نموذج على الجهاز يستخدِم Prompt API من Chrome.

استخدِم الخيار onDeviceParams لضبط نموذج على الجهاز فقط. مزيد من المعلومات عن المَعلمات المتاحة

const model = getGenerativeModel(ai, {
  mode: InferenceMode.INFERENCE_MODE,
  onDeviceParams: {
    createOptions: {
      temperature: 0.8,
      topK: 8
    }
  }
});