Method: projects.locations.collections.engines.assistants.createCachedContent

Cria um cache de contexto explícito (Vertex CachedContent). O name dele é transmitido como cachedContent em solicitações subsequentes de "assistants.generateContent". Limitado a clientes do Gemini Enterprise (visibilidade ASSISTANT_USER).

Solicitação HTTP


POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/assistants/*}:createCachedContent

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso do Assistant que atende à solicitação. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "model": string,
  "httpBody": {
    object (HttpBody)
  }
}
Campos
model

string

Obrigatório. ID opaco do modelo usado com o cache. Precisa corresponder ao modelo nas solicitações assistants.generateContent que o referenciam.

httpBody

object (HttpBody)

Obrigatório. O Vertex CachedContent a ser criado, como JSON.

Corpo da resposta

Se for bem-sucedida, a resposta será uma resposta HTTP genérica que tem o formato definido pelo método.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • discoveryengine.assistants.assist

Para mais informações, consulte a documentação do IAM.