运行时标签和路由

使用标签控制运行时可以声明和执行的特定任务，基于所需的能力。

运行时标签和路由允许你控制任务到运行时的分配，基于能力和需求。当你创建任务时，你可以指定运行时必须有哪些标签（操作系统、工具链、提供商、自定义标签）。调度器随后只会将任务分配给标签集匹配的运行时。

为什么标签很重要

想象你有三个运行时:

macOS 守护进程 - Claude 提供商，无 Docker
Linux 守护进程 - Claude 和 Cursor，Docker 支持，Node.js 20
Windows 守护进程 - 仅 Claude 提供商

如果你创建一个说"这个智能体需要 Docker 和 Node 20"的任务，AACWorkflow 应该只提供给 Linux 守护进程。没有标签，任务可能会意外分配给 macOS 守护进程，在运行时失败。

标签可防止这些不匹配。

标签是什么?

标签是关键字描述运行时能力或属性:

类别	示例
操作系统	`macos`、`linux`、`windows`
架构	`arm64`、`amd64`（x86-64）
工具链	`node20`、`node22`、`python3.11`、`go`、`rust`
提供商	`claude`、`codex`、`cursor`
容器	`docker`、`podman`
自定义	`ci-runner`、`production`、`gpu-enabled`

标签不区分大小写，使用 kebab-case（小写加连字符）。

来自能力的自动标签

当守护进程注册时，它根据其能力自动宣传标签:

操作系统和架构 - macos、linux、windows、arm64、amd64
AI 提供商 - claude、codex、cursor（每个已安装提供商一个）
MCP 传输 - mcp-stdio、mcp-sse、mcp-http

这些是能力标签，在重启守护进程或安装新提供商时自动更新。

详见 Runtime capability registry。

自定义标签

除了自动能力标签外，你可以将自定义标签分配给运行时，以描述 AACWorkflow 无法自动检测的属性:

转到 设置 → 运行时
点击一个运行时
滚动到 自定义标签
添加标签如 node20、gpu-enabled、ci-runner、production
点击保存

对以下项目使用自定义标签:

工具链版本 - node20、python3.11、go1.21
硬件 - gpu-enabled、high-memory
目的 - ci-runner、local-dev、production
位置 - us-west、eu-central

在任务上要求标签

当你创建任务或将智能体分配给问题时，你可以指定所需标签。只有标签集是所需标签超集的运行时才会声明该任务。

通过 UI

创建或编辑问题/任务
在 运行时需求 下，点击 添加标签
从列表中选择标签（自动完成，来自所有运行时）
示例：选择 docker 和 node20
保存问题/任务

任务现在只会在具有 docker 和 node20 两个标签的运行时上运行。

从问题继承标签

问题可以设置所有其任务继承的默认所需标签:

打开一个问题
转到 问题设置 → 运行时需求
添加所需标签
分配给此问题的任何智能体都将默认具有这些需求

如果需要，你可以按任务覆盖需求。

标签匹配算法

AACWorkflow 使用集合匹配:

任务所需标签: [docker, node20]
运行时标签: [macos, arm64, claude, docker, node20, custom-tag]
匹配? 是的 - 运行时有所有所需标签

另一个示例:

任务所需标签: [docker, gpu-enabled]
运行时标签: [linux, amd64, claude, docker]
匹配? 否 - 运行时有 docker 但没有 gpu-enabled

空的所需标签与任何运行时匹配（无限制）。

查看运行时标签

在 UI 中

转到 设置 → 运行时
点击一个运行时
看 能力标签（自动）和 自定义标签（手动）

通过 API

/runtimes/{id} 端点返回两个集合:

{
  "id": "runtime-123",
  "name": "Linux CI runner",
  "capability_labels": ["linux", "amd64", "claude", "docker"],
  "custom_labels": ["ci-runner", "node20", "python3.11"],
  "effective_labels": ["linux", "amd64", "claude", "docker", "ci-runner", "node20", "python3.11"]
}