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 agen tersebut dapat berkomunikasi.

Sebelum memulai

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

  • Deploy agen Dialogflow Anda. Untuk melihat dasbor agen percakapan dan Dialogflow, lihat Agen percakapan.

  • Peran Admin Discovery Engine.

  • 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 dengan 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.

Konsol

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

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

    Buka Gemini Enterprise

  2. Pilih project Anda.

  3. Klik nama aplikasi yang ingin Anda daftarkan agennya.

  4. Klik Agents > Add Agents. Panel Pilih jenis agen akan muncul.

  5. Di kartu Agen kustom melalui Dialogflow, klik Tambahkan untuk mendaftarkan agen Dialogflow Anda ke Gemini Enterprise. Panel Konfigurasi akan terbuka.

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

    1. Masukkan nama di kolom Nama agen Anda. Nilai ini muncul di Gemini Enterprise sebagai nama tampilan agen Anda.

    2. Masukkan deskripsi di kolom Deskripsikan agen Anda. 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 Sumber agen Dialogflow.

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

      Opsi Ketersediaan agen, Jika 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 Google Cloud project Anda.
  • APP_ID: ID aplikasi Gemini Enterprise Anda.
  • DISPLAY_NAME: nama agen yang mudah digunakan dan ditampilkan di Gemini Enterprise.
  • DESCRIPTION: penjelasan singkat tentang fungsi agen Anda yang dapat dilihat 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 dalam icon.content.
  • DIALOGFLOW_PROJECT_ID: Google Cloud Project ID yang mengidentifikasi lokasi agen Dialogflow Anda.
  • DIALOGFLOW_LOCATION: lokasi geografis spesifik 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 mencakup nama resource uniknya di kolom nama. Nama resource ini dapat digunakan untuk update atau referensi 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. Tetapkan 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 Google Cloud project Anda.
  • LOCATION: multi-region aplikasi Anda: global, us, atau eu.
  • APP_ID: ID aplikasi Gemini Enterprise Anda.

Jika agen Anda tidak dibuat 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. Tetapkan 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 Google Cloud project 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 update:

  • 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 Google Cloud project 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 hanya untuk manfaat pengguna.
  • ICON_URI: URI publik ikon yang ditampilkan di samping nama agen Dialogflow Anda. Anda juga dapat memberikan gambar berenkode Base64 dalam 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. Tetapkan 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 Google Cloud project 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.