Exporter et importer un modèle de sujet

Vous pouvez exporter les modèles que vous avez déjà entraînés pour les sauvegarder. Vous pouvez utiliser ces sauvegardes pour rétablir un modèle existant ou pour transférer un modèle vers un nouveau projet.

Remarque : L'exportation et l'importation de modèles ne sont disponibles que pour les modèles thématiques V2 ou ultérieurs.

Exporter un modèle

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

• contactcenterinsights.issueModels.export

L'exportation d'un modèle thématique vers Cloud Storage vous permet d'enregistrer une copie de sauvegarde du modèle afin de pouvoir le restaurer ultérieurement si nécessaire.

REST

Pour exporter un modèle thématique, appelez la méthode export sur la ressource issueModel.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet
• ISSUE_MODEL_ID : ID du modèle thématique à exporter.
• GCS_DESTINATION : URI Cloud Storage vers lequel le modèle thématique est exporté.

Remarque : Tous les exemples utilisent l'instance Insights sur l'expérience client globale. Pour savoir comment utiliser les instances régionales, consultez Régionalisation.

Méthode HTTP et URL :

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

Corps JSON de la requête :

{ 
  gcs_destination: { 
    object_uri: 'GCS_DESTINATION'
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Importer un modèle

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez disposer des autorisations suivantes :

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

L'importation d'un modèle thématique depuis Cloud Storage vous permet de remplacer un modèle thématique existant ou d'en créer un nouveau à partir d'un modèle existant. Partir d'un modèle existant peut être utile lorsque vous souhaitez apporter des modifications sans changer le modèle d'origine.

• Pour remplacer un modèle de thème existant, appelez la méthode d'importation avec un URI d'objet Cloud Storage pointant vers un modèle de thème précédemment exporté à partir du même projet. Les insights sur l'expérience client extraient l'ID du modèle de remplacement à partir du fichier exporté.
• Si le modèle de thèmes n'existe pas dans le projet ou est importé dans un nouveau projet, Customer Experience Insights en crée automatiquement un.
• Vous pouvez éventuellement définir le flag create_new_model si vous ne souhaitez pas remplacer le modèle existant.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet
• GCS_SOURCE : URI Cloud Storage où le modèle thématique est enregistré.
• CREATE_NEW_MODEL : indicateur booléen permettant de créer un modèle au lieu d'en remplacer un existant.
Remarque : Tous les exemples utilisent l'instance Insights sur l'expérience client globale. Pour savoir comment utiliser les instances régionales, consultez Régionalisation.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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