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

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

يمكنك أيضًا إنشاء مخرجات منظَّمة، بما في ذلك 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) لـ JS).

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

// ...

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

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

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

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

هذا النموذج هو النموذج الاحتياطي المستضاف على السحابة الإلكترونية عند استخدام وضع 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",
    generationConfig: {
      maxOutputTokens: 200,
      stopSequences: ["red"]
    }
  }
});

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

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

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

const model = getGenerativeModel(ai, {
  mode: InferenceMode.INFERENCE_MODE,
  onDeviceParams: {
    createOptions: {
      expectedInputs: [{ type: "text", languages: ["en"] }],
      expectedOutputs: [{ type: "text", languages: ["en"] }],
      initialPrompts: [
        { role: "system", content: [{ type: "text", value: "You are a helpful and concise assistant." }] }
      ]
    }
  }
});


تقديم ملاحظات حول تجربتك مع Firebase AI Logic