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)

פלט בלבד. מועד היצירה של רשומת המטמון.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

פלט בלבד. המועד שבו עודכנה לאחרונה רשומת המטמון לפי שעון UTC.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

object (UsageMetadata)

פלט בלבד. מטא-נתונים לגבי השימוש בתוכן שנשמר במטמון.

string (Timestamp format)

חותמת הזמן לפי שעון UTC שמציינת שהתוקף של המשאב הזה פג. הערך הזה זמין תמיד בפלט, ללא קשר למה שנשלח כקלט.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Duration format)

קלט בלבד. TTL חדש למשאב הזה, קלט בלבד.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. דוגמה: "3.5s".

string

זה שינוי אופציונלי. מזהה. שם המשאב שמתייחס לתוכן שנשמר במטמון. פורמט: cachedContents/{id}

string

זה שינוי אופציונלי. בלתי ניתן לשינוי. שם תצוגה בעל משמעות שנוצר על ידי המשתמש בשביל התוכן שנשמר במטמון. 128 תווי Unicode לכל היותר.

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

סוג 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] עם הקשר הגנרציה 'function' [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

זה שינוי אופציונלי. הפורמט של הנתונים הוא משמש רק לסוגי נתונים פרימיטיביים. פורמטים נתמכים: לסוג NUMBER: מספר ממשי (float), כפול עבור סוג 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 (Any). שמות הפונקציות צריכים להיות זהים ל-[FunctionDeclaration.name]. כשהמצב מוגדר ל-Any, המודל יחזה קריאה לפונקציה מתוך קבוצת שמות הפונקציות שסופקה.

{
  "totalTokenCount": integer
}

integer

המספר הכולל של האסימונים שהתוכן ששמור במטמון צריך.