Esportazione e importazione

Puoi esportare e importare le applicazioni degli agenti:

  1. Apri la console Gemini Enterprise for CX.
  2. Seleziona il progetto. Viene visualizzato l'elenco delle applicazioni di agenti per il tuo progetto.
  3. Fai clic sul menu contestuale per la tua applicazione, poi seleziona importa o esporta.

File ambiente

Quando esporti un'applicazione agente, un file denominato environment.json è incluso nella directory radice dell'archivio scaricato. Questo file ti aiuta a gestire le impostazioni specifiche dell'ambiente per la tua applicazione, come i bucket Cloud Storage, gli endpoint di servizio e gli URI dei datastore.

L'utilizzo di questo file per le esportazioni e le importazioni presenta i seguenti vantaggi:

  • Maggiore portabilità: Trasferisci le applicazioni agent tra progetti o ambienti diversi (ad esempio, dallo sviluppo alla produzione) modificando un solo file.
  • Configurazione centralizzata:tutte le dipendenze esterne chiave sono elencate in un unico posto, semplificando la gestione e fornendo una panoramica chiara.
  • Errori ridotti:Riduce al minimo il rischio di errori rispetto alla modifica manuale delle impostazioni in più file di risorse.
  • Adatto all'automazione:il formato JSON consente di aggiornare programmaticamente le configurazioni utilizzando script nell'ambito di una pipeline CI/CD.

Per aggiornare le impostazioni specifiche dell'ambiente:

  1. Esportazione: Scarica l'applicazione dell'agente esportata ed estraila.
  2. Modifica: apri il file environment.json che si trova nella directory root. Modifica i valori delle dipendenze in modo che corrispondano alle impostazioni dell'ambiente di destinazione.
  3. Importazione:comprimi l'intera directory, incluso il file environment.json modificato, in un nuovo archivio zip. Importa questo nuovo archivio nell'ambiente di destinazione. Il sistema applica i valori aggiornati da environment.json.

Dettagli del file dell'ambiente

Il file environment.json funge da manifest centrale per le dipendenze esterne che potrebbero cambiare tra i diversi ambienti (ad esempio sviluppo, test e produzione).

Quando esporti un'applicazione agente, il sistema identifica i campi specifici dell'ambiente all'interno delle risorse dell'applicazione. Anziché codificare questi valori, il sistema li estrae e li inserisce nel file environment.json. I valori sono organizzati in base al tipo e al nome della risorsa. Nei file manifest delle risorse originali, questi valori estratti vengono sostituiti con una variabile segnaposto, $env_var.

Quando importi l'applicazione agente, il sistema legge il file environment.json. Trova i segnaposto $env_var nei manifest delle risorse e li sostituisce con i valori corrispondenti del file environment.json. Questo processo configura l'applicazione per il nuovo ambiente.

I seguenti campi vengono gestiti nel file 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 (estratto automaticamente da OpenApiToolset.open_api_schema)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids