Exporter et importer

Cette page explique comment exporter et importer des applications d'agent et des outils individuels.

Exporter et importer des agents

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

Exporter et importer des outils

Vous pouvez exporter et importer des outils individuels. Cette fonctionnalité propose deux nouvelles options dans le panneau "Outils" : Importer et Exporter.

  • Exporter : téléchargez le contenu de l'outil sous forme de fichier JSON sur votre ordinateur local ou dans Cloud Storage.
  • Importer : utilisez des fichiers JSON locaux ou stockés dans Cloud Storage pour créer des outils ou mettre à jour ceux existants.

Exporter un outil

Pour exporter un outil :

  1. Ouvrez la console Gemini Enterprise pour CX, puis sélectionnez votre projet et votre agent.
  2. Ouvrez le panneau Outil.
  3. Cliquez sur le menu contextuel de l'outil que vous souhaitez exporter.
  4. Sélectionnez Export (Exporter).
  5. Dans la boîte de dialogue, choisissez l'une des options suivantes :
    • Télécharger : enregistre le fichier JSON sur votre ordinateur local.
    • Cloud Storage : enregistre le fichier JSON dans un URI Cloud Storage spécifié.

Importer un outil

Il existe deux workflows pour importer un outil :

Importer pour écraser

Utilisez cette option pour modifier un outil existant. Le fichier JSON importé doit correspondre au même type d'outil que l'outil actuel.

  1. Ouvrez la console Gemini Enterprise pour CX, puis sélectionnez votre projet et votre agent.
  2. Ouvrez le panneau Outil.
  3. Cliquez sur le menu contextuel de l'outil que vous souhaitez mettre à jour.
  4. Sélectionnez Importer pour écraser.
  5. Dans la boîte de dialogue, choisissez l'une des options suivantes :
    • Importer un fichier JSON : sélectionnez un fichier JSON sur votre ordinateur local.
    • Cloud Storage : saisissez l'URI d'un fichier JSON dans Cloud Storage.

Importer en tant que nouveau

Utilisez cette option pour créer un outil.

  1. Ouvrez la console Gemini Enterprise pour CX, puis sélectionnez votre projet et votre agent.
  2. Ouvrez le panneau Outil de création.
  3. Sélectionnez Importer en tant que nouveau.
  4. Dans la boîte de dialogue, choisissez l'une des options suivantes :
    • Importer un fichier JSON : sélectionnez un fichier JSON sur votre ordinateur local.
    • Cloud Storage : saisissez l'URI d'un fichier JSON dans Cloud Storage.