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)

Không bắt buộc. Chỉ nhập. Không thể thay đổi. Nội dung được lưu vào bộ nhớ đệm.

object (Tool)

Không bắt buộc. Chỉ nhập. Không thể thay đổi. Danh sách Tools mà mô hình có thể dùng để tạo phản hồi tiếp theo

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo của mục bộ nhớ đệm.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Chỉ có đầu ra. Thời điểm mục nhập trong bộ nhớ đệm được cập nhật lần gần đây nhất theo giờ UTC.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (UsageMetadata)

Chỉ có đầu ra. Siêu dữ liệu về việc sử dụng nội dung được lưu vào bộ nhớ đệm.

string (Timestamp format)

Dấu thời gian theo giờ UTC tại thời điểm tài nguyên này được coi là đã hết hạn. Trạng thái này luôn được cung cấp trên đầu ra, bất kể nội dung nào được gửi trên đầu vào.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Chỉ nhập. TTL mới cho tài nguyên này, chỉ nhập.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

string

Không bắt buộc. Giá trị nhận dạng. Tên tài nguyên tham chiếu đến nội dung được lưu vào bộ nhớ đệm. Định dạng cachedContents/{id}

string

Không bắt buộc. Không thể thay đổi. Tên hiển thị có ý nghĩa do người dùng tạo cho nội dung được lưu vào bộ nhớ đệm. Tối đa 128 ký tự Unicode.

string

Bắt buộc. Không thể thay đổi. Tên của Model để sử dụng cho định dạng nội dung được lưu vào bộ nhớ đệm: models/{model}

object (Content)

Không bắt buộc. Chỉ nhập. Không thể thay đổi. Hướng dẫn hệ thống thiết lập dành cho nhà phát triển. Hiện chỉ có văn bản.

object (ToolConfig)

Không bắt buộc. Chỉ nhập. Không thể thay đổi. Cấu hình công cụ. Cấu hình này được dùng chung cho tất cả công cụ.

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

object (Part)

Đã sắp xếp Parts cấu thành một thông báo. Các phần có thể có nhiều loại MIME.

string

Không bắt buộc. Nhà sản xuất nội dung. Phải là "người dùng" hoặc "mô hình".

Hữu ích khi thiết lập cho các cuộc trò chuyện nhiều lượt, nếu không có thể để trống hoặc không đặt.

{

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

Văn bản cùng dòng.

object (Blob)

byte nội dung nghe nhìn cùng dòng.

object (FunctionCall)

Một FunctionCall được dự đoán được trả về từ mô hình chứa chuỗi đại diện cho FunctionDeclaration.name cùng với các đối số và giá trị của các đối số đó.

object (FunctionResponse)

Kết quả đầu ra của một FunctionCall chứa một chuỗi đại diện cho FunctionDeclaration.name và một đối tượng JSON có cấu trúc chứa bất kỳ dữ liệu đầu ra nào của hàm sẽ được dùng làm ngữ cảnh cho mô hình.

object (FileData)

Dữ liệu dựa trên URI.

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

string

Loại MIME tiêu chuẩn IANA của dữ liệu nguồn. Ví dụ: - image/png - image/jpeg Nếu cung cấp loại MIME không được hỗ trợ, hệ thống sẽ trả về lỗi. Để biết danh sách đầy đủ các loại được hỗ trợ, hãy xem Định dạng tệp được hỗ trợ.

string (bytes format)

byte thô cho định dạng nội dung nghe nhìn.

Chuỗi được mã hoá base64.

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

string

Bắt buộc. Tên hàm cần gọi. Phải là a-z, A-Z, 0-9 hoặc chứa dấu gạch dưới và dấu gạch ngang, với độ dài tối đa là 63.

object (Struct format)

Không bắt buộc. Các tham số và giá trị hàm ở định dạng đối tượng JSON.

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

string

Bắt buộc. Tên hàm cần gọi. Phải là a-z, A-Z, 0-9 hoặc chứa dấu gạch dưới và dấu gạch ngang, với độ dài tối đa là 63.

object (Struct format)

Bắt buộc. Phản hồi hàm ở định dạng đối tượng JSON.

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

string

Không bắt buộc. Loại MIME tiêu chuẩn IANA của dữ liệu nguồn.

string

Bắt buộc. URI.

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

object (FunctionDeclaration)

Không bắt buộc. Danh sách FunctionDeclarations có sẵn cho mô hình có thể dùng để gọi hàm.

Mô hình hoặc hệ thống không thực thi hàm. Thay vào đó, hàm đã xác định có thể được trả về dưới dạng [FunctionCall][content.part.function_call] có các đối số phía máy khách để thực thi. Mô hình có thể quyết định gọi một tập hợp con các hàm này bằng cách điền [FunctionCall][content.part.function_call] trong phản hồi. Lượt trò chuyện tiếp theo có thể chứa [FunctionResponse][content.part.function_response] với ngữ cảnh tạo "hàm" [content.role] cho lượt mô hình tiếp theo.

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

string

Bắt buộc. Tên hàm. Phải là a-z, A-Z, 0-9 hoặc chứa dấu gạch dưới và dấu gạch ngang, với độ dài tối đa là 63.

string

Bắt buộc. Mô tả ngắn gọn về hàm.

object (Schema)

Không bắt buộc. Mô tả các tham số cho hàm này. Phản ánh Khóa chuỗi đối tượng tham số Open API 3.03: tên của tham số. Tên tham số có phân biệt chữ hoa chữ thường. Giá trị giản đồ: Giản đồ xác định loại dùng cho tham số.

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

enum (Type)

Bắt buộc. Kiểu dữ liệu.

string

Không bắt buộc. Định dạng của dữ liệu. Dữ liệu này chỉ được dùng cho các loại dữ liệu gốc. Các định dạng được hỗ trợ: cho loại NUMBER: số thực, gấp đôi cho loại INTEGER: int32, int64

string

Không bắt buộc. Nội dung mô tả ngắn gọn về tham số. Ví dụ về cách sử dụng. Nội dung mô tả tham số có thể được định dạng là Markdown.

boolean

Không bắt buộc. Cho biết liệu giá trị này có thể là rỗng hay không.

string

Không bắt buộc. Các giá trị có thể có của phần tử Type.STRING có định dạng enum. Ví dụ: chúng ta có thể xác định một Hướng Enum là : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}

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

Không bắt buộc. Thuộc tính của Type.OBJECT.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

Không bắt buộc. Các thuộc tính bắt buộc của Type.OBJECT.

object (Schema)

Không bắt buộc. Giản đồ các phần tử của Type.ARRAY.

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

object (FunctionCallingConfig)

Không bắt buộc. Cấu hình gọi hàm.

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

enum (Mode)

Không bắt buộc. Chỉ định chế độ thực thi lệnh gọi hàm. Nếu bạn không chỉ định, giá trị mặc định sẽ được đặt thành TỰ ĐỘNG.

string

Không bắt buộc. Một tập hợp tên hàm mà khi được cung cấp, sẽ giới hạn các hàm mà mô hình sẽ gọi.

Bạn chỉ nên đặt thuộc tính này khi chế độ là BẤT KỲ. Tên hàm phải khớp với [FunctionDeclaration.name]. Khi chế độ được đặt thành BẤT KỲ, mô hình sẽ dự đoán lệnh gọi hàm từ tập hợp tên hàm được cung cấp.

{
  "totalTokenCount": integer
}

integer

Tổng số mã thông báo mà nội dung được lưu vào bộ nhớ đệm sử dụng.