Mendaftarkan dan mengelola agen Dialogflow

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 langkah-langkah berikut telah selesai:

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

  • Peran Admin Gemini Enterprise.

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

    Buka Discovery Engine API

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

Mendaftarkan agen Dialogflow dengan Gemini Enterprise

Anda dapat mendaftarkan agen Dialogflow dengan Gemini Enterprise menggunakan Google Cloud konsol atau REST API. Pendaftaran akan membuat agen Anda tersedia bagi pengguna dalam aplikasi Gemini Enterprise.

Konsol

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

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

    Buka Gemini Enterprise

  2. Pilih project Anda.

  3. Klik nama aplikasi yang ingin Anda gunakan untuk mendaftarkan 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 dengan Gemini Enterprise. Panel Configuration akan terbuka.

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

    1. Masukkan nama di kolom Your agent name. Nilai ini akan 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 dengan Gemini Enterprise di kolom Dialogflow agent source.

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

      Opsi Agent availability, When selected, 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 Anda. Google Cloud
  • 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, Extract key information from uploaded invoices for business travel.
  • 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: ID project yang mengidentifikasi lokasi agen Dialogflow Anda. Google Cloud
  • 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 terhadap perintah ini akan menampilkan semua kolom resource agen Dialogflow yang baru dibuat, yang mencakup 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 Amerika Serikat
    • 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 Anda. Google Cloud
  • LOCATION: multi-region aplikasi Anda: global, us, atau eu.
  • APP_ID: ID aplikasi Gemini Enterprise Anda.

Jika agen Anda tidak dibuat sebelumnya 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 Amerika Serikat
    • 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 Anda. Google Cloud
  • 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 ada selama proses pembaruan:

  • displayName
  • description
  • reasoning_engine

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

Contoh kode ini menunjukkan cara memperbarui pendaftaran agen Dialogflow Anda:

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 Anda. Google Cloud
  • AGENT_RESOURCE_NAME: nama resource pendaftaran agen yang akan diperbarui.
  • DISPLAY_NAME:nama tampilan agen.
  • DESCRIPTION: deskripsi agen yang ditampilkan di Gemini Enterprise. Deskripsi ini hanya untuk manfaat 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 Amerika Serikat
    • 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 Anda. Google Cloud
  • 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.