Carregamento em lote

Importante:

Será cobrado 1 AI Unit ou 0,2 Platform Units por comentário criado ou por comentário atualizado, com base em seu ID exclusivo, se seu texto foi modificado.

A CLI permite carregar comentários (incluindo comentários pré-anotados) em lote. Além de importar dados para o Communications Mining™ nos casos em que uma conexão ao vivo não é necessária, ela pode ser usada para carregar dados de treinamento pré-existentes no Communications Mining ou para substituir comentários ou rótulos existentes no Communications Mining.

Observação:

Esta seção pressupõe que você já tenha instalado e configurado a CLI.

Preparando dados

A CLI espera dados no formato JSONL (também chamado de JSON delimitado por nova linha), onde cada linha é um valor JSON. Muitas ferramentas conseguem exportar arquivos JSONL prontos para uso. Entre em contato com o suporte se tiver alguma dúvida.

Cada linha no arquivo JSONL representa um objeto de comentário. Cada objeto de comentário deve ter pelo menos um ID exclusivo, um carimbo de data/hora e uma parte do texto, mas pode ter outros campos, como metadados. Para saber quais campos definir para seus dados, verifique a Referência do comentário.

Cada linha no arquivo JSONL deve ter o seguinte formato, onde apenas os campos obrigatórios são mostrados.

Observação:

Isso é mostrado com recuo para legibilidade, mas deve estar tudo em uma linha em seu arquivo.

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

Se você quiser carregar rótulos ao lado de comentários, você pode incluí-los assim (Igual ao mencionado anteriormente, isso é mostrado com recuo para legibilidade, mas deve estar tudo em uma linha em seu arquivo):

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

Carregamento de dados

Carregamento de comentários

O comando a seguir carregará comentários para a origem especificada. Recomendamos carregar comentários em uma nova origem vazia, pois isso facilita a reversão se algo der errado — você apenas exclui a origem.

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

Se você quiser atualizar comentários existentes, deve especificar o sinalizador --overwrite . Os comentários serão substituídos com base no campo comment.id . Recomendamos que você faça uma cópia de backup da origem antes de atualizar comentários para poder recuperar os comentários originais se algo der errado.

Carregamento de comentários com rótulos

Se você quiser carregar rótulos com seus comentários, especifique um conjunto de dados no qual os rótulos serão carregados. O conjunto de dados deve estar conectado à origem antes de você iniciar o carregamento.

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

É possível substituir rótulos em comentários existentes especificando o sinalizador --overwrite .

Observação:

Isso substituirá os rótulos existentes por novos, e não adicionará rótulos existentes aos novos. Recomendamos que você faça uma cópia de backup do conjunto de dados antes de substituir rótulos para poder recuperar os rótulos originais se algo der errado.