AACWorkflow Docs

小队模板

预构建的小队组合——选择一个模板，获得一个准备好的领导者和团队智能体。

小队模板是预配置的智能体团队蓝图，允许你在一次点击中创建完整功能的小队。与手动选择领导者和成员不同，你选择为你的用例定制的模板。

可用的模板

AACWorkflow 搭载五个入门模板，每个针对不同类型的工作进行优化:

模板角色成员用例
前端小队前端构建器（领导者）实现者、审查者端到端构建 UI 功能
后端小队后端构建器（领导者）数据库专家、API 审查者实现服务器端功能
质量保证小队质量保证主管（领导者）测试编写者、Bug 调查者测试覆盖和 Bug 分类
全栈小队全栈架构师（领导者）前端构建器、后端构建器、代码审查者跨栈复杂功能
研究小队研究领导（领导者）文档编写者、分析智能体深度调查和分析

每个模板都带有描述、成员预览和默认说明，指导小队协作。

从模板创建小队

通过 UI

  1. 转到 小队 并点击 + 新建小队
  2. 在模态框中，滚动到 从模板开始 部分
  3. 点击模板卡（名称、描述、成员列表）
  4. 要么:
    • 点击 应用模板 以实现一次点击创建，或
    • 在下方表单中自定义小队名称和成员，然后点击 创建
  5. 你被重定向到新的小队页面

小队创建时包括:

  • 领导者: 模板的领导者智能体（例如，"前端构建器"）
  • 成员: 模板的成员智能体（例如，"实现者"、"审查者"）
  • 说明: 模板的默认协作指南

通过 API

curl -X POST https://aacworkflow.example.com/api/squads/from-template \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "frontend_squad",
    "name": "My UI Team"  # 可选；如果省略则自动生成
  }'

返回:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My UI Team",
  "workspace_id": "...",
  "leader_id": "550e8400-e29b-41d4-a716-446655440001",
  "members": [
    {
      "agent_id": "550e8400-e29b-41d4-a716-446655440002",
      "role": "implementer"
    },
    {
      "agent_id": "550e8400-e29b-41d4-a716-446655440003",
      "role": "reviewer"
    }
  ],
  "instructions": "Coordinate UI work: implement, then review before done.",
  "created_at": "2025-06-22T15:30:00Z"
}

模板结构

每个模板定义为 AACWorkflow 嵌入目录中的 JSON:

{
  "id": "frontend_squad",
  "name": "Frontend Squad",
  "description": "Ships UI features end to end",
  "leader": {
    "agent_template_id": "frontend-builder",
    "role": "leader"
  },
  "members": [
    {
      "agent_template_id": "frontend-builder",
      "role": "implementer"
    },
    {
      "agent_template_id": "code-reviewer",
      "role": "reviewer"
    }
  ],
  "default_instructions": "Coordinate UI work: implement, then review before done."
}

当你应用模板时:

  1. 领导者智能体模板被物化（从它创建新智能体）
  2. 每个成员智能体模板被物化
  3. 使用物化的领导者和成员创建小队
  4. 应用默认说明

定制

模板创建后

一旦小队从模板创建，你可以:

  • 重命名小队 — 点击小队名称编辑
  • 改变说明 — 转到 小队设置 → 说明 并编辑
  • 添加/移除成员 — 转到 成员 并管理名单
  • 改变领导者 — 晋升成员或邀请新智能体带领

小队现在独立于模板。改变模板（在未来 AACWorkflow 版本中）不会影响现有小队。

模板定制（未来）

在将来的版本中，你将能够:

  • 星形/收藏模板 — 将经常使用的模板保持在顶部
  • 创建自定义模板 — 将你的小队配置保存为可重用模板
  • 组织范围模板 — 存储在工作区级别、跨团队共享的模板

如何创建模板智能体

当你应用模板时，AACWorkflow:

  1. 按 ID 解析模板（必须存在于嵌入目录中）
  2. 对于每个引用的智能体模板（领导者 + 成员），调用 CreateAgentFromTemplate
  3. 使用物化的领导者创建小队
  4. 将每个物化的成员添加到小队
  5. 设置默认说明

所有 UUID 是内部往返。用户输入仅为 template_id（对目录进行验证）和可选的 squad_name。

每次应用模板时，创建新智能体实例。应用"前端小队"模板两次创建两个单独的前端构建器智能体。

列出可用的模板

通过 UI

转到 小队 → 新建小队。模态框显示所有可用的模板。

通过 API

curl https://aacworkflow.example.com/api/squad-templates \
  -H "Authorization: Bearer <token>"

返回:

[
  {
    "id": "frontend_squad",
    "name": "Frontend Squad",
    "description": "Ships UI features end to end",
    "member_preview": [
      { "agent_template_id": "frontend-builder", "role": "implementer" },
      { "agent_template_id": "code-reviewer", "role": "reviewer" }
    ]
  },
  {
    "id": "backend_squad",
    "name": "Backend Squad",
    "description": "Implement server-side features",
    "member_preview": [...]
  }
]

获取模板详细

curl https://aacworkflow.example.com/api/squad-templates/frontend_squad \
  -H "Authorization: Bearer <token>"

返回:

{
  "id": "frontend_squad",
  "name": "Frontend Squad",
  "description": "Ships UI features end to end",
  "leader": {
    "agent_template_id": "frontend-builder",
    "role": "leader"
  },
  "members": [
    {
      "agent_template_id": "frontend-builder",
      "role": "implementer"
    },
    {
      "agent_template_id": "code-reviewer",
      "role": "reviewer"
    }
  ],
  "default_instructions": "Coordinate UI work: implement, then review before done."
}

本地化

模板名称和描述已本地化为所有支持的语言（英语、俄语、韩语、中文）。

当你通过 UI 创建小队时，模板名称和描述以你工作区配置的语言显示。default_instructions 保持为英语（设计上——它们被注入到智能体提示中）。

安全

  • 模板 ID 在任何写入之前对照嵌入目录进行验证
  • 创建的智能体和小队的范围是你的工作区
  • 从模板创建小队需要与手动创建相同的权限
  • 不需要特殊权限；任何工作区成员都可以创建小队

故障排除

应用时"找不到模板"

模板 ID 可能已改变或被删除。通过 API 检查可用模板:

curl https://aacworkflow.example.com/api/squad-templates

"某些智能体未能创建"

如果在模板应用的中途创建智能体失败，小队不被创建（原子性）。修复根本问题（例如达到配额）并重试。

"小队已创建但没有预期的成员"

检查小队页面:

  1. 转到 小队 → 小队名称
  2. 点击 成员 并验证列表
  3. 如果缺少成员，手动添加它们或重新创建小队

相关

本页目录

可用的模板从模板创建小队通过 UI通过 API模板结构定制模板创建后模板定制（未来）如何创建模板智能体列出可用的模板通过 UI通过 API获取模板详细本地化安全故障排除应用时"找不到模板""某些智能体未能创建""小队已创建但没有预期的成员"相关