Exporter et importer

Vous pouvez exporter et importer des applications d'agent :

  1. Ouvrez la console Gemini Enterprise pour CX.
  2. Sélectionnez votre projet. La liste des applications d'agent pour votre projet s'affiche.
  3. Cliquez sur le menu contextuel de votre application, puis sélectionnez "Importer" ou "Exporter".

Fichier d'environnement

Lorsque vous exportez une application d'agent, un fichier nommé environment.json est inclus dans le répertoire racine de l'archive téléchargée. Ce fichier vous aide à gérer les paramètres spécifiques à l'environnement de votre application, tels que les buckets Cloud Storage, les points de terminaison de service et les URI du data store.

L'utilisation de ce fichier pour les exportations et les importations présente les avantages suivants :

  • Portabilité améliorée : transférez des applications d'agent entre différents projets ou environnements (par exemple, du développement à la production) en modifiant un seul fichier.
  • Configuration centralisée : toutes les dépendances externes clés sont listées au même endroit, ce qui simplifie la gestion et offre une vue d'ensemble claire.
  • Réduction des erreurs : le risque d'erreurs est minimisé par rapport à la modification manuelle des paramètres dans plusieurs fichiers de ressources.
  • Adapté à l'automatisation : le format JSON vous permet de mettre à jour les configurations de manière programmatique à l'aide de scripts dans un pipeline CI/CD.

Pour modifier les paramètres spécifiques à l'environnement :

  1. Exporter : téléchargez l'application d'agent exportée et extrayez-la.
  2. Modifier : ouvrez le fichier environment.json situé dans le répertoire racine. Modifiez les valeurs des dépendances pour qu'elles correspondent aux paramètres de votre environnement cible.
  3. Importer : compressez l'intégralité du répertoire, y compris le fichier environment.json modifié, dans une nouvelle archive ZIP. Importez cette nouvelle archive dans l'environnement cible. Le système applique les valeurs mises à jour de environment.json.

Détails du fichier d'environnement

Le fichier environment.json sert de fichier manifeste central pour les dépendances externes qui peuvent changer entre différents environnements (par exemple, développement, test et production).

Lorsque vous exportez une application d'agent, le système identifie les champs spécifiques à l'environnement dans les ressources de l'application. Au lieu de coder en dur ces valeurs, le système les extrait et les place dans le fichier environment.json. Les valeurs sont organisées par type et nom de ressource. Dans les fichiers manifestes de ressources d'origine, ces valeurs extraites sont remplacées par une variable d'espace réservé, $env_var.

Lorsque vous importez l'application d'agent, le système lit le fichier environment.json. Il recherche les espaces réservés $env_var dans les manifestes de ressources et les remplace par les valeurs correspondantes du fichier environment.json. Ce processus configure l'application pour le nouvel environnement.

Les champs suivants sont gérés dans le fichier environment.json :

  • ApiKeyConfig.key_name
  • ApiKeyConfig.api_key_secret_version
  • AudioRecordingConfig.gcs_bucket
  • BoostSpecs.data_stores
  • ConnectorTool.connection
  • DataStore.name
  • EngineSource.engine
  • FileSearchTool.file_corpus
  • OAuthConfig.client_secret_version
  • OAuthConfig.token_endpoint
  • OpenApiToolset.url (extrait automatiquement de OpenApiToolset.open_api_schema)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids