في كلّ طلب إلى نموذج، يمكنك إرسال إعدادات النموذج للتحكّم في كيفية إنشاء النموذج للردّ. يقدّم كل نموذج خيارات إعدادات مختلفة.
يمكنك تجربة الطلبات وإعدادات النماذج وإجراء عمليات تكرار سريعة باستخدام Vertex AI Studio.
Gemini الانتقال إلى خيارات ضبط Imagen الانتقال إلى خيارات ضبط
ضبط نماذج Gemini
يوضّح لك هذا القسم كيفية إعداد عملية ضبط لاستخدامها مع نماذج Gemini، ويقدّم وصفًا لكل مَعلمة.
إعداد إعدادات النموذج (Gemini)
الإعدادات لحالات الاستخدام العامة
اضبط قيم المَعلمات في ملف تعريف الارتباط
GenerationConfig
كجزء من إنشاء مثيل GenerativeModel
واستدعاء
generateContent
أو generateContentStream
أو startChat
.
يتم الاحتفاظ بالإعدادات طوال مدة عمل النسخة. إذا أردت
استخدام إعدادات مختلفة، أنشئ مثيلًا جديدًا من GenerativeModel
باستخدام تلك الإعدادات.
// ...
// Set parameter values in a `GenerationConfig` (example values shown here)
val config = generationConfig {
maxOutputTokens = 200
stopSequences = listOf("red")
temperature = 0.9f
topK = 16
topP = 0.1f
}
// Specify the config as part of creating the `GenerativeModel` instance
val generativeModel = Firebase.vertexAI.generativeModel(
modelName = "GEMINI_MODEL_NAME ",
generationConfig = config
)
// ...
// ...
// Set parameter values in a `GenerationConfig` (example values shown here)
GenerationConfig.Builder configBuilder = new GenerationConfig.Builder();
configBuilder.maxOutputTokens = 200;
configBuilder.stopSequences = List.of("red");
configBuilder.temperature = 0.9f;
configBuilder.topK = 16;
configBuilder.topP = 0.1f;
GenerationConfig generationConfig = configBuilder.build();
// Specify the config as part of creating the `GenerativeModel` instance
GenerativeModel gm = FirebaseVertexAI.getInstance().generativeModel(
"GEMINI_MODEL_NAME ",
generationConfig
);
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
// ...
يمكنك العثور على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.
الإعدادات الخاصة بـ Gemini Live API
اضبط قيم المَعلمات في ملف تعريف
LiveGenerationConfig
كجزء من إنشاء مثيل LiveModel
.
يتم الاحتفاظ بالإعدادات طوال مدة عمل النسخة. إذا أردت
استخدام إعدادات مختلفة، أنشئ مثيلًا جديدًا من LiveModel
باستخدام تلك الإعدادات.
// ...
// Set parameter values in a `LiveGenerationConfig` (example values shown here)
val config = liveGenerationConfig {
maxOutputTokens = 200
responseModality = ResponseModality.AUDIO
speechConfig = SpeechConfig(voice = Voices.FENRIR)
temperature = 0.9f
topK = 16
topP = 0.1f
}
// Specify the config as part of creating the `LiveModel` instance
val generativeModel = Firebase.vertexAI.liveModel(
modelName = "gemini-2.0-flash-live-preview-04-09",
generationConfig = config
)
// ...
// ...
// Set parameter values in a `LiveGenerationConfig` (example values shown here)
LiveGenerationConfig.Builder configBuilder = new LiveGenerationConfig.Builder();
configBuilder.setMaxOutputTokens(200);
configBuilder.setResponseModalities(ResponseModality.AUDIO);
configBuilder.setSpeechConfig(new SpeechConfig(Voices.FENRIR));
configBuilder.setTemperature(0.9f);
configBuilder.setTopK(16);
configBuilder.setTopP(0.1f);
LiveGenerationConfig generationConfig = configBuilder.build();
// Specify the config as part of creating the `LiveModel` instance
LiveGenerativeModel gm = FirebaseVertexAI.getInstance().liveModel(
"gemini-2.0-flash-live-preview-04-09",
generationConfig
);
LiveModelFutures model = LiveModelFutures.from(gm);
// ...
يمكنك العثور على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.
وصف المَعلمات (Gemini)
في ما يلي نظرة عامة على مستوى عالٍ للمَعلمات المتاحة، حسب الاقتضاء. يمكنك العثور على قائمة شاملة بالمَعلمات وقيمها في مستندات Google Cloud.
المَعلمة | الوصف | القيمة التلقائية |
---|---|---|
الطابع الزمني للصوت
audioTimestamp
|
قيمة منطقية تتيح فهم الطابع الزمني لملفات الإدخال التي تتضمّن صوتًا فقط لا ينطبق ذلك إلا عند استخدام مكالمات |
false |
عقوبة معدّل التكرار
frequencyPenalty
|
يتحكّم في احتمالية تضمين الرموز التي تظهر بشكل متكرّر في
الاستجابة التي تم إنشاؤها. تفرض القيم الإيجابية عقوبات على الرموز التي تظهر بشكل متكرر في المحتوى الذي تم إنشاؤه، ما يقلل من احتمال تكرار المحتوى. |
--- |
الحد الأقصى لرموز الإخراج
maxOutputTokens
|
تُحدِّد الحد الأقصى لعدد الرموز المميّزة التي يمكن إنشاؤها في الاستجابة. | --- |
عقوبة عدم التواجد
presencePenalty
|
يتحكّم في احتمالية تضمين الرموز المميّزة التي تظهر في
الردّ الذي تم إنشاؤه. تفرض القيم الإيجابية عقوبات على الرموز التي تظهر في المحتوى الذي تم إنشاؤه من قبل، ما يزيد من احتمالية إنشاء محتوى أكثر تنوعًا. |
--- |
تسلسلات الإيقاف
stopSequences
|
تُحدِّد قائمة سلاسل تُطلب من النموذج إيقاف إنشاء المحتوى إذا تم العثور على إحدى السلاسل في الاستجابة. لا ينطبق إلا عند استخدام إعدادات
|
--- |
درجة الحرارة
temperature
|
يتحكّم في درجة العشوائية في الردّ. تؤدي درجات الحرارة المنخفضة إلى ظهور ردود أكثر تحديدًا، بينما تؤدي درجات الحرارة المرتفعة إلى ظهور ردود أكثر تنوعًا أو إبداعًا. |
يعتمد ذلك على الطراز |
أهمّ K
topK
|
يحدّ من عدد الكلمات الأكثر احتمالًا المستخدَمة في المحتوى
الذي تم إنشاؤه. إذا كانت قيمة top-K هي 1 ، يعني ذلك أنّ الرمز التالي الذي يتم اختياره يجب أن يكون
الأكثر احتمالية من بين جميع الرموز في مفردات النموذج،
في حين أنّ قيمة top-K هي n ، يعني ذلك أنّ الرمز التالي يجب أن يتم
اختياره من بين n الرمز الأكثر احتمالية
(كل ذلك استنادًا إلى درجة الحرارة التي تم ضبطها).
|
يعتمد ذلك على الطراز |
Top-P
topP
|
تتحكّم هذه الإعدادات في تنوّع المحتوى الذي يتم إنشاؤه. يتم اختيار الرموز من الأكثر احتمالًا (راجِع top-K أعلاه) إلى الأقل احتمالًا إلى أن يصبح مجموع احتمالاتها مساويًا لقيمة top-P. |
يعتمد ذلك على الطراز |
طريقة الردّ
responseModality
|
تُستخدَم لتحديد نوع المحتوى الذي يتم بثّه عند استخدام العنصر Live API، مثل النص أو الصوت. لا ينطبق إلا عند استخدام Live API وأحد إعدادات
|
--- |
الكلام (الصوت)
speechConfig
|
تُستخدَم لتحديد الصوت المستخدَم لإخراج الصوت الذي يتم بثّه عند استخدام Live API. لا ينطبق إلا عند استخدام Live API وأحد إعدادات
|
Puck |
ضبط نماذج Imagen
يوضّح لك هذا القسم كيفية إعداد عملية ضبط لاستخدامها مع نماذج Imagen، ويقدّم وصفًا لكل مَعلمة.
إعداد إعدادات النموذج (Imagen)
اضبط قيم المَعلمات في ملف تعريف
ImagenGenerationConfig
كجزء من إنشاء مثيل ImagenModel
واستدعاء generateImages
.
يتم الاحتفاظ بالإعدادات طوال مدة عمل النسخة. إذا أردت
استخدام إعدادات مختلفة، أنشئ مثيلًا جديدًا من ImagenModel
باستخدام تلك الإعدادات.
// ...
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
val config = ImagenGenerationConfig(
negativePrompt = "frogs",
numberOfImages = 2,
aspectRatio = ImagenAspectRatio.LANDSCAPE_16x9,
imageFormat = ImagenImageFormat.jpeg(compressionQuality = 100),
addWatermark = false
)
// Specify the config as part of creating the `ImagenModel` instance
val imagenModel = Firebase.vertexAI.imagenModel(
modelName = "IMAGEN_MODEL_NAME ",
generationConfig = config
)
// ...
// ...
// Set parameter values in a `ImagenGenerationConfig` (example values shown here)
ImagenGenerationConfig config = new ImagenGenerationConfig.Builder()
.setNegativePrompt("frogs")
.setNumberOfImages(2)
.setAspectRatio(ImagenAspectRatio.LANDSCAPE_16x9)
.setImageFormat(ImagenImageFormat.jpeg(100))
.setAddWatermark(false)
.build();
// Specify the config as part of creating the `ImagenModel` instance
ImagenModel m = FirebaseVertexAI.getInstance().imagenModel(
"IMAGEN_MODEL_NAME ",
config
);
ImagenModelFutures model = ImagenModelFutures.from(m);
// ...
يمكنك العثور على وصف لكل مَعلمة في القسم التالي من هذه الصفحة.
وصف المَعلمات (Imagen)
في ما يلي نظرة عامة على مستوى عالٍ للمَعلمات المتاحة، حسب الاقتضاء. يمكنك العثور على قائمة شاملة بالمَعلمات وقيمها في مستندات Google Cloud.
المَعلمة | الوصف | القيمة التلقائية |
---|---|---|
طلب سلبي
negativePrompt
|
وصف لما تريد حذفه في الصور التي يتم إنشاؤها
هذه المَعلمة غير متاحة بعد في
|
--- |
عدد النتائج
numberOfImages
|
عدد الصور التي تم إنشاؤها والتي يتم عرضها لكل طلب | الإعداد التلقائي هو صورة واحدة لطُرز Imagen 3 |
نسبة العرض إلى الارتفاع
aspectRatio
|
نسبة العرض إلى الارتفاع للصور التي يتم إنشاؤها | القيمة التلقائية هي مربّع (1:1) |
تنسيق الصورة
imageFormat
|
خيارات الإخراج، مثل تنسيق الصورة (نوع MIME) ومستوى الضغط للصور التي تم إنشاؤها | نوع MIME التلقائي هو PNG نسبة الضغط التلقائية هي 75 (إذا تم ضبط نوع MIME على JPEG) |
العلامة المائية
addWatermark
|
ما إذا كنت تريد إضافة علامة مائية رقمية غير مرئية (تُعرف باسم SynthID) إلى الصور التي تم إنشاؤها | الإعداد التلقائي هو true لطُرز Imagen 3
|
إنشاء أشخاص
personGeneration
|
ما إذا كان سيتم السماح بإنشاء أشخاص من خلال النموذج | الإعداد التلقائي يعتمد على الطراز |
خيارات أخرى للتحكّم في إنشاء المحتوى
- اطّلِع على مزيد من المعلومات عن تصميم الطلب حتى تتمكّن من التأثير في النموذج لإنشاء نتائج خاصة باحتياجاتك.
- استخدِم إعدادات الأمان لضبط احتمالية تلقّي ردود قد تُعتبر ضارة، بما في ذلك خطاب الكراهية والمحتوى الجنسي الفاضح.
- اضبط تعليمات النظام لتوجيه سلوك النموذج. هذه الميزة تشبه "مقدّمة" تضعها قبل عرض النموذج على أي تعليمات أخرى من المستخدم النهائي.
- نقْل مخطّط ردّ مع الطلب لتحديد مخطّط إخراج محدّد يتم استخدام هذه الميزة بشكل شائع عند إنشاء مخرجات بتنسيق JSON، ولكن يمكن استخدامها أيضًا في مهام التصنيف (مثلاً عندما تريد أن يستخدم النموذج تصنيفات أو علامات معيّنة).