コンテンツへスキップ
For the complete documentation index, see llms.txt. This page is also available as Markdown.

ラベリングで共同作業する

チーム全体でデータセットのラベル付けを手伝います。

概要

小規模なチームが数百枚の画像のラベリングに取り組んでいる場合でも、大規模なチームが数百万枚の画像に取り組んでいる場合でも、データセットの作成は枠を描くこと以上のものです。ラベリングの大部分は、現実世界の画像を学習済みモデルの保存された知識に取り込むプロセスにあり、そこには画像の収集、保存、整理、選択、割り当て、ラベリング、レビューが含まれます。

Roboflow には、次のことを可能にする共同作業機能があります。

  • チーム内の誰にでもラベリングジョブを割り当てて、複数のチームメンバー間で作業を分担する

  • アップロード時に画像をバッチに整理する

  • 作業の指針となり、一貫性を確保するための画像ラベリング手順を提供する

  • 進行中のラベリング作業をひと目で確認する

  • すべてのラベリング作業の履歴タイムラインを見る

  • 変更を元に戻す

  • 画像にコメントを追加し、画像コメントの履歴を表示する

  • ラベリングに問題のある画像を、修正のためにチームメンバーへ送り返す

  • データセットに含める前にラベルを承認または却下する

ラベリングジョブを割り当てる

チーム全体でラベリング作業を分担したり、ラベリングを担当する特定の人に割り当てたりできます。個々のチームメンバーにジョブを割り当てれば、同時にオンラインになっていても互いの作業を上書きしてしまう心配がありません。

チーム内の1人または複数人にジョブを割り当てることができます。まだワークスペースにチームメンバーを追加していない場合は、 招待して 同じタイミングで完了するラベリングジョブを割り当てることもできます。

提供 ラベリング手順

「画像を割り当て」タブから、ラベラーに手順を提供できます。バッチをラベラーに割り当てる前に、「手順を追加」をクリックしてバッチに手順を追加します。手順を設定したら、「画像を割り当て」をクリックします。

手順を割り当てるには「編集」をクリックします。

ラベリング手順を保存するには、「手順を保存」をクリックします。

バッチにアップロード時のメモがある場合は、バッチカードに表示され、既定で手順に反映されます。ジョブを割り当てる前に編集できます。

ジョブ通知

ラベリングジョブが割り当てられると、その担当作業があるチームメンバーに通知が届きます。

ラベリングジョブボード

ラベリングジョブボードでは、ラベリングプロセスを進む個別に割り当てられたジョブの現在の状態をひと目で確認できます。

特定のラベラーの統計を表示するには、 ラベラー ドロップダウンに値を入力してください。

ジョブの詳細

ラベリングジョブボードで個々のジョブをクリックすると、そのジョブと進捗の詳細をより詳しく確認できます。まだラベル付けが必要な画像をすぐに確認でき、必要に応じてジョブを別のチームメンバーに再割り当てできます。

個別画像の管理

ジョブ内の「注釈済み」タブでは、チェックボックス、ドラッグ चयन択、またはヘッダーの「すべて選択」チェックボックスを使って個別の画像を選択できます。選択したら、次のことができます。

  • 「N枚を未注釈へ送る」をクリックすると、選択した画像を再ラベルのために「未注釈」タブに戻します。

  • 「N枚をデータセットに追加」をクリックすると、選択した画像だけをデータセットに追加します。選択されなかった注釈済み画像はジョブに残ります。

一部の画像だけをデータセットに追加した場合、ジョブは現在の状態のまま更新された件数で維持されるため、ラベラーは残りの画像の作業を続けられます。

これらの操作は注釈エディタでも利用できます。割り当て済みジョブの注釈済み画像を表示しているときは、

  • チェックマークボタンを使って、現在の画像をデータセットに追加します。

  • 画像切り替えの横にある「未注釈へ送る」ボタン(矢印アイコン)を使って、現在の画像を再ラベルのために送り返します。

