Mengelola intent dengan API

Biasanya, Anda membuat dan menghapus intent menggunakan konsol. Namun, dalam skenario lanjutan tertentu, Anda mungkin lebih mudah menggunakan API ini.

Membuat intent

Contoh berikut menunjukkan cara memanggil metode Create untuk jenis Intent. Buka referensi Intent API

Pilih protokol dan versi untuk referensi Intent:

Protokol	V3	V3beta1
REST	Resource intent	Resource intent
RPC	Antarmuka Intent	Antarmuka Intent
C++	IntentsClient	Tidak tersedia
C#	IntentsClient	Tidak tersedia
Go	IntentsClient	Tidak tersedia
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	IntentsClient	IntentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda
• REGION_ID: ID wilayah Anda
• AGENT_ID: ID agen Anda

Metode HTTP dan URL:

POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents

Meminta isi JSON:

{
  "displayName": "My intent display name"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID",
  "displayName": "My intent display name",
  "priority": 500000
}

Mengupdate intent

Panduan mask kolom menunjukkan cara memperbarui setiap kolom intent.

Menghapus intent

Contoh berikut menunjukkan cara memanggil metode Delete untuk jenis Intent. Buka referensi Intent API

Pilih protokol dan versi untuk referensi Intent:

Protokol	V3	V3beta1
REST	Resource intent	Resource intent
RPC	Antarmuka Intent	Antarmuka Intent
C++	IntentsClient	Tidak tersedia
C#	IntentsClient	Tidak tersedia
Go	IntentsClient	Tidak tersedia
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	IntentsClient	IntentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda
• REGION_ID: ID wilayah Anda
• AGENT_ID: ID agen Anda
• INTENT_ID: ID intent Anda yang terdapat dalam respons pembuatan

Metode HTTP dan URL:

DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID" | Select-Object -Expand Content

Anda akan menerima kode status yang berhasil (2xx), serta respons yang kosong.