Descarga por lotes

Descargue comentarios y predicciones de forma masiva desde Communications Mining utilizando la CLI para importar a las herramientas de análisis.

La CLI te permite descargar comentarios y predicciones por lotes. Esto es más útil para importar scripts en herramientas de análisis que no requieren una conexión en vivo.

Nota:

Esta sección asume que ya has instalado y configurado CLI.

Descargar comentarios con predicciones

El siguiente comando descargará todos los comentarios y predicciones en el origen y el conjunto de datos especificados. Ten en cuenta que el nombre del conjunto de datos y el nombre de la fuente deben ir precedidos del nombre del proyecto en el que se encuentran. Si el conjunto de datos contiene varios orígenes, debes emitir este comando para cada origen para descargar todos los comentarios del conjunto de datos.

re get comments project/source-name --dataset project/dataset-name --predictions=true -f output.jsonl

¿Qué versión del modelo utiliza la CLI para obtener predicciones?

La CLI descargará las últimas predicciones calculadas disponibles. Estas son las mismas predicciones que se muestran en la IU.

Importante:

If you need predictions from a specific model version, consider using the streams or the predict API routes.

Procesamiento de datos

Nota:

Al igual que la API, la CLI devuelve etiquetas previstas con puntuaciones de confianza. Para procesar correctamente las puntuaciones de confianza, asegúrate de comprobar las secciones Uso de etiquetas en automatización y Uso de etiquetas en análisis de la documentación de Etiquetas.

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

Cada línea del archivo JSONL tendrá el siguiente formato:

{
  "comment": {...},
  "annotating": {
    "assigned": [...]
    "predicted": [...]
  },
  "entities": {
    "assigned": [...]
    "predicted": [...]
  }
}

Nombre del campo	Descripción
comment	Comment object in the format described in Comments.
annotating.assigned	List of assigned labels, in the format described in Labels.
entities.assigned	List of assigned entities, in the format described in General fields.
annotating.predicted	List of predicted labels, in the format described in Labels.
entities.predicted	List of predicted entities, in the format described in General fields.

Ten en cuenta que el campo annotating o entities puede estar completamente ausente si el comentario no tiene etiquetas o entidades asignadas ni previstas.

The following is an example comment with predictions downloaded from a real-life dataset.

{
  "comment": {
    "id": "1234abcd",
    "uid": "5678ef.1234abdc",
    "timestamp": "2021-02-01T00:00:00Z",
    "messages": [
      {
        "body": {
          "text": "The hot chocolate biscuit on arrival raised my expectations"
        }
      }
    ],
    "user_properties": {
      "string:Question": "What did you like about your stay",
      "number:Reviewer Score": 5.4,
      "number:Average Score": 8.4,
      "number:Reviewer Total Number Of Reviews": 1,
      "string:Hotel Name": "DoubleTree by Hilton London Victoria"
    },
    "created_at": "2021-02-01T00:00:00Z"
  },
  "annotating": {
    "predicted": [
      {
        "name": "Refreshments",
        "sentiment": 0.3598046874571062,
        "probability": 0.54764723591506481
      },
      {
        "name": "Property",
        "sentiment": 0.6684685489411859,
        "probability": 0.417815982922911644
      }
    ]
  }
}