Ekspor/pemulihan Git

Dialogflow CX terintegrasi dengan beberapa penyedia Git (GitHub, Gitlab, Bitbucket, dan lainnya). Integrasi ini memudahkan Anda untuk mengekspor agen ke JSON untuk push ke penyedia Git, dan menarik dari penyedia Git untuk pemulihan agen. Format JSON yang diekspor dan di-push ke penyedia Git adalah konten file zip yang diperluas dari agen yang diekspor.

Dengan menggunakan fitur ini, Anda dapat memanfaatkan fitur kontrol sumber penyedia Git seperti:

  • Ulasan perubahan agen menggunakan alat peninjauan kode
  • Memeriksa perbedaan agen menggunakan alat perbedaan
  • Penggabungan

Batasan

Batasan berikut berlaku:

  • [Hanya versi integrasi lama] GitHub API memiliki batasan jumlah file yang dapat diupdate dalam satu commit. Jika jumlah file melebihi 500, Anda mungkin tidak dapat melakukan push ke GitHub dari Dialogflow CX. Dalam kasus seperti itu, Anda dapat mengekspor agen sebagai zip dan menggunakan Git CLI di mesin Anda untuk melakukan push file agen ke GitHub. Batasan ini akan diatasi dalam rilis Dialogflow CX mendatang.
  • Repositori yang dihosting sendiri dengan akses pribadi GitHub tidak didukung, karena Dialogflow CX tidak dapat mengakses repositori ini.
  • Repositori Git tidak boleh berisi file apa pun selain file agen yang diekspor oleh ekspor agen. File lain di repositori akan dihapus pada setiap push.

Konfigurasi

Untuk mengonfigurasi fitur ini, Anda harus mendapatkan token akses dari penyedia Git, menyimpannya di Secret Manager, dan memberikan resource secret ke Dialogflow CX:

Token akses

Untuk mendapatkan token akses dari penyedia Git:

GitHub

Anda harus mendapatkan a token pribadi GitHub Jika Anda menggunakan token akses pribadi yang terperinci, Anda memerlukan izin akses berikut:

  • Repository Permissions > Contents: Read and write
  • Repository Permissions > Metadata: Read-only (should be auto-selected after selecting Contents permission)

Gitlab

Anda harus mendapatkan a token akses pribadi Gitlab.

Bitbucket

Anda harus mendapatkan token akses Bitbucket.

Secret Manager

Setelah memiliki token akses, Anda harus membuat secret untuk token Anda:

  1. Mengaktifkan Secret Manager API.
  2. Membuat secret.

Konfigurasi Dialogflow CX

Untuk mengonfigurasi integrasi ini untuk Dialogflow CX:

  1. Berikan izin agen layanan Dialogflow untuk mengakses secret token akses di Secret Manager. Berikan peran Secret Manager Secret Accessor ke akun layanan gcp-sa-dialogflow. di project agen Anda. Lihat Memberikan akses ke secret Secret Manager.
  2. Buka konfigurasi integrasi Git:
    • Konsol Conversational Agents
      1. Buka tampilan setelan dengan mengklik ikon setelan di dekat pojok kanan atas.
      2. Scroll ke bawah, lalu klik Add Git integration.
    • Konsol Dialogflow CX
      1. Klik tab Manage.
      2. Klik Git di bagian Testing &Deployment.
      3. Klik Create new.
  3. Berikan detail konfigurasi:
    1. Masukkan info berikut:
      • Nama tampilan untuk koneksi GitHub.
      • URL repositori Git (misalnya: https://github.com/<path-to-repo>.git).
      • Tambahkan cabang Git yang akan berinteraksi dengan agen Anda. Anda dapat menetapkan cabang sebagai cabang default dengan mengklik ikon bintang di sampingnya.
      • Secret token akses, yang merupakan versi secret yang Anda buat dalam format projects/*/secrets/*/versions/* untuk versi tertentu atau projects/*/secrets/*/versions/latest untuk versi terbaru.
    2. Klik Connect.
    3. Mungkin perlu waktu satu menit agar layanan Git siap. Konsol akan menampilkan notifikasi.

Push dan pemulihan

Setelah dikonfigurasi, Anda dapat melakukan push/pull agen ke/dari Git.

Tombol Push digunakan untuk mengekspor agen Anda dan melakukan commit ke cabang Git yang dipilih di dropdown cabang Git. Commit ini akan terdiri dari seluruh agen, bukan perubahan tertentu, dan akan menghapus file yang ada di repositori.

Pengguna dengan peran Dialogflow Reader memiliki kemampuan untuk melakukan push ke repositori Git. Untuk mencegah push yang tidak diinginkan, konfigurasi agen ini dengan token akses pribadi hanya baca.

Tombol Restore digunakan untuk menarik data agen Anda dari cabang Git yang dipilih di dropdown cabang Git dan memulihkan agen Dialogflow CX Anda dari data ini. Tindakan ini akan mengganti agen Anda dengan cara yang sama seperti perilaku pemulihan agen.

Contoh kasus penggunaan

Contoh berikut mengilustrasikan cara fitur ini dapat digunakan oleh beberapa orang untuk mengusulkan perubahan agen yang berbeda ke agen produksi.

Pertimbangkan bahwa agen Anda menggunakan cabang Git berikut:

  • Prod: cabang untuk agen produksi Anda
  • Dev1: cabang untuk pengembangan agen
  • Dev2: cabang lain untuk pengembangan agen

Pengguna 1 ingin mengusulkan perubahan agen dan melakukan langkah-langkah berikut:

  1. Ekspor agen produksi ke agen baru.
  2. Buat perubahan yang diinginkan pada salinan agen ini.
  3. Uji perubahan.
  4. Push agen yang diubah ke cabang Dev1.
  5. Buat permintaan penggabungan ke cabang Prod.

Pengguna 2 ingin mengusulkan perubahan agen dan melakukan langkah-langkah berikut:

  1. Ekspor agen produksi ke agen baru.
  2. Buat perubahan yang diinginkan pada salinan agen ini.
  3. Uji perubahan.
  4. Push agen yang diubah ke cabang Dev2.
  5. Buat permintaan penggabungan ke cabang Prod.

Pengguna 3 meninjau permintaan penggabungan dari kedua pengguna dan melakukan langkah-langkah berikut:

  1. Selesaikan konflik.
  2. Commit perubahan yang disetujui.
  3. Pulihkan cabang Git produksi ke agen Dialogflow CX produksi.
Sebelumnya
Sesi
Berikutnya
Sentimen