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

توضّح هذه الصفحة خيارات الضبط التالية:

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

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

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

يمكنك أيضًا إنشاء إخراج منظَّم، بما في ذلك JSON والقيم التعدادية.

قبل البدء

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

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

تستخدم الأمثلة في دليل البدء وضع 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
    }
  }
});