ניהול כוונות באמצעות ה-API

בדרך כלל יוצרים ומוחקים כוונות באמצעות המסוף. עם זאת, בתרחישים מתקדמים מסוימים, יכול להיות שיהיה קל יותר להשתמש ב-API.

יצירת Intent

בדוגמאות הבאות מוסבר איך להפעיל את השיטה Create לסוג Intent. לעיון במאמרי העזרה של Intent API

בוחרים פרוטוקול וגרסה להפניה ל-Intent:

פרוטוקול	V3	V3beta1
REST	משאב Intent	משאב Intent
RPC	ממשק Intent	ממשק Intent
C++‎	IntentsClient	לא זמין
C#‎	IntentsClient	לא זמין
המשך	IntentsClient	לא זמין
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	לא זמין	לא זמין
Python	IntentsClient	IntentsClient
Ruby	לא זמין	לא זמין

סגירה

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud
• ‫REGION_ID: מזהה האזור שלכם
• ‫AGENT_ID: מזהה הנציג שלכם

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

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

עדכון Intent

במדריך למסכת שדות מוסבר איך לעדכן שדות ספציפיים של כוונה.

מחיקת כוונה

בדוגמאות הבאות מוסבר איך להפעיל את השיטה Delete לסוג Intent. לעיון במאמרי העזרה של Intent API

בוחרים פרוטוקול וגרסה להפניה ל-Intent:

פרוטוקול	V3	V3beta1
REST	משאב Intent	משאב Intent
RPC	ממשק Intent	ממשק Intent
C++‎	IntentsClient	לא זמין
C#‎	IntentsClient	לא זמין
המשך	IntentsClient	לא זמין
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	לא זמין	לא זמין
Python	IntentsClient	IntentsClient
Ruby	לא זמין	לא זמין

סגירה

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud
• ‫REGION_ID: מזהה האזור שלכם
• ‫AGENT_ID: מזהה הנציג שלכם
• ‫INTENT_ID: מזהה הכוונה, שמופיע בתגובה ליצירה

ה-method של ה-HTTP וכתובת ה-URL:

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

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

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)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$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

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.