Esportazione e importazione

Questa pagina descrive come esportare e importare applicazioni di agenti e singoli strumenti.

Esportazione e importazione di agenti

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

Esportazione e importazione di strumenti

Puoi esportare e importare singoli strumenti. Questa funzionalità offre due nuove opzioni nel riquadro Strumenti: Importa ed Esporta.

  • Esporta:scarica i contenuti dello strumento come file JSON nella macchina locale o in Cloud Storage.
  • Importa:utilizza file JSON locali o file JSON archiviati in Cloud Storage per creare nuovi strumenti o aggiornare quelli esistenti.

Esportare uno strumento

Per esportare uno strumento:

  1. Apri la console Gemini Enterprise per CX e seleziona il progetto e l'agente.
  2. Apri il riquadro Strumento.
  3. Fai clic sul menu contestuale dello strumento che vuoi esportare.
  4. Seleziona Esporta.
  5. Nella finestra di dialogo, scegli una delle seguenti opzioni:
    • Download:salva il file JSON nella macchina locale.
    • Cloud Storage:salva il file JSON in un URI Cloud Storage specificato.

Importare uno strumento

Esistono due flussi di lavoro per importare uno strumento:

Importa per sovrascrivere

Utilizza questa opzione per modificare uno strumento esistente. Il file JSON importato deve corrispondere allo stesso tipo di strumento di quello attuale.

  1. Apri la console Gemini Enterprise per CX e seleziona il progetto e l'agente.
  2. Apri il riquadro Strumento.
  3. Fai clic sul menu contestuale dello strumento che vuoi aggiornare.
  4. Seleziona Importa per sovrascrivere.
  5. Nella finestra di dialogo, scegli una delle seguenti opzioni:
    • Carica JSON:seleziona un file JSON dalla macchina locale.
    • Cloud Storage:inserisci l'URI di un file JSON in Cloud Storage.

Importa come nuovo

Utilizza questa opzione per creare un nuovo strumento.

  1. Apri la console Gemini Enterprise per CX e seleziona il progetto e l'agente.
  2. Apri il riquadro Strumento di creazione.
  3. Seleziona Importa come nuovo.
  4. Nella finestra di dialogo, scegli una delle seguenti opzioni:
    • Carica JSON:seleziona un file JSON dalla macchina locale.
    • Cloud Storage:inserisci l'URI di un file JSON in Cloud Storage.