Menghubungkan ke Knowledge Catalog

Dokumen ini menjelaskan cara Gemini Enterprise terintegrasi 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 diaktifkan secara otomatis saat Anda menghubungkan penyimpanan data BigQuery, Spanner, Cloud SQL, atau AlloyDB untuk PostgreSQL dalam mode kueri gabungan ke aplikasi Gemini Enterprise Anda. Daripada muncul sebagai penyimpanan data, Knowledge Catalog adalah opsi konfigurasi di tab Asisten aplikasi Gemini Enterprise Anda. Anda juga dapat mengaktifkan atau menonaktifkan integrasi secara manual kapan saja, bahkan di luar konektor Data Cloud pendamping.

Cara kerja konektor Knowledge Catalog dan Data Cloud

Di Knowledge Catalog, setiap aset data yang dikatalogkan di seluruh lingkunganGoogle Cloud Anda disimpan sebagai catatan metadata yang disebut entri. Karena konektor Data Cloud dalam mode kueri gabungan memiliki akses luas ke semua resource yang dapat dilihat oleh pengguna terautentikasi—bukan hanya dibatasi ke satu set data atau tabel—agen tidak mengetahui di mana data yang relevan berada pada awalnya.

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 keterampilan bawaan dan alat hanya baca untuk melakukan hal berikut:

  • Menelusuri data yang dapat diakses: Menelusuri aset data yang dikatalogkan di Knowledge Catalog yang memiliki izin akses untuk pengguna yang diautentikasi.
  • Mencari konteks teknis dan bisnis: Mengambil metadata yang telah dipertkaya, termasuk skema tabel, deskripsi kolom, istilah glosarium bisnis, dan contoh kueri yang telah diverifikasi sebelumnya (kueri emas). Saat dipasangkan dengan konektor Data Cloud pendamping, agen menggunakan kueri emas 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 menggambarkan 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 yang dapat diakses pengguna, agen mencari konteks yang diperkaya di Knowledge Catalog (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: 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 mendeteksi aset data yang memiliki izin Identity and Access Management (IAM) untuk dilihat oleh pengguna yang diautentikasi:

  • Pemisahan akses metadata dan data dengan pemangkasan hasil penelusuran: Knowledge Catalog menerapkan pemangkasan hasil penelusuran berdasarkan izin pengguna yang diautentikasi di sumber data pokok. Jika pengguna tidak memiliki izin baca (seperti roles/bigquery.dataViewer atau roles/bigquery.metadataViewer) pada set data atau tabel, aset tersebut akan dikecualikan secara otomatis dari hasil penelusuran katalog dan tidak dapat ditemukan oleh asisten.
  • Sumber data pihak pertama Google Cloud : 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.
  • Sumber data pihak ketiga dan metadata tambahan: Untuk metadata kustom, glosarium bisnis, atau aset data pihak ketiga yang ditambahkan ke Knowledge Catalog, pastikan pengguna memiliki izin melihat 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 melampirkan konektor Data Cloud, atau untuk menonaktifkannya sambil menjaga konektor Data Cloud tetap aktif)—di tab Assistant pada halaman Configurations aplikasi Anda:

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

    Gemini Enterprise

  2. Klik nama aplikasi yang ingin Anda konfigurasi.

  3. Klik Konfigurasi, lalu pilih tab Asisten.

  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