Mengelola setelan pengamatan

Dokumen ini menjelaskan cara mengonfigurasi setelan kemampuan observasi untuk aplikasi Gemini Enterprise atau agen individual menggunakan Google Cloud konsol atau REST API.

Logika pengaktifan bergantung pada jenis agen:

  • Agen Asisten inti: Gunakan tombol tingkat aplikasi (tingkat mesin) dalam konfigurasi.
  • Agen lainnya: (Saat ini terbatas untuk agen buatan karyawan Workflow Builder dan agen Deep Research): Gunakan tombol tingkat agen di dalam setelan agen individual.

Setelah mengaktifkan setelan, Anda dapat melihat data berikut dari interaksi Anda dengan asisten atau agen di aplikasi web Gemini Enterprise:

  • Melihat metrik di Metrics Explorer.
  • Melihat rekaman aktivitas dan rentang di Trace Explorer.

Konsep utama

Bagian ini memperkenalkan konsep utama terkait kemampuan observasi di Gemini Enterprise.

Konsep Deskripsi
Rekaman aktivitas Rekaman aktivitas adalah kumpulan rentang yang mewakili satu permintaan atau transaksi saat mengalir melalui berbagai layanan dan komponen.

Misalnya, rekaman aktivitas mewakili seluruh siklus proses permintaan. Hal ini mencakup pengguna yang mengajukan pertanyaan dari asisten Gemini Enterprise, asisten Gemini Enterprise yang merespons, dan tindakan berikutnya yang dipicu oleh jawaban, seperti mengirim email.
Rentang Rentang adalah satu unit kerja berjangka waktu dalam rekaman aktivitas. Rentang mewakili operasi tertentu, seperti panggilan fungsi, permintaan API, atau kueri database. Setiap rentang mencakup detail seperti waktu mulai dan berakhir, ID unik, dan hubungannya dengan rentang lainnya. Hubungan ini bersama-sama membentuk rekaman aktivitas.
Log rentang Log rentang adalah pesan atau peristiwa bentuk bebas yang diberi stempel waktu dan terkait dengan rentang tertentu. Log ini memberikan informasi kontekstual terperinci tentang eksekusi rentang, membantu pengguna melakukan debug masalah, dan memahami alur permintaan.
Metrik Metrik adalah pengukuran numerik yang dikumpulkan sistem dari waktu ke waktu. Pengukuran ini mewakili performa, penggunaan resource, atau perilaku sistem. Engineer menggunakan metrik untuk memantau kondisi sistem, mengidentifikasi tren, dan memicu pemberitahuan.
Log audit penggunaan Log audit penggunaan adalah catatan aktivitas administratif dan akses dalam Google Cloud resource Anda. Log ini memberikan informasi terperinci tentang siapa yang melakukan tindakan apa, kapan, dan dari mana. Log ini penting untuk audit keamanan, kepatuhan, dan memahami cara resource Anda digunakan.
Log error konektor Gemini Enterprise Log error konektor Gemini Enterprise menangkap error dan kegagalan terjadi saat mengintegrasikan Gemini Enterprise dengan sumber data pihak ketiga seperti Jira dan Microsoft OneDrive. Log ini mencakup masalah koneksi masalah transformasi data, dan error API.

Sebelum memulai

Pastikan Anda memiliki hal berikut:

Mengaktifkan setelan kemampuan observasi

Untuk mengaktifkan kemampuan observasi untuk aplikasi Gemini Enterprise atau agen individual, Anda dapat menggunakan konsol atau REST API. Google Cloud

Konsol

Untuk mengaktifkan setelan kemampuan observasi menggunakan Google Cloud konsol, ikuti langkah-langkah berikut:

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

    Gemini Enterprise

  2. Klik nama aplikasi yang ingin Anda konfigurasi.

  3. Bergantung pada jenis agen yang Anda konfigurasi, lakukan salah satu hal berikut:

    • Agen Asisten inti: Klik Konfigurasi, lalu klik tab Kemampuan observasi.
    • Agen lainnya (agen buatan karyawan Workflow Builder dan agen Deep Research): Klik Agen, klik nama agen yang ingin Anda konfigurasi, lalu klik tab Konfigurasi.

  4. Anda dapat mengaktifkan atau menonaktifkan setelan berikut:

    Setelan kemampuan observasi Deskripsi
    Aktifkan instrumentasi log dan rekaman aktivitas OpenTelemetry Jika diaktifkan, Anda dapat melihat rekaman aktivitas, rentang, log rentang, dan metrik yang terkait dengan log Anda di Cloud Logging.
    Aktifkan logging input perintah dan output respons Jika diaktifkan, Cloud Logging akan mencatat konten lengkap perintah dan respons pengguna. Hal ini mencakup data sensitif atau Informasi Identitas Pribadi (PII). Untuk mengaktifkan setelan ini, Anda harus mengaktifkan Aktifkan instrumentasi log dan rekaman aktivitas OpenTelemetry terlebih dahulu.

