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 «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Только вывод. Когда запись кэша была последний раз обновлена ​​по времени UTC.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

object ( UsageMetadata )

Только вывод. Метаданные об использовании кэшированного контента.

string ( Timestamp format)

Временная метка в формате UTC, когда срок действия этого ресурса считается истекшим. Это всегда предоставляется на выходе, независимо от того, что было отправлено на вход.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "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

Необязательный. Производитель контента. Должно быть либо «пользователь», либо «модель».

Полезно для многоходовых разговоров, в противном случае его можно оставить пустым или не установить.

{

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

Необходимый. Имя функции, которую нужно вызвать. Должен быть 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

Необязательный. Стандартный MIME-тип IANA исходных данных.

string

Необходимый. УРИ.

{
  "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

Необходимый. Имя функции. Должен быть az, AZ, 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, double для типа INTEGER: int32, int64.

string

Необязательный. Краткое описание параметра. Это может содержать примеры использования. Описание параметра может быть отформатировано как Markdown.

boolean

Необязательный. Указывает, может ли значение быть нулевым.

string

Необязательный. Возможные значения элемента Type.STRING в формате перечисления. Например, мы можем определить направление перечисления как: {type:STRING, format:enum, enum:["ВОСТОК", СЕВЕР", "ЮГ", "ЗАПАД"]}

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 )

Необязательный. Указывает режим, в котором должен выполняться вызов функции. Если не указано, значение по умолчанию будет установлено на АВТО.

string

Необязательный. Набор имен функций, который, если он указан, ограничивает функции, которые будет вызывать модель.

Это значение следует устанавливать только в том случае, если выбран режим ЛЮБОЙ. Имена функций должны соответствовать [FunctionDeclaration.name]. Если для режима установлено значение ЛЮБОЙ, модель будет прогнозировать вызов функции на основе предоставленного набора имен функций.

{
  "totalTokenCount": integer
}

integer

Общее количество токенов, которые потребляет кэшированный контент.