Téléchargement par lot

Important :

Vous serez facturé 1 AI Unit ou 0,2 Platform Units par commentaire créé ou par commentaire mis à jour, en fonction de son ID unique, si son texte a été modifié.

La CLI vous permet de télécharger des commentaires (y compris des commentaires pré-annotés) par lots. En plus d’importer des données dans Communications Mining™ dans les cas où une connexion en direct n’est pas nécessaire, elle peut être utilisée pour télécharger des données d’entraînement préexistantes dans Communications Mining, ou pour remplacer des commentaires ou des libellés existants dans Communications Mining.

Remarque :

Cette section suppose que vous avez déjà installé et configuré la CLI.

Préparation des données

La CLI attend des données au format JSON, où chaque ligne est une valeur JSON. De nombreux outils pourront exporter des fichiers JSON prêts à l'emploi. Veuillez contacter le support si vous avez des questions.

Chaque ligne du fichier JSON représente un objet de commentaire. Chaque objet de commentaire doit avoir au moins un ID unique, un horodatage et un élément de texte, mais peut contenir d'autres champs tels que des métadonnées. Pour savoir quels champs définir pour vos données, consultez la section Référence de commentaire.

Chaque ligne du fichier JSON doit avoir le format suivant, où seuls les champs obligatoires sont affichés.

Remarque :

Il est indiqué avec retrait pour plus de lisibilité, mais doit être tout sur une seule ligne dans votre fichier.

{
  "comment": {
    "id": "<unique id>",
    "timestamp": "<timestamp>",
    "messages": [
      {
        "body": {
          "text": "<text of the comment>"
        }
      }
    ]
  }
}

Si vous souhaitez télécharger des libellés avec des commentaires, vous pouvez les inclure comme suit ) :

{
  "comment": {
    "id": "<unique id>",
    "timestamp": "<timestamp>",
    "messages": [
      {
        "body": {
          "text": "<text of the comment>"
        }
      }
    ]
  },
  "labelling": {
    "assigned": [
      {
        "name": "<Your Label Name>",
        "sentiment": "<positive|negative>"
      },
      {
        "name": "<Another Label Name>",
        "sentiment": "<positive|negative>"
      }
    ]
  }
}

Charger des données

Téléchargement de commentaires

La commande suivante téléchargera des commentaires dans la source spécifiée. Nous vous recommandons de télécharger des commentaires dans une nouvelle source vide, car cela facilite la restauration en cas de problème. Il suffit pour cela de supprimer la source.

re create comments \
  --source <project_name/source_name> \
  --file <file_name.jsonl>

Si vous souhaitez mettre à jour les commentaires existants, vous devez spécifier l'indicateur --overwrite . Les commentaires seront écrasés en fonction du champ comment.id . Nous vous recommandons de faire une copie de sauvegarde de la source avant de mettre à jour les commentaires afin de pouvoir récupérer les commentaires d'origine en cas de problème.

Téléchargement de commentaires avec des libellés

Si vous souhaitez télécharger des libellés avec vos commentaires, vous devez spécifier un ensemble de données dans lequel les libellés doivent être téléchargés. L'ensemble de données doit être connecté à la source avant de commencer le téléchargement.

re create comments \
  --source <project_name/source_name> \
  --dataset <project_name/dataset_name> \
  --file <file_name.jsonl>

Vous pouvez remplacer des libellés sur des commentaires existants en spécifiant l'indicateur --overwrite .

Remarque :

Cela remplacera les libellés existants par de nouveaux libellés, et n'ajoutera pas de libellés existants aux nouveaux. Nous vous recommandons de faire une copie de sauvegarde de l'ensemble de données avant d'écraser les libellés, afin de pouvoir récupérer les libellés d'origine en cas de problème.