Carga por lotes

Importante:

Operación facturable

Se le cobrará 1 AI Unit por comentario creado o por comentario actualizado (en función de su Id. único) si se modificó el 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 instalado y 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. Consulta la referencia de comentarios para saber qué campos establecer para tus datos.

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 deseas cargar etiquetas junto a los comentarios, puedes incluirlos así (al igual que antes, 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>"
        }
      }
    ]
  },
  "annotating": {
    "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 a la fuente especificada. Recomendamos cargar los comentarios en una nueva fuente vacía, ya que facilita la reversión si algo sale mal: simplemente elimina la fuente.

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.