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

Crée un cache de contexte explicite (Vertex CachedContent). Son name est transmis en tant que cachedContent dans les requêtes assistants.generateContent suivantes. Limité aux clients Gemini Enterprise (visibilité ASSISTANT_USER).

Requête HTTP


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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de l'Assistant qui diffuse la requête. Format : projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "model": string,
  "httpBody": {
    object (HttpBody)
  }
}
Champs
model

string

Obligatoire. ID de modèle opaque avec lequel le cache est utilisé. Il doit correspondre au modèle dans les requêtes assistants.generateContent qui y font référence.

httpBody

object (HttpBody)

Obligatoire. Vertex CachedContent à créer, au format JSON.

Corps de la réponse

Si la requête aboutit, la réponse est une réponse HTTP générique dont le format est défini par la méthode.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • 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

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • discoveryengine.assistants.assist

Pour en savoir plus, consultez la documentation IAM.