Content

نوع البيانات المنظَّمة الأساسي الذي يحتوي على محتوى متعدد الأجزاء لرسالة.

يتضمّن الحقل Content حقل role الذي يحدّد منتج Content والحقل parts الذي يحتوي على بيانات متعدّدة الأجزاء تتضمّن محتوى دور الرسالة.

تمثيل JSON
{
  "parts": [
    {
      object (Part)
    }
  ],
  "role": string
}
الحقول
parts[]

object (Part)

تم ترتيب Parts ويشكل رسالة واحدة. قد تحتوي الأجزاء على أنواع MIME مختلفة.

role

string

اختياريّ. منتج المحتوى. يجب أن يكون إما "مستخدم" أو "نموذج".

من المفيد الضبط على محادثات متعددة الأدوار، وإلا يمكن تركه فارغًا أو بدون ضبط.

الجزء

نوع بيانات يحتوي على وسائط تشكل جزءًا من رسالة Content متعدّدة الأجزاء.

يتكوّن Part من بيانات مرتبطة بنوع بيانات. لا يمكن أن يحتوي Part إلا على أحد الأنواع المقبولة في Part.data.

يجب أن يحتوي Part على نوع MIME ثابت IANA يحدّد نوع الوسائط ونوعها الفرعي إذا كان الحقل inlineData معبأً بوحدات بايت غير أوّلية.

تمثيل JSON
{

  // Union field data can be only one of the following:
  "text": string,
  "inlineData": {
    object (Blob)
  },
  "functionCall": {
    object (FunctionCall)
  },
  "functionResponse": {
    object (FunctionResponse)
  },
  "fileData": {
    object (FileData)
  }
  // End of list of possible types for union field data.
}
الحقول

حقل الاتحاد data

يمكن أن يكون الحقل "data" واحدًا فقط مما يلي:

text

string

نص مضمّن.

inlineData

object (Blob)

وحدات بايت للوسائط المضمّنة

functionCall

object (FunctionCall)

تم عرض FunctionCall متوقعة من النموذج الذي يحتوي على سلسلة تمثل FunctionDeclaration.name مع الوسيطات وقيمها.

functionResponse

object (FunctionResponse)

يتم استخدام ناتج النتيجة لدالة FunctionCall يحتوي على سلسلة تمثل FunctionDeclaration.name وكائن JSON منظمًا يحتوي على أي ناتج من الدالة كسياق للنموذج.

fileData

object (FileData)

البيانات المستندة إلى معرّف الموارد المنتظم (URI).

بلوب

وحدات بايت للوسائط الأولية.

يجب عدم إرسال النص كوحدات بايت غير أوّلية، استخدِم حقل "النص".

تمثيل JSON
{
  "mimeType": string,
  "data": string
}
الحقول
mimeType

string

تمثّل هذه السمة نوع MIME القياسي الصادر عن هيئة أرقام الإنترنت المخصصة (IANA) لبيانات المصدر. تشمل الأنواع المقبولة ما يلي: "image/png" و"image/jpeg" و"image/heic" و"image/heif" و"image/webp".

data

string (bytes format)

وحدات البايت الأولية لتنسيقات الوسائط

سلسلة بترميز base64.

FunctionCall

تم عرض FunctionCall متوقعة من النموذج الذي يحتوي على سلسلة تمثل FunctionDeclaration.name مع الوسيطات وقيمها.

تمثيل JSON
{
  "name": string,
  "args": {
    object
  }
}
الحقول
name

string

مطلوبة. اسم الدالة المطلوب استدعاءها. يجب أن تكون قيمة a-z أو A-Z أو 0-9 أو تحتوي على شرطات سفلية وشرطات، على أن يصل طولها إلى 63 حرفًا كحد أقصى.

args

object (Struct format)

اختياريّ. المعلَمات والقيم الخاصة بالدالة بتنسيق عنصر JSON.

FunctionResponse

يتم استخدام ناتج النتيجة من FunctionCall الذي يحتوي على سلسلة تمثل FunctionDeclaration.name وكائن JSON منظمًا يحتوي على أي ناتج من الدالة كسياق للنموذج. يجب أن تتضمن هذه البيانات نتيجة FunctionCall التي تم إجراؤها استنادًا إلى نموذج التوقّع.

تمثيل JSON
{
  "name": string,
  "response": {
    object
  }
}
الحقول
name

string

مطلوبة. اسم الدالة المطلوب استدعاءها. يجب أن تكون قيمة a-z أو A-Z أو 0-9 أو تحتوي على شرطات سفلية وشرطات، على أن يصل طولها إلى 63 حرفًا كحد أقصى.

response

object (Struct format)

مطلوبة. استجابة الدالة بتنسيق عنصر JSON

FileData

البيانات المستندة إلى معرّف الموارد المنتظم (URI).

تمثيل JSON
{
  "mimeType": string,
  "fileUri": string
}
الحقول
mimeType

string

اختياريّ. تمثّل هذه السمة نوع MIME القياسي الصادر عن هيئة أرقام الإنترنت المخصصة (IANA) لبيانات المصدر.

fileUri

string

مطلوبة. معرّف الموارد المنتظم (URI).