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 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 agennya.

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

  5. Di kartu Custom agent via Dialogflow, klik Add untuk mendaftarkan agen Dialogflow Anda dengan 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. Di bagian Setelan alat, masukkan deskripsi di kolom Deskripsi alat. Deskripsi ini digunakan oleh LLM untuk memahami tujuan alat dan memutuskan kapan harus menggunakannya.

    5. Masukkan nama di kolom Input parameter name. Ini adalah nama parameter untuk panggilan fungsi. Nama parameter ini memberikan petunjuk kepada LLM tentang jenis konten yang diharapkan berisi parameter, seperti question, command, search_query.

    6. Masukkan deskripsi untuk kolom Deskripsi parameter input. Ini adalah deskripsi parameter untuk panggilan fungsi. Deskripsi ini memberi LLM informasi selengkapnya tentang parameter, seperti jenis konten yang diharapkan untuk diteruskan dan tindakan yang harus dilakukan.

    7. Klik Buat.

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 name. 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.