批量上传

重要提示：

可计费操作

对于每个创建的评论或每个更新的评论 (依据其唯一 ID)，如果其文本已被修改，您需支付 1 个 AI Unit 的费用。

CLI 允许您批量上传注释（包括预先注释的注释）。除了在不需要实时连接的情况下将数据导入到 Communications Mining 中外，它还可用于将预先存在的训练数据上传到 Communications Mining 中，或者覆盖 Communications Mining 中的现有注释或标签。

注意：本节假定您已安装并配置CLI。

准备数据

CLI 需要 JSONL 格式的数据（也称为以换行符分隔的 JSON），其中每一行都是一个 JSON 值。许多工具都可以导出 JSONL 文件。如果您有任何问题，请联系支持团队。

JSONL 文件中的每一行代表一个注释对象。每个注释对象至少应具有唯一 ID、时间戳和一段文本，但可以具有其他字段，例如元数据。请参阅注释参考，了解要为数据设置哪些字段。

JSONL 文件中的每一行均应采用以下格式（仅显示必填字段）。（请注意，为便于阅读，显示时缩进，但应全部占到文件中的一行。）

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

如果要与注释一起上传标签，则可以将其包含在内（如上所述，为便于阅读，以缩进显示，但应全部显示在文件的一行中）：

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

上传数据

上传注释

以下命令会将注释上传到指定的来源。我们建议将注释上传到新的空源中，因为如果出现问题，这样可以更轻松地回滚 - 您只需删除源即可。

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

如果要更新现有注释，则应指定--overwrite标志。系统将覆盖comment.id字段中的注释。我们建议您在更新注释之前备份源的副本，以便能够在出现问题时恢复原始注释。

上传带有标签的注释

如果您想与注释一起上传标签，则应指定要将标签上传到的数据集。在开始上传之前，应将数据集连接到源。

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