Batch-Upload

Wichtig:

Ihnen werden 1 AI Unit oder 0,2 Platform Units pro erstelltem Kommentar oder pro aktualisiertem Kommentar auf Grundlage der eindeutigen ID in Rechnung gestellt, wenn sein Text geändert wurde.

Mit der CLI können Sie Kommentare ( einschließlich vorab kommentierter Kommentare) in Batches hochladen. Zusätzlich zum Importieren von Daten in Communications Mining™, wenn eine Live-Verbindung nicht erforderlich ist, kann sie zum Hochladen bereits vorhandener Trainingsdaten in Communications Mining oder zum Überschreiben vorhandener Kommentare oder Beschriftungen in Communications Mining verwendet werden.

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 neue Zeile getrennte JSON bezeichnet), wobei 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 ein Textteil haben, kann aber auch andere Felder wie Metadaten haben. Informationen, welche Felder für Ihre Daten festgelegt werden sollen, finden Sie in der Kommentarreferenz.

Jede Zeile in der JSONL-Datei muss das folgende Format haben, wobei nur die erforderlichen Felder angezeigt werden.

Hinweis:

Dies wird zur besseren Lesbarkeit mit einem Einzug angezeigt, sollte sich jedoch in einer Zeile Ihrer Datei befinden.

{
  "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 auf diese Weise einschließen (wie zuvor erwähnt, dies wird zur besseren Lesbarkeit mit Einzug angezeigt, sollte sich jedoch in einer Zeile in Ihrer Datei befinden):

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

Hochladen von Daten

Kommentare werden hochgeladen

Mit dem folgenden Befehl werden Kommentare in die angegebene Quelle hochgeladen. Wir empfehlen, Kommentare in eine neue leere Quelle hochzuladen, da es ein Rollback 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 für vorhandene Kommentare überschreiben, indem Sie das Flag --overwrite angeben.

Hinweis:

Dadurch werden vorhandene Beschriftungen durch neue Beschriftungen ersetzt, und vorhandene Beschriftungen werden nicht zu neuen hinzugefügt. Wir empfehlen, vor dem Überschreiben von Beschriftungen eine Sicherungskopie des Datasets zu erstellen, um die ursprünglichen Beschriftungen wiederherstellen zu können, wenn etwas schief läuft.