Téléchargement par lot

Important :

Opération facturable

Vous serez facturé 1 AI Unit 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 requise, elle peut être utilisée pour télécharger des données d'entraînement préexistantes dans Communications Mining ou pour écraser 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 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 JSONL représente un objet commentaire. Chaque objet commentaire doit avoir au moins un ID, un horodatage et une partie de texte uniques, mais peut avoir d'autres champs tels que des métadonnées. Veuillez consulter la page Commentaire pour savoir quels champs définir pour vos données.

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 (identique à ci-dessus, cela est affiché avec une mise en retrait pour plus de lisibilité, mais doivent tous être sur une seule ligne dans votre fichier) :

{
  "comment": {
    "id": "<unique id>",
    "timestamp": "<timestamp>",
    "messages": [
      {
        "body": {
          "text": "<text of the comment>"
        }
      }
    ]
  },
  "annotating": {
    "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 ci-dessous 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 – supprimez simplement 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 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.