团队

团队将组织成员归组，用于责任归属、流量归因和共享治理。预算、限流策略和 MCP 访问策略可以使用团队身份，控制来自已绑定团队的调用方 API Key 的流量。

团队成员关系与调用方 API Key 绑定的用途不同。成员名单用于标识谁属于该团队；只有请求使用的调用方 API Key 显式绑定到该团队时，流量才会计入团队控制。

创建团队

1. 打开 Teams，选择 New team。
2. 输入 Display name 和可选的 Description。
3. 选择 Create team。

团队将显示其成员数量和 Team ID。选择团队名称或 Manage 可打开团队详情页。

其他指南要求设置 TEAM_ID 时，请复制 Team ID。团队详情页 URL 的末尾也包含同一个 UUID。

export TEAM_ID="YOUR_TEAM_ID"

添加和管理成员

团队成员来自组织成员池。将成员加入团队之前，请先创建或邀请成员。

1. 打开团队详情页。
2. 在 Members 下选择 Add member。
3. 选择 Org member，并为其分配团队角色 Member 或 Lead。
4. 选择 Add member。

Member 和 Lead 标签属于团队成员名单，不会取代成员的组织角色。当团队只有一名 Lead 时，需要先将另一名成员提升为 Lead，才能降级或移除唯一的 Lead。

使用成员行中的角色选择器更改其团队角色。选择移除操作可将成员移出团队，但不会移除其组织成员资格。

将调用方 API Key 绑定到团队

仅加入团队不会让流量归因到团队。需要将应使用团队预算、限流或 MCP 访问权限的每个调用方 API Key 绑定到团队：

1. 打开环境，选择 API keys。
2. 使用 New API key 创建 Key，或编辑已有 Key。
3. 在 Team 中选择团队。
4. 可以选择 Owner。选择团队后，Owner 列表只包含该团队的成员。
5. 创建 Key 或保存更改。

API Key 所在行会显示其团队绑定。成员出现在团队名单中，并不意味着其个人 Key 的流量会计入该团队。

配置团队控制

团队详情页提供 Team budget (shared)、Per-member budget 和 MCP entitlement 控件。以下指南介绍完整行为：

• 预算介绍共享团队预算，以及团队中每名成员各自独立的额度。
• 限流策略介绍如何匹配团队，并将其配额拆分为按成员计数的配额桶。
• MCP 访问策略介绍如何配置团队绑定 Key 可达的 MCP 工具。

请使用控制台创建、编辑和删除团队，以及管理团队成员。公共 AISIX Cloud Admin API 支持团队权益，但其公共契约目前不包含团队生命周期和成员管理操作。

从身份提供方同步团队

SCIM 目录同步会将身份提供方中的组表示为同名团队。组成员关系变化会自动更新团队名单。请在身份提供方中管理目录同步团队的名单，避免后续同步覆盖控制台中的更改。

目录同步团队可以与控制台中创建的团队一样，使用调用方 API Key 绑定、预算、限流策略和 MCP 权益。

编辑或删除团队

打开团队详情页，选择 Edit 可更改显示名称或描述。选择 Delete 可删除团队及其成员名单。名单中的人员仍然是组织成员。

下一步

继续阅读调用方 API Key，创建绑定到团队的凭证。然后为团队配置预算、限流策略或 MCP 访问策略。