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)

فقط خروجی آخرین باری که ورودی حافظه پنهان در زمان UTC به روز شد.

مهر زمانی در قالب 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)

فقط ورودی TTL جدید برای این منبع، فقط ورودی.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' 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

اختیاری. تولید کننده محتوا. باید «کاربر» یا «مدل» باشد.

برای تنظیم مکالمات چند نوبتی مفید است، در غیر این صورت می توانید آن را خالی یا تنظیم نشده رها کنید.

{

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

نوع استاندارد IANA MIME داده منبع. مثال‌ها: - image/png - image/jpeg اگر نوع MIME پشتیبانی‌نشده ارائه شود، یک خطا برگردانده می‌شود. برای فهرست کامل انواع پشتیبانی شده، فرمت‌های فایل پشتیبانی شده را ببینید.

string ( bytes format)

بایت های خام برای فرمت های رسانه ای.

رشته ای با کد base64.

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

string

ضروری. نام تابعی که باید فراخوانی شود. باید az، AZ، ​​0-9 باشد یا دارای زیرخط و خط تیره با حداکثر طول 63 باشد.

object ( Struct format)

اختیاری. پارامترها و مقادیر تابع در قالب شی JSON.

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

string

ضروری. نام تابعی که باید فراخوانی شود. باید az، AZ، ​​0-9 باشد یا دارای زیرخط و خط تیره با حداکثر طول 63 باشد.

object ( Struct format)

ضروری. پاسخ تابع در قالب شی JSON.

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

string

اختیاری. نوع استاندارد IANA MIME داده منبع.

string

ضروری. URI.

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

object ( FunctionDeclaration )

اختیاری. لیستی از FunctionDeclarations موجود در مدل که می تواند برای فراخوانی تابع استفاده شود.

مدل یا سیستم عملکرد را اجرا نمی کند. در عوض، تابع تعریف شده ممکن است به عنوان یک [FunctionCall][content.part.function_call] با آرگومان هایی به سمت مشتری برای اجرا برگردانده شود. ممکن است مدل تصمیم بگیرد که زیر مجموعه ای از این توابع را با پر کردن [FunctionCall][content.part.function_call] در پاسخ فراخوانی کند. نوبت مکالمه بعدی ممکن است حاوی یک [FunctionResponse][content.part.function_response] با زمینه تولید "function" [content.role] برای نوبت مدل بعدی باشد.

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

string

ضروری. نام تابع. باید az، AZ، ​​0-9 باشد یا دارای زیرخط و خط تیره با حداکثر طول 63 باشد.

string

ضروری. توضیح مختصری از عملکرد

object ( Schema )

اختیاری. پارامترهای این تابع را شرح می دهد. کلید رشته رشته پارامتر Open API 3.03 را منعکس می کند: نام پارامتر. نام پارامترها به حروف بزرگ و کوچک حساس هستند. Schema Value: طرحی که نوع مورد استفاده برای پارامتر را تعیین می کند.

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

enum ( Type )

ضروری. نوع داده.

string

اختیاری. فرمت داده ها این فقط برای انواع داده های اولیه استفاده می شود. فرمت های پشتیبانی شده: برای نوع NUMBER: شناور، دو برابر برای نوع INTEGER: int32، int64

string

اختیاری. شرح مختصری از پارامتر این می تواند شامل نمونه هایی از استفاده باشد. شرح پارامتر ممکن است به صورت Markdown قالب بندی شود.

boolean

اختیاری. نشان می دهد که آیا مقدار ممکن است null باشد.

string

اختیاری. مقادیر احتمالی عنصر Type.STRING با فرمت enum. برای مثال می‌توانیم یک جهت Enum را به این صورت تعریف کنیم: {type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}

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

اختیاری. خواص Type.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 )

اختیاری. حالتی را که فراخوانی تابع باید در آن اجرا شود را مشخص می کند. اگر مشخص نشده باشد، مقدار پیش فرض روی AUTO تنظیم می شود.

string

اختیاری. مجموعه ای از نام های تابع که در صورت ارائه، توابعی را که مدل فراخوانی می کند محدود می کند.

این فقط زمانی باید تنظیم شود که حالت ANY باشد. نام توابع باید با [FunctionDeclaration.name] مطابقت داشته باشد. با تنظیم حالت بر روی ANY، مدل یک فراخوانی تابع را از مجموعه نام های تابع ارائه شده پیش بینی می کند.

{
  "totalTokenCount": integer
}

integer

تعداد کل نشانه هایی که محتوای کش مصرف می کند.