Mendaftarkan dan mengelola agen Dialogflow

Pratinjau

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.

Halaman ini menjelaskan cara mendaftarkan dan menggunakan agen Dialogflow dengan Gemini Enterprise.

Ringkasan

Untuk menggunakan agen Dialogflow dengan Gemini Enterprise, Anda harus men-deploy, lalu mendaftarkan agen terlebih dahulu. Mendaftarkan agen Dialogflow akan menautkan agen yang di-deploy ke Gemini Enterprise sehingga keduanya dapat berkomunikasi.

Sebelum memulai

Sebelum mendaftarkan agen Dialogflow, Anda harus memastikan bahwa langkah-langkah berikut telah diselesaikan:

• Men-deploy agen Dialogflow Anda. Untuk melihat dasbor Dialogflow dan agen percakapan, lihat Agen percakapan.

• Peran Gemini Enterprise Admin.

• Aktifkan Discovery Engine API. Untuk mengaktifkan Discovery Engine API untuk project Google Cloud, di konsol Google Cloud , buka halaman Discovery Engine API.

  Buka Discovery Engine API

• Buat aplikasi Gemini Enterprise. Untuk mengetahui informasi selengkapnya, lihat Membuat aplikasi.

Mendaftarkan agen Dialogflow ke Gemini Enterprise

Anda dapat mendaftarkan agen Dialogflow ke Gemini Enterprise menggunakan konsolGoogle Cloud atau REST API. Pendaftaran membuat agen Anda tersedia bagi pengguna dalam aplikasi Gemini Enterprise.

Kuota pendaftaran agen dan pemberian lisensi: Mendaftarkan agen ke aplikasi akan menggunakan satu unit kuota pembuatan agen harian gabungan project Anda (discoveryengine.googleapis.com/agents_tier_enterprise_regional). Kuota ditentukan oleh jumlah lisensi Gemini Enterprise Standard (1 pembuatan per pengguna per hari, digabungkan) atau lisensi Plus (10 per pengguna per hari, digabungkan) yang didistribusikan ke project. Lisensi Frontline memberikan kuota pembuatan 0.

Jika Anda mendaftarkan agen backend di beberapa aplikasi atau mesin Gemini Enterprise dalam project yang sama, setiap panggilan API pendaftaran (agents.create) akan dihitung sebagai pembuatan agen terhadap kuota harian ini. Skrip deployment otomatis atau pipeline CI/CD yang mendaftarkan agen di banyak aplikasi dapat mengalami HTTP 429 RESOURCE_EXHAUSTED: Agent creation quota exceeded jika jumlah panggilan pendaftaran dalam sehari melebihi jumlah lisensi Standard yang didistribusikan. Pastikan project Anda memiliki lisensi Standard yang cukup yang didistribusikan sebelum menjalankan peluncuran multi-aplikasi. Untuk mengetahui detail selengkapnya, lihat Kuota pembuatan harian.

Konsol

Untuk mendaftarkan agen Dialogflow menggunakan konsol Google Cloud , ikuti langkah-langkah berikut:

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

   Buka Gemini Enterprise

2. Pilih project Anda.

3. Klik nama aplikasi yang ingin Anda daftarkan dengan agen.

4. Klik Agents > Add Agents. Panel Choose an agent type akan muncul.

5. Di kartu Custom agent via Dialogflow, klik Add untuk mendaftarkan agen Dialogflow Anda ke Gemini Enterprise. Panel Configuration akan terbuka.

6. Untuk mengonfigurasi agen, ikuti langkah-langkah berikut:

   1. Masukkan nama di kolom Your agent name. Nilai ini muncul di Gemini Enterprise sebagai nama tampilan agen Anda.

   2. Masukkan deskripsi di kolom Describe your agent. Nilai ini digunakan oleh LLM untuk menentukan apakah akan memanggil agen Anda sebagai respons terhadap kueri pengguna.

   3. Masukkan jalur resource agen Dialogflow yang ingin Anda daftarkan ke Gemini Enterprise di kolom Dialogflow agent source.

      Gunakan format ini: projects/{project}/locations/{location}/agents/{agent}

      Opsi Ketersediaan agen, Saat dipilih, ditetapkan secara default.

   4. Klik Create.

curl

Contoh kode ini menunjukkan cara mendaftarkan agen Anda:

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "icon": {
        "uri": "ICON_URI"
      },
      "dialogflowAgentDefinition": {
        "dialogflowAgent": "projects/DIALOGFLOW_PROJECT_ID/locations/DIALOGFLOW_LOCATION/agents/DIALOGFLOW_AGENT_ID"
      }
    }'

Ganti variabel dengan nilai:

