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)

Opcional. Apenas entrada. Imutável. O conteúdo a ser armazenado em cache.

object (Tool)

Opcional. Apenas entrada. Imutável. Uma lista de Tools que o modelo pode usar para gerar a próxima resposta

string (Timestamp format)

Apenas saída. Hora de criação da entrada do cache.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Apenas saída. Quando a entrada do cache foi atualizada pela última vez no horário UTC.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (UsageMetadata)

Apenas saída. Metadados sobre o uso do conteúdo armazenado em cache.

string (Timestamp format)

Carimbo de data/hora em UTC de quando o recurso será considerado expirado. Isso é sempre fornecido na saída, independente do que tiver sido enviado na entrada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Apenas entrada. Novo TTL para este recurso, somente entrada.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

string

Opcional. Identificador. O nome do recurso que se refere ao conteúdo armazenado em cache. Formato: cachedContents/{id}

string

Opcional. Imutável. O nome de exibição significativo gerado pelo usuário do conteúdo armazenado em cache. Máximo de 128 caracteres Unicode.

string

Obrigatório. Imutável. O nome do Model que será usado para conteúdo em cache. Formato: models/{model}

object (Content)

Opcional. Apenas entrada. Imutável. O desenvolvedor definiu as instruções do sistema. No momento, somente texto.

object (ToolConfig)

Opcional. Apenas entrada. Imutável. Configuração da ferramenta. Essa configuração é compartilhada para todas as ferramentas.

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

object (Part)

Parts ordenados que constituem uma única mensagem. As partes podem ter diferentes tipos MIME.

string

Opcional. O produtor do conteúdo. Precisa ser "user" ou "model".

Útil para definir para conversas de várias interações. Caso contrário, pode ser deixado em branco ou sem definição.

{

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

Texto inline.

object (Blob)

Bytes de mídia inline.

object (FunctionCall)

Uma previsão FunctionCall retornada do modelo que contém uma string representando FunctionDeclaration.name com os argumentos e os valores deles.

object (FunctionResponse)

O resultado de uma FunctionCall que contém uma string representando o FunctionDeclaration.name e um objeto JSON estruturado contendo qualquer saída da função é usada como contexto para o modelo.

object (FileData)

Dados baseados em URI.

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

string

O tipo MIME padrão da IANA dos dados de origem. Exemplos: - image/png - image/jpeg Se um tipo MIME incompatível for fornecido, será retornado um erro. Para uma lista completa dos tipos compatíveis, consulte Formatos de arquivo compatíveis.

string (bytes format)

Bytes brutos para formatos de mídia.

Uma string codificada em base64.

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

string

Obrigatório. O nome da função a ser chamada. Precisa ser a-z, A-Z, 0-9 ou conter sublinhados e traços, com comprimento máximo de 63.

object (Struct format)

Opcional. Os parâmetros e valores da função no formato de objeto JSON.

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

string

Obrigatório. O nome da função a ser chamada. Precisa ser a-z, A-Z, 0-9 ou conter sublinhados e traços, com comprimento máximo de 63.

object (Struct format)

Obrigatório. A resposta da função no formato de objeto JSON.

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

string

Opcional. O tipo MIME padrão da IANA dos dados de origem.

string

Obrigatório. URI.

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

object (FunctionDeclaration)

Opcional. Uma lista de FunctionDeclarations disponíveis para o modelo que pode ser usada para chamar funções.

O modelo ou sistema não executa a função. Em vez disso, a função definida pode ser retornada como uma [FunctionCall][content.part.function_call] com argumentos para execução no lado do cliente. O modelo pode decidir chamar um subconjunto dessas funções preenchendo [FunctionCall][content.part.function_call] na resposta. A próxima rodada da conversa pode conter uma [FunctionResponse][content.part.function_response] com o contexto de geração da "função" [content.role] para a próxima rodada do modelo.

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

string

Obrigatório. O nome da função. Precisa ser a-z, A-Z, 0-9 ou conter sublinhados e traços, com comprimento máximo de 63.

string

Obrigatório. Uma breve descrição da função.

object (Schema)

Opcional. Descreve os parâmetros para esta função. Reflete a chave da string do objeto de parâmetro da OpenAPI 3.03: o nome do parâmetro. Os nomes dos parâmetros diferenciam maiúsculas de minúsculas. Valor do esquema: o esquema que define o tipo usado para o parâmetro.

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

enum (Type)

Obrigatório. Tipo de dados.

string

Opcional. O formato dos dados. Isso é usado apenas para tipos de dados primitivos. Formatos suportados: para NUMBER, tipo: float, double para tipo INTEGER: int32, int64

string

Opcional. Uma breve descrição do parâmetro. Ela pode conter exemplos de uso. A descrição do parâmetro pode ser formatada como Markdown.

boolean

Opcional. Indica se o valor pode ser nulo.

string

Opcional. Possíveis valores do elemento de Type.STRING com formato de enumeração. Por exemplo, podemos definir uma direção de tipo enumerado como : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}

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

Opcional. Propriedades de Type.OBJECT.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

Opcional. Propriedades obrigatórias de Type.OBJECT.

object (Schema)

Opcional. Esquema dos elementos de Type.ARRAY.

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

object (FunctionCallingConfig)

Opcional. Config. da chamada de função.

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

enum (Mode)

Opcional. Especifica o modo em que a chamada de função precisa ser executada. Se não for especificado, o valor padrão será definido como AUTOMÁTICO.

string

Opcional. Um conjunto de nomes de função que, quando fornecidos, limita as funções que o modelo vai chamar.

Isso só deve ser definido quando o Modo for QUALQUER. Os nomes das funções precisam corresponder a [FunctionDeclaration.name]. Com o modo definido como QUALQUER, o modelo vai prever uma chamada de função do conjunto de nomes de função fornecidos.

{
  "totalTokenCount": integer
}

integer

Número total de tokens consumidos pelo conteúdo em cache.