どちらの操作でも、エディタは自動的に次の画像へ進みます。

レビュー モード

この機能は Teams アドオン とEnterpriseワークスペースで利用できます。詳しくは 料金ページ をご覧ください。

ラベル付けされた画像を個別に承認または却下し、必要に応じて再作業のためにラベラーへ送り返せます。そのためには、画像のバッチをクリックします。次に、「承認済み」「却下済み」「To Do」タブの間を移動して、ジョブ内の画像の状態を確認します。

レビュー モードは、そのワークスペースで有効になっているすべてのプロジェクトでオンになります。オフにするには、設定を開き、「プロジェクト設定」を開いて、「レビュー モード」をオフに切り替えます。これによりレビュー列が削除され、完了したジョブはそのままデータセットに送られます。オフにしてもワークスペースからレビュー モードが削除されるわけではないため、いつでも再度オンにできます。

これを変更するには「ワークスペース設定の編集」権限が必要です。オフにしたときにバッチがまだレビュー中の場合は、Roboflow が確認を求め、その後それらのバッチを「注釈中」に戻します。

エージェントからラベリング作業を参照する

でプロジェクトタブを開き Roboflow Agent で「データセット」を選択すると、ラベリング段階ごとにプロジェクトの画像を閲覧できます。各段階(「未割り当て」「注釈中」「レビュー」「データセット」)ごとのチップに画像数が表示されます。チップを選び、次にバッチまたはジョブカードを選ぶと、下のグリッドを絞り込めます。

画像をクリックすると注釈エディタで開きます。「未割り当て」では読み取り専用で開きます。また、ジョブが注釈ボードから外れた場合、またはもうあなたに割り当てられていない場合も読み取り専用になります。ラベルを編集するには、「ワークスペース画像の検索」権限に加えて「注釈の更新」権限が必要です。

ジョブを各段階へ進める

Agent でジョブを開くと、タブバーにそのジョブが「未割り当て」「注釈中」「レビュー」「データセット」のどこにあるかが表示されます。段階にカーソルを合わせると、その段階で何が起こるかを確認できます。 レビュー モード がワークスペースでオフになっている場合、「レビュー」段階はグレー表示になります。ワークスペースにその機能がない場合は、アップグレード方法が表示されます。

ステッパー横のボタンで、ジョブを前後に移動できます。表示されるボタンは段階と権限によって異なります。

  • 「Nを注釈中に移動」は、未割り当ての画像からラベリングジョブを作成し、それをあなたに割り当てます。

  • 「レビューに送信」は、注釈中のジョブをレビューに送ります。

  • 「注釈中へ戻す」は、レビュー中のジョブ内のすべての画像を、追加のラベリングのために送り返します。

  • 「Nをデータセットに追加」は、ジョブの準備完了画像をデータセットに追加します。一部だけ追加した場合、残りはジョブ内に残ります。

「レビュー」段階では、これらのジョブ操作は「一括操作」メニューにあります。ステッパー右端の矢印をクリックしてください。このメニューには「すべて承認」と「すべて却下」もあり、まだ判断が必要なジョブ内のすべての画像に対して適用されます。

各ボタンは書き込み前にジョブの段階を再確認します。その間に別の誰かがジョブを移動していた場合、何も変更されず、Agent がその理由を知らせます。

画像を追加して注釈を開始

Agent に、ワークスペースから画像をモデルに追加してラベリングを開始するよう依頼します。画像を追加し、それらをあなたをラベラーとするラベリングジョブに割り当て、そのジョブの注釈エディタを開きます。

このモードでは1回のリクエストで最大500枚の画像を処理でき、画像のみ対応しています。ラベル付けせずに画像を追加する場合はこの制限はありません。Action Recognition と Multimodal のプロジェクトはサポートされていません。

作業はバックグラウンドで実行されます。ジョブを作成できない場合(例:一部の画像がすでに別のジョブにある場合)でも、画像はモデルに追加され、ジョブは作成されず、何が割り当てを妨げたのかを Agent が知らせます。

