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)

Campo facoltativo. Solo input. Immutabile. I contenuti da memorizzare nella cache.

object (Tool)

Campo facoltativo. Solo input. Immutabile. Un elenco di Tools che il modello potrebbe utilizzare per generare la risposta successiva

string (Timestamp format)

Solo output. Data/ora di creazione della voce della cache.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Solo output. Data dell'ultimo aggiornamento della voce della cache nel fuso orario UTC.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (UsageMetadata)

Solo output. Metadati sull'utilizzo dei contenuti memorizzati nella cache.

string (Timestamp format)

Timestamp in UTC di quando questa risorsa è considerata scaduta. Viene sempre fornito nell'output, indipendentemente da quanto inviato nell'input.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Solo input. Nuovo TTL per questa risorsa, solo input.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

string

Campo facoltativo. Identificatore. Il nome della risorsa che fa riferimento ai contenuti memorizzati nella cache. Formato: cachedContents/{id}

string

Campo facoltativo. Immutabile. Il nome visualizzato significativo generato dall'utente dei contenuti memorizzati nella cache. Massimo 128 caratteri Unicode.

string

Obbligatoria. Immutabile. Nome del Model da utilizzare per i contenuti memorizzati nella cache. Formato: models/{model}

object (Content)

Campo facoltativo. Solo input. Immutabile. Istruzione di sistema impostata dallo sviluppatore. Attualmente solo testo.

object (ToolConfig)

Campo facoltativo. Solo input. Immutabile. Configurazione strumento Questa configurazione è condivisa per tutti gli strumenti.

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

object (Part)

Parts ordinato che costituiscono un singolo messaggio. Le parti possono avere tipi MIME diversi.

string

Campo facoltativo. Il produttore dei contenuti. Deve essere "user" o "model".

Utile per le conversazioni multi-turno, altrimenti può essere lasciato vuoto o non impostato.

{

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

Testo in linea.

object (Blob)

Media byte in linea.

object (FunctionCall)

Un valore FunctionCall previsto restituito dal modello che contiene una stringa che rappresenta il valore FunctionDeclaration.name con gli argomenti e i relativi valori.

object (FunctionResponse)

L'output del risultato di un FunctionCall che contiene una stringa che rappresenta il valore FunctionDeclaration.name e un oggetto JSON strutturato contenente qualsiasi output della funzione viene utilizzato come contesto per il modello.

object (FileData)

dati basati su URI.

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

string

Il tipo MIME standard IANA dei dati di origine. Esempi: - image/png - image/jpeg Se viene fornito un tipo MIME non supportato, verrà restituito un errore. Per un elenco completo dei tipi di file supportati, vedi Formati file supportati.

string (bytes format)

Byte non elaborati per i formati multimediali.

Una stringa con codifica base64.

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

string

Obbligatoria. Il nome della funzione da chiamare. Deve essere a-z, A-Z, 0-9 o contenere trattini bassi e trattini, con una lunghezza massima di 63 caratteri.

object (Struct format)

Campo facoltativo. I parametri e i valori della funzione in formato oggetto JSON.

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

string

Obbligatoria. Il nome della funzione da chiamare. Deve essere a-z, A-Z, 0-9 o contenere trattini bassi e trattini, con una lunghezza massima di 63 caratteri.

object (Struct format)

Obbligatoria. La risposta della funzione in formato oggetto JSON.

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

string

Campo facoltativo. Il tipo MIME standard IANA dei dati di origine.

string

Obbligatoria. URI.

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

object (FunctionDeclaration)

Campo facoltativo. Un elenco di FunctionDeclarations disponibili per il modello, che possono essere utilizzati per le chiamate di funzione.

Il modello o il sistema non esegue la funzione. La funzione definita può invece essere restituita come [FunctionCall][content.part.function_call] con argomenti al lato client per l'esecuzione. Il modello può decidere di chiamare un sottoinsieme di queste funzioni compilando [FunctionCall][content.part.function_call] nella risposta. Il turno di conversazione successivo potrebbe contenere un oggetto [FunctionResponse][content.part.function_response] con il contesto di generazione della funzione [content.role] per il successivo turno del modello.

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

string

Obbligatoria. Il nome della funzione. Deve essere a-z, A-Z, 0-9 o contenere trattini bassi e trattini, con una lunghezza massima di 63 caratteri.

string

Obbligatoria. Una breve descrizione della funzione.

object (Schema)

Campo facoltativo. Descrive i parametri di questa funzione. Riflette la stringa oggetto parametro Open API 3.03 Chiave: il nome del parametro. I nomi dei parametri sono sensibili alle maiuscole. Valore schema: lo schema che definisce il tipo utilizzato per il parametro.

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

enum (Type)

Obbligatoria. Tipo di dati.

string

Campo facoltativo. Il formato dei dati. Viene utilizzato solo per i tipi di dati primitivi. Formati supportati: per il tipo NUMBER: numero in virgola mobile, doppio per il tipo INTEGER: int32, int64

string

Campo facoltativo. Una breve descrizione del parametro. Potrebbero contenere esempi di utilizzo. La descrizione del parametro può essere formattata come Markdown.

boolean

Campo facoltativo. Indica se il valore può essere nullo.

string

Campo facoltativo. Valori possibili dell'elemento di Type.STRING con formato enum. Ad esempio possiamo definire una direzione enum come : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}

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

Campo facoltativo. Proprietà di Type.OBJECT.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

Campo facoltativo. Proprietà obbligatorie di Type.OBJECT.

object (Schema)

Campo facoltativo. Schema degli elementi di Type.ARRAY.

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

object (FunctionCallingConfig)

Campo facoltativo. Configurazione della chiamata di funzione.

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

enum (Mode)

Campo facoltativo. Specifica la modalità in cui devono essere eseguite le chiamate di funzione. Se non specificato, il valore predefinito verrà impostato su AUTO.

string

Campo facoltativo. Un insieme di nomi di funzioni che, se forniti, limitano le funzioni chiamate dal modello.

Deve essere impostata solo quando la modalità è impostata su UNO. I nomi delle funzioni devono corrispondere a [FunctionDeclaration.name]. Con la modalità impostata su QUALSIASI, il modello prevede una chiamata di funzione dall'insieme di nomi di funzione fornito.

{
  "totalTokenCount": integer
}

integer

Numero totale di token utilizzati dai contenuti memorizzati nella cache.