一括ダウンロード

CLI を使用すると、コメントと予測をバッチでダウンロードできます。 これは、ライブ接続を必要としない分析ツールへのスクリプトインポートに最も役立ちます。

注:

このセクションでは 、CLI がすでにインストールおよび設定されていることを前提としています。

予測付きのコメントをダウンロードする

次のコマンドは、指定されたソースとデータセット内にある コメント と 予測 をすべてダウンロードします。データセット名とソース名の先頭には、プレフィックスとしてそのデータセットとソースが存在するプロジェクト名を付ける必要があることに注意してください。データセットに複数のソースが含まれる場合は、このコマンドをソースごとに発行して、データセット内のすべてのコメントをダウンロードする必要があります。

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

CLI はどのモデル バージョンを使用して予測を取得しますか?

CLI は、利用可能な最新の計算済み予測をダウンロードします。 これらは、UI に表示される予測と同じです。

重要:

特定のモデル バージョンからの予測が必要な場合は、ストリーム または Predict API ルートの使用を検討してください。

データの処理

注:

API と同様に、CLI は予測されたラベルと信頼度スコアを返します。信頼度スコアを正しく処理するには、ラベルに関するドキュメントの 「オートメーションでラベルを使用する 」および 「分析でラベルを使用する 」セクションを確認してください。

CLI は、各行が JSON 値である JSONL 形式 (改行で区切られた JSON とも呼ばれる) でデータを返します。多くのツールでは、JSONLファイルをすぐに処理できます。ご不明な点がございましたら 、サポートまでお問い合わせください 。

JSONL ファイルの各行の形式は次のとおりです。

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

フィールド名	説明
comment	記述された コメント形式のコメントオブジェクト。
annotating.assigned	割り当てられたラベルのリスト。「 ラベル」の形式です。
entities.assigned	割り当てられたエンティティのリスト。説明された 形式 (一般フィールド)
annotating.predicted	予測されたラベルのリストです。「 ラベル」の形式です。
entities.predicted	予測されたエンティティのリストです。 説明された形式は一般フィールドです。

annotating フィールドまたは entities フィールドは、コメントにラベルまたはエンティティが割り当てられておらず、予測もされていない場合、完全に存在しない可能性があることに注意してください。

以下は、実際のデータセットからダウンロードした予測を含むコメントの例です。

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