نوع البيانات المنظَّمة الأساسي الذي يحتوي على محتوى متعدد الأجزاء لرسالة.
يتضمّن الحقل Content
حقل role
الذي يحدّد منتج Content
والحقل parts
الذي يحتوي على بيانات متعدّدة الأجزاء تتضمّن محتوى دور الرسالة.
تمثيل JSON |
---|
{
"parts": [
{
object ( |
الحقول | |
---|---|
parts[] |
تم ترتيب |
role |
اختياريّ. منتج المحتوى. يجب أن يكون إما "مستخدم" أو "نموذج". من المفيد الضبط على محادثات متعددة الأدوار، وإلا يمكن تركه فارغًا أو بدون ضبط. |
الجزء
نوع بيانات يحتوي على وسائط تشكل جزءًا من رسالة Content
متعدّدة الأجزاء.
يتكوّن Part
من بيانات مرتبطة بنوع بيانات. لا يمكن أن يحتوي Part
إلا على أحد الأنواع المقبولة في Part.data
.
يجب أن يحتوي Part
على نوع MIME ثابت IANA يحدّد نوع الوسائط ونوعها الفرعي إذا كان الحقل inlineData
معبأً بوحدات بايت غير أوّلية.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
text |
نص مضمّن. |
inlineData |
وحدات بايت للوسائط المضمّنة |
functionCall |
تم عرض |
functionResponse |
يتم استخدام ناتج النتيجة لدالة |
fileData |
البيانات المستندة إلى معرّف الموارد المنتظم (URI). |
بلوب
وحدات بايت للوسائط الأولية.
يجب عدم إرسال النص كوحدات بايت غير أوّلية، استخدِم حقل "النص".
تمثيل JSON |
---|
{ "mimeType": string, "data": string } |
الحقول | |
---|---|
mimeType |
تمثّل هذه السمة نوع MIME القياسي الصادر عن هيئة أرقام الإنترنت المخصصة (IANA) لبيانات المصدر. تشمل الأنواع المقبولة ما يلي: "image/png" و"image/jpeg" و"image/heic" و"image/heif" و"image/webp". |
data |
وحدات البايت الأولية لتنسيقات الوسائط سلسلة بترميز base64. |
FunctionCall
تم عرض FunctionCall
متوقعة من النموذج الذي يحتوي على سلسلة تمثل FunctionDeclaration.name
مع الوسيطات وقيمها.
تمثيل JSON |
---|
{ "name": string, "args": { object } } |
الحقول | |
---|---|
name |
مطلوبة. اسم الدالة المطلوب استدعاءها. يجب أن تكون قيمة a-z أو A-Z أو 0-9 أو تحتوي على شرطات سفلية وشرطات، على أن يصل طولها إلى 63 حرفًا كحد أقصى. |
args |
اختياريّ. المعلَمات والقيم الخاصة بالدالة بتنسيق عنصر JSON. |
FunctionResponse
يتم استخدام ناتج النتيجة من FunctionCall
الذي يحتوي على سلسلة تمثل FunctionDeclaration.name
وكائن JSON منظمًا يحتوي على أي ناتج من الدالة كسياق للنموذج. يجب أن تتضمن هذه البيانات نتيجة FunctionCall
التي تم إجراؤها استنادًا إلى نموذج التوقّع.
تمثيل JSON |
---|
{ "name": string, "response": { object } } |
الحقول | |
---|---|
name |
مطلوبة. اسم الدالة المطلوب استدعاءها. يجب أن تكون قيمة a-z أو A-Z أو 0-9 أو تحتوي على شرطات سفلية وشرطات، على أن يصل طولها إلى 63 حرفًا كحد أقصى. |
response |
مطلوبة. استجابة الدالة بتنسيق عنصر JSON |
FileData
البيانات المستندة إلى معرّف الموارد المنتظم (URI).
تمثيل JSON |
---|
{ "mimeType": string, "fileUri": string } |
الحقول | |
---|---|
mimeType |
اختياريّ. تمثّل هذه السمة نوع MIME القياسي الصادر عن هيئة أرقام الإنترنت المخصصة (IANA) لبيانات المصدر. |
fileUri |
مطلوبة. معرّف الموارد المنتظم (URI). |