アルゴリズム管理

アルゴリズム管理は、プラットフォーム内で再利用可能なカスタムアルゴリズムテンプレートを管理します。各テンプレートは Docker イメージ参照、パラメータスキーマ、リソース制限のセットを記録します。ワークフロー管理の処理ルールがデータセットに一致すると、テンプレートに従ってそのデータセット上でコンテナを起動し、データセットを読み取り専用の入力としてマウントし、実行レポートと成果物を回収します。

前提条件

項目	内容
メニュー入口	管理 → ワークフロー → パイプライン概要 → 「ポストプロセスアルゴリズム」→ アルゴリズムライブラリ管理
代替入口	ワークフロー → 処理ルール → カスタムアルゴリズムを実行ステップ → アルゴリズム選択ボックスの横の「新規作成」
ルート	/algorithms
ページ権限	ワークフローを表示
API 権限	トレーニングを表示（一覧と詳細）、トレーニングタスクを作成（新規作成・編集・有効化/停止・削除）
書き込み可能範囲	グローバルアルゴリズムは管理者のみ書き込み可能。プロジェクトアルゴリズムにはプロジェクトマネージャーで、対象プロジェクトへの書き込み権限が必要
依存関係	イメージを実行ノードからアクセス可能なレジストリにプッシュ済みであること。実行ノードにコンテナ実行環境があること

モジュール権限の設定方法はモジュール権限を参照してください。

アルゴリズムの定義と操作

アルゴリズムフィールド

新規作成ページと編集ページでは次のフィールドを管理します。

フィールド	タイプ	必須	既定値	説明
名前	テキスト	はい	なし	最大 200 文字。処理ルールは名前と ID でアルゴリズムを参照
範囲	列挙	はい	グローバル	グローバル：プラットフォーム全体で使用可能。プロジェクト：選択したプロジェクトのみで使用可能
イメージ参照	テキスト	はい	なし	registry/repo:tag または Docker Hub の repo:tag。最大 500 文字
説明	テキスト	いいえ	空	最大 500 文字
有効化	スイッチ	いいえ	オン	無効化すると処理ルールから選択できない
パラメータスキーマ	JSON	はい	空オブジェクト	実行時パラメータフォームの生成に使用する JSON Schema
リソース制限	JSON	いいえ	下表を参照	コンテナのリソース上限

パラメータスキーマ

パラメータスキーマは実行時フォームのフィールドを記述し、プラットフォームはそれに基づいてパラメータ入力コントロールを生成します。

項目	値	説明
フィールドタイプ	string、number、integer、boolean、array、object	JSON Schema で定義
列挙制約	enum	選択可能な値を制限
既定値	default	実行時フォームの初期値
必須項目	required 配列	未入力の場合は実行を拒否
数値範囲	minimum、maximum	数値フィールドの上下限

例：

{
  "type": "object",
  "properties": {
    "threshold": { "type": "number", "title": "品質しきい値", "default": 0.8, "minimum": 0, "maximum": 1 },
    "mode": { "type": "string", "title": "検出モード", "enum": ["strict", "normal", "loose"], "default": "normal" },
    "enable_video": { "type": "boolean", "title": "動画を生成", "default": false }
  },
  "required": ["threshold"]
}

実行時に入力したパラメータはコンテナのコマンドライン引数に変換され、規則は --key value です。ブール値の true は --key に変換し、false は省略します。

リソース制限

フィールド	タイプ	既定値	説明
memory_mb	数値	2048	メモリ上限。単位は MB
cpus	数値	1	CPU コア数の上限
pids_limit	数値	100	プロセス数の上限
timeout_seconds	数値	3600	実行タイムアウト。単位は秒
network_enabled	ブール	false	コンテナのネットワークアクセスを許可するかどうか

例：

{
  "memory_mb": 2048,
  "cpus": 1,
  "pids_limit": 100,
  "timeout_seconds": 3600,
  "network_enabled": false
}

イメージの入出力規約

プラットフォームは固定パラメータでコンテナを起動し、アルゴリズムイメージは次のパスを読み書きします。

パス	読み書き	必須	説明
/input/dataset.{拡張子}	読み取り専用	はい	プラットフォームがマウントしたデータセットファイル。拡張子はデータセットと一致
/output/report.json	書き込み可	はい	実行レポート。実行記録の results フィールドに書き込まれる
/output/artifacts/*	書き込み可	いいえ	動画や画像などの成果物。プラットフォームがアップロードし、実行記録に記録
stdout の [PROGRESS] 42 message	出力	いいえ	プラットフォームが実行進捗として解析

プラットフォームは --input、--output、--mode の 3 つのパラメータを必ず渡し、--mode の値は qc または preprocess です。

モード	動作
qc	元のデータを変更せず、レポートと成果物のみを生成
preprocess	成果物として新しいファイルを出力できます。プラットフォームは元のデータセットを自動的に置き換えません

一覧の操作

操作	効果	制約
有効化スイッチ	アルゴリズムの有効状態を切り替え	無効化すると処理ルールから選択できない
編集	イメージ、スキーマ、リソース制限を変更	グローバルアルゴリズムは管理者のみ編集可能
削除	アルゴリズムを論理削除	復元不可。処理ルールから参照されている場合は先に処理ルールを調整

制約と制限

項目	値	説明
名前の長さ	200 文字以下	超過時は保存を拒否
説明の長さ	500 文字以下	超過時は保存を拒否
パラメータのキー名	input、output、mode は使用不可	プラットフォームの固定パラメータと競合
一覧の表示範囲	プロジェクト未指定の場合、管理者はすべて、管理者以外はグローバルアルゴリズムのみ表示	プロジェクトアルゴリズムはプロジェクト内で表示
イメージタグ	省略時は latest として扱う	明示的なタグの指定を推奨
カスタムアルゴリズムイメージ	アルゴリズム記録のイメージ参照を使用	システム組み込みアルゴリズムのイメージはデプロイ側で上書き可能
終了コード	0 以外は失敗として扱う	失敗時は stdout/stderr のログを保持

トラブルシューティング

現象	考えられる原因	対処	担当
保存時にイメージをプルできないと表示される	イメージがプッシュされていない、または実行ノードがレジストリにアクセスできない	イメージをプッシュする。プライベートレジストリの場合は実行ノードにプル用の認証情報を設定する	アルゴリズム開発者、プラットフォーム運用
管理者以外がグローバルアルゴリズムを保存して拒否される	グローバルアルゴリズムは管理者のみ書き込み可能	プロジェクト範囲を選択し、書き込み権限のあるプロジェクトを指定する	プロジェクトマネージャー
パイプライン実行が失敗し report.json がない	イメージが規約どおり /output/report.json を書き込んでいない	入出力規約に従ってイメージを修正し、再実行する	アルゴリズム開発者
実行がタイムアウトする	timeout_seconds を超過している	タイムアウト上限を引き上げるか、アルゴリズムを最適化する	アルゴリズム開発者
パラメータが反映されない	パラメータのキーがプラットフォームの固定パラメータと重複している、またはイメージが --key value を解析していない	パラメータのキー名を変更し、イメージのパラメータ解析を修正する	アルゴリズム開発者
グローバルワークフローでプロジェクトアルゴリズムを選択できない	アルゴリズムのプロジェクト範囲が対象プロジェクトと一致しない	同じ範囲のアルゴリズムを選択するか、管理者がグローバルアルゴリズムを作成する	プロジェクトマネージャー、管理者

関連ページ

ページ	用途
ワークフロー管理	「カスタムアルゴリズムを実行」アクションでアルゴリズムを参照
データ品質検査	品質検査ルールの実行と結果の表示
運用監視	タスクキューと実行ログの表示