تعليمات النظام هي بمثابة "مقدمة" تتم إضافتها قبل أن يتلقّى النموذج أي تعليمات أخرى من المستخدم النهائي. فهي تتيح لك توجيه سلوك النموذج استنادًا إلى احتياجاتك وحالات الاستخدام المحدّدة.
تتوفّر تعليمات النظام في جميع نماذج Gemini باستثناء نماذج تحويل النص إلى كلام في Gemini.
الانتقال إلى عيّنات التعليمات البرمجية
عند ضبط تعليمات النظام، يمكنك تزويد النموذج بسياق إضافي لفهم المهمة وتقديم ردود أكثر تخصيصًا والالتزام بإرشادات محدّدة طوال تفاعل المستخدم مع النموذج. يمكنك تحديد سلوك على مستوى المنتج في تعليمات النظام، بشكل منفصل عن الطلبات التي يقدّمها المستخدمون النهائيون. على سبيل المثال، يمكنك تضمين أشخاص مثل الدور أو الشخصية، والمعلومات السياقية، وتعليمات التنسيق.
يمكنك استخدام تعليمات النظام بعدة طرق، بما في ذلك:
- تحديد شخصية أو دور (لروبوت دردشة مثلاً)
- تحديد تنسيق الناتج (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: وصف موجز للوصفة، مكتوب بشكل إيجابي كما لو كان لبيعها
طلب المستخدم:
- كيس بروكلي مجمّد بوزن رطل واحد
- نصف لتر من الكريمة الثقيلة
- عبوة قطع جبن بوزن رطل واحد
خيارات أخرى للتحكّم في إنشاء المحتوى
- مزيد من المعلومات حول تصميم الطلبات للتأثير في النموذج لإنشاء مخرجات مخصّصة لاحتياجاتك
- اضبط مَعلمات النموذج للتحكّم في كيفية إنشاء النموذج للردّ، مثل الحدّ الأقصى لعدد الرموز المميّزة في الردّ، واحتمال تكرار الرموز المميّزة في الردّ، وما إلى ذلك.
- استخدِم إعدادات الأمان لضبط احتمالية الحصول على ردود قد تُعتبر ضارة، بما في ذلك الكلام الذي يحض على الكراهية والمحتوى الجنسي الفاضح.
- مرِّر مخطط استجابة مع الطلب لتحديد مخطط ناتج معيّن. تُستخدم هذه الميزة شائع الاستخدام عند إنشاء مخرجات JSON، ولكن يمكن استخدامها أيضًا لمهام التصنيف (مثلاً عندما تريد أن يستخدم النموذج تصنيفات أو علامات معيّنة).