AACWorkflow Docs

소대 템플릿

사전 구성된 소대 조합 — 템플릿을 선택하고 리더와 팀 에이전트가 준비된 상태로 보세요.

소대 템플릿은 한 번의 클릭으로 완벽하게 기능하는 소대를 만들 수 있게 해주는 미리 구성된 에이전트 팀 청사진입니다. 리더와 구성원을 수동으로 선택하는 대신 사용 사례에 맞는 템플릿을 선택합니다.

사용 가능한 템플릿

AACWorkflow는 다양한 유형의 작업에 최적화된 5개의 스타터 템플릿을 제공합니다:

템플릿역할구성원사용 사례
프론트엔드 소대프론트엔드 빌더(리더)구현자, 검토자엔드투엔드 UI 기능 구축
백엔드 소대백엔드 빌더(리더)데이터베이스 전문가, API 검토자서버 측 기능 구현
QA 소대QA 리드(리더)테스트 작성자, 버그 조사자테스트 범위 및 버그 분류
풀스택 소대풀스택 아키텍트(리더)프론트엔드 빌더, 백엔드 빌더, 코드 검토자스택 전체의 복잡한 기능
연구 소대연구 리드(리더)문서 작성자, 분석 에이전트깊이 있는 조사 및 분석

각 템플릿에는 설명, 구성원 미리보기, 소대 협업을 안내하는 기본 지침이 함께 제공됩니다.

템플릿에서 소대 만들기

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를 통해템플릿 세부 정보 가져오기지역화보안문제 해결적용할 때 "템플릿을 찾을 수 없음""일부 에이전트를 만들지 못함""소대가 생성되었지만 예상된 구성원이 없음"관련