画像を承認・却下する

開いたジョブが「レビュー」段階にある場合、エディタには注釈ボードと同じ承認・却下コントロールが表示されます。現在の画像で「承認」または「却下」をクリックするか、Aで承認、Rで却下、Uで最後の判断を取り消します。これには「レビュー画像」権限が必要です。

HTTP API

ジョブのエンドポイントを使って、バッチから画像をラベリング用に割り当て、注釈ジョブのステータスを追跡します。

新しい注釈ジョブを作成

ジョブを作成すると、画像がバッチから移動され、ラベラーとレビュアーにメールが送られます。どちらもワークスペースのメンバーである必要があります。ワークスペースにロールベースアクセス制御がない場合、アプリにはレビュアーが表示されないため、 reviewerEmail をラベラーのメールアドレスに設定してください。

Create an annotation job

post

Moves images from a batch into a new annotation job and assigns a labeler and a reviewer, who get an email. Both must be workspace members. When you leave out instructionText, the job uses the batch notes. Requires annotation-job:create.

認可
Authorizationstring必須

Roboflow API key or OAuth access token.

パスパラメータ
workspacestring必須

Workspace URL slug.

projectstring必須

Project URL slug.

本文
namestring必須

Job name.

batchstring必須

ID of the batch to take images from.

num_imagesinteger · 最小: 1必須

Number of images to put in the job.

labelerEmailstring · email必須

Email of the workspace member who labels the images.

reviewerEmailstring · email必須

Email of the workspace member who reviews the labels. Without Role Based Access Control, use the labeler's email.

instructionTextstringオプション

Instructions for the labeler. When you leave it out, the job uses the batch notes set at upload.

レスポンス
200

Successful response.

application/json
idstringオプション

Job ID.

namestringオプション
ownerstringオプション

Workspace ID.

projectstringオプション

Project ID.

sourceBatchstringオプション

Project ID and batch ID joined by a slash.

createdBystringオプション

User ID of the creator, or API for jobs created with the API.

labelerstringオプション

Labeler email.

reviewerstring · ヌル許容オプション

Reviewer email.

statusstring · enumオプション

assigned while labeling, review while in review, complete once added to the dataset.

可能な値:
instructionsTextstringオプション

Instructions shown to the labeler.

numImagesintegerオプション
annotatedintegerオプション
unannotatedintegerオプション
approvedintegerオプション
rejectedintegerオプション
sourcestringオプション

What opened the job (ex: vision_events). Absent for jobs created by hand.

mediaTypestringオプション

Set for video batches.

Other propertiesanyオプション
post/{workspace}/{project}/jobs
POST /{workspace}/{project}/jobs HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "name": "Job created by API",
  "batch": "6VN0fFQIWU1E24bDjGsN",
  "num_images": 10,
  "labelerEmail": "lenny@roboflow.com",
  "reviewerEmail": "lenny@roboflow.com",
  "instructionText": "Label every forklift."
}
{
  "id": "h2E42jt686yLyMIxxqOQ",
  "name": "Test Job",
  "owner": "holeSv3hwbzrOv37vH5b",
  "project": "PBDhem3YRI1rKtQZSqRK",
  "sourceBatch": "PBDhem3YRI1rKtQZSqRK/6VN0fFQIWU1E24bDjGsN",
  "createdBy": "API",
  "labeler": "korryn@roboflow.com",
  "reviewer": "thomas@roboflow.com",
  "status": "assigned",
  "instructionsText": "Please label all the raccoons in the images using polygons",
  "numImages": 25,
  "annotated": 12,
  "unannotated": 2,
  "approved": 0,
  "rejected": 0,
  "created": {
    "_seconds": 1669148192,
    "_nanoseconds": 651000000
  }
}

注釈ジョブを一覧表示

List annotation jobs

get

Lists every annotation job in the project. Requires annotation-job:read.

認可
Authorizationstring必須

Roboflow API key or OAuth access token.

パスパラメータ
workspacestring必須

