Mengekspor dan mengimpor

Halaman ini menjelaskan cara mengekspor dan mengimpor aplikasi agen dan alat individual.

Mengekspor dan mengimpor agen

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

Mengekspor dan mengimpor alat

Anda dapat mengekspor dan mengimpor alat satu per satu. Fungsi ini menyediakan dua opsi baru di panel Alat: Impor dan Ekspor.

  • Ekspor: Download konten alat sebagai file JSON ke komputer lokal Anda atau ke Cloud Storage.
  • Impor: Gunakan file JSON lokal atau file JSON yang disimpan di Cloud Storage untuk membuat alat baru atau memperbarui alat yang ada.

Mengekspor alat

Untuk mengekspor alat:

  1. Buka konsol Gemini Enterprise untuk CX, lalu pilih project dan agen Anda.
  2. Buka panel Alat.
  3. Klik menu konteks untuk alat yang ingin Anda ekspor.
  4. Pilih Ekspor.
  5. Pada dialog, pilih salah satu opsi berikut:
    • Download: Menyimpan file JSON ke komputer lokal Anda.
    • Cloud Storage: Menyimpan file JSON ke URI Cloud Storage yang ditentukan.

Mengimpor alat

Ada dua alur kerja untuk mengimpor alat:

Mengimpor untuk menimpa

Gunakan opsi ini untuk mengubah alat yang ada. File JSON yang diimpor harus sesuai dengan jenis alat yang sama dengan alat saat ini.

  1. Buka konsol Gemini Enterprise untuk CX, lalu pilih project dan agen Anda.
  2. Buka panel Alat.
  3. Klik menu konteks untuk alat yang ingin Anda perbarui.
  4. Pilih Impor untuk menimpa.
  5. Pada dialog, pilih salah satu opsi berikut:
    • Upload JSON: Pilih file JSON dari komputer lokal Anda.
    • Cloud Storage: Masukkan URI file JSON di Cloud Storage.

Impor sebagai baru

Gunakan opsi ini untuk membuat alat baru.

  1. Buka konsol Gemini Enterprise untuk CX, lalu pilih project dan agen Anda.
  2. Buka panel Create Tool.
  3. Pilih Impor sebagai baru.
  4. Pada dialog, pilih salah satu opsi berikut:
    • Upload JSON: Pilih file JSON dari komputer lokal Anda.
    • Cloud Storage: Masukkan URI file JSON di Cloud Storage.