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)

Opcjonalnie. Tylko dane wejściowe. Stała. Zawartość do pamięci podręcznej.

object (Tool)

Opcjonalnie. Tylko dane wejściowe. Stała. Lista właściwości Tools, których model może używać do wygenerowania następnej odpowiedzi

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia wpisu w pamięci podręcznej.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Tylko dane wyjściowe. Czas ostatniej aktualizacji wpisu pamięci podręcznej według czasu UTC.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (UsageMetadata)

Tylko dane wyjściowe. Metadane dotyczące wykorzystania treści zapisanych w pamięci podręcznej.

string (Timestamp format)

Sygnatura czasowa UTC wskazująca, kiedy zasób jest uznawany za nieaktualny. Wartość ta jest zawsze podawana na danych wyjściowych, niezależnie od tego, co zostało przesłane na dane wejściowe.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Tylko dane wejściowe. Nowa wartość TTL dla tego zasobu, tylko dane wejściowe.

Czas trwania w sekundach składający się z maksymalnie dziewięciu cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

string

Opcjonalnie. Identyfikator. Nazwa zasobu odnosząca się do treści przechowywanej w pamięci podręcznej. Format: cachedContents/{id}

string

Opcjonalnie. Stała. Wygenerowana przez użytkownika rozpoznawalna wyświetlana nazwa treści z pamięci podręcznej. Maksymalnie 128 znaków Unicode.

string

Wymagane. Stała. Nazwa elementu (Model), który ma być używany w przypadku treści w pamięci podręcznej. Format: models/{model}

object (Content)

Opcjonalnie. Tylko dane wejściowe. Stała. Instrukcja systemowa ustawiona przez dewelopera. Obecnie tylko tekstowe.

object (ToolConfig)

Opcjonalnie. Tylko dane wejściowe. Stała. Konfiguracja narzędzia. Ta konfiguracja jest współdzielona dla wszystkich narzędzi.

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

object (Part)

Zamówiono Parts, które tworzą jedną wiadomość. Części mogą mieć różne typy MIME.

string

Opcjonalnie. Producent treści. Musi mieć wartość „user” lub „model”.

Ta opcja jest przydatna w przypadku rozmów wieloetapowych. W przeciwnym razie pole może pozostać puste lub nieskonfigurowane.

{

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

Tekst wbudowany.

object (Blob)

Wbudowane bajty multimediów.

object (FunctionCall)

Prognozowana wartość FunctionCall zwrócona z modelu, która zawiera ciąg reprezentujący element FunctionDeclaration.name z argumentami i ich wartościami.

object (FunctionResponse)

Wynikowe dane wyjściowe funkcji FunctionCall, które zawierają ciąg znaków reprezentujący obiekt FunctionDeclaration.name, i uporządkowany obiekt JSON zawierający dowolne dane wyjściowe funkcji, są używane jako kontekst dla modelu.

object (FileData)

Dane oparte na identyfikatorze URI.

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

string

Standardowy typ MIME danych źródłowych wg IANA. Przykłady: – obraz/png – obraz/jpeg. Jeśli zostanie podany nieobsługiwany typ MIME, zostanie zwrócony błąd. Pełną listę obsługiwanych formatów znajdziesz w artykule o obsługiwanych formatach plików.

string (bytes format)

Nieprzetworzone bajty formatów multimediów.

Ciąg zakodowany w formacie base64.

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

string

Wymagane. Nazwa funkcji do wywołania. Nazwa musi mieć format a–z, A–Z lub 0–9, albo zawierać podkreślenia i myślniki o maksymalnej długości 63 znaki.

object (Struct format)

Opcjonalnie. Parametry i wartości funkcji w formacie obiektu JSON.

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

string

Wymagane. Nazwa funkcji do wywołania. Nazwa musi mieć format a–z, A–Z lub 0–9, albo zawierać podkreślenia i myślniki o maksymalnej długości 63 znaki.

object (Struct format)

Wymagane. Odpowiedź funkcji w formacie obiektu JSON.

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

string

Opcjonalnie. Standardowy typ MIME danych źródłowych wg IANA.

string

Wymagane. Identyfikator URI.

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

object (FunctionDeclaration)

Opcjonalnie. Lista elementów FunctionDeclarations dostępnych dla modelu, które mogą być używane do wywoływania funkcji.

Model lub system nie wykonuje tej funkcji. Zamiast tego zdefiniowana funkcja może zostać zwrócona jako [wywołanie funkcji][content.part.function_call] z argumentami po stronie klienta do wykonania. Model może zdecydować o wywołaniu podzbioru tych funkcji, wypełniając w odpowiedzi [wywołanie funkcji][content.part.function_call]. Następny skręt wątku może zawierać odpowiedź [FunctionResponse][content.part.function_response] z kontekstem generowania „funkcji” [content.role] dla następnej kolejki modelu.

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

string

Wymagane. Nazwa funkcji. Nazwa musi mieć format a–z, A–Z lub 0–9, albo zawierać podkreślenia i myślniki o maksymalnej długości 63 znaki.

string

Wymagane. Krótki opis funkcji.

object (Schema)

Opcjonalnie. Opisuje parametry tej funkcji. Odzwierciedla klucz ciągu znaków obiektu parametru Open API 3.03: nazwę parametru. W nazwach parametrów rozróżniana jest wielkość liter. Wartość schematu: schemat określający typ parametru.

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

enum (Type)

Wymagane. Typ danych.

string

Opcjonalnie. Format danych. Jest używana tylko w przypadku podstawowych typów danych. Obsługiwane formaty: dla typu NUMBER: liczba zmiennoprzecinkowa, podwójna (liczba całkowita): int32, int64.

string

Opcjonalnie. Krótki opis parametru. Może zawierać przykłady użycia. Opis parametru może mieć format Markdown.

boolean

Opcjonalnie. Wskazuje, czy wartość może być pusta.

string

Opcjonalnie. Możliwe wartości elementu Type.STRING w formacie wyliczenia. Kierunek listy można na przykład zdefiniować jako : {type:STRING, format:enum, enum:["WSCHÓD", PÓŁNOC", "SOUTH", "WEST"]}

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

Opcjonalnie. Właściwości obiektu Type.OBJECT.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

Opcjonalnie. Wymagane właściwości obiektu Type.OBJECT.

object (Schema)

Opcjonalnie. Schemat elementów typu Type.ARRAY.

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

object (FunctionCallingConfig)

Opcjonalnie. Funkcja wywołująca konfigurację.

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

enum (Mode)

Opcjonalnie. Określa tryb, w którym mają być wykonywane wywołania funkcji. Jeśli nie określono inaczej, domyślną wartością będzie AUTO.

string

Opcjonalnie. Zbiór nazw funkcji, które po podaniu ograniczają funkcje wywoływane przez model.

Tę wartość należy ustawiać tylko wtedy, gdy tryb ma wartość DOWOLNY. Nazwy funkcji powinny być takie same jak [FunctionDeklaracja.nazwa]. Gdy tryb jest ustawiony na DOWOLNY, model przewiduje wywołanie funkcji na podstawie podanego zestawu nazw funkcji.

{
  "totalTokenCount": integer
}

integer

Łączna liczba tokenów wykorzystanych przez pamięć podręczną.