Menyiapkan penyimpanan data Confluence Cloud

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Confluence Cloud ke Gemini Enterprise.

Sebelum memulai

Pastikan hal berikut sebelum Anda menyiapkan koneksi gabungan Confluence Cloud:

• Berikan peran Discovery Engine Editor (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman IAM.

     Buka IAM

  2. Cari akun pengguna, lalu klik edit Edit.
  3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

• Untuk menerapkan kontrol akses sumber data dan mengamankan data di Google Gemini Enterprise, konfigurasi penyedia identitas Anda.

• Untuk menyiapkan penyimpanan data Confluence Cloud, Anda harus menggunakan model pengelolaan pengguna Atlassian terpusat yang baru. Jika menggunakan model asli, Anda harus memigrasikan pengelolaan pengguna sebelum melanjutkan. Untuk mengetahui informasi selengkapnya, lihat Peran administrator situs.

• Buat aplikasi OAuth 2.0, dapatkan client ID dan secret, lalu konfigurasi izin aplikasi minimum dengan izin administrator Confluence Cloud.

• Opsional: Untuk mengambil alamat email pengguna dari Confluence Cloud, meskipun setelan membatasi visibilitas email, instal aplikasi User Identity Accessor for Confluence Cloud dengan hak istimewa Administrator situs Confluence, lalu konfigurasi untuk mengambil alamat email pengguna secara aman. Anda mungkin tidak perlu menginstal aplikasi ini jika alamat email sudah dapat diakses secara publik.

  Catatan: Atlassian memperbarui elemen antarmuka pengguna, dan beberapa elemen yang disebutkan dalam dokumentasi ini diganti namanya (misalnya, Products diganti namanya menjadi Apps). Untuk mengetahui informasi selengkapnya, lihat Perubahan terminologi Atlassian Administration dari "products" menjadi "apps".

Membuat penyimpanan data Confluence Cloud

Untuk membuat penyimpanan data Confluence Cloud, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Pilih atau buat project Google Cloud .

3. Di menu navigasi, klik Data stores.

4. Klik Buat penyimpanan data.

5. Di bagian Source, telusuri Confluence Cloud, lalu klik Select.

6. Di bagian Data:

   1. Di bagian Connector mode, pilih Penyerapan data atau Federated search sebagai mode koneksi.

   2. Klik Lanjutkan.

   3. Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.

      • Jika Anda memilih Penyerapan data:

        1. Pilih OAuth 2.0 client credentials atau API token sebagai metode autentikasi.

        • Jika Anda memilih OAuth 2.0 client credentials, masukkan detail berikut:

          • Client ID: ID untuk aplikasi OAuth 2.0 Anda.
          • Rahasia klien: Kunci rahasia yang terkait dengan aplikasi OAuth 2.0 Anda.
          • Instance URI: URL dasar instance Confluence Cloud Anda ( Misalnya, https://your-domain.atlassian.net).
          • ID Instance: ID unik untuk instance Confluence Cloud Anda.

        • Jika Anda memilih Token API, masukkan detail berikut:

          • URI Instance: URL dasar instance Confluence Cloud Anda ( Misalnya, https://your-domain.atlassian.net).
          • Akun pengguna: Nama pengguna Atlassian yang terkait dengan token API.
          • Token API: Token API yang dibuat dari akun Atlassian Anda.

      • Jika Anda memilih Penelusuran gabungan:

        1. Masukkan detail berikut:

           • Client ID: ID untuk aplikasi OAuth 2.0 Anda.
           • Rahasia klien: Kunci rahasia yang terkait dengan aplikasi OAuth 2.0 Anda.
           • URI Instance: URL dasar instance Confluence Cloud Anda ( Misalnya, https://your-domain.atlassian.net).

        2. Klik Login dan selesaikan login Atlassian.

      Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi Confluence Cloud.

   4. Klik Lanjutkan.

   5. Di bagian Destinations, masukkan URL untuk endpoint Confluence Cloud Anda.

   6. Klik Lanjutkan.

   7. Di bagian Entities to sync (jika Anda memilih Data ingestion) atau Entities to search (jika Anda memilih Federated search):

      1. Pilih semua entity yang diperlukan.
      • Jika Anda memilih Federated search, lanjutkan ke langkah berikutnya.

      • Jika Anda memilih Penyerapan data, lakukan tindakan berikut:

        1. Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:

           1. Klik Filter.
           2. Untuk memfilter entity agar tidak disertakan dalam indeks, pilih Kecualikan dari indeks, atau untuk memastikan entity disertakan dalam indeks, pilih Sertakan dalam indeks.
           3. Masukkan kunci ruang. Tekan Enter setelah setiap tombol spasi. Kunci ruang adalah kode unik di URL ruang Confluence, yang ditemukan setelah /spaces/. (Misalnya, di https://company.atlassian.net/wiki/spaces/ABC/overview, tombol spasi adalah ABC.)
           4. Klik Simpan.

        2. Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:

           1. Dalam daftar Frekuensi sinkronisasi, pilih frekuensi sinkronisasi.

              • Untuk menjadwalkan sinkronisasi penuh data entitas dan identitas secara terpisah, luaskan menu di bagian Sinkronisasi penuh, lalu pilih Opsi kustom.

           2. Dalam daftar Frekuensi sinkronisasi inkremental, pilih frekuensi sinkronisasi inkremental.

        Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

7. Klik Lanjutkan.

8. Di bagian Tindakan:

   • Jika Anda memilih Federated search:
     1. Dari Select Confluence Cloud actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi penyimpanan data.

   • Jika Anda memilih Penyerapan data:

     1. Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.

     2. Masukkan detail autentikasi berikut:

        • Client ID: ID untuk aplikasi OAuth 2.0 Anda.
        • Rahasia klien: Kunci rahasia yang terkait dengan aplikasi OAuth 2.0 Anda.
        • Instance URI: URL dasar instance Confluence Cloud Anda ( Misalnya, https://your-domain.atlassian.net).
        • ID Instance: ID unik untuk instance Confluence Cloud Anda.

        Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi Confluence Cloud.

     3. Klik Login dan login ke Confluence Cloud untuk memverifikasi akun Anda.

     4. Klik Lanjutkan.

     5. Di bagian Destinations, masukkan URL untuk endpoint Confluence Cloud Anda.

     6. Dari Select Confluence Cloud actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi penyimpanan data.

     Catatan: Jika Anda melewati penambahan tindakan pada langkah ini, Anda dapat menambahkannya nanti. Untuk mengetahui informasi selengkapnya, lihat Menambahkan tindakan.

     Untuk melihat dan mengelola daftar tindakan, lihat Melihat dan mengelola tindakan.

9. Klik Lanjutkan.

10. Jika alur pembuatan penyimpanan data menampilkan bagian Opsi lanjutan, Anda dapat mencentang kotak Aktifkan Alamat IP Statis di dalamnya. Hal ini memastikan penyimpanan data menggunakan serangkaian alamat IP tetap untuk traffic keluar, yang cocok untuk dimasukkan ke daftar yang diizinkan di sistem sumber. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.

11. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data Anda, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Setelan enkripsi:
       • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Buka halaman setelan untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu region untuk konektor pihak ketiga.
       • Pilih Kunci enkripsi yang dikelolaGoogle atau Kunci Cloud KMS.
       • Jika Anda memilih Cloud KMS key:
         • Dalam daftar Key management type, pilih jenis yang sesuai.
         • Di daftar Cloud KMS key, pilih kunci.
       Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

12. Klik Lanjutkan.

13. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

14. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Creating menjadi Active, penyimpanan data Confluence Cloud siap digunakan.

Untuk penyimpanan data penyerapan yang dibuat dengan Confluence Cloud, status penyimpanan data akan bertransisi dari Membuat ke Berjalan setelah inisiasi sinkronisasi. Statusnya kemudian berubah menjadi Active setelah penyerapan selesai, yang menandakan bahwa penyimpanan data telah dikonfigurasi sepenuhnya. Bergantung pada volume data, penyerapan mungkin memerlukan waktu beberapa jam.

Setelah membuat penyimpanan data, buat aplikasi, hubungkan ke penyimpanan data Confluence Cloud, dan otorisasi Gemini Enterprise untuk mengakses Confluence Cloud sebelum menjalankan kueri apa pun.

Mengaktifkan sinkronisasi real-time untuk penyerapan data

Pratinjau — Sinkronisasi real-time

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Sinkronisasi real-time hanya menyinkronkan entitas dokumen dan tidak menyinkronkan data yang terkait dengan entitas identitas. Tabel berikut menunjukkan peristiwa dokumen yang didukung dengan sinkronisasi real-time.

Entitas Confluence	Buat	Perbarui	Hapus	Perubahan izin
Ruang
Halaman
Blog
Lampiran
Komentar
Papan tulis virtual

Aktifkan sinkronisasi real-time 20 menit setelah membuat penyimpanan data Confluence Cloud.

Untuk mengaktifkan sinkronisasi real-time untuk penyimpanan data Confluence, ikuti langkah-langkah berikut:

Buat URL webhook

1. Buka halaman Gemini Enterprise, dan di menu navigasi, klik Penyimpanan Data.
2. Pilih penyimpanan data Confluence.
3. Klik View/Edit di baris Realtime sync.
4. Pada dialog View and edit realtime sync parameters, lakukan hal berikut:
   1. Untuk mengaktifkan sinkronisasi real-time, klik tombol Aktifkan sinkronisasi real-time.
   2. Di kolom Rahasia klien, masukkan nilai placeholder, seperti clientsecret.
   3. Klik Simpan.
5. Setelah status Realtime sync berubah menjadi Running, klik View/Edit.
6. Pada dialog View and edit realtime sync parameters, lakukan hal berikut:
   1. Salin URL Webhook.
   2. Klik Close.

Berlangganan acara menggunakan API

Untuk menerima update real-time dari Confluence, Anda harus berlangganan ke peristiwa tertentu menggunakan permintaan POST. Untuk melakukan panggilan API, gunakan akun administrator yang sama dengan yang digunakan untuk menyiapkan autentikasi dan izin di Confluence guna membuat penyimpanan data.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

• INSTANCE_URL: Alamat web dasar untuk situs Atlassian Cloud Anda.

• USERNAME: Nama pengguna Atlassian Cloud.

• API_TOKEN: Token API yang dibuat dari akun Atlassian Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan token API di Confluence

• SUBSCRIPTION_NAME: Nama unik untuk langganan peristiwa Anda.

• LISTENER_URL: URL webhook yang disalin dari konsol Google Cloud setelah Sinkronisasi Real-Time (RTS) diaktifkan di penyimpanan data Anda.

• EVENT_TYPE: Jenis peristiwa yang ingin Anda berlangganan. Anda dapat berlangganan untuk membuat, memperbarui, dan menghapus peristiwa untuk lampiran, postingan blog, halaman, ruang, dan komentar.

  Pengguna dapat berlangganan ke peristiwa berikut:

  • space_created
  • space_updated
  • page_created
  • page_updated
  • attachment_created
  • attachment_updated
  • comment_created
  • comment_updated
  • blog_created
  • blog_updated
  Catatan: Peristiwa Whiteboard dan trashed tidak didukung. Buat langganan hanya untuk entitas yang sudah ditambahkan ke penyimpanan data Anda untuk menghindari penyerapan data yang tidak diinginkan.

  Contoh perintah dan hasil

  curl -X POST \
      https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
      -H "Content-Type: application/json" \
      -u "admin1:######" \
      -d '{
        "name": "Cymbal_DCT",
        "events": [
          "attachment_created",
          "attachment_updated"
        ],
        "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
        "active": true
      }'
  
  {
  "name": "Cymbal_DCT",
  "url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
  "description": " Webhook for Cymbal DCT group to fetch attachments.",
  "excludeBody": false,
  "filters": {},
  "events": [
      "attachment_created",
      "attachment_updated",
  ],
  "enabled": true,
  "self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
  "lastUpdatedUser": "Cymb_389",
  "lastUpdatedDisplayName": "Ariel",
  "lastUpdated": 1752095647212
  }
  

Kode error API

Tabel ini mencantumkan kode error API umum yang ditemui pengguna saat membuat webhook.

Class error	Kode error	Pesan error	Pemecahan masalah
403	FORBIDDEN	Pengguna saat ini tidak diizinkan menggunakan Confluence.	Pastikan token yang valid dari akun administrator dan endpoint API yang benar.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi dari penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda mengizinkan Confluence Cloud dan mengirim kueri penelusuran ke Gemini Enterprise:

• Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke API Atlassian.
• Gemini Enterprise menggabungkan hasil dengan hasil dari sumber data terhubung lainnya dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

• String kueri Anda dikirim ke backend penelusuran pihak ketiga (Atlassian API).
• Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
• Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin akan dikirim ke semua sumber data tersebut.
• Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke Confluence Cloud. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri sesi Anda. Akibatnya, beberapa bagian histori kueri Anda mungkin juga disertakan dalam kueri yang dikirim ke Atlassian API.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna dalam membuat kueri data Confluence Cloud, buat aplikasi dan hubungkan ke penyimpanan data Confluence Cloud.
• Untuk melihat dan mengelola daftar tindakan, lihat Melihat dan mengelola tindakan.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.