• PROJECT_ID: ID project Google Cloud Anda.
• APP_ID: ID aplikasi Gemini Enterprise Anda.
• DISPLAY_NAME: nama yang mudah digunakan untuk agen Anda yang ditampilkan di Gemini Enterprise.
• DESCRIPTION: penjelasan singkat tentang fungsi agen Anda yang dapat dilihat oleh pengguna di Gemini Enterprise. Misalnya, Ekstrak informasi penting dari invoice yang diupload untuk perjalanan bisnis.
• ICON_URI: URI publik ikon yang ditampilkan di samping nama agen Dialogflow Anda. Anda juga dapat memberikan gambar berenkode Base64 di icon.content.
• DIALOGFLOW_PROJECT_ID: Google Cloud project ID yang mengidentifikasi lokasi agen Dialogflow Anda.
• DIALOGFLOW_LOCATION: lokasi geografis tertentu tempat agen Dialogflow Anda dihosting, seperti global atau us-central1.
• DIALOGFLOW_AGENT_ID: ID unik agen Dialogflow Anda.

Respons yang berhasil untuk perintah ini akan menampilkan semua kolom resource agen Dialogflow yang baru dibuat, yang menyertakan nama resource uniknya di kolom nama. Nama resource ini dapat digunakan untuk referensi atau update mendatang.

Mencantumkan agen yang terhubung ke aplikasi

Contoh kode berikut menunjukkan cara mendapatkan detail semua agen yang terhubung ke aplikasi Anda:

REST

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

Ganti variabel dengan nilai:

• 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.
• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION: multi-region aplikasi Anda: global, us, atau eu.
• APP_ID: ID aplikasi Gemini Enterprise Anda.

Jika agen Anda tidak dibuat otomatis oleh Google, respons akan menyertakan kolom name di beberapa baris pertama. Nilai kolom ini berisi ID Agen di akhir jalur. Misalnya, dalam respons berikut, ID Agen adalah 12345678901234567890:

{
"name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
...
}

Melihat detail agen Dialogflow

Contoh kode berikut menunjukkan cara mengambil detail agen yang terdaftar di Gemini Enterprise:

REST

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

Ganti variabel dengan nilai:

• 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.
• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION: multi-region aplikasi Anda: global, us, atau eu.
• APP_ID: ID aplikasi Gemini Enterprise Anda.
• AGENT_ID: ID agen. Anda dapat menemukan ID agen dengan mencantumkan agen yang terhubung ke aplikasi Anda.

Memperbarui agen Dialogflow

Semua kolom yang diberikan selama pendaftaran agen dapat diperbarui. Kolom berikut wajib diisi selama proses pembaruan:

• displayName
• description
• reasoning_engine

Saat memperbarui kolom, semua kolom dan nilainya harus ditentukan ulang dalam permintaan pembaruan, meskipun tidak ada perubahan yang dilakukan pada kolom tertentu.

Contoh kode ini menunjukkan cara memperbarui pendaftaran agen Dialogflow:

curl

  curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
  "https://discoveryengine.googleapis.com/v1alpha/AGENT_RESOURCE_NAME" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "icon": {
        "uri": "ICON_URI"
      },
      "dialogflowAgentDefinition": {
        "dialogflowAgent": "projects/PROJECT_ID/locations/REASONING_ENGINE_LOCATION/agents/DIALOGFLOW_AGENT_ID"
      }
    }'

Ganti variabel dengan nilai:

• PROJECT_ID: ID project Google Cloud Anda.
• AGENT_RESOURCE_NAME: nama resource pendaftaran agen yang akan diperbarui.
• DISPLAY_NAME:tNama tampilan agen.
• DESCRIPTION: deskripsi agen yang ditampilkan di Gemini Enterprise. Deskripsi ini hanya untuk kepentingan pengguna.
• ICON_URI: URI publik ikon yang ditampilkan di samping nama agen Dialogflow Anda. Anda juga dapat memberikan gambar berenkode Base64 di icon.content.
• REASONING_ENGINE_LOCATION: lokasi cloud mesin penalaran tempat Anda membuat agen.
• DIALOGFLOW_AGENT_ID: ID unik agen Dialogflow Anda.

Menghapus agen Dialogflow

Contoh kode berikut menunjukkan cara menghapus agen yang terhubung ke aplikasi Anda:

REST

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"

Ganti variabel dengan nilai:

• 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.
• PROJECT_ID: ID project Google Cloud Anda.
• LOCATION: multi-region aplikasi Anda: global, us, atau eu
• APP_ID: ID aplikasi Gemini Enterprise Anda.
• AGENT_ID: ID agen. Anda dapat menemukan ID agen dengan mencantumkan agen yang terhubung ke aplikasi Anda.

Contoh perintah dan hasil

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://global-discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890"

{
  "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890/operations/delete-agent-12345678901234567890",
  "done": true
}