Carga por lotes

Importante:

Operación facturable

Se te cobrará 1 AI Unit o 0,2 Platform Units por comentario creado, o por comentario actualizado (en función de su ID único) si se ha modificado su texto.

La CLI te permite cargar comentarios (incluidos los comentarios preanotados) por lotes. Además de importar datos a Communications Mining™ en aquellos casos en los que no se requiere una conexión activa, puede utilizarse para cargar datos de entrenamiento preexistentes en Communications Mining, o para sobrescribir comentarios o etiquetas existentes en Communications Mining.

Nota: Esta sección asume que ya has configurado la CLI.

Preparar datos

La CLI espera datos en formato JSONL (también llamado JSON delimitado por saltos de línea), donde cada línea es un valor JSON. Muchas herramientas podrán exportar archivos JSONL listos para usar. Póngase en contacto con el soporte técnico si tiene alguna pregunta.

Cada línea del archivo JSONL representa un objeto de comentario. Cada objeto de comentario debe tener al menos un ID único, una marca de tiempo y un fragmento de texto, pero puede tener otros campos como metadatos. Para saber qué campos establecer para tus datos, consulta la Referencia de comentarios.

Cada línea del archivo JSONL debe tener el siguiente formato (solo se muestran los campos obligatorios). (Ten en cuenta que esto se muestra con sangría para facilitar la lectura, pero debe estar todo en una línea en tu archivo).

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

Si desea cargar etiquetas junto con los comentarios, puede incluirlos así (al igual que se mencionó anteriormente, esto se muestra con sangría para facilitar la lectura, pero debe estar todo en una línea en su archivo):

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

Cargar datos

Cargar comentarios

El siguiente comando cargará los comentarios en el origen especificado. Recomendamos cargar los comentarios en un nuevo origen vacío, ya que facilita la reversión si algo sale mal: simplemente elimina el origen.

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

Si quieres actualizar los comentarios existentes, debes especificar el marcador --overwrite . Los comentarios se sobrescribirán en función del campo comment.id . Te recomendamos que hagas una copia de seguridad del origen antes de actualizar los comentarios para poder recuperar los comentarios originales si algo sale mal.

Cargar comentarios con etiquetas

Si desea cargar etiquetas junto con sus comentarios, debe especificar un conjunto de datos en el que se deben cargar las etiquetas. El conjunto de datos debe estar conectado a la fuente antes de comenzar a cargar.

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

Puedes sobrescribir etiquetas en comentarios existentes especificando el marcador --overwrite . Ten en cuenta que esto reemplazará las etiquetas existentes por etiquetas nuevas (no añadirá etiquetas existentes a etiquetas nuevas). Te recomendamos que hagas una copia de seguridad del conjunto de datos antes de sobrescribir las etiquetas para poder recuperar las etiquetas originales si algo sale mal.