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

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

יצירת כוונה

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

בוחרים פרוטוקול וגרסה להפניה של הכוונה:

פרוטוקול	V3	V3beta1
REST	Intent resource	Intent resource
RPC	ממשק הכוונה	ממשק הכוונה
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

בוחרים פרוטוקול וגרסה להפניה של הכוונה:

פרוטוקול	V3	V3beta1
REST	Intent resource	Intent resource
RPC	ממשק הכוונה	ממשק הכוונה
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) ותגובה ריקה.