種類
種類はWorkflowsの型システムです。各接続の背後にある意味論的な意味とデータ表現を示します。
Workflowsでは、一部の値は事前に設定できず、実行中にのみ決定されます。これは、正確な入力値をあらかじめ把握できない関数を書くことに似ています。入力値は、ユーザー入力または他の関数の出力から、実行時にのみ提供されます。
これを管理するために、Workflowsでは セレクタを使用します。これらは参照のように機能し、データを直接保持せずにデータを指し示します。
セレクタ
セレクタは、名前付き入力、たとえば入力画像のようなものを、次のように参照する場合があります。 $inputs.image、あるいは前のステップで生成された予測、たとえば $steps.my_model.predictions.
Workflowsエコシステムでは、ユーザーはデータの用途(例: 「画像」)に注目し、その正確な形式を気にする必要はありません。一方、ワークフローブロックを構築する開発者には、正確なデータ形式が必要です。 Kinds これらは両方のニーズに応えます。ユーザーのデータ処理を簡単にしつつ、開発者が正しいデータ構造を扱えるようにします。
何ですか Kinds?
Kinds は、Workflowsの型システムであり、各 種類 が定義するものは次のとおりです:
name - 表現する 意味論的な意味 基礎となるデータの、たとえば
imageまたはpoint;Pythonのデータ表現 - ブロック作成者が、ブロック内でデータを扱う際に想定すべきデータ型と形式。
任意 シリアライズされたデータ表現 - 外部システムがWorkflowsエコシステムと統合する際に使用すべきkindの形式を定義します。必要に応じて、独自のkind用シリアライザとデシリアライザが提供され、シームレスな変換を実現します。
kindを使うと互換性の確保が簡単になります。あるステップが特定の 種類 を出力し、別のステップが同じ 種類を必要とする場合、ワークフローエンジンはそれらが互換であるとみなし、互換性チェックの必要性を減らし、Workflows定義のコンパイル時検証を提供します。
現時点では、 kinds はあまりにも単純で、型の多相をサポートしていません。そのため、開発者はその問題を解決するためにkindのユニオンを使うよう求められます。広範なkindのユニオンを定義するのは問題になる可能性があるため、この問題はおそらくExecution Engineで対処されるでしょう v2.
Roboflowプラグインで宣言されるkind
*: 任意の要素に相当ROBOFLOW_MANAGED_KEY: Roboflow管理のキーまたは認証情報bar_code_detection: バーコード検出による予測boolean: ブールフラグbytes: このkindはバイトを表しますclassification_prediction: 分類器による予測contours: 各配列が輪郭点を表すnumpy配列のリストdetection: detectionsベースの予測の単一要素(たとえばobject_detection_prediction)detections_overlaps: ペアごとの検出オーバーラップ記録のリスト辞書: 辞書埋め込み: ベクトル埋め込みを表す浮動小数点数のリスト。float_zero_to_one:float範囲内の値[0.0, 1.0]float: 浮動小数点値image_keypoints: 古典的コンピュータビジョン手法で検出された画像キーポイントimage_metadata: supervisionに必要な画像メタデータを含む辞書image: Workflows内の画像inference_id: 推論識別子instance_segmentation_prediction: 検出されたバウンディングボックスとセグメンテーションマスクを含む、sv.Detections(...)オブジェクト形式の予測整数: 整数値keypoint_detection_prediction: 検出されたバウンディングボックスと検出されたキーポイントを含む、sv.Detections(...)オブジェクト形式の予測labeled_points: 正/負ラベル付き2D点のリストlanguage_model_output: LLM / VLMの出力list_of_values: 任意の型の値のリストnumpy_array: Numpy配列object_detection_prediction: 検出されたバウンディングボックスを含む、sv.Detections(...)オブジェクト形式の予測parent_id: ステップ出力の親の識別子point: 2Dの単一点予測タイプ: 予測の種類を示す文字列値qr_code_detection: QRコード検出による予測rgb_color: RGBカラーroboflow_api_key: Roboflow APIキーroboflow_model_id: RoboflowモデルIDroboflow_project: Roboflowプロジェクト名roboflow_solution: Roboflow Vision Eventsのユースケース識別子secret: シークレット値semantic_segmentation_prediction: セマンティックセグメンテーション向けに、各ピクセルのクラスラベルと信頼度を含む予測serialised_payloads: 通常はsinkに受け入れられるシリアライズ済み要素string: 文字列値タイムスタンプ: タイムスタンプオブジェクトtop_class: 分類モデルが予測したトップクラスを表す文字列値video_metadata: ビデオ画像メタデータzone: ポリゴンゾーンの定義
最終更新
役に立ちましたか?