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' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

string (Timestamp format)

출력 전용입니다. 캐시 항목이 마지막으로 업데이트된 시간입니다(UTC 시간).

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

object (UsageMetadata)

출력 전용입니다. 캐시된 콘텐츠의 사용에 관한 메타데이터입니다.

string (Timestamp format)

이 리소스가 만료된 것으로 간주되는 시간의 타임스탬프(UTC)입니다. 이는 입력으로 전송된 항목에 관계없이 항상 출력으로 제공됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

string (Duration format)

입력 전용입니다. 이 리소스의 새 TTL, 입력 전용입니다.

소수점 아래가 최대 9자리까지이고 '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)

FunctionDeclaration.name를 나타내는 문자열이 포함된 FunctionCall의 결과 출력과 함수의 출력이 포함된 구조화된 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

필수 항목입니다. 호출하려는 함수의 이름입니다. 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

선택사항입니다. 소스 데이터의 IANA 표준 MIME 유형입니다.

string

필수 항목입니다. URI입니다.

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

object (FunctionDeclaration)

선택사항입니다. 함수 호출에 사용할 수 있는 모델에서 사용할 수 있는 FunctionDeclarations 목록입니다.

모델 또는 시스템이 함수를 실행하지 않습니다. 대신 정의된 함수는 실행을 위한 클라이언트 측 인수가 포함된 [FunctionCall][content.part.function_call] 로 반환될 수 있습니다. 모델은 응답에 [FunctionCall][content.part.function_call] 을 채워 이러한 함수의 하위 집합을 호출하기로 결정할 수 있습니다. 다음 대화 차례에는 다음 모델 차례를 위한 [content.role] 'function' 생성 컨텍스트와 함께 [FunctionResponse][content.part.function_response]이 포함될 수 있습니다.

{
  "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, double의 INTEGER 유형: int32, int64

string

선택사항입니다. 매개변수에 대한 간단한 설명입니다. 사용 예가 포함될 수 있습니다. 매개변수 설명은 마크다운 형식으로 지정해야 합니다.

boolean

선택사항입니다. null 값을 나타냅니다.

string

선택사항입니다. enum 형식을 사용하는 Type.STRING 요소의 가능한 값입니다. 예를 들어 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

캐시된 콘텐츠가 사용하는 총 토큰 수입니다.