Esportazione e importazione

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

Esportazione e importazione di agenti

Puoi esportare e importare applicazioni agenti:

  1. Apri la console di CX Agent Studio.
  2. Seleziona il progetto. Viene visualizzato l'elenco delle applicazioni agenti per il progetto.
  3. Fai clic sul menu contestuale dell'applicazione, quindi seleziona Importa o Esporta.

File di ambiente

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

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

  • Portabilità migliorata: trasferisci le applicazioni agenti tra progetti o ambienti diversi (ad esempio, dallo sviluppo alla produzione) modificando un singolo file.
  • Configurazione centralizzata: tutte le dipendenze esterne chiave sono elencate in un'unica posizione, semplificando la gestione e fornendo una panoramica chiara.
  • Riduzione degli errori: riduce al minimo il rischio di errori rispetto alla modifica manuale delle impostazioni in più file di risorse.
  • Compatibilità con l'automazione: il formato JSON ti consente di aggiornare le configurazioni a livello di programmazione utilizzando gli script come parte di una pipeline CI/CD.

Per aggiornare le impostazioni specifiche dell'ambiente:

  1. Esporta: scarica l'applicazione agente esportata ed estraila.
  2. Modifica: apri il file environment.json che si trova nella directory principale. Modifica i valori delle dipendenze in modo che corrispondano alle impostazioni dell'ambiente di destinazione.
  3. Importa: 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 di ambiente

Il file environment.json funge da manifest centrale per le dipendenze esterne che potrebbero cambiare tra ambienti diversi (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 per tipo e 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. Questa procedura 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à fornisce due nuove opzioni nel riquadro Strumento: Importa ed Esporta.

  • Esporta: scarica i contenuti dello strumento come file JSON nella macchina locale o in Cloud Storage.
  • Importa: utilizza i file JSON locali o i 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 di CX Agent Studio 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:
    • Scarica: 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 di CX Agent Studio 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 di CX Agent Studio e seleziona il progetto e l'agente.
  2. Apri il riquadro Crea strumento.
  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.