ייצוא וייבוא של מודל נושאים

אתם יכולים לייצא מודלים שכבר אימנתם כדי לגבות אותם. אתם יכולים להשתמש בגיבויים האלה כדי לבטל שינויים במודל קיים או כדי להעביר מודל לפרויקט חדש.

הערה: אפשר לייצא ולייבא מודלים רק במודלים של נושאים בגרסה 2 ואילך.

ייצוא מודל

ההרשאות שנדרשות למשימה הזו

כדי לבצע את המשימה הזו נדרשות ההרשאות הבאות:

• contactcenterinsights.issueModels.export

ייצוא של מודל נושאים ל-Cloud Storage מאפשר לכם לשמור עותק גיבוי של המודל כדי שתוכלו לשחזר אותו מאוחר יותר אם יהיה צורך.

REST

כדי לייצא מודל נושאים, מבצעים קריאה ל-method‏ export במשאב issueModel.

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫ISSUE_MODEL_ID: המזהה של מודל הנושא לייצוא.
• ‫GCS_DESTINATION: URI של Cloud Storage שאליו מיוצא מודל הנושא.

הערה: כל הדוגמאות מתייחסות למופע הגלובלי של Customer Experience Insights. הוראות לשימוש במופעים אזוריים מופיעות במאמר בנושא התאמה לאזור.

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

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export

תוכן בקשת JSON:

{ 
  gcs_destination: { 
    object_uri: 'GCS_DESTINATION'
  }
}

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

‫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 "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export"

‎PowerShell (Windows)

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID"
}

ייבוא מודל

ההרשאות שנדרשות למשימה הזו

כדי לבצע את המשימה הזו נדרשות ההרשאות הבאות:

• contactcenterinsights.issueModels.create
• contactcenterinsights.issueModels.import

ייבוא של מודל נושאים מ-Cloud Storage מאפשר לכם להחליף מודל נושאים קיים או ליצור מודל נושאים חדש על סמך מודל קיים. התחלה ממודל קיים יכולה להיות שימושית כשרוצים לבצע שינויים בלי לשנות את המודל המקורי.

• כדי להחליף מודל נושאים קיים, צריך להפעיל את שיטת הייבוא עם מזהה משאבים אחיד (URI) של אובייקט Cloud Storage, שמפנה למודל נושאים שיוצא בעבר מאותו פרויקט. התכונה 'תובנות לגבי חוויית הלקוח' שולפת את מזהה מודל ההחלפה מהקובץ המיוצא.
• אם מודל הנושאים לא קיים בפרויקט או שהוא מיובא לפרויקט חדש, Customer Experience Insights יוצר באופן אוטומטי מודל נושאים חדש.
• אפשר גם להגדיר את הדגל create_new_model אם לא רוצים להחליף את המודל הקיים.

REST

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫GCS_SOURCE: ה-URI של Cloud Storage שבו נשמר מודל הנושא.
• ‫CREATE_NEW_MODEL: סימון בוליאני ליצירת מודל חדש במקום החלפת מודל קיים.
הערה: בכל הדוגמאות נעשה שימוש במופע הגלובלי של Customer Experience Insights. הוראות לשימוש במופעים אזוריים מופיעות במאמר בנושא התאמה לאזור.

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

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import

תוכן בקשת JSON:

{
  gcs_source: {
    object_uri: 'GCS_SOURCE'
  }
  create_new_model: CREATE_NEW_MODEL
}

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

‫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 "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import"

‎PowerShell (Windows)

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

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID"
}