Batch-Upload

Wichtig:

Abrechenbarer Vorgang

Ihnen wird 1 AI Unit pro erstelltem Kommentar oder pro aktualisiertem Kommentar (basierend auf der eindeutigen ID) in Rechnung gestellt, wenn dessen Text geändert wurde.

Mit der CLI können Sie Kommentare (einschließlich vorkommentierter Kommentare) in Batches hochladen. Zusätzlich zum Importieren von Daten in Communications Mining in den Fällen, in denen keine Live-Verbindung erforderlich ist, kann sie verwendet werden, um bereits vorhandene Trainingsdaten in Communications Mining hochzuladen oder um vorhandene Kommentare oder Bezeichnungen in Communications Mining zu überschreiben.

Hinweis: In diesem Abschnitt wird davon ausgegangen, dass Sie die CLI bereits installiert und konfiguriert haben.

Vorbereiten von Daten

Die CLI erwartet Daten im JSONL-Format (auch als durch neue Zeilen getrennte JSON bezeichnet), bei denen jede Zeile ein JSON-Wert ist. Viele Tools können JSONL-Dateien sofort exportieren. Wenden Sie sich an den Support, wenn Sie Fragen haben.

Jede Zeile in der JSONL-Datei stellt ein Kommentarobjekt dar. Jedes Kommentarobjekt muss mindestens eine eindeutige ID, einen Zeitstempel und einen Text haben, kann aber auch andere Felder wie Metadaten haben. Bitte lesen Sie die Referenz für Kommentare , um zu erfahren, welche Felder für Ihre Daten festgelegt werden sollen.

Jede Zeile in der JSONL-Datei muss das folgende Format haben (nur Pflichtfelder angezeigt). (Beachten Sie, dass dies zur besseren Lesbarkeit mit Einzug angezeigt wird, sich aber in Ihrer Datei in einer Zeile befinden sollte.)

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

Wenn Sie Beschriftungen zusammen mit Kommentaren hochladen möchten, können Sie sie folgendermaßen einfügen (wie oben, wird dies zur besseren Lesbarkeit mit Einzug angezeigt, sollte sich aber in Ihrer Datei alle in einer Zeile befinden):

{
  "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>"
      }
    ]
  }
}

Hochladen von Daten

Kommentare werden hochgeladen

Der folgende Befehl lädt Kommentare in die angegebene Quelle hoch. Wir empfehlen, Kommentare in eine neue leere Quelle hochzuladen, da es das Zurücksetzen erleichtert, wenn etwas schief gelaufen ist – Sie löschen einfach die Quelle.

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

Wenn Sie vorhandene Kommentare aktualisieren möchten, sollten Sie das Flag --overwrite angeben. Die Kommentare werden basierend auf dem comment.id -Feld überschrieben. Wir empfehlen Ihnen, vor dem Aktualisieren der Kommentare eine Sicherungskopie der Quelle zu erstellen, damit Sie im Falle eines Fehlers die ursprünglichen Kommentare wiederherstellen können.

Hochladen von Kommentaren mit Beschriftungen

Wenn Sie Beschriftungen zusammen mit Ihren Kommentaren hochladen möchten, müssen Sie ein Dataset angeben, in das die Beschriftungen hochgeladen werden sollen. Das Dataset muss mit der Quelle verbunden sein, bevor Sie mit dem Hochladen beginnen.

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

Sie können Beschriftungen vorhandener Kommentare überschreiben, indem Sie das Flag --overwrite angeben. Beachten Sie, dass dadurch vorhandene Beschriftungen durch neue Beschriftungen ersetzt werden (keine vorhandenen Beschriftungen zu neuen Beschriftungen hinzugefügt werden). Es wird empfohlen, vor dem Überschreiben von Beschriftungen eine Sicherungskopie des Datasets zu erstellen, um im Falle eines Fehlers die ursprünglichen Beschriftungen wiederherstellen zu können.