Mendapatkan detail entity dan penyimpanan data

Halaman ini menjelaskan cara mengambil detail resource untuk penyimpanan data Gemini Enterprise dan entitas yang mendasarinya menggunakan konsol Google Cloud atau Discovery Engine REST API.

Saat berinteraksi dengan penyimpanan data menggunakan API—seperti mengonfigurasi kontrol akses IAM tingkat resource, mengirim kueri ke endpoint penelusuran, atau mengotomatiskan pipeline penyerapan—Anda memerlukan ID resource unik dari penyimpanan data target dan entitas pokoknya.

Konsep penyimpanan data

Untuk memahami cara menyusun resource penyimpanan data di Discovery Engine API, pertimbangkan konsep berikut:

Konsep Deskripsi
Penyimpanan data Penampung untuk data yang diserap dari sumber data Google atau pihak ketiga. Penyimpanan data mandiri termasuk dalam koleksi default (default_collection). Untuk mengetahui informasi selengkapnya, lihat Konsep Gemini Enterprise dan Tentang aplikasi dan penyimpanan data.
Pengumpulan data Resource pengelompokan logis dalam project Google Cloud dan lokasi (projects/{project}/locations/{location}/collections/{collection}).

Penyimpanan data pihak ketiga multi-entitas (seperti Jira, Salesforce, atau SharePoint Online) membuat koleksi khusus yang merepresentasikan instance penyimpanan data.
Entitas penyimpanan data Saat Anda menghubungkan sumber data pihak ketiga yang berisi beberapa jenis entitas (seperti masalah Jira, project Jira, atau file SharePoint), Gemini Enterprise akan otomatis membuat penyimpanan data turunan terpisah untuk setiap jenis entitas.

Penyimpanan data entity ini berada sebagai resource turunan di bawah collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Untuk mengetahui informasi selengkapnya, lihat Data terstruktur untuk penyimpanan data pihak ketiga dan Pengantar konektor dan penyimpanan data.

Mengambil detail entity dan penyimpanan data

Pilih salah satu opsi berikut:

Konsol

Untuk mengambil detail penyimpanan data dan entitas di konsol Google Cloud , ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Gemini Enterprise > Data Stores.

    Buka halaman Data Stores

  2. Klik nama penyimpanan data target Anda.

  3. Di halaman detail penyimpanan data, lihat ID penyimpanan data yang ditampilkan di header.

  4. Jika penyimpanan data berisi entity, klik tab Entity untuk melihat daftar entity yang dikonfigurasi, nama tampilan, dan ID penyimpanan data entity yang sesuai (misalnya, DataConnector3_entityA dan DataConnector3_entityB).

REST

Untuk mengambil ID entity dan penyimpanan data menggunakan REST API, selesaikan langkah-langkah berikut:

  1. Mencantumkan ID kumpulan penyimpanan data (untuk penyimpanan data multi-entitas):

    Untuk penyimpanan data pihak ketiga dengan beberapa entitas (seperti Jira atau Salesforce), Gemini Enterprise akan membuat koleksi khusus yang merepresentasikan instance konektor. Panggil endpoint collections list untuk mengambil ID koleksi di project Anda:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"

    Ganti kode berikut:

    • PROJECT_ID: ID Google Cloud project Anda.
    • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
      • us untuk multi-region AS
      • eu untuk multi-region Uni Eropa
      • global untuk lokasi Global
      Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
    • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu.

    Respons berisi daftar koleksi:

    {
  "collections": [
    {
      "name": "projects/123456789/locations/global/collections/DataConnector3",
      "displayName": "Jira Production Data Store"
    }
  ]
}

    Dalam contoh ini, ID koleksinya adalah DataConnector3. Gunakan ID ini saat mengonfigurasi kontrol akses tingkat pengumpulan untuk instance konektor.

  2. Mencantumkan ID entity dan penyimpanan data mandiri di bagian default_collection:

    Di Gemini Enterprise, semua resource penyimpanan data, termasuk penyimpanan data mandiri dan entity turunan untuk konektor multi-entity, berada di bawah default_collection. Meskipun penyimpanan data multi-entitas memiliki ID koleksi khusus (seperti DataConnector3), penyimpanan data entitas turunannya terdaftar di default_collection dan diberi awalan dengan ID konektor.

    Panggil endpoint daftar dataStores di default_collection untuk menemukan ID entity dan penyimpanan data Anda:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"

    Ganti kode berikut:

    • PROJECT_ID: ID Google Cloud project Anda.
    • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
      • us untuk multi-region AS
      • eu untuk multi-region Uni Eropa
      • global untuk lokasi Global
      Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
    • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu.

    Respons berisi daftar penyimpanan data:

    {
  "dataStores": [
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA",
      "displayName": "Jira Issues Entity"
    },
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB",
      "displayName": "Jira Projects Entity"
    }
  ]
}

    Dalam contoh ini, ID penyimpanan data entity adalah DataConnector3_entityA dan DataConnector3_entityB. Gunakan ID ini saat mengonfigurasi kontrol akses untuk semua penyimpanan data entitas pokok dari penyimpanan data multi-entitas menggunakan REST API.

Langkah berikutnya