تعليمات النظام تشبه "مقدمة" تضيفها قبل أن يتعرّض النموذج لأي تعليمات أخرى من المستخدِم النهائي. تسمح لك هذه التعليمات بتوجيه سلوك النموذج استنادًا إلى احتياجاتك وحالات استخدامك المحدّدة.
تتوافق تعليمات النظام مع جميع نماذج Gemini. ولا تتوافق مع نماذج Imagen.
arrow_downward الانتقال إلى نماذج التعليمات البرمجية
عند ضبط تعليمات النظام، تقدّم للنموذج سياقًا إضافيًا لفهم المهمة وتقديم ردود أكثر تخصيصًا والالتزام بإرشادات محدّدة خلال تفاعل المستخدِم الكامل مع النموذج. يمكنك تحديد سلوك على مستوى المنتج في تعليمات النظام، بشكل منفصل عن الطلبات التي يقدّمها المستخدِمون النهائيون. على سبيل المثال، يمكنك تضمين عناصر مثل الدور أو الشخصية والمعلومات السياقية وتعليمات التنسيق.
يمكنك استخدام تعليمات النظام بطرق عديدة، بما في ذلك:
- تحديد شخصية أو دور (لروبوت دردشة مثلاً)
- تحديد تنسيق الناتج (مثل Markdown أو YAML)
- تحديد نمط الناتج وصياغته (مثل الإسهاب والرسمية ومستوى القراءة المستهدَف)
- تحديد الأهداف أو القواعد للمهمة (مثل عرض مقتطف من التعليمات البرمجية بدون مزيد من التفسيرات)
- تقديم سياق إضافي للطلب (مثل تاريخ آخر تحديث للبيانات)
عند ضبط تعليمات النظام، يتم تطبيقها على الطلب بأكمله. وتعمل هذه التعليمات على مستوى عدة أدوار للمستخدِم والنموذج عند تضمينها في الطلب. على الرغم من أنّ تعليمات النظام منفصلة عن محتوى الطلب، تظل جزءًا من طلباتك العامة، وبالتالي تخضع لسياسات استخدام البيانات العادية.
ضبط تعليمات النظام
|
انقر على موفّر Gemini API لعرض المحتوى الخاص بالموفّر والتعليمات البرمجية على هذه الصفحة. |
ضبط تعليمات النظام لحالات الاستخدام العامة
Swift
يمكنك تحديد
systemInstruction
عند إنشاء مثيل GenerativeModel.
import FirebaseAILogic
// Specify the system instructions as part of creating the `GenerativeModel` instance
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
modelName: "GEMINI_MODEL_NAME",
systemInstruction: ModelContent(role: "system", parts: "You are a cat. Your name is Neko.")
)
Kotlin
يمكنك تحديد
systemInstruction
عند إنشاء مثيل GenerativeModel.
// Specify the system instructions as part of creating the `GenerativeModel` instance
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
modelName = "GEMINI_MODEL_NAME",
systemInstruction = content { text("You are a cat. Your name is Neko.") }
)
Java
يمكنك تحديد
systemInstruction
عند إنشاء مثيل GenerativeModel.
// Specify the system instructions as part of creating the `GenerativeModel` instance
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel(
/* modelName */ "GEMINI_MODEL_NAME",
/* generationConfig (optional) */ null,
/* safetySettings (optional) */ null,
/* requestOptions (optional) */ new RequestOptions(),
/* tools (optional) */ null,
/* toolsConfig (optional) */ null,
/* systemInstruction (optional) */ new Content.Builder().addText("You are a cat. Your name is Neko.").build()
);
GenerativeModelFutures model = GenerativeModelFutures.from(ai);
Web
يمكنك تحديد
systemInstruction
عند إنشاء مثيل GenerativeModel.
// ...
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Specify the system instructions as part of creating the `GenerativeModel` instance
const model = getGenerativeModel(ai, {
model: "GEMINI_MODEL_NAME",
systemInstruction: "You are a cat. Your name is Neko."
});
Dart
يمكنك تحديد
systemInstruction
عند إنشاء مثيل GenerativeModel.
// ...
// Specify the system instructions as part of creating the `GenerativeModel` instance
final model = FirebaseAI.googleAI().generativeModel(
model: 'GEMINI_MODEL_NAME',
systemInstruction: Content.system('You are a cat. Your name is Neko.'),
);
// ...
Unity
يمكنك تحديد
systemInstruction
عند إنشاء مثيل GenerativeModel.
// ...
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Specify the system instructions as part of creating the `GenerativeModel` instance
var model = ai.GetGenerativeModel(
modelName: "GEMINI_MODEL_NAME",
systemInstruction: ModelContent.Text("You are a cat. Your name is Neko.")
);
ضبط تعليمات النظام لـ Gemini Live API
Swift
يمكنك تحديد
systemInstruction
عند إنشاء مثيل LiveModel.
// ...
// Specify the system instructions as part of creating the `liveModel` instance
let liveModel = FirebaseAI.firebaseAI(backend: .googleAI()).liveModel(
modelName: "GEMINI_LIVE_MODEL_NAME",
systemInstruction: ModelContent(role: "system", parts: "You are a cat. Your name is Neko."),
// ...
)
// ...
Kotlin
يمكنك تحديد
systemInstruction
عند إنشاء مثيل LiveModel.
// ...
// Specify the system instructions as part of creating the `LiveModel` instance
val liveModel = Firebase.ai(backend = GenerativeBackend.googleAI()).liveModel(
modelName = "GEMINI_LIVE_MODEL_NAME",
systemInstruction = content { text("You are a cat. Your name is Neko.") },
// ...
)
// ...
Java
يمكنك تحديد
systemInstruction
عند إنشاء مثيل LiveModel.
// ...
// Specify the system instructions as part of creating the `LiveModel` instance
LiveGenerativeModel lm = FirebaseAI.getInstance(GenerativeBackend.googleAI()).liveModel(
/* modelName */ "GEMINI_LIVE_MODEL_NAME",
/* systemInstruction (optional) */ new Content.Builder().addText("You are a cat. Your name is Neko.").build()
// ...
);
LiveModelFutures liveModel = LiveModelFutures.from(lm);
// ...
Web
يمكنك تحديد
systemInstruction
عند إنشاء مثيل LiveGenerativeModel.
// ...
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Specify the system instructions as part of creating the `LiveGenerativeModel` instance
const liveModel = getLiveGenerativeModel(ai, {
model: "GEMINI_LIVE_MODEL_NAME",
systemInstruction: "You are a cat. Your name is Neko.",
// ...
});
// ...
Dart
يمكنك تحديد
systemInstruction
عند إنشاء مثيل LiveGenerativeModel.
// ...
// Specify the system instructions as part of creating the `liveGenerativeModel` instance
final liveModel = FirebaseAI.googleAI().liveGenerativeModel(
model: 'GEMINI_LIVE_MODEL_NAME',
systemInstruction: Content.system('You are a cat. Your name is Neko.'),
// ...
);
// ...
Unity
يمكنك تحديد
systemInstruction
عند إنشاء مثيل LiveModel.
// ...
// Specify the system instructions as part of creating the `LiveModel` instance
var liveModel = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetLiveModel(
modelName: "GEMINI_LIVE_MODEL_NAME",
systemInstruction: ModelContent.Text("You are a cat. Your name is Neko."),
// ...
);
// ...
أمثلة على تعليمات النظام
في ما يلي بعض الأمثلة على تعليمات النظام التي تساعد في توجيه السلوك المتوقّع للنموذج. تعرض بعض الأمثلة أيضًا نموذج طلب قد تكون تعليمات النظام مفيدة له.
إنشاء رموز
تعليمات النظام:
أنت خبير في البرمجة ومتخصّص في عرض الرموز لواجهات العرض الأمامية. عندما أصف أحد مكوّنات موقع إلكتروني أريد إنشاءه، يُرجى عرض رمز HTML وCSS اللازمَين لتنفيذ ذلك. لا تقدّم أي تفسير لهذا الرمز. قدِّم أيضًا بعض الاقتراحات بشأن تصميم واجهة المستخدِم.طلب المستخدِم:
أنشئ مربّعًا في منتصف الصفحة يحتوي على مجموعة متناوبة من الصور، كل منها مصحوبة بتعليق. يجب أن يكون للصورة في منتصف الصفحة ظل من الخلف لجعلها بارزة. يجب أيضًا أن تؤدي إلى صفحة أخرى من الموقع الإلكتروني. اترك عنوان URL فارغًا لأتمكّن من ملئه.
روبوت دردشة موسيقي
تعليمات النظام:
ستردّ بصفتك مؤرخًا موسيقيًا، وستعرض معرفة شاملة بمختلف الأنواع الموسيقية وتقدّم أمثلة ذات صلة. ستكون صياغتك متفائلة وحماسية، وستنشر متعة الموسيقى. إذا لم يكن السؤال مرتبطًا بالموسيقى، يجب أن يكون الردّ "هذا خارج نطاق معرفتي".طلب المستخدِم:
إذا وُلد شخص في الستينيات، ما هو النوع الموسيقي الأكثر شيوعًا في تلك الفترة؟ أدرِج خمس أغانٍ على شكل نقاط تعداد.
إنشاء بيانات منسَّقة
تعليمات النظام:
أنت مساعد للطهاة المنزليين. ستتلقّى قائمة بالمكوّنات وستردّ بقائمة من الوصفات التي تستخدم هذه المكوّنات. يجب دائمًا إدراج الوصفات التي لا تحتاج إلى مكوّنات إضافية قبل الوصفات التي تحتاج إلى ذلك.يجب أن يكون ردّك عبارة عن عنصر JSON يحتوي على 3 وصفات. يتضمّن عنصر الوصفة المخطط التالي:
- name: اسم الوصفة
- usedIngredients: المكوّنات في الوصفة التي تم تقديمها في القائمة
- otherIngredients: المكوّنات في الوصفة التي لم يتم تقديمها في القائمة (يتم حذفها إذا لم تكن هناك مكوّنات أخرى)
- description: وصف موجز للوصفة، مكتوب بطريقة إيجابية كما لو كان الهدف بيعها
طلب المستخدِم:
- كيس من البروكلي المجمّد بوزن رطل واحد
- علبة من الكريمة الثقيلة بوزن رطل واحد
- عبوة من أطراف الجبن وقطعه بوزن رطل واحد
خيارات أخرى للتحكّم في إنشاء المحتوى
- مزيد من المعلومات حول تصميم الطلبات لتتمكّن من التأثير في النموذج لإنشاء ناتج محدّد يناسب احتياجاتك
- ضبط مَعلمات النموذج للتحكّم في طريقة إنشاء النموذج للردّ بالنسبة إلى نماذج Gemini، تتضمّن هذه المَعلمات الحد الأقصى لعدد الرموز المميزة للناتج، واحتمال تكرار الرموز المميزة للناتج، وما إلى ذلك. بالنسبة إلى نماذج Imagen، تتضمّن هذه المَعلمات نسبة العرض إلى الارتفاع، وإنشاء الأشخاص، ووضع العلامة المائية، وما إلى ذلك.
- استخدام إعدادات الأمان لضبط احتمال الحصول على ردود قد تُعتبر ضارة، بما في ذلك كلام يحض على الكراهية والمحتوى الجنسي الفاضح.
- تمرير مخطط الردّ مع الطلب لتحديد مخطط ناتج معيّن تُستخدم هذه الميزة بشكل شائع عند إنشاء ناتج JSON، ولكن يمكن استخدامها أيضًا لمهام التصنيف (مثل عندما تريد أن يستخدم النموذج تصنيفات أو علامات معيّنة).