Themenmodell exportieren und importieren

Sie können bereits trainierte Modelle exportieren, um sie zu sichern. Mit diesen Sicherungen können Sie ein vorhandenes Modell wiederherstellen oder ein Modell in ein neues Projekt ü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 die export Methode für die issueModel Ressource auf, um ein Themenmodell zu exportieren.

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. Die Verwendung eines vorhandenen Modells kann nützlich sein, wenn Sie Änderungen vornehmen möchten, ohne das ursprüngliche Modell zu ändern.

• Rufen Sie die Importmethode mit einem Cloud Storage-Objekt-URI auf, der auf ein zuvor exportiertes Themenmodell aus demselben Projekt verweist, um ein vorhandenes Themenmodell zu ersetzen. Customer Experience Insights 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, in dem das Themenmodell gespeichert ist.
• CREATE_NEW_MODEL: Boolesches Flag zum Erstellen eines neuen Modells anstelle des Ersetzens eines vorhandenen Modells.
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"
}