REST Resource: cachedContents

{
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "usageMetadata": {
    object (UsageMetadata)
  },

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
  "name": string,
  "displayName": string,
  "model": string,
  "systemInstruction": {
    object (Content)
  },
  "toolConfig": {
    object (ToolConfig)
  }
}

object (Content)

اختياريّ. الإدخال فقط. غير قابل للتغيير. المحتوى المطلوب تخزينه مؤقتًا.

object (Tool)

اختياريّ. الإدخال فقط. غير قابل للتغيير. قائمة بـ Tools التي قد يستخدمها النموذج لإنشاء الرد التالي

string (Timestamp format)

النتائج فقط. وقت إنشاء إدخال ذاكرة التخزين المؤقت

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

النتائج فقط. تاريخ آخر تعديل لإدخال ذاكرة التخزين المؤقت بالتوقيت العالمي المنسّق

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (UsageMetadata)

النتائج فقط. البيانات الوصفية حول استخدام المحتوى المُخزَّن مؤقتًا

string (Timestamp format)

الطابع الزمني بالتوقيت العالمي المنسّق (UTC) لوقت اعتبار هذا المورد منتهي الصلاحية. يتم توفير ذلك دائمًا في الناتج، بصرف النظر عما تم إرساله في الإدخال.

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

string (Duration format)

الإدخال فقط. مدة البقاء جديدة لهذا المورد، الإدخال فقط.

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"

string

اختياريّ. المُعرّف. اسم المورد الذي يشير إلى المحتوى المخزَّن مؤقتًا تنسيق الملف: cachedContents/{id}

string

اختياريّ. غير قابل للتغيير. الاسم المعروض الذي ينشئه المستخدمون للمحتوى المخزَّن مؤقتًا. الحد الأقصى لعدد أحرف يونيكود هو 128 حرفًا.

string

مطلوبة. غير قابل للتغيير. اسم Model المطلوب استخدامه للمحتوى المخزَّن مؤقتًا التنسيق: models/{model}

object (Content)

اختياريّ. الإدخال فقط. غير قابل للتغيير. تعليمات بشأن ضبط النظام من قِبل المطوّر هذه الميزة هي نصّ فقط حاليًا.

object (ToolConfig)

اختياريّ. الإدخال فقط. غير قابل للتغيير. إعدادات الأداة. وتتم مشاركة هذه الإعدادات مع جميع الأدوات.

{
  "parts": [
    {
      object (Part)
    }
  ],
  "role": string
}

object (Part)

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

string

اختياريّ. منتج المحتوى. يجب أن تكون القيمة إما "user" أو "model".

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

{

  // 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.
}

string

نص مضمّن.

object (Blob)

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

object (FunctionCall)

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

object (FunctionResponse)

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

object (FileData)

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

{
  "mimeType": string,
  "data": string
}

string

تمثّل هذه السمة نوع MIME العادي لبيانات المصدر الصادر عن هيئة أرقام الإنترنت المخصصة (IANA). أمثلة: - image/png - image/jpeg في حال تقديم نوع MIME غير متوافق، سيتم عرض خطأ. للحصول على قائمة كاملة بأنواع الملفات المتوافقة، يُرجى الاطّلاع على تنسيقات الملفات المتوافقة.

string (bytes format)

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

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

{
  "name": string,
  "args": {
    object
  }
}

string

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

object (Struct format)

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

{
  "name": string,
  "response": {
    object
  }
}

string

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

object (Struct format)

مطلوبة. استجابة الدالة بتنسيق كائن JSON.

{
  "mimeType": string,
  "fileUri": string
}

string

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

string

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

{
  "functionDeclarations": [
    {
      object (FunctionDeclaration)
    }
  ]
}

object (FunctionDeclaration)

اختياريّ. تتوفر قائمة بـ FunctionDeclarations للنموذج ويمكن استخدامها لاستدعاء الدوال.

لا ينفّذ النموذج أو النظام الدالة. بدلاً من ذلك، يمكن عرض الدالة المحددة على شكل [FunctionCall][content.part.function_call] مع وسيطات إلى جانب العميل للتنفيذ. قد يقرّر النموذج استدعاء مجموعة فرعية من هذه الدوال عن طريق إضافة [FunctionCall][content.part.function_call] في الاستجابة. قد يشتمل منعطف المحادثة التالي على [FunctionResponse][content.part.function_response] مع سياق إنشاء "الوظيفة" من [content.role] للمنعطف التالي للنموذج.

{
  "name": string,
  "description": string,
  "parameters": {
    object (Schema)
  }
}

string

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

string

مطلوبة. تمثّل هذه السمة وصفًا موجزًا للدالة.

object (Schema)

اختياريّ. تصف المعاملات لهذه الدالة. يعكس مفتاح سلسلة كائن المعلَمة Open API 3.03: اسم المعلمة. أسماء المَعلمات حسّاسة لحالة الأحرف. قيمة المخطط: المخطط الذي يحدد النوع المستخدم للمعلمة.

{
  "type": enum (Type),
  "format": string,
  "description": string,
  "nullable": boolean,
  "enum": [
    string
  ],
  "properties": {
    string: {
      object (Schema)
    },
    ...
  },
  "required": [
    string
  ],
  "items": {
    object (Schema)
  }
}

enum (Type)

مطلوبة. نوع البيانات.

string

اختياريّ. تنسيق البيانات. يستخدم هذا فقط لأنواع البيانات الأولية. التنسيقات المتوافقة: لنوع الأرقام: عدد عائم، مزدوج لنوع العدد الصحيح: int32، وint64

string

اختياريّ. تمثّل هذه السمة وصفًا موجزًا للمَعلمة. وقد يحتوي هذا القسم على أمثلة على الاستخدام. يمكن تنسيق وصف المَعلمة على أنّه Markdown.

boolean

اختياريّ. يشير إلى ما إذا كانت القيمة خالية.

string

اختياريّ. القيم المحتملة لعنصر Type.STRING بتنسيق enum. على سبيل المثال، يمكننا تعريف اتجاه التعداد على النحو التالي : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}

map (key: string, value: object (Schema))

اختياريّ. خصائص النوع.OBJECT.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

string

اختياريّ. السمات المطلوبة من Type.OBJECT.

object (Schema)

اختياريّ. مخطط لعناصر Type.ARRAY.

{
  "functionCallingConfig": {
    object (FunctionCallingConfig)
  }
}

object (FunctionCallingConfig)

اختياريّ. تهيئة استدعاء الدالة.

{
  "mode": enum (Mode),
  "allowedFunctionNames": [
    string
  ]
}

enum (Mode)

اختياريّ. تحدِّد هذه السياسة الوضع الذي يجب فيه تنفيذ استدعاء الدوال. وفي حال عدم تحديد القيمة، سيتم ضبط القيمة التلقائية على "تلقائي".

string

اختياريّ. يشير ذلك المصطلح إلى مجموعة من أسماء الدوال التي تحدّ من الدوال التي سيستدعيها النموذج.

يجب ضبط هذا الإعداد فقط عندما يكون الوضع "Any". يجب أن تتطابق أسماء الدوال مع [FunctionDeclaration.name]. عند تعيين الوضع على "أي"، يتوقع النموذج استدعاء الدالة من مجموعة أسماء الدوال المتوفرة.

{
  "totalTokenCount": integer
}

integer

إجمالي عدد الرموز المميّزة التي يستهلكها المحتوى المخزَّن مؤقتًا