REST

Untuk mengonfigurasi setelan kemampuan observasi menggunakan REST API, lihat bagian berikut:

Mengonfigurasi setelan kemampuan observasi untuk Asisten Inti (tingkat aplikasi)

Untuk mengonfigurasi setelan kemampuan observasi menggunakan REST API di tingkat aplikasi (yang berlaku untuk agen Asisten Inti), lihat bagian berikut:

Mengaktifkan kemampuan observasi saat membuat aplikasi

Untuk membuat aplikasi baru dengan kemampuan observasi diaktifkan, jalankan perintah berikut:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines?engineId=APP_ID" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_ENTERPRISE",
    "searchAddOns": ["SEARCH_ADD_ON_LLM"],
    "requiredSubscriptionTier": "SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT"
  },
  "industryVertical": "GENERIC",
  "appType": "APP_TYPE_INTRANET",
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

Ganti kode berikut:

  • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
    • us untuk multi-region AS
    • eu untuk multi-region UE
    • global untuk lokasi Global
    Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
  • PROJECT_ID: ID project Anda.
  • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
  • APP_ID: ID aplikasi yang ingin Anda buat.
  • APP_DISPLAY_NAME: nama tampilan aplikasi yang ingin Anda buat.

Mengaktifkan kemampuan observasi untuk aplikasi yang sudah ada

Untuk mengaktifkan kemampuan observasi di aplikasi yang sudah ada, jalankan perintah berikut:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

Ganti kode berikut:

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

Mengonfigurasi setelan kemampuan observasi untuk agen individual

Untuk mengaktifkan kemampuan observasi untuk agen individual (seperti agen Workflow Builder atau agen Deep Research) menggunakan REST API, jalankan perintah berikut untuk memperbarui observabilityConfig agen:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

Ganti kode berikut:

  • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
    • us untuk multi-region AS
    • eu untuk multi-region UE
    • global untuk lokasi Global
    Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
  • PROJECT_ID: ID project Anda.
  • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
  • APP_ID: ID aplikasi.
  • AGENT_ID: ID agen yang ingin Anda konfigurasi

Menonaktifkan setelan kemampuan observasi

Untuk menonaktifkan setelan kemampuan observasi untuk aplikasi Gemini Enterprise atau agen individual, gunakan konsol Google Cloud atau REST API.

Konsol

Untuk menonaktifkan setelan kemampuan observasi menggunakan Google Cloud konsol, ikuti langkah-langkah berikut:

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

    Gemini Enterprise

  2. Klik nama aplikasi yang setelan kemampuan observasinya ingin Anda nonaktifkan.

  3. Bergantung pada jenis agen yang Anda konfigurasi, lakukan salah satu hal berikut:

    • Agen Asisten inti: Klik Konfigurasi, lalu klik tab Kemampuan observasi.
    • Agen lainnya (termasuk agen buatan karyawan Workflow Builder dan agen Deep Research): Klik Agen, klik nama agen yang ingin Anda konfigurasi, lalu klik tab Konfigurasi.

  4. Anda dapat menonaktifkan setelan berikut:

    Setelan kemampuan observasi Deskripsi
    Aktifkan instrumentasi log dan rekaman aktivitas OpenTelemetry Jika dinonaktifkan, setelan ini akan menghentikan pengumpulan rekaman aktivitas, rentang, log rentang, dan metrik. Setelan ini juga menonaktifkan setelan Aktifkan logging input perintah dan output respons, yang berarti tidak ada log yang dikirim ke Cloud Logging.
    Aktifkan logging input perintah dan output respons Jika dinonaktifkan, Cloud Logging tidak akan mencatat input perintah dan output respons.

REST

Untuk menonaktifkan setelan kemampuan observasi menggunakan REST API, lihat bagian berikut:

Menonaktifkan kemampuan observasi di tingkat aplikasi (Asisten Inti)

Untuk menonaktifkan kemampuan observasi di tingkat aplikasi, jalankan perintah berikut:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": false,
    "sensitiveLoggingEnabled": false
  }
}'

Ganti kode berikut:

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

Menonaktifkan kemampuan observasi untuk agen individual

Untuk menonaktifkan kemampuan observasi untuk agen individual (seperti agen Workflow Builder atau agen Deep Research), jalankan perintah berikut:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": false,
    "sensitiveLoggingEnabled": false
  }
}'

Ganti kode berikut:

  • ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
    • us untuk multi-region AS
    • eu untuk multi-region UE
    • global untuk lokasi Global
    Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
  • PROJECT_ID: ID project Anda.
  • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
  • APP_ID: ID aplikasi.
  • AGENT_ID: ID agen yang ingin Anda konfigurasi

Langkah berikutnya