Téléchargement par lot

Important :

Opération facturable

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.

Note: This section assumes you have already and configured the CLI.

Préparation des données

La CLI attend des données au format JSONL (également appelé JSON délimité par nouvelle ligne), où chaque ligne est une valeur JSON. De nombreux outils pourront exporter des fichiers JSONL prêts à l'emploi. Veuillez contacter l’assistance 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 JSONL doit avoir le format suivant (seuls les champs obligatoires sont affichés). (Notez que cela est indiqué avec une mise en retrait pour plus de lisibilité, mais que cela 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

The following command will upload comments to the specified source. We recommend to upload comments into a new empty source, as it makes rolling back easier if something went wrong - you just delete the 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 les libellés des commentaires existants en spécifiant l'indicateur --overwrite . Notez que cela remplacera les libellés existants par de nouveaux libellés (n'ajoutera pas de libellés existants aux nouveaux libellés). 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.