Mengekspor dan mengimpor

Anda dapat mengekspor dan mengimpor aplikasi agen:

  1. Buka konsol Gemini Enterprise untuk CX.
  2. Pilih project Anda. Daftar aplikasi agen untuk project Anda akan ditampilkan.
  3. Klik menu konteks untuk aplikasi Anda, lalu pilih impor atau ekspor.

File lingkungan

Saat Anda mengekspor aplikasi agen, file bernama environment.json akan disertakan di direktori root arsip yang didownload. File ini membantu Anda mengelola setelan khusus lingkungan untuk aplikasi, seperti bucket Cloud Storage, endpoint layanan, dan URI penyimpanan data.

Menggunakan file ini untuk ekspor dan impor memiliki keuntungan sebagai berikut:

  • Portabilitas yang Lebih Baik: Transfer aplikasi agen di antara berbagai project atau lingkungan (misalnya, dari pengembangan ke produksi) dengan mengubah satu file.
  • Konfigurasi Terpusat: Semua dependensi eksternal utama dicantumkan di satu tempat, sehingga menyederhanakan pengelolaan dan memberikan ringkasan yang jelas.
  • Mengurangi Kesalahan: Meminimalkan risiko kesalahan dibandingkan dengan mengedit setelan secara manual di beberapa file resource.
  • Kompatibel dengan Otomatisasi: Format JSON memungkinkan Anda memperbarui konfigurasi secara terprogram menggunakan skrip sebagai bagian dari pipeline CI/CD.

Untuk memperbarui setelan khusus lingkungan:

  1. Ekspor: Download aplikasi agen yang diekspor dan ekstrak.
  2. Ubah: Buka file environment.json yang berada di direktori root. Ubah nilai untuk dependensi agar sesuai dengan setelan lingkungan target Anda.
  3. Impor: Kompresi seluruh direktori, termasuk file environment.json yang diubah, ke dalam arsip zip baru. Impor arsip baru ini ke lingkungan target. Sistem menerapkan nilai yang diperbarui dari environment.json.

Detail file lingkungan

File environment.json berfungsi sebagai manifes pusat untuk dependensi eksternal yang mungkin berubah di antara lingkungan yang berbeda (misalnya, pengembangan, pengujian, dan produksi).

Saat Anda mengekspor aplikasi agen, sistem mengidentifikasi kolom khusus lingkungan dalam resource aplikasi. Daripada membuat hardcode nilai ini, sistem akan mengekstraknya dan menempatkannya dalam file environment.json. Nilai diatur menurut jenis dan nama resource. Dalam file manifes resource asli, nilai yang diekstrak ini diganti dengan variabel placeholder, $env_var.

Saat Anda mengimpor aplikasi agen, sistem akan membaca file environment.json. Plugin ini menemukan placeholder $env_var dalam manifes resource dan menggantinya dengan nilai yang sesuai dari file environment.json. Proses ini mengonfigurasi aplikasi untuk lingkungan baru.

Kolom berikut dikelola dalam 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 (Diekstrak secara otomatis dari OpenApiToolset.open_api_schema)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids