ai-tasks

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AI Tasks Skill

When to use

使用场景

User wants to tag images with business-specific categories
User needs controlled vocabularies (predefined value lists)
User wants yes/no quality checks on images
User needs to extract metadata using natural language analysis

用户希望为图像添加特定业务类别的标签
用户需要使用受控词汇表（预定义值列表）
用户希望对图像进行是/否的质量检测
用户需要通过自然语言分析提取元数据

AI Task Structure

AI任务结构

Each AI Task contains 1-10 sub-tasks with:

Instruction (required): Natural language question about the image
Action Type (required):
```
select_tags
```
,
```
select_metadata
```
, or
```
yes_no
```
Vocabulary (optional): 1-30 predefined approved values

每个AI任务包含1-10个子任务，子任务需包含：

指令（必填）：关于图像的自然语言问题
操作类型（必填）：
```
select_tags
```
、
```
select_metadata
```
或
```
yes_no
```
词汇表（可选）：1-30个预定义的核准值

Action Types

操作类型

select_tags

Adds tags from vocabulary. Supports multiple selections.

json

{
  "type": "select_tags",
  "instruction": "What body style is this vehicle?",
  "vocabulary": ["sedan", "suv", "hatchback"],
  "max_selections": 1
}

从词汇表中添加标签，支持多选。

json

{
  "type": "select_tags",
  "instruction": "What body style is this vehicle?",
  "vocabulary": ["sedan", "suv", "hatchback"],
  "max_selections": 1
}

select_metadata

Sets custom metadata field (field must exist in DAM).

json

{
  "type": "select_metadata",
  "instruction": "What is the primary color?",
  "field": "primary_color",
  "vocabulary": ["red", "blue", "white", "black"],
  "max_selections": 1
}

设置自定义元数据字段（该字段必须已存在于DAM中）。

json

{
  "type": "select_metadata",
  "instruction": "What is the primary color?",
  "field": "primary_color",
  "vocabulary": ["red", "blue", "white", "black"],
  "max_selections": 1
}

yes_no

Binary quality check with conditional actions.

json

{
  "type": "yes_no",
  "instruction": "Is the product completely visible?",
  "on_yes": { "add_tags": ["framing_ok"] },
  "on_no": { "add_tags": ["needs_reshot"] }
}

带有条件操作的二元质量检测。

json

{
  "type": "yes_no",
  "instruction": "Is the product completely visible?",
  "on_yes": { "add_tags": ["framing_ok"] },
  "on_no": { "add_tags": ["needs_reshot"] }
}

Gotchas

注意事项

Instruction clarity: Be specific ("What is the collar type?" not "Describe the image")
Vocabulary design: Use business terminology, non-overlapping, 1-30 items max
Field requirements: For
```
select_metadata
```
, field must exist in DAM first
Tag values: Cannot contain
```
%
```
character
yes_no tasks: Must have at least one of
```
on_yes
```
or
```
on_no
```
Vocabulary length: Max 500 characters combined (select_tags only)
Scope: Works on visual content only (images/videos)

指令清晰度：表述要具体（例如“衣领类型是什么？”而非“描述图像”）
词汇表设计：使用业务术语，避免重叠，最多包含1-30个条目
字段要求：使用
```
select_metadata
```
时，字段必须已在DAM中存在
标签值：不能包含
```
%
```
字符
yes_no任务：必须至少包含
```
on_yes
```
或
```
on_no
```
中的一个
词汇表长度：总字符数最多500个（仅适用于select_tags）
适用范围：仅适用于视觉内容（图像/视频）

Applying AI Tasks

AI任务的应用方式

Via Saved Extensions: Create and apply via dashboard/API
Via API at Upload: Include in
```
extensions
```
array
Via Path Policies: Auto-apply to files in specific folders

通过已保存的扩展：通过控制台/API创建并应用
上传时通过API：包含在
```
extensions
```
数组中
通过路径策略：自动应用于特定文件夹中的文件

Full examples

完整示例

For complete, copy-ready

ai-tasks

configurations organized by industry (fashion e-commerce, travel, automotive) and detailed per-task-type parameter references, read resources/EXAMPLES.md.

如需按行业（时尚电商、旅游、汽车）分类的可直接复制使用的

ai-tasks

配置，以及各任务类型的详细参数参考，请阅读resources/EXAMPLES.md。