Menghubungkan ke Knowledge Catalog

Dokumen ini menjelaskan cara Gemini Enterprise berintegrasi dengan Knowledge Catalog untuk memberi agen alat hanya baca guna menelusuri data yang dapat diakses pengguna dan mencari konteks teknis dan bisnis.

Anda tidak perlu membuat penyimpanan data terpisah untuk terhubung ke Knowledge Catalog. Sebagai gantinya, integrasi Knowledge Catalog otomatis diaktifkan saat Anda menghubungkan penyimpanan data BigQuery, Spanner, Cloud SQL, atau AlloyDB untuk PostgreSQL dalam mode kueri gabungan ke aplikasi Gemini Enterprise Anda. Alih-alih muncul sebagai penyimpanan data, Knowledge Catalog adalah opsi konfigurasi di tab Asisten pada aplikasi Gemini Enterprise Anda. Anda juga dapat mengaktifkan atau menonaktifkan integrasi secara manual kapan saja, bahkan di luar konektor Data Cloud pendamping.

Cara kerja Knowledge Catalog dan konektor Data Cloud bersama-sama

Di Knowledge Catalog, setiap aset data yang dikatalogkan di seluruh lingkungan Google Cloud Anda disimpan sebagai data metadata yang disebut entri. Karena konektor Data Cloud dalam mode kueri gabungan memiliki akses luas ke semua resource yang dapat dilihat oleh pengguna yang diautentikasi—bukan dibatasi pada satu set data atau tabel—agen tidak akan langsung mengetahui lokasi data yang relevan.

Jika Knowledge Catalog diaktifkan untuk aplikasi Gemini Enterprise Anda—baik secara otomatis saat Anda melampirkan konektor Data Cloud gabungan, atau secara manual di tab Assistant—integrasi ini akan memberi agen kemampuan bawaan dan alat hanya baca untuk melakukan hal berikut:

  • Menelusuri data yang dapat diakses: Menelusuri aset data yang dikatalogkan di Knowledge Catalog yang izin aksesnya dimiliki oleh pengguna yang diautentikasi.
  • Mencari konteks teknis dan bisnis: Mengambil metadata yang diperkaya—termasuk skema tabel, deskripsi kolom, istilah glosarium bisnis, dan kueri contoh yang telah diverifikasi sebelumnya (golden query). Jika dipasangkan dengan konektor Data Cloud pendamping, agen akan menggunakan golden query ini untuk mencegah halusinasi gabungan pada skema yang kompleks dan meneruskan konteks ini ke konektor untuk membuat dan menjalankan kueri yang akurat.

Contoh alur kerja

Diagram berikut mengilustrasikan cara Knowledge Catalog dan konektor Data Cloud gabungan bekerja sama untuk menjawab pertanyaan pengguna:

Diagram yang menunjukkan alur kerja empat langkah dari pertanyaan pengguna, ke penelusuran semantik dan pengambilan konteks Knowledge Catalog, hingga eksekusi kueri SQL BigQuery.

Dalam alur kerja ini, Gemini Enterprise menyelesaikan langkah-langkah berikut:

  1. Pertanyaan pengguna: Pengguna mengajukan pertanyaan dalam bahasa alami di Gemini Enterprise:

    "How many sales did we have this month for all cold weather products?"
    
  2. Penemuan penelusuran semantik: Agen root Gemini Enterprise menelusuri Knowledge Catalog menggunakan istilah penelusuran yang diekstrak dari pertanyaan pengguna:

    ["cold weather", "products", "orders", "sales"]
    
  3. Pengambilan konteks: Untuk entri yang cocok dan dapat diakses oleh pengguna, agen akan mencari konteks yang diperkaya di Knowledge Catalog (yang berasal dari metadata teknis, pola penggunaan, glosarium bisnis, dan inferensi LLM):

    simpleName: my-project.ecomm.products
    type: BigQuery Table
    terms: "Cold Weather Products; category IN ('Sweaters', 'Coats & Jackets')"
    
  4. Eksekusi kueri: Dengan menggunakan metadata tabel dan definisi bisnis yang diambil, agen merumuskan dan menjalankan kueri SQL hanya baca melalui konektor BigQuery gabungan:

    -- Execute BigQuery read-only SQL
    SELECT COUNT(order_id) FROM `my-project.ecomm.orders`
    WHERE product_id IN (
      SELECT id FROM `my-project.ecomm.products`
      WHERE category IN ('Sweaters', 'Coats & Jackets')
    );
    

Sebelum memulai

Integrasi Knowledge Catalog bersifat hanya baca dan menggunakan API internal, sehingga Anda tidak perlu mengaktifkan Dataplex API atau memberikan izin alat MCP, dan pengguna tidak memerlukan izin untuk membuat atau mengubah resource di Knowledge Catalog.

Karena integrasi mengautentikasi permintaan menggunakan kredensial pengguna akhir, agen hanya dapat menemukan dan menemukan aset data yang izin Identity and Access Management (IAM)-nya dimiliki oleh pengguna yang diautentikasi untuk melihat:

  • Pemisahan metadata dan akses data dengan pemangkasan hasil penelusuran: Knowledge Catalog menerapkan pemangkasan hasil penelusuran berdasarkan izin pengguna yang diautentikasi di sumber data yang mendasarinya. Jika pengguna tidak memiliki izin baca (seperti roles/bigquery.dataViewer atau roles/bigquery.metadataViewer) pada set data atau tabel, aset tersebut akan otomatis difilter dari hasil penelusuran katalog dan tidak dapat ditemukan oleh asisten.
  • Sumber data Google Cloud pihak pertama: Izin untuk sumber data pihak pertama—seperti BigQuery, AlloyDB untuk PostgreSQL, Spanner, dan Cloud SQL—diwariskan secara otomatis. Misalnya, memberikan peran BigQuery Data Viewer (roles/bigquery.dataViewer) kepada pengguna akan memberi mereka akses untuk menelusuri dan menemukan metadata tabel dan set data yang sesuai di Knowledge Catalog.
  • Metadata tambahan dan sumber data pihak ketiga: Untuk metadata kustom, glosarium bisnis, atau aset data pihak ketiga yang ditambahkan ke Knowledge Catalog, pastikan pengguna memiliki izin lihat yang diperlukan di Knowledge Catalog (seperti roles/dataplex.dataDomainEntryReader atau roles/dataplex.catalogViewer) sehingga agen dapat menemukan data tersebut. Untuk mengetahui informasi selengkapnya, lihat Mengelola akses dengan IAM dalam dokumentasi Knowledge Catalog.

Mengaktifkan atau menonaktifkan Knowledge Catalog di aplikasi Anda

Saat Anda melampirkan penyimpanan data BigQuery, Spanner, Cloud SQL, atau AlloyDB untuk PostgreSQL dalam mode kueri gabungan ke aplikasi Gemini Enterprise, Knowledge Catalog dan kemampuan agen bawaannya akan otomatis diaktifkan untuk aplikasi tersebut.

Anda juga dapat mengaktifkan atau menonaktifkan integrasi Knowledge Catalog secara manual kapan saja—bahkan di luar konektor Data Cloud pendamping (misalnya, untuk mengaktifkan Knowledge Catalog tanpa menghubungkan konektor Data Cloud, atau untuk menonaktifkannya sambil tetap mengaktifkan konektor Data Cloud)—di tab Asisten pada halaman Konfigurasi aplikasi Anda:

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

    Gemini Enterprise

  2. Klik nama aplikasi yang ingin Anda konfigurasi.

  3. Klik Configurations, lalu pilih tab Assistant.

  4. Di bagian Enable Knowledge Catalog, gunakan tombol untuk mengaktifkan atau menonaktifkan integrasi Knowledge Catalog.

  5. Klik Save and publish.

Untuk mengetahui informasi selengkapnya tentang setelan asisten, lihat Mengonfigurasi asisten.

Langkah berikutnya