ai-tasks について
ai-tasksは、画像や動画の分析タスクを定義するスキルです。タグ、メタデータ、画質チェックを一貫して扱いたいチーム向けに、選択式の語彙やYes/Noの処理を設定できます。
主な機能
- 01承認済み候補からのタグ選択
- 02DAMフィールドへのメタデータ抽出
- 03条件付きタグ処理を伴う二択チェック
- 04ビジュアルコンテンツ向けタスク設定
活用シーン
- 01業務用語に基づく商品画像の分類
- 02商品が完全に写っているかの確認
- 03画像属性のDAMメタデータへの抽出
MCP 対応
DAM MCPエンドポイントで `list_saved_extensions`、`create_saved_extension`、`apply_extension_bulk` を使ってAI Tasksを管理できます。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ imagekit-developer/ skills --skill ai-tasksインストール後、Claude Code で/ai-tasksを入力して読み込まれたか確認します。
同梱ファイルresources/EXAMPLES.md
詳細
AI タスクスキル
使用するタイミング
- 画像にビジネス固有のカテゴリをタグ付けしたい場合
- 管理された語彙(事前定義された値のリスト)が必要な場合
- 画像に対して「はい/いいえ」の品質チェックを行いたい場合
- 自然言語による分析でメタデータを抽出したい場合
AI タスクの構造
各 AI タスクには、次の1~10 個のサブタスクが含まれます。
- 指示(必須):画像に関する自然言語の質問
- アクションタイプ(必須):
select_tags、select_metadata、またはyes_no - 語彙(任意):事前に承認された値を1~30個
アクションタイプ
select_tags
語彙からタグを追加します。複数選択に対応しています。
{
"type": "select_tags",
"instruction": "What body style is this vehicle?",
"vocabulary": ["sedan", "suv", "hatchback"],
"max_selections": 1
}
select_metadata
カスタムメタデータフィールドを設定します(フィールドが DAM に存在している必要があります)。
{
"type": "select_metadata",
"instruction": "What is the primary color?",
"field": "primary_color",
"vocabulary": ["red", "blue", "white", "black"],
"max_selections": 1
}
yes_no
条件付きアクションを伴う二択の品質チェックです。
{
"type": "yes_no",
"instruction": "Is the product completely visible?",
"on_yes": { "add_tags": ["framing_ok"] },
"on_no": { "add_tags": ["needs_reshot"] }
}
注意点
- 指示の明確さ:「画像を説明してください」ではなく、「襟のタイプは何ですか?」のように具体的にします
- 語彙の設計:ビジネス用語を使い、重複しないようにします。項目数は最大1~30個です
- フィールド要件:
select_metadataでは、事前にフィールドが DAM に存在している必要があります - タグの値:
%文字は使用できません - yes_no タスク:
on_yesまたはon_noの少なくとも一方が必要です - 語彙の文字数:合計で最大500文字です(
select_tagsのみ) - 対象範囲:視覚コンテンツ(画像/動画)のみが対象です
AI タスクの適用
- DAM MCP 経由:
https://imagekit.io/mcp/damでlist_saved_extensions、create_saved_extension、apply_extension_bulkを使用します - Saved Extensions 経由:ダッシュボード/API から作成して適用します
- アップロード時の API 経由:
extensions配列に含めます - Path Policies 経由:特定のフォルダー内のファイルに自動適用します
完全な例
業界別(ファッション EC、旅行、自動車)の、コピーしてすぐに使える ai-tasks 設定と、タスクタイプごとの詳細なパラメーターリファレンスについては、resources/EXAMPLES.md をお読みください。
コメント
Markdown 対応