Themenmodell exportieren und importieren

Sie können bereits trainierte Modelle exportieren, um sie zu sichern. Sie können diese Backups verwenden, um ein vorhandenes Modell zurückzusetzen oder ein Modell in ein neues Projekt zu übertragen.

Hinweis :Das Exportieren und Importieren von Modellen ist nur für Themenmodelle der Version 2 oder höher verfügbar.

Modell exportieren

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:

• contactcenterinsights.issueModels.export

Wenn Sie ein Themenmodell in Cloud Storage exportieren, können Sie eine Sicherungskopie des Modells speichern, um es bei Bedarf später wiederherzustellen.

REST

Rufen Sie zum Exportieren eines Themenmodells die Methode export für die Ressource issueModel auf.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Ihre Projekt-ID.
• ISSUE_MODEL_ID: Die ID des zu exportierenden Themenmodells.
• GCS_DESTINATION: Ein Cloud Storage-URI, in den das Themenmodell exportiert wird.

Hinweis:In allen Beispielen wird die globale Customer Experience Insights-Instanz verwendet. Eine Anleitung zur Verwendung regionaler Instanzen finden Sie unter Regionalisierung.

HTTP-Methode und URL:

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

JSON-Text anfordern:

{ 
  gcs_destination: { 
    object_uri: 'GCS_DESTINATION'
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Modell importieren

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie folgende Berechtigungen:

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

Wenn Sie ein Themenmodell aus Cloud Storage importieren, können Sie ein vorhandenes Themenmodell ersetzen oder ein neues Themenmodell auf Grundlage eines vorhandenen Modells erstellen. Ein vorhandenes Modell als Ausgangspunkt zu verwenden, kann nützlich sein, wenn Sie Anpassungen vornehmen möchten, ohne das ursprüngliche Modell zu ändern.

• Wenn Sie ein vorhandenes Themenmodell ersetzen möchten, rufen Sie die Importmethode mit einem Cloud Storage-Objekt-URI auf, der auf ein zuvor exportiertes Themenmodell aus demselben Projekt verweist. Insights zur Customer Experience ruft die ID des Ersatzmodells aus der exportierten Datei ab.
• Wenn das Themenmodell im Projekt nicht vorhanden ist oder in ein neues Projekt importiert wird, erstellt Customer Experience Insights automatisch ein neues Themenmodell.
• Optional können Sie das Flag create_new_model festlegen, wenn Sie das vorhandene Modell nicht ersetzen möchten.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Ihre Projekt-ID.
• GCS_SOURCE: Der Cloud Storage-URI, unter dem das Themenmodell gespeichert wird.
• CREATE_NEW_MODEL: Boolescher Wert, mit dem angegeben wird, ob ein neues Modell erstellt werden soll, anstatt ein vorhandenes Modell zu ersetzen.
Hinweis:In allen Beispielen wird die globale Customer Experience Insights-Instanz verwendet. Eine Anleitung zur Verwendung regionaler Instanzen finden Sie unter Regionalisierung.

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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