Workspace URL slug.

projectstring必須

Project URL slug.

レスポンス
200

Successful response.

application/json
get/{workspace}/{project}/jobs
GET /{workspace}/{project}/jobs HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "jobs": [
    {
      "id": "h2E42jt686yLyMIxxqOQ",
      "name": "Test Job",
      "owner": "holeSv3hwbzrOv37vH5b",
      "project": "PBDhem3YRI1rKtQZSqRK",
      "sourceBatch": "PBDhem3YRI1rKtQZSqRK/6VN0fFQIWU1E24bDjGsN",
      "createdBy": "API",
      "labeler": "korryn@roboflow.com",
      "reviewer": "thomas@roboflow.com",
      "status": "assigned",
      "instructionsText": "Please label all the raccoons in the images using polygons",
      "numImages": 25,
      "annotated": 12,
      "unannotated": 2,
      "approved": 0,
      "rejected": 0,
      "created": {
        "_seconds": 1669148192,
        "_nanoseconds": 651000000
      }
    }
  ]
}

注釈ジョブを取得

Get an annotation job

get

Returns one annotation job, with its image counts and status. Requires annotation-job:read.

認可
Authorizationstring必須

Roboflow API key or OAuth access token.

パスパラメータ
workspacestring必須

Workspace URL slug.

projectstring必須

Project URL slug.

jobIdstring必須

Job ID.

レスポンス
200

Successful response.

application/json
idstringオプション

Job ID.

namestringオプション
ownerstringオプション

Workspace ID.

projectstringオプション

Project ID.

sourceBatchstringオプション

Project ID and batch ID joined by a slash.

createdBystringオプション

User ID of the creator, or API for jobs created with the API.

labelerstringオプション

Labeler email.

reviewerstring · ヌル許容オプション

Reviewer email.

statusstring · enumオプション

assigned while labeling, review while in review, complete once added to the dataset.

可能な値:
instructionsTextstringオプション

Instructions shown to the labeler.

numImagesintegerオプション
annotatedintegerオプション
unannotatedintegerオプション
approvedintegerオプション
rejectedintegerオプション
sourcestringオプション

What opened the job (ex: vision_events). Absent for jobs created by hand.

mediaTypestringオプション

Set for video batches.

Other propertiesanyオプション
get/{workspace}/{project}/jobs/{jobId}
GET /{workspace}/{project}/jobs/{jobId} HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "id": "h2E42jt686yLyMIxxqOQ",
  "name": "Test Job",
  "owner": "holeSv3hwbzrOv37vH5b",
  "project": "PBDhem3YRI1rKtQZSqRK",
  "sourceBatch": "PBDhem3YRI1rKtQZSqRK/6VN0fFQIWU1E24bDjGsN",
  "createdBy": "API",
  "labeler": "korryn@roboflow.com",
  "reviewer": "thomas@roboflow.com",
  "status": "assigned",
  "instructionsText": "Please label all the raccoons in the images using polygons",
  "numImages": 25,
  "annotated": 12,
  "unannotated": 2,
  "approved": 0,
  "rejected": 0,
  "created": {
    "_seconds": 1669148192,
    "_nanoseconds": 651000000
  }
}

Python SDK

新しい注釈ジョブを作成

注釈ジョブを作成するには、ラベラーとレビュアーに割り当てたいアップロードバッチが必要です。

MCPサーバー

AI エージェントを MCPサーバー に接続すると、次のツールを使ってチームにラベリング作業を割り当てられます。

ツール
説明

annotation_jobs_list

プロジェクト内の注釈ジョブを一覧表示します。

annotation_jobs_get

1件の注釈ジョブの詳細を取得します。

annotation_jobs_create

ジョブを作成し、画像をラベラーとレビュアーに割り当てます。

annotation_jobs_update

ジョブのラベラー、レビュアー、または手順を更新します。

annotation_jobs_images_reassign

選択した画像からジョブを作成し、以前の割り当てを解除します。

最終更新

役に立ちましたか?