アノテーションタスク

アノテーションタスクは、データからアノテーション、レビュー、提出までの一連の流れを担い、プラットフォームにおけるアノテーションとレビュー作業の基本単位です。このページではタスクのフィールド、状態、操作を定義します。タスクの作成と割り当ての操作は アノテーションタスク作成 を参照してください。

前提条件

項目	内容
メニュー入口	データ → アノテーション
ルート	タスク一覧 /tasks、新規作成 /tasks/new、タスク詳細 /tasks/{id}
必須権限	「アノテーションタスクを表示」
関連権限	「アノテーションを実行」、「アノテーションをレビュー」、「アノテーションタスクを管理」
参照可能なロール	管理者、プロジェクトマネージャー、レビュアー、アノテーター。収集者のロールはメニューの許可リストに含まれません
適用ルール	管理者はモジュール権限の制限を受けず、すべて読み書きです。その他のロールにはロール既定テンプレートが適用され、ユーザー単位の上書きがロール既定より優先されます。未設定のモジュールは禁止です

モジュール権限の設定方法は モジュール権限 を参照してください。ロールごとのモジュール既定レベルは次のとおりです。

ロール	「アノテーションタスクを表示」	「アノテーションを実行」	「アノテーションをレビュー」	「アノテーションタスクを管理」
プロジェクトマネージャー	読み書き	読み書き	読み書き	読み書き
レビュアー	読み取り専用	禁止	読み書き	禁止
アノテーター	読み取り専用	読み書き	禁止	禁止
収集者	読み取り専用	禁止	禁止	禁止

タスク定義

タスクのフィールド

タスクのフィールドは tasks テーブルで定義します。

フィールド	意味	制約
タスク名	タスク名	プラットフォーム全体で一意
所属プロジェクト	タスクが所属するプロジェクト	作成フォームで選択
アノテーター	アノテーションを実行するアカウント	必須、1 名
レビュアー	アノテーションをレビューするアカウント	空欄可。空欄の場合、タスクにレビュー担当はいません
作成者	タスクを作成したアカウント	タスク状態の変更時に関連ユーザーとして記録
ステータス	タスクの現在の状態	6 つの値のいずれか。「タスクの状態」を参照
理由	レビューで差し戻すときに入力する理由	ステータスが「不合格」のときに保存され、最大 1000 文字です
作成日時	タスクの作成日時	一覧の並べ替えと日付による絞り込みに使用

タスクの状態

タスクの状態は 6 つあり、画面に表示される名前と 1 対 1 で対応します。

ステータス	許可される次の状態
開始待ち	作業中
作業中	未チェック
未チェック	合格、不合格、作業中
不合格	未チェック、合格
合格	不合格、データ提出
データ提出	なし。終端状態です

「許可される次の状態」は、タスク詳細のサイドバーにある「現在のワークフロー」に表示される操作項目を決めます。現在の状態とそのロールが設定できる状態の積集合をとり、戻し用の「前へ」の入口を加えたものです。

ステータス変更権限

ステータスの変更はロールと身分の 2 段階で制限されます。ロール層は、誰がタスクをある状態に設定できるかを決めます。

ステータス	この状態を設定できるロール
開始待ち	管理者、プロジェクトマネージャー、レビュアー、アノテーター、収集者
作業中	管理者、プロジェクトマネージャー、レビュアー、アノテーター、収集者
未チェック	管理者、プロジェクトマネージャー、レビュアー、アノテーター、収集者
不合格	管理者、プロジェクトマネージャー、レビュアー
合格	管理者、プロジェクトマネージャー、レビュアー
データ提出	管理者、プロジェクトマネージャー

身分層はロール層とは別に適用されます。管理者とプロジェクトマネージャーは身分の制限を受けません。その他のロールはタスクの関係者である必要があります。

操作者	設定できる状態	説明
タスクのアノテーター	開始待ち、作業中、未チェック	合格およびそれ以降の状態は設定できません
タスクのレビュアー	合格、不合格	その他の状態は設定できません
タスクの作成者	所属ロールで許可される状態と同じ	作成者がタスクを代行管理するために使用
その他のアカウント	なし	API は 403 を返します

タスクが合格のとき、アノテーターは状態を変更できません。これによりレビューの結論が書き換えられないようにします。

データセットとチェック結果

タスクは dataset_tasks を通じてデータセットを関連付け、各関連レコードは 1 件のチェック結果を持ちます。

フィールド	意味	制約
データセット	タスクが関連付けるデータセット	1 つのデータセットは同時に 1 つのタスクにのみ属します
チェック結果	合格（VALID）または不合格（INVALID）	未判定のときは空です
データ不合格理由	チェックが不合格のときに入力する理由	最大 1000 文字

警告

アノテーターがデータのチェック結果を合格としてマークしても、サーバーはその結果を記録しません（空値を書き戻します）。データの合格と不合格は、タスクのレビュアー、管理者、またはプロジェクトマネージャーがマークします。

タスク操作

一覧と絞り込み

項目	説明
状態のグループ化	上部タブで状態ごとにまとめ、各状態のタスク数を表示します。「全タスク」には合計を表示します
ビュー	全タスクビューには横向きビュー（状態ごとの列）と縦向きビュー（統合一覧）があります
タスク名	名前のあいまい一致
所属プロジェクト	プロジェクトで絞り込み
アノテーター	アノテーターアカウントで絞り込み
レビュアー	レビュアーアカウントで絞り込み
作成日	作成日で絞り込み。形式は YYYY-MM-DD です
ページネーション	下部にページごとの件数と総件数を表示します

絞り込み条件は URL クエリパラメータに書き込まれるため、条件付きのリンクをそのまま共有できます。

タスク詳細

タスク詳細ページはサイドバーと 4 つのタブで構成されます。

タブ	ルート	内容
アノテーションデータ	/tasks/{id}/dataset	タスクに関連付けたデータセット一覧、チェック結果、1 件ごとの操作
一括アノテーション	/tasks/{id}/repeats	一括アノテーションのワークスペース
問題アノテーション	/tasks/{id}/invalids	無効としてマークされたアノテーション項目
アノテーション統計	/tasks/{id}/analysis	タスク内のアノテーション記述と統計

サイドバーには、タスクのカバー、タスク名、プロジェクト、アノテーター、レビュアー、進捗を表示し、次の操作を提供します。

操作	作用	制約
タスク編集	タスク名、所属プロジェクト、アノテーター、レビュアーを変更	「アノテーションタスクを管理」が必要
タスク削除	タスクを論理削除	「アノテーションタスクを管理」が必要。削除後はゴミ箱から復元できます
現在のワークフロー	現在の状態と実行可能な次・前のステップを表示	ロールと身分で絞り込み

一括操作

タスク一覧でタスクを選択すると、下部の操作バーに一括削除が表示されます。削除は 1 件ずつ実行する論理削除で、データセット自体には影響しません。削除したタスクは ゴミ箱 に入り、復元できます。

タスク一覧右上の「アノテーションタスク作成」ボタンは、アカウントに「アノテーションタスクを管理」の書き込み権限がある場合に表示され、アノテーションタスク作成 のフォームを開きます。

一括アノテーション

一括アノテーションのワークスペースには 3 つのモードがあります。3 つのモードはいずれも同じタスクのデータセット範囲で有効です。

モード	作用
クイック注釈	タスク内のすべてのデータセットに同じアノテーション記述を追加します
アノテーション一括コピー	サンプルのアノテーションを時間軸の比率に合わせて他のデータセットへコピーします
ラベル一括置換	記述、対象、ターゲットなどの文言をルールに従って一括置換します

ワークスペースには、サンプルセレクター、アノテーション進捗バー、アノテーションモードの選択が含まれます。

制約と制限

項目	値	説明
タスク名	プラットフォーム全体で一意	作成時に同名がある場合、システムが連番を付けます（例：「タスク (2)」）。既存の名前へ編集すると API は 400 を返します
データセットの所属	1 つのデータセットは同時に 1 つのタスクにのみ属します	データセットをタスクに追加すると、他のタスクから自動で外れます
理由の長さ	最大 1000 文字	超過分は切り捨てられます
チェック結果のマーク	合格はタスクのレビュアー、管理者、またはプロジェクトマネージャーのみがマークします	アノテーターが合格をマークするとサーバーは空値を書き戻します
ステータス変更	タスクのアノテーター、レビュアー、作成者、または管理者、プロジェクトマネージャーのみ	その他のアカウントは 403 を返します
合格済みのタスク	アノテーターは状態を変更できません	レビュアーまたは管理者、プロジェクトマネージャーが操作します
一括操作	一括削除のみ	その他の一括操作はありません

トラブルシューティング

現象	考えられる原因	対処	担当
「タスク名が既に存在します」と表示	編集時に名前が他のタスクと重複	タスク名を変更します	プロジェクトマネージャー、管理者
「タスクが存在しません」と表示	タスクが削除済み、またはタスク ID が無効	一覧に戻り、タスクの有無を確認します	アノテーター、レビュアー、プロジェクトマネージャー
タスクへのアクセス権限がないと表示	アカウントがタスクの所属プロジェクトにいない、タスクの関係者でない、またはタスクの所属プロジェクトが公開でない	プロジェクトメンバーまたは管理者がアカウントをプロジェクトに追加し、割り当てます	プロジェクトマネージャー、管理者
「タスクは合格済みのため変更できません」と表示	アノテーターが合格済みタスクを変更しようとした	レビュアーまたは管理者、プロジェクトマネージャーが変更します	レビュアー、管理者
「アノテーターは「作業中」か「確認待ち」にのみ変更可能です」と表示	アノテーターが権限外の状態を選択した	許可された状態を選択します	アノテーター
「レビュアーは「合格」または「不合格」にのみ変更可能です」と表示	レビュアーが権限外の状態を選択した	許可された状態を選択します	レビュアー
「この状態に設定する権限がありません」と表示	アカウントのロールがその状態の許可リストにない	権限のあるロールが操作します	プロジェクトマネージャー、管理者
「状態パラメータは必須です」または「無効なタスク状態です」と表示	リクエストに状態がない、または状態値が不正	タスク詳細のサイドバーで状態を選択します	アノテーター、レビュアー
「権限がありません」と表示	公開プロジェクトでタスクを作成したが、アカウントがプロジェクトメンバーでない	プロジェクトメンバーが作成するか、管理者にプロジェクトへの追加を依頼します	プロジェクトマネージャー、管理者
「管理者のみ公開タスクの所属プロジェクトを変更できます。」と表示	プロジェクトマネージャーが公開プロジェクトのタスクの所属プロジェクトを変更した	管理者が操作します	管理者
タスクをそのプロジェクトに移動する権限がないと表示	移動先プロジェクトがアカウントの管理範囲外	権限のあるプロジェクトを選択します	プロジェクトマネージャー
「メンバー以外は結果を変更できません。」と表示	プロジェクトメンバー以外がデータのチェック結果を変更した	プロジェクトメンバーまたは管理者が操作します	プロジェクトマネージャー、管理者
一覧が空	絞り込み条件が狭すぎる、プロジェクト範囲の選択ミス、またはアカウントにタスクの参照権限がない	絞り込みをリセットする、プロジェクト範囲を切り替える、またはプロジェクトメンバーであることを確認します	アノテーター、レビュアー、プロジェクトマネージャー

関連ページ

ページ	用途
アノテーションタスク作成	タスクの作成、アノテーターとレビュアーの割り当て
データ管理	アノテーション対象データセットの絞り込みと選択
データ品質検査	ROS 録画の自動品質検査ルール
データエクスポート	トレーニング用にアノテーション結果をエクスポート
ゴミ箱	削除したタスクとデータの復元
モジュール権限	モジュール権限の設定方法
アノテーターガイド	アノテーターの実行フロー
レビュアーガイド	レビューと差し戻